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

Reviewed-on: #2

README.md

@@ -1,3 +1,14 @@
 # kodi-timekeeper
 
 An approach to having kids use a Kodi media center instance: manage session use and keep track of time spent and available budget.
+
+## Valid Conventional Commits scopes
+
+* `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
+    ```

newsfragments/1.build.rst

@@ -1 +1,2 @@
 Add rudimentary versioning mechanics
+Set up project defaults

pyproject.toml

@@ -1,23 +1,105 @@
+[project]
+    name = "kodi-timekeeper"
+    description = "An approach to letting kids use a Kodi media center instance"
+    version = "0.1.0"
+    authors = [
+        { name = "hygienic-books", email = "hygienic-books@tentic.net" }
+    ]
+    dependencies = [
+        "certifi==2021.10.8",
+            # 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 = [
+        "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",
+            # via -r requirements.in
+        "tomli==2.0.1",
+            # via
+            #   pytest
+            #   towncrier
+        "towncrier==21.9.0"
+            # via -r requirements.in
+    ]
+
 [build-system]
-    requires = ["setuptools", "wheel"]
+    requires = [
+        "setuptools==58.0.4",
+        "wheel==0.37.1"
+    ]
     build-backend = "setuptools.build_meta"
 
 [tool.semantic_release]
-    version_toml = "src/kodi-timekeeper/__init__.py:__version__"
+    version_toml = "pyproject.toml:project.version"
     major_on_zero = false
 
 [tool.towncrier]
+    directory = "newsfragments"
     package = "kodi-timekeeper"
     package_dir = "src"
     filename = "CHANGELOG.md"
-[tool.towncrier.fragment.build]
-[tool.towncrier.fragment.chore]
-[tool.towncrier.fragment.ci]
-[tool.towncrier.fragment.docs]
-[tool.towncrier.fragment.feat]
-[tool.towncrier.fragment.fix]
-[tool.towncrier.fragment.perf]
-[tool.towncrier.fragment.refactor]
-[tool.towncrier.fragment.revert]
-[tool.towncrier.fragment.style]
-[tool.towncrier.fragment.test]
+    type = [
+        { name = "Features",          directory = "feat",     showcontent = true },
+        { 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 = "Documentation",     directory = "docs",     showcontent = true }
+    ]
+
+# New format is in the works, not yet part of towncrier 21.9.0
+# News topics from which we may want to choose:
+# [tool.towncrier.fragment.build]
+# [tool.towncrier.fragment.chore]
+# [tool.towncrier.fragment.ci]
+# [tool.towncrier.fragment.docs]
+# [tool.towncrier.fragment.feat]
+# [tool.towncrier.fragment.fix]
+# [tool.towncrier.fragment.perf]
+# [tool.towncrier.fragment.refactor]
+# [tool.towncrier.fragment.revert]
+# [tool.towncrier.fragment.style]
+# [tool.towncrier.fragment.test]
+# [tool.towncrier.fragment.deprecation]
+# [tool.towncrier.fragment.remove]
+# [tool.towncrier.fragment.trivial]
+# [tool.towncrier.fragment.meta]
+
+[tool.pytest.ini_options]
+    python_files = "test_*"
+    python_classes = "*Tests"
+    python_functions = "test_*"

pytest.ini

@@ -1,4 +0,0 @@
-[pytest]
-python_files = test_*
-python_classes = *Tests
-python_function = test_*

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

src/kodi-timekeeper/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.0.0"

tests/kodi-timekeeper/test_ktk.py

@@ -1,3 +1,21 @@
 class KTKTests:
-    def test_adding_two_ints_returns_correct_result(self):
-        pass
+    #def test_adding_two_ints_returns_correct_result(self):
+    #    assert alter(1, 2) == 3
+    #    pass
+
+    def test_one(self):
+        assert 1 == 1
+
+    def test_two(self):
+        expect = (1, 2, 3)
+        actual = (1, 2, 3)
+
+
+def test_adsasd():
+    expect = (1, 2, 3)
+    actual = (1, 2, 3)
+
+
+def test_aasssd():
+    expect = (1, 2, 3)
+    actual = (1, 2, 3)