Remove end-of-life Python 3.7 support

.github/workflows/test_tox.yml

@@ -14,8 +14,6 @@ jobs:
     strategy:
       matrix:
         include:
-        - python-version: '3.7'
-          toxenv: 'py37,wheel'
         - python-version: '3.8'
           toxenv: 'py38,wheel'
         - python-version: '3.9'

config/dpkg/changelog

@@ -1,5 +1,5 @@
-winreg-kb (20221228-1) unstable; urgency=low
+winreg-kb (20240211-1) unstable; urgency=low
 
   * Auto-generated
 
- -- Joachim Metz <[email protected]>  Wed, 28 Dec 2022 17:04:31 +0100
+ -- Joachim Metz <[email protected]>  Sun, 11 Feb 2024 06:14:44 +0100

docs/conf.py

@@ -52,6 +52,7 @@
 # docstrings.
 napoleon_google_docstring = True
 napoleon_numpy_docstring = False
+napoleon_include_init_with_doc = True
 napoleon_include_private_with_doc = False
 napoleon_include_special_with_doc = True
 

pyproject.toml

@@ -1,3 +1,10 @@
 [build-system]
 requires = ["setuptools", "wheel"]
 build-backend = "setuptools.build_meta"
+
+[tool.docformatter]
+black = false
+non-cap = ["dfDateTime", "dfImageTools", "dfVFS", "dfWinReg", "dtFabric", "iMessage", "iOS", "iPod", "mDNS"]
+non-strict = false
+wrap-summaries = 80
+wrap-descriptions = 80

setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = winregrc
-version = 20240120
+version = 20240211
 description = Windows Registry resources (winregrc)
 long_description = winregrc is a Python module part of winreg-kb to allow reuse of Windows Registry resources.
 long_description_content_type = text/plain
@@ -22,7 +22,7 @@ install_requires = file:requirements.txt
 package_dir =
   winregrc = winregrc
 packages = find:
-python_requires = >=3.7
+python_requires = >=3.8
 scripts =
   scripts/appcompatcache.py
   scripts/application_identifiers.py

tox.ini

@@ -1,5 +1,5 @@
 [tox]
-envlist = py3{7,8,9,10,11,12},coverage,docs,lint,wheel
+envlist = py3{8,9,10,11,12},coverage,docformatter,docs,lint,wheel
 
 [testenv]
 allowlist_externals = ./run_tests.py
@@ -19,12 +19,19 @@ deps =
     setuptools >= 65
     wheel
 commands =
-  py3{7,8,9,10,11,12}: ./run_tests.py
+  py3{8,9,10,11,12}: ./run_tests.py
   coverage: coverage erase
   coverage: coverage run --source=winregrc --omit="*_test*,*__init__*,*test_lib*" run_tests.py
   coverage: coverage xml
   wheel: python -m build --no-isolation --wheel
 
+[testenv:docformatter]
+usedevelop = True
+deps =
+  docformatter
+commands =
+  docformatter --in-place --recursive winregrc tests
+
 [testenv:docs]
 usedevelop = True
 deps =
@@ -45,10 +52,14 @@ setenv =
 deps =
   -rrequirements.txt
   -rtest_requirements.txt
+  docformatter
   pylint >= 3.0.0, < 3.1.0
+  setuptools
   yamllint >= 1.26.0
 commands =
+  docformatter --version
   pylint --version
   yamllint -v
+  docformatter --check --diff --recursive scripts setup.py tests winregrc
   pylint --rcfile=.pylintrc scripts setup.py tests winregrc
   yamllint -c .yamllint.yaml winregrc

utils/update_release.sh

@@ -25,7 +25,7 @@ winreg-kb (${VERSION}-1) unstable; urgency=low
 EOT
 
 # Regenerate the API documentation.
-tox -edocs
+tox -edocformatter,docs
 
 exit ${EXIT_SUCCESS};
 

winregrc/__init__.py

@@ -1,4 +1,4 @@
 # -*- coding: utf-8 -*-
 """Windows Registry resources (winregrc)."""
 
-__version__ = '20221228'
+__version__ = '20240211'

winregrc/filters.py

@@ -87,7 +87,11 @@ def __init__(self, key_path):
 
   @property
   def key_paths(self):
-    """list[str]: key paths defined by the filter."""
+    """Retrieves the key paths defined by the filter.
+
+    Returns:
+      list[str]: key paths defined by the filter.
+    """
     if self._wow64_key_path:
       return [self._key_path, self._wow64_key_path]
     return [self._key_path]