build: Drop Python 3.6 support

Author: pawamoy

.copier-answers.yml

@@ -1,5 +1,5 @@
 # Changes here will be overwritten by Copier
-_commit: 0.7.2
+_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,7 +73,6 @@ jobs:
         - macos-latest
         - windows-latest
         python-version:
-        - "3.6"
         - "3.7"
         - "3.8"
         - "3.9"

README.md

@@ -11,10 +11,10 @@ Load Python objects documentation.
 
 ## Requirements
 
-`pytkdocs` requires Python 3.6 or above.
+pytkdocs 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
@@ -25,26 +25,25 @@ 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 pytkdocs
+pip install pytkdocs
 ```
 
 With [`pipx`](https://github.com/pipxproject/pipx):
 ```bash
-python3.6 -m pip install --user pipx
-
-pipx install --python python3.6 pytkdocs
+python3.7 -m pip install --user pipx
+pipx install pytkdocs
 ```
 
 With `conda`:

config/mypy.ini

@@ -1,3 +1,5 @@
 [mypy]
 ignore_missing_imports = true
 exclude = tests/fixtures/
+warn_unused_ignores = false
+show_error_codes = true

docs/gen_ref_nav.py

@@ -8,15 +8,21 @@
 
 for path in sorted(Path("src").glob("**/*.py")):
     module_path = path.relative_to("src").with_suffix("")
-    doc_path = path.relative_to("src", "pytkdocs").with_suffix(".md")
+    doc_path = path.relative_to("src").with_suffix(".md")
     full_doc_path = Path("reference", doc_path)
 
     parts = list(module_path.parts)
-    parts[-1] = f"{parts[-1]}.py"
-    nav[parts] = doc_path
+    if parts[-1] == "__init__":
+        parts = parts[:-1]
+        doc_path = doc_path.with_name("index.md")
+        full_doc_path = full_doc_path.with_name("index.md")
+    elif parts[-1] == "__main__":
+        continue
+    nav_parts = list(parts)
+    nav[nav_parts] = doc_path
 
     with mkdocs_gen_files.open(full_doc_path, "w") as fd:
-        ident = ".".join(module_path.parts)
+        ident = ".".join(parts)
         print("::: " + ident, file=fd)
 
     mkdocs_gen_files.set_edit_path(full_doc_path, 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
@@ -174,43 +173,17 @@ 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, strict: bool = False):
+def check_docs(ctx):
     """
     Check if the documentation builds correctly.
 
     Arguments:
         ctx: The context instance (passed automatically).
-        strict: Whether to build with MkDocs' struct mode.
     """
     Path("htmlcov").mkdir(parents=True, exist_ok=True)
     Path("htmlcov/index.html").touch(exist_ok=True)
-    ctx.run(f"mkdocs build{' -s' if strict else ''}", title="Building documentation", pty=PTY)
+    ctx.run("mkdocs build", title="Building documentation", pty=PTY)
 
 
 @duty  # noqa: WPS231
@@ -288,7 +261,6 @@ def clean(ctx):
 
 
 @duty
-@no_docs_py36(nofail=False)
 def docs(ctx):
     """
     Build the documentation locally.
@@ -300,7 +272,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).
@@ -314,7 +285,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 = "Load Python objects documentation."
 authors = [{name = "Timothée Mazzucotelli", email = "pawamoy@pm.me"}]
 license = {file = "LICENSE"}
 readme = "README.md"
-requires-python = ">=3.6.2"
+requires-python = ">=3.7"
 keywords = ["python", "source", "signature", "docs"]
 dynamic = ["version"]
 classifiers = [
@@ -18,7 +18,6 @@ classifiers = [
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.6",
     "Programming Language :: Python :: 3.7",
     "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
@@ -33,7 +32,6 @@ classifiers = [
 dependencies = [
     "astunparse>=1.6; python_version < '3.9'",
     "cached-property>=1.5; python_version < '3.8'",
-    "dataclasses>=0.7; python_version < '3.7'",
     "typing-extensions>=3.7; python_version < '3.8'",
 ]
 
@@ -62,13 +60,14 @@ package-dir = "src"
 [tool.pdm.dev-dependencies]
 duty = ["duty>=0.7"]
 docs = [
-    "mkdocs>=1.2; python_version >= '3.7'",
-    "mkdocs-coverage>=0.2; python_version >= '3.7'",
-    "mkdocs-gen-files>=0.3; python_version >= '3.7'",
-    "mkdocs-literate-nav>=0.4; python_version >= '3.7'",
-    "mkdocs-material>=7.3; python_version >= '3.7'",
-    "mkdocstrings>=0.16; python_version >= '3.7'",
-    "toml>=0.10; python_version >= '3.7'",
+    "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",

scripts/multirun.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -e
 
-PYTHON_VERSIONS="${PYTHON_VERSIONS-3.6 3.7 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.6 3.7 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