Add automatic versioning for docs.

Author: tobiasraabe

docs/rtd_environment.yml

@@ -4,7 +4,7 @@ channels:
 
 dependencies:
   - python >= 3.7
-  - pip
+  - pip >=21.1
   - setuptools_scm
   - toml
 
@@ -16,3 +16,6 @@ dependencies:
   - sphinx-autoapi
   - sphinx-copybutton
   - sphinx-panels
+
+  - pip:
+    - -e ../

docs/source/conf.py

@@ -4,6 +4,9 @@
 documentation: https://www.sphinx-doc.org/en/master/usage/configuration.html
 
 """
+from importlib.metadata import version
+
+
 # -- Project information -----------------------------------------------------
 
 
@@ -12,9 +15,9 @@
 copyright = f"2021, {author}"  # noqa: A001
 
 # The version, including alpha/beta/rc tags, but not commit hash and datestamps
-release = "1.1.0"
+release = version("cookiecutter-pytask-project")
 # The short X.Y version.
-version = "1.1"
+version = ".".join(release.split(".")[:2])
 
 
 # -- General configuration ---------------------------------------------------

pyproject.toml

@@ -1,3 +1,11 @@
+[build-system]
+requires = ["setuptools>=45", "wheel", "setuptools_scm[toml]>=6.0"]
+
+
+[tool.setuptools_scm]
+write_to = "version.py"
+
+
 [tool.tryceratops]
 ignore = ["TC003"]
 

setup.cfg

@@ -0,0 +1,37 @@
+[metadata]
+name = cookiecutter-pytask-project
+description = A minimal cookiecutter template for a project with pytask.
+long_description = file: README.rst
+long_description_content_type = text/x-rst
+url = https://cookiecutter-pytask-project.readthedocs.io/en/latest
+author = Tobias Raabe
+author_email = [email protected]
+license = MIT
+license_file = LICENSE
+platforms = unix, linux, osx, cygwin, win32
+classifiers =
+    Development Status :: 3 - Alpha
+    Environment :: Console
+    Intended Audience :: Science/Research
+    License :: OSI Approved :: MIT License
+    Operating System :: MacOS :: MacOS X
+    Operating System :: Microsoft :: Windows
+    Operating System :: POSIX
+    Programming Language :: Python :: 3
+    Programming Language :: Python :: 3 :: Only
+    Programming Language :: Python :: 3.7
+    Programming Language :: Python :: 3.8
+    Programming Language :: Python :: 3.9
+    Programming Language :: Python :: 3.10
+    Topic :: Scientific/Engineering
+    Topic :: Software Development :: Build Tools
+project_urls =
+    Changelog = https://cookiecutter-pytask-project.readthedocs.io/en/latest/changes.html
+    Documentation = https://cookiecutter-pytask-project.readthedocs.io/en/latest
+    Github = https://github.com/pytask-dev/cookiecutter-pytask-project
+    Tracker = https://github.com/pytask-dev/cookiecutter-pytask-project/issues
+
+
+[check-manifest]
+ignore =
+    version.py

{{cookiecutter.project_slug}}/.github/workflows/main.yml

@@ -1,4 +1,4 @@
-name: Continuous Integration Workflow
+name: main
 
 # Automatically cancel a previous run.
 concurrency: