Merge branch 'master' into refactor-set-method

doc/conf.py

@@ -34,6 +34,7 @@ root = os.path.relpath(os.path.join(os.path.dirname(__file__), ".."))
 # ones.
 extensions = [
     "sphinx.ext.autodoc",
+    "sphinx_autodoc_typehints",
     "sphinx.ext.doctest",
     "sphinx.ext.todo",
     "sphinx.ext.coverage",
@@ -46,6 +47,9 @@ extensions = [
     "sphinxcontrib.spelling",
 ]
 
+# mock the following modules for autodoc
+autodoc_mock_imports = ["qrcode"]
+
 # supress warnings for external images
 suppress_warnings = [
     "image.nonlocal_uri",

doc/requirements.txt

@@ -11,4 +11,5 @@ python-barcode>=0.11.0,<1
 importlib-metadata
 importlib_resources
 sphinxcontrib.datatemplates
+sphinx-autodoc-typehints
 pycups

tox.ini

@@ -30,11 +30,12 @@ setenv = PY_IGNORE_IMPORTMISMATCH=1
 [testenv:docs]
 basepython = python
 changedir = doc
-deps = sphinx>=3.0.0
+deps = sphinx>=7.2.3
        setuptools_scm
        python-barcode
        sphinxcontrib-spelling>=7.2.0
        sphinxcontrib.datatemplates
+       sphinx-autodoc-typehints
        sphinx_rtd_theme
        pycups
 commands = sphinx-build -W -b html -d {envtmpdir}/doctrees .  {envtmpdir}/html