.copier-answers.yml

 # Changes here will be overwritten by Copier
-_commit: v0.2.3
+_commit: v0.3.3
 _src_path: https://gitlab.softwareheritage.org/swh/devel/swh-py-template.git
 description: Software Heritage Documentation
 distribution_name: swh-docs

.pre-commit-config.yaml

 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.6.0
+    rev: v5.0.0
     hooks:
       - id: trailing-whitespace
       - id: check-json
       - id: check-yaml
 
   - repo: https://github.com/python/black
-    rev: 24.8.0
+    rev: 25.1.0
     hooks:
       - id: black
 
   - repo: https://github.com/PyCQA/isort
-    rev: 5.13.2
+    rev: 6.0.0
     hooks:
       - id: isort
 
@@ -20,16 +20,16 @@ repos:
     rev: 7.1.1
     hooks:
       - id: flake8
-        additional_dependencies: [flake8-bugbear==24.4.26]
+        additional_dependencies: [flake8-bugbear==24.12.12, flake8-pyproject]
 
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.3.0
+    rev: v2.4.1
     hooks:
       - id: codespell
         name: Check source code spelling
         additional_dependencies:
           - tomli
-        stages: [commit]
+        stages: [pre-commit]
       - id: codespell
         name: Check commit message spelling
         additional_dependencies:

docs/devel/contributing/gitlab.rst

@@ -188,7 +188,7 @@ indicating that the release process is ongoing.
 
 Next, deployment container images are updated.
 
-And finally a new merge request will automatically be created in 
+And finally a new merge request will automatically be created in
 `Helm charts for swh packages`_ so that the devops team can proceed with deployment.
 
 .. _Helm charts for swh packages: https://gitlab.softwareheritage.org/swh/infra/sysadm-environment

docs/devel/index.rst

@@ -88,7 +88,7 @@ Components
 Here is brief overview of the most relevant software components in the Software
 Heritage stack, in alphabetical order.
 For a better introduction to the architecture, see the :ref:`architecture-overview`,
-which presents each of them in a didactical order.
+which presents each of them in a didactic order.
 
 Each component name is linked to the development documentation
 of the corresponding Python module.

docs/user/using_data/index.rst

@@ -118,15 +118,13 @@ Code and configuration changes
 
 Software Heritage's codebase evolves over time, and the archive adds support
 for new forges regularly.
-Major changes are documented in the `archive changelog`_
+Major changes are documented in the :ref:`Archive ChangeLog <archive-changelog>`.
 
 Typically, this means that source code deleted from a given forge before
 Software Heritage started archiving that forge is missing
 -- which may lead to code hosted in less popular places to be underrepresented
 in the archive.
 
-.. _archive changelog: archive-changelog
-
 Large objects
 ^^^^^^^^^^^^^
 

mypy.ini

-[mypy]
-namespace_packages = True
-warn_unused_ignores = True
-explicit_package_bases = True
-# ^ Needed for mypy to detect py.typed from swh packages installed
-# in editable mode
-
-# 3rd party libraries without stubs (yet)
-
-[mypy-sphinx.*]
-ignore_missing_imports = True
-
-# [mypy-add_your_lib_here.*]
-# ignore_missing_imports = True

pyproject.toml

@@ -55,3 +55,35 @@ known_first_party = ['swh']
 
 [tool.codespell]
 ignore-words-list = "aks,crate"
+
+[tool.mypy]
+namespace_packages = true
+warn_unused_ignores = true
+explicit_package_bases = true
+# ^ Needed for mypy to detect py.typed from swh packages installed
+# in editable mode
+
+plugins = []
+
+# 3rd party libraries without stubs (yet)
+# [[tool.mypy.overrides]]
+# module = [
+#     "package1.*",
+#     "package2.*",
+# ]
+# ignore_missing_imports = true
+
+[tool.flake8]
+select = ["C", "E", "F", "W", "B950"]
+ignore = [
+    "E203", # whitespaces before ':' <https://github.com/psf/black/issues/315>
+    "E231", # missing whitespace after ','
+    "E501", # line too long, use B950 warning from flake8-bugbear instead
+    "W503" # line break before binary operator <https://github.com/psf/black/issues/52>
+]
+max-line-length = 88
+
+[tool.pytest.ini_options]
+norecursedirs = "build docs .*"
+asyncio_mode = "strict"
+consider_namespace_packages = true

pytest.ini

-[pytest]
-norecursedirs = build docs .*
-asyncio_mode = strict
-consider_namespace_packages = true

setup.cfg

-[flake8]
-# E203: whitespaces before ':' <https://github.com/psf/black/issues/315>
-# E231: missing whitespace after ','
-# E501: line too long, use B950 warning from flake8-bugbear instead
-# W503: line break before binary operator <https://github.com/psf/black/issues/52>
-select = C,E,F,W,B950
-ignore = E203,E231,E501,E704,W503
-max-line-length = 88

swh/docs/software_origins.py

@@ -3,8 +3,7 @@
 # License: GNU General Public License version 3, or any later version
 # See top-level LICENSE file for more information
 
-"""Parser for :file:`docs/devel/software-origins-support.yml`
-"""
+"""Parser for :file:`docs/devel/software-origins-support.yml`"""
 
 import collections
 from pathlib import Path

tox.ini

@@ -40,7 +40,7 @@ commands =
 [testenv:black]
 skip_install = true
 deps =
-  black==24.8.0
+  black==25.1.0
 commands =
   {envpython} -m black --check swh
 
@@ -48,7 +48,9 @@ commands =
 skip_install = true
 deps =
   flake8==7.1.1
-  flake8-bugbear==24.4.26
+  flake8-bugbear==24.12.12
+  flake8-pyproject==1.2.3
   pycodestyle==2.12.1
+
 commands =
   {envpython} -m flake8