chore: Template upgrade

Author: pawamoy

.copier-answers.yml

@@ -1,5 +1,5 @@
 # Changes here will be overwritten by Copier
-_commit: 0.7.0
+_commit: 0.8.1
 _src_path: gh:pawamoy/copier-pdm
 author_email: pawamoy@pm.me
 author_fullname: "Timoth\xE9e Mazzucotelli"

.github/workflows/ci.yml

@@ -73,6 +73,7 @@ jobs:
         - macos-latest
         - windows-latest
         python-version:
+        - "3.7"
         - "3.8"
         - "3.9"
         - "3.10"

README.md

@@ -10,10 +10,10 @@ A Python handler for mkdocstrings.
 
 ## Requirements
 
-Python for mkdocstrings requires Python 3.6 or above.
+Python for mkdocstrings requires Python 3.7 or above.
 
 <details>
-<summary>To install Python 3.6, I recommend using <a href="https://github.com/pyenv/pyenv"><code>pyenv</code></a>.</summary>
+<summary>To install Python 3.7, I recommend using <a href="https://github.com/pyenv/pyenv"><code>pyenv</code></a>.</summary>
 
 ```bash
 # install pyenv
@@ -24,24 +24,23 @@ export PATH="${HOME}/.pyenv/bin:${PATH}"
 export PYENV_ROOT="${HOME}/.pyenv"
 eval "$(pyenv init -)"
 
-# install Python 3.6
-pyenv install 3.6.12
+# install Python 3.7
+pyenv install 3.7.12
 
 # make it available globally
-pyenv global system 3.6.12
+pyenv global system 3.7.12
 ```
 </details>
 
 ## Installation
 
 With `pip`:
 ```bash
-python3.6 -m pip install mkdocstrings-python
+pip install mkdocstrings-python
 ```
 
 With [`pipx`](https://github.com/pipxproject/pipx):
 ```bash
-python3.6 -m pip install --user pipx
-
-pipx install --python python3.6 mkdocstrings-python
+python3.7 -m pip install --user pipx
+pipx install mkdocstrings-python
 ```

config/mypy.ini

@@ -2,3 +2,4 @@
 ignore_missing_imports = true
 exclude = tests/fixtures/
 warn_unused_ignores = true
+show_error_codes = true

docs/gen_ref_nav.py

@@ -7,8 +7,6 @@
 nav = mkdocs_gen_files.Nav()
 
 for path in sorted(Path("src").glob("**/*.py")):
-    # if str(path) in exclude:
-    #     continue
     module_path = path.relative_to("src").with_suffix("")
     doc_path = path.relative_to("src").with_suffix(".md")
     full_doc_path = Path("reference", doc_path)

duties.py

@@ -6,7 +6,6 @@
 import sys
 import tempfile
 from contextlib import suppress
-from functools import wraps
 from io import StringIO
 from pathlib import Path
 from typing import List, Optional, Pattern
@@ -43,7 +42,6 @@ def update_changelog(
     marker: str,
     version_regex: str,
     template_url: str,
-    commit_style: str,
 ) -> None:
     """
     Update the given changelog file in place.
@@ -53,15 +51,16 @@ def update_changelog(
         marker: The line after which to insert new contents.
         version_regex: A regular expression to find currently documented versions in the file.
         template_url: The URL to the Jinja template used to render contents.
-        commit_style: The style of commit messages to parse.
     """
     from git_changelog.build import Changelog
+    from git_changelog.commit import AngularStyle
     from jinja2.sandbox import SandboxedEnvironment
 
+    AngularStyle.DEFAULT_RENDER.insert(0, AngularStyle.TYPES["build"])
     env = SandboxedEnvironment(autoescape=False)
     template_text = urlopen(template_url).read().decode("utf8")  # noqa: S310
     template = env.from_string(template_text)
-    changelog = Changelog(".", style=commit_style)
+    changelog = Changelog(".", style="angular")
 
     if len(changelog.versions_list) == 1:
         last_version = changelog.versions_list[0]
@@ -101,7 +100,6 @@ def changelog(ctx):
             "marker": "<!-- insertion marker -->",
             "version_regex": r"^## \[v?(?P<version>[^\]]+)",
             "template_url": template_url,
-            "commit_style": "angular",
         },
         title="Updating changelog",
         pty=PTY,
@@ -169,32 +167,7 @@ def safety():  # noqa: WPS430
     ctx.run(safety, title="Checking dependencies")
 
 
-def no_docs_py36(nofail=True):
-    """
-    Decorate a duty that builds docs to warn that it's not possible on Python 3.6.
-
-    Arguments:
-        nofail: Whether to fail or not.
-
-    Returns:
-        The decorated function.
-    """
-
-    def decorator(func):
-        @wraps(func)
-        def wrapper(ctx):
-            if sys.version_info <= (3, 7, 0):
-                ctx.run(["false"], title="Docs can't be built on Python 3.6", nofail=nofail, quiet=True)
-            else:
-                func(ctx)
-
-        return wrapper
-
-    return decorator
-
-
 @duty
-@no_docs_py36()
 def check_docs(ctx):
     """
     Check if the documentation builds correctly.
@@ -282,7 +255,6 @@ def clean(ctx):
 
 
 @duty
-@no_docs_py36(nofail=False)
 def docs(ctx):
     """
     Build the documentation locally.
@@ -294,7 +266,6 @@ def docs(ctx):
 
 
 @duty
-@no_docs_py36(nofail=False)
 def docs_serve(ctx, host="127.0.0.1", port=8000):
     """
     Serve the documentation (localhost:8000).
@@ -308,7 +279,6 @@ def docs_serve(ctx, host="127.0.0.1", port=8000):
 
 
 @duty
-@no_docs_py36(nofail=False)
 def docs_deploy(ctx):
     """
     Deploy the documentation on GitHub pages.

pyproject.toml

@@ -8,7 +8,7 @@ description = "A Python handler for mkdocstrings."
 authors = [{name = "Timothée Mazzucotelli", email = "pawamoy@pm.me"}]
 license = {file = "LICENSE"}
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.7"
 keywords = []
 dynamic = ["version"]
 classifiers = [
@@ -18,6 +18,7 @@ classifiers = [
     "Programming Language :: Python",
     "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",
@@ -47,53 +48,54 @@ version = {use_scm = true}
 includes = ["src/mkdocstrings"]
 
 [tool.pdm.dev-dependencies]
-duty = ["duty~=0.7"]
+duty = ["duty>=0.7"]
 docs = [
-    "mkdocs~=1.2",
-    "mkdocs-coverage~=0.2",
-    "mkdocs-gen-files~=0.3",
-    "mkdocs-literate-nav~=0.4",
-    "mkdocs-material~=8.0",
-    "mkdocstrings~=0.16",
-    "toml~=0.10",
+    "mkdocs>=1.2",
+    "mkdocs-coverage>=0.2",
+    "mkdocs-gen-files>=0.3",
+    "mkdocs-literate-nav>=0.4",
+    "mkdocs-material>=7.3",
+    "mkdocs-section-index>=0.3",
+    "mkdocstrings>=0.16",
+    "toml>=0.10",
 ]
 format = [
-    "autoflake~=1.4",
-    "black~=21.10b0",
-    "isort~=5.10",
+    "autoflake>=1.4",
+    "black>=21.10b0",
+    "isort>=5.10",
 ]
 maintain = [
     # TODO: remove this section when git-changelog is more powerful
-    "git-changelog~=0.4",
+    "git-changelog>=0.4",
 ]
 quality = [
-    "darglint~=1.8",
-    "flake8-bandit~=2.1",
-    "flake8-black~=0.2",
-    "flake8-bugbear~=21.9",
-    "flake8-builtins~=1.5",
-    "flake8-comprehensions~=3.7",
-    "flake8-docstrings~=1.6",
-    "flake8-pytest-style~=1.5",
-    "flake8-string-format~=0.3",
-    "flake8-tidy-imports~=4.5",
-    "flake8-variables-names~=0.0",
-    "pep8-naming~=0.12",
-    "wps-light~=0.15",
+    "darglint>=1.8",
+    "flake8-bandit>=2.1",
+    "flake8-black>=0.2",
+    "flake8-bugbear>=21.9",
+    "flake8-builtins>=1.5",
+    "flake8-comprehensions>=3.7",
+    "flake8-docstrings>=1.6",
+    "flake8-pytest-style>=1.5",
+    "flake8-string-format>=0.3",
+    "flake8-tidy-imports>=4.5",
+    "flake8-variables-names>=0.0",
+    "pep8-naming>=0.12",
+    "wps-light>=0.15",
 ]
 tests = [
-    "pytest~=6.2",
-    "pytest-cov~=3.0",
-    "pytest-randomly~=3.10",
-    "pytest-sugar~=0.9",
-    "pytest-xdist~=2.4",
+    "pytest>=6.2",
+    "pytest-cov>=3.0",
+    "pytest-randomly>=3.10",
+    "pytest-sugar>=0.9",
+    "pytest-xdist>=2.4",
 ]
 typing = [
-    "mypy~=0.910",
-    "types-markdown~=3.3",
-    "types-toml~=0.10",
+    "mypy>=0.910",
+    "types-markdown>=3.3",
+    "types-toml>=0.10",
 ]
-security = ["safety~=1.10"]
+security = ["safety>=1.10"]
 
 [tool.black]
 line-length = 120

scripts/multirun.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -e
 
-PYTHON_VERSIONS="${PYTHON_VERSIONS-3.8 3.9 3.10 3.11}"
+PYTHON_VERSIONS="${PYTHON_VERSIONS-3.7 3.8 3.9 3.10 3.11}"
 
 if [ -n "${PYTHON_VERSIONS}" ]; then
     for python_version in ${PYTHON_VERSIONS}; do

scripts/setup.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -e
 
-PYTHON_VERSIONS="${PYTHON_VERSIONS-3.8 3.9 3.10 3.11}"
+PYTHON_VERSIONS="${PYTHON_VERSIONS-3.7 3.8 3.9 3.10 3.11}"
 
 install_with_pipx() {
     if ! command -v "$1" &>/dev/null; then