refactor: Drop support for Python 3.8

.copier-answers.yml

@@ -1,5 +1,5 @@
 # Changes here will be overwritten by Copier
-_commit: 1.4.6
+_commit: 1.4.7
 _src_path: gh:pawamoy/copier-uv
 author_email: dev@pawamoy.fr
 author_fullname: Timothée Mazzucotelli

.github/workflows/ci.yml

@@ -75,11 +75,11 @@ jobs:
  echo 'jobs=[
  {"os": "macos-latest"},
  {"os": "windows-latest"},
- {"python-version": "3.9"},
  {"python-version": "3.10"},
  {"python-version": "3.11"},
  {"python-version": "3.12"},
- {"python-version": "3.13"}
+ {"python-version": "3.13"},
+ {"python-version": "3.14"}
  ]' | tr -d '[:space:]' >> $GITHUB_OUTPUT
  else
  echo 'jobs=[
@@ -100,18 +100,18 @@ jobs:
  - macos-latest
  - windows-latest
  python-version:
- - "3.8"
  - "3.9"
  - "3.10"
  - "3.11"
  - "3.12"
  - "3.13"
+ - "3.14"
  resolution:
  - highest
  - lowest-direct
  exclude: ${{ fromJSON(needs.exclude-test-jobs.outputs.jobs) }}
  runs-on: ${{ matrix.os }}
- continue-on-error: ${{ matrix.python-version == '3.13' }}
+ continue-on-error: ${{ matrix.python-version == '3.14' }}
 
  steps:
  - name: Checkout

CONTRIBUTING.md

@@ -10,4 +10,4 @@ We provide a guide for contributors. If you are reading this locally or directly
  - Development workflow: [docs/guide/contributors/workflow.md](docs/guide/contributors/workflow.md)
  - Project architecture: [docs/guide/contributors/architecture.md](docs/guide/contributors/architecture.md)
 
-However we strongly recommend reading the online version at https://mkdocstrings.github.io/griffe/guide/contributors/, as some content is dynamically generated when building the documentation pages.
+We strongly recommend reading the online version at https://mkdocstrings.github.io/griffe/guide/contributors/, as some content is dynamically generated when building the documentation pages.

README.md

@@ -19,17 +19,14 @@ but also "signature" in a familiar way. "On reconnaît bien là sa griffe."
 
 ## Installation
 
-With `pip`:
-
 ```bash
 pip install griffe
 ```
 
-With [`pipx`](https://github.com/pipxproject/pipx):
+With [`uv`](https://docs.astral.sh/uv/):
 
 ```bash
-python3.8 -m pip install --user pipx
-pipx install griffe
+uv tool install griffe
 ```
 
 ## Usage

config/ruff.toml

@@ -1,4 +1,4 @@
-target-version = "py38"
+target-version = "py39"
 line-length = 120
 
 [lint]

duties.py

@@ -8,11 +8,13 @@
 from functools import partial
 from importlib.metadata import version as pkgversion
 from pathlib import Path
-from typing import TYPE_CHECKING, Iterator
+from typing import TYPE_CHECKING
 
 from duty import duty, tools
 
 if TYPE_CHECKING:
+ from collections.abc import Iterator
+
  from duty.context import Context
 
 

pyproject.toml

@@ -8,8 +8,7 @@ description = "Signatures for entire Python programs. Extract the structure, the
 authors = [{name = "Timothée Mazzucotelli", email = "dev@pawamoy.fr"}]
 license = {text = "ISC"}
 readme = "README.md"
-# YORE: EOL 3.8: Remove `3.8` with `3.9` within line.
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 keywords = ["api", "signature", "breaking-changes", "static-analysis", "dynamic-analysis"]
 dynamic = ["version"]
 classifiers = [
@@ -18,8 +17,6 @@ classifiers = [
  "Programming Language :: Python",
  "Programming Language :: Python :: 3",
  "Programming Language :: Python :: 3 :: Only",
- # YORE: EOL 3.8: Remove line.
- "Programming Language :: Python :: 3.8",
  # YORE: EOL 3.9: Remove line.
  "Programming Language :: Python :: 3.9",
  # YORE: EOL 3.10: Remove line.
@@ -30,6 +27,8 @@ classifiers = [
  "Programming Language :: Python :: 3.12",
  # YORE: EOL 3.13: Remove line.
  "Programming Language :: Python :: 3.13",
+ # YORE: EOL 3.14: Remove line.
+ "Programming Language :: Python :: 3.14",
  "Topic :: Documentation",
  "Topic :: Software Development",
  "Topic :: Software Development :: Documentation",
@@ -87,7 +86,7 @@ dev-dependencies = [
  # maintenance
  "build>=1.2",
  "git-changelog>=2.5",
- "twine>=5.0; python_version < '3.13'",
+ "twine>=5.1",
 
  # ci
  "duty>=1.4",
@@ -120,5 +119,6 @@ dev-dependencies = [
  "mkdocs-redirects>=1.2",
  "mkdocstrings[python]>=0.25",
  "pydeps>=1.12",
+ # YORE: EOL 3.10: Remove line.
  "tomli>=2.0; python_version < '3.11'",
 ]

scripts/gen_credits.py

@@ -5,11 +5,12 @@
 import os
 import sys
 from collections import defaultdict
+from collections.abc import Iterable
 from importlib.metadata import distributions
 from itertools import chain
 from pathlib import Path
 from textwrap import dedent
-from typing import Dict, Iterable, Union
+from typing import Union
 
 from jinja2 import StrictUndefined
 from jinja2.sandbox import SandboxedEnvironment
@@ -28,8 +29,8 @@
 project_name = project["name"]
 devdeps = [dep for dep in pyproject["tool"]["uv"]["dev-dependencies"] if not dep.startswith("-e")]
 
-PackageMetadata = Dict[str, Union[str, Iterable[str]]]
-Metadata = Dict[str, PackageMetadata]
+PackageMetadata = dict[str, Union[str, Iterable[str]]]
+Metadata = dict[str, PackageMetadata]
 
 
 def _merge_fields(metadata: dict) -> PackageMetadata:

scripts/insiders.py

@@ -10,13 +10,16 @@
 from datetime import date, datetime, timedelta
 from itertools import chain
 from pathlib import Path
-from typing import Iterable, cast
+from typing import TYPE_CHECKING, cast
 from urllib.error import HTTPError
 from urllib.parse import urljoin
 from urllib.request import urlopen
 
 import yaml
 
+if TYPE_CHECKING:
+ from collections.abc import Iterable
+
 logger = logging.getLogger(f"mkdocs.logs.{__name__}")
 
 

scripts/make.py

@@ -9,9 +9,12 @@
 import sys
 from contextlib import contextmanager
 from pathlib import Path
-from typing import Any, Callable, Iterator
+from typing import TYPE_CHECKING, Any, Callable
 
-PYTHON_VERSIONS = os.getenv("PYTHON_VERSIONS", "3.8 3.9 3.10 3.11 3.12 3.13").split()
+if TYPE_CHECKING:
+ from collections.abc import Iterator
+
+PYTHON_VERSIONS = os.getenv("PYTHON_VERSIONS", "3.9 3.10 3.11 3.12 3.13 3.14").split()
 
 _commands = []
 

src/_griffe/agents/inspector.py

@@ -7,7 +7,7 @@
 from inspect import Parameter as SignatureParameter
 from inspect import Signature, cleandoc, getsourcelines
 from inspect import signature as getsignature
-from typing import TYPE_CHECKING, Any, Sequence
+from typing import TYPE_CHECKING, Any
 
 from _griffe.agents.nodes.runtime import ObjectNode
 from _griffe.collections import LinesCollection, ModulesCollection
@@ -19,6 +19,7 @@
 from _griffe.models import Alias, Attribute, Class, Docstring, Function, Module, Parameter, Parameters
 
 if TYPE_CHECKING:
+ from collections.abc import Sequence
  from pathlib import Path
 
  from _griffe.enumerations import Parser

src/_griffe/agents/nodes/ast.py

@@ -3,10 +3,13 @@
 from __future__ import annotations
 
 from ast import AST
-from typing import Iterator
+from typing import TYPE_CHECKING
 
 from _griffe.exceptions import LastNodeError
 
+if TYPE_CHECKING:
+ from collections.abc import Iterator
+
 
 def ast_kind(node: AST) -> str:
  """Return the kind of an AST node.

src/_griffe/agents/nodes/parameters.py

@@ -4,11 +4,14 @@
 
 import ast
 from itertools import zip_longest
-from typing import Iterable, List, Optional, Tuple, Union
+from typing import TYPE_CHECKING, Optional, Union
 
 from _griffe.enumerations import ParameterKind
 
-ParametersType = List[Tuple[str, Optional[ast.AST], ParameterKind, Optional[Union[str, ast.AST]]]]
+if TYPE_CHECKING:
+ from collections.abc import Iterable
+
+ParametersType = list[tuple[str, Optional[ast.AST], ParameterKind, Optional[Union[str, ast.AST]]]]
 """Type alias for the list of parameters of a function."""
 
 

src/_griffe/agents/nodes/runtime.py

@@ -5,11 +5,14 @@
 import inspect
 import sys
 from functools import cached_property
-from typing import Any, ClassVar, Sequence
+from typing import TYPE_CHECKING, Any, ClassVar
 
 from _griffe.enumerations import ObjectKind
 from _griffe.logger import logger
 
+if TYPE_CHECKING:
+ from collections.abc import Sequence
+
 _builtin_module_names = {_.lstrip("_") for _ in sys.builtin_module_names}
 _cyclic_relationships = {
  ("os", "nt"),
@@ -19,7 +22,6 @@
 
 
 def _same_components(a: str, b: str, /) -> bool:
- # YORE: EOL 3.8: Replace `lstrip` with `removeprefix` within line.
  return [cpn.lstrip("_") for cpn in a.split(".")] == [cpn.lstrip("_") for cpn in b.split(".")]
 
 

src/_griffe/agents/nodes/values.py

@@ -3,17 +3,11 @@
 from __future__ import annotations
 
 import ast
-import sys
+from ast import unparse
 from typing import TYPE_CHECKING
 
 from _griffe.logger import logger
 
-# YORE: EOL 3.8: Replace block with line 4.
-if sys.version_info < (3, 9):
- from astunparse import unparse
-else:
- from ast import unparse
-
 if TYPE_CHECKING:
  from pathlib import Path
 

src/_griffe/c3linear.py

@@ -7,13 +7,14 @@
 
 from __future__ import annotations
 
+from collections import deque
 from itertools import islice
-from typing import Deque, TypeVar
+from typing import TypeVar
 
 _T = TypeVar("_T")
 
 
-class _Dependency(Deque[_T]):
+class _Dependency(deque[_T]):
  """A class representing a (doubly-ended) queue of items."""
 
  @property

src/_griffe/cli.py

@@ -19,7 +19,7 @@
 import sys
 from datetime import datetime, timezone
 from pathlib import Path
-from typing import IO, TYPE_CHECKING, Any, Callable, Sequence
+from typing import IO, TYPE_CHECKING, Any, Callable
 
 import colorama
 
@@ -34,6 +34,8 @@
 from _griffe.logger import logger
 
 if TYPE_CHECKING:
+ from collections.abc import Sequence
+
  from _griffe.extensions.base import Extension, Extensions
 
 

src/_griffe/collections.py

@@ -3,11 +3,12 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any, ItemsView, KeysView, ValuesView
+from typing import TYPE_CHECKING, Any
 
 from _griffe.mixins import DelMembersMixin, GetMembersMixin, SetMembersMixin
 
 if TYPE_CHECKING:
+ from collections.abc import ItemsView, KeysView, ValuesView
  from pathlib import Path
 
  from _griffe.models import Module

src/_griffe/diff.py

@@ -10,7 +10,7 @@
 
 import contextlib
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Iterable, Iterator
+from typing import TYPE_CHECKING, Any
 
 from colorama import Fore, Style
 
@@ -20,6 +20,8 @@
 from _griffe.logger import logger
 
 if TYPE_CHECKING:
+ from collections.abc import Iterable, Iterator
+
  from _griffe.models import Alias, Attribute, Class, Function, Object
 
 _POSITIONAL = frozenset((ParameterKind.positional_only, ParameterKind.positional_or_keyword))