====Python versioning====

==== Key Points====

  * Use Semantic versioning 
    * follow [[https://www.python.org/dev/peps/pep-0440/|PEP 440]] in order to use tools like pip and setuptools
    * Semantic Versioning 2.0.0 specification) vs
    * Other schemes:     
      * Date based versioning (YEAR.MONTH 12.04)
      * Serial (single number)
      * Hybrid
      
==== Guide ====

https://jacobtomlinson.dev/posts/2020/versioning-and-formatting-your-python-code/

- consider using versioneer

[[https://realpython.com/python-application-layouts/|Real Python]] has a friendlier approach to it

=== Pre-release versioning ===

  * zero or more dev releases (denoted with a “.devN” suffix)
  * zero or more alpha releases (denoted with a “.aN” suffix)
  * zero or more beta releases (denoted with a “.bN” suffix)
  * zero or more release candidates (denoted with a “.rcN” suffix)

====Where to keep version information ====
https://packaging.python.org/guides/single-sourcing-package-version/#single-sourcing-the-version

? How to use setup.cfg?

====History====

  * created 2021-06-06