Merge pull request '1-get-feet-wet-versioning' (#2) from 1-get-feet-wet-versioning into master

Reviewed-on: #2

README.md

@@ -4,4 +4,11 @@ An approach to having kids use a Kodi media center instance: manage session use
 
 ## Valid Conventional Commits scopes
 
-* `meta`: Affects the Git project's structure such as a `pyproject.toml` change or new directories
+* `meta`: Affects the Git project's structure such as for example a `pyproject.toml` change, adding a new directory or changing how a news fragment file is formatted
+  * Examples:
+    ```
+    refactor(meta): Move pytest config into 'pyproject.toml'
+    ```
+    ```
+    build(meta): Set custom towncrier news topics
+    ```

pyproject.toml

@@ -6,15 +6,54 @@
         { name = "hygienic-books", email = "hygienic-books@tentic.net" }
     ]
     dependencies = [
-      'requests == 2.27.1',
+        "certifi==2021.10.8",
-      'click == 8.1.0'
+            # via requests
+        "charset-normalizer==2.0.12",
+            # via requests
+        "idna==3.3",
+            # via requests
+        "requests==2.27.1",
+            # via -r requirements.in
+        "urllib3==1.26.9"
+            # via requests
     ]
 
 [project.optional-dependencies]
     dev = [
-        "towncrier == 21.9.0",
+        "attrs==21.4.0",
+            # via pytest
+        "click==8.1.3",
+            # via
+            #   click-default-group
+            #   towncrier
+        "click-default-group==1.2.2",
+            # via towncrier
+        "incremental==21.3.0",
+            # via towncrier
+        "iniconfig==1.1.1",
+            # via pytest
+        "jinja2==3.1.2",
+            # via towncrier
+        "markupsafe==2.1.1",
+            # via jinja2
+        "packaging==21.3",
+            # via pytest
+        "pluggy==1.0.0",
+            # via pytest
+        "py==1.11.0",
+            # via pytest
+        "pyparsing==3.0.8",
+            # via packaging
+        "pytest==7.1.2",
+            # via -r requirements.in
         "semver==2.13.0",
-        "pytest == 7.1.2"
+            # via -r requirements.in
+        "tomli==2.0.1",
+            # via
+            #   pytest
+            #   towncrier
+        "towncrier==21.9.0"
+            # via -r requirements.in
     ]
 
 [build-system]
@@ -38,7 +77,8 @@
         { name = "Bug fixes",         directory = "fix",      showcontent = true },
         { name = "Project structure", directory = "build",    showcontent = true },
         { name = "Refactor",          directory = "refactor", showcontent = true },
-        { name = "Test",              directory = "test",     showcontent = true }
+        { name = "Test",              directory = "test",     showcontent = true },
+        { name = "Documentation",     directory = "docs",     showcontent = true }
     ]
 
 # New format is in the works, not yet part of towncrier 21.9.0

requirements.in

@@ -0,0 +1,4 @@
+requests
+towncrier
+semver
+pytest

requirements.txt

@@ -0,0 +1,53 @@
+#
+# This file is autogenerated by pip-compile with python 3.10
+# To update, run:
+#
+#    pip-compile
+#
+attrs==21.4.0
+    # via pytest
+certifi==2021.10.8
+    # via requests
+charset-normalizer==2.0.12
+    # via requests
+click==8.1.3
+    # via
+    #   click-default-group
+    #   towncrier
+click-default-group==1.2.2
+    # via towncrier
+idna==3.3
+    # via requests
+incremental==21.3.0
+    # via towncrier
+iniconfig==1.1.1
+    # via pytest
+jinja2==3.1.2
+    # via towncrier
+markupsafe==2.1.1
+    # via jinja2
+packaging==21.3
+    # via pytest
+pluggy==1.0.0
+    # via pytest
+py==1.11.0
+    # via pytest
+pyparsing==3.0.8
+    # via packaging
+pytest==7.1.2
+    # via -r requirements.in
+requests==2.27.1
+    # via -r requirements.in
+semver==2.13.0
+    # via -r requirements.in
+tomli==2.0.1
+    # via
+    #   pytest
+    #   towncrier
+towncrier==21.9.0
+    # via -r requirements.in
+urllib3==1.26.9
+    # via requests
+
+# The following packages are considered to be unsafe in a requirements file:
+# setuptools