Merge pull request #303 from openzim/bootstrap_2

Adopt Python bootstrap 2.0.0

Author: benoit74

.github/workflows/QA.yaml

@@ -62,16 +62,16 @@ jobs:
       - name: Install dependencies (and project)
         run: |
           pip install -U pip
-          pip install -e .[lint,scripts,test,check]
+          pip install -e .[qa,scripts,test]
 
-      - name: Check black formatting
-        run: inv lint-black
+      - name: Check Linting
+        run: inv check-lint
 
-      - name: Check ruff
-        run: inv lint-ruff
+      - name: Check Formatting
+        run: inv check-format
 
-      - name: Check pyright
-        run: inv check-pyright
+      - name: Check Type
+        run: inv check-type
 
   check-javascript-qa:
     runs-on: ubuntu-24.04

.github/workflows/Tests.yaml

@@ -133,10 +133,9 @@ jobs:
           python-version-file: pyproject.toml
           architecture: x64
 
-      - name: Install dependencies (and project)
+      - name: Install dependencies
         run: |
           pip install -U pip hatch
-          pip install -e .[docs]
 
       - name: Build mkdoc documentation
         run: hatch run docs:build

.pre-commit-config.yaml

@@ -7,14 +7,11 @@ repos:
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
-  - repo: https://github.com/psf/black
-    rev: '25.11.0'
-    hooks:
-      - id: black
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.5
+    rev: v0.15.12
     hooks:
-      - id: ruff
+      - id: ruff-check
+      - id: ruff-format
   - repo: https://github.com/RobertCraigie/pyright-python
     rev: v1.1.407
     hooks:

CHANGELOG.md

@@ -26,6 +26,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 - Upgrade to wombat 3.10.3 (#286)
+- Adopt openzim/\_python-bootstrap 2.0.0 (#303)
 
 ## [5.3.0] - 2025-11-14
 

README.md

@@ -1,7 +1,7 @@
 # zimscraperlib
 
-[![QA Status](https://github.com/openzim/python-scraperlib/workflows/QA/badge.svg?query=branch%3Amain)](https://github.com/openzim/python-scraperlib/actions/workflows/QA.yaml)
-[![Tests Status](https://github.com/openzim/python-scraperlib/workflows/Tests/badge.svg?query=branch%3Amain)](https://github.com/openzim/python-scraperlib/actions/workflows/Tests.yaml)
+[![QA Status](https://github.com/openzim/python-scraperlib/actions/workflows/QA.yaml/badge.svg?branch=main)](https://github.com/openzim/python-scraperlib/actions/workflows/QA.yaml)
+[![Tests Status](https://github.com/openzim/python-scraperlib/actions/workflows/Tests.yaml/badge.svg?branch=main)](https://github.com/openzim/python-scraperlib/actions/workflows/Tests.yaml)
 [![CodeFactor](https://www.codefactor.io/repository/github/openzim/python-scraperlib/badge)](https://www.codefactor.io/repository/github/openzim/python-scraperlib)
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
 [![PyPI version shields.io](https://img.shields.io/pypi/v/zimscraperlib.svg)](https://pypi.org/project/zimscraperlib/)
@@ -67,7 +67,7 @@ apk add ffmpeg gifsicle libmagic wget cairo
 
 This project adheres to openZIM's [Contribution Guidelines](https://github.com/openzim/overview/wiki/Contributing).
 
-This project has implemented openZIM's [Python bootstrap, conventions and policies](https://github.com/openzim/_python-bootstrap/docs/Policy.md) **v1.0.2**.
+This project has implemented openZIM's [Python bootstrap, conventions and policies](https://github.com/openzim/_python-bootstrap/docs/Policy.md) **v2.0.0**.
 
 All instructions below must be run from the root of your local clone of this repository.
 

pyproject.toml

@@ -57,11 +57,8 @@ scripts = [
   "PyYAML==6.0.3",
 
 ]
-lint = [
-  "black==25.11.0",
-  "ruff==0.14.5",
-]
-check = [
+qa = [
+  "ruff==0.15.12",
   "pyright==1.1.407",
   "pytest==9.0.1",
 ]
@@ -71,6 +68,7 @@ test = [
   "coverage==7.11.3",
 ]
 docs = [
+  "ruff==0.15.12",
   "mkdocs==1.6.1",
   "mkdocs-include-markdown-plugin==7.2.0",
   "mkdocs-material==9.7.0",
@@ -84,9 +82,8 @@ dev = [
   "ipython==9.7.0",
   "pre-commit==4.4.0",
   "zimscraperlib[scripts]",
-  "zimscraperlib[lint]",
+  "zimscraperlib[qa]",
   "zimscraperlib[test]",
-  "zimscraperlib[check]",
   "zimscraperlib[docs]",
 ]
 
@@ -129,25 +126,19 @@ report-cov = "inv report-cov"
 coverage = "inv coverage --args '{args}'"
 html = "inv coverage --html --args '{args}'"
 
-[tool.hatch.envs.lint]
-template = "lint"
+[tool.hatch.envs.qa]
+template = "qa"
 skip-install = false
-features = ["scripts", "lint"]
-
-[tool.hatch.envs.lint.scripts]
-black = "inv lint-black --args '{args}'"
-ruff = "inv lint-ruff --args '{args}'"
-all = "inv lintall --args '{args}'"
-fix-black = "inv fix-black --args '{args}'"
-fix-ruff = "inv fix-ruff --args '{args}'"
-fixall = "inv fixall --args '{args}'"
-
-[tool.hatch.envs.check]
-features = ["scripts", "check"]
+features = ["scripts", "qa", "test"]
 
-[tool.hatch.envs.check.scripts]
-pyright = "inv check-pyright --args '{args}'"
-all = "inv checkall --args '{args}'"
+[tool.hatch.envs.qa.scripts]
+check-lint = "inv check-lint --args '{args}'"
+check-format = "inv check-format --args '{args}'"
+check-type = "inv check-type --args '{args}'"
+check-all = "inv check-all --args '{args}'"
+fix-format = "inv fix-format --args '{args}'"
+fix-lint = "inv fix-lint --args '{args}'"
+fix-all = "inv fix-all --args '{args}'"
 
 [tool.hatch.envs.docs]
 features = ["scripts", "docs"]

src/zimscraperlib/html.py

@@ -40,14 +40,13 @@ def find_language_in(content: str | BinaryIO | TextIO, mime_type: str) -> str:
             node = soup.find(nodename)
             if node:
                 if not isinstance(
-                    node, element.Tag  # pyright:ignore[reportUnnecessaryIsInstance]
+                    node,
+                    element.Tag,  # pyright:ignore[reportUnnecessaryIsInstance]
                 ) or not node.has_attr(key):
                     continue
                 if (
                     nodename == "meta"
-                    and not node.attrs.get(
-                        "http-equiv", ""
-                    ).lower()  # pyright:ignore[reportUnknownMemberType, reportAttributeAccessIssue]
+                    and not node.attrs.get("http-equiv", "").lower()  # pyright:ignore[reportUnknownMemberType, reportAttributeAccessIssue]
                     == "content-language"
                 ):
                     continue

src/zimscraperlib/i18n.py

@@ -167,13 +167,13 @@ def __eq__(self, value: object) -> bool:
 
     def __hash__(self):
         return hash(
-            f"{getattr(self, "iso_639_1", None)}$"
-            f"{getattr(self, "iso_639_2b", None)}$"
-            f"{getattr(self, "iso_639_2t", None)}$"
-            f"{getattr(self, "iso_639_3", None)}$"
-            f"{getattr(self, "iso_639_5", None)}$"
-            f"{getattr(self, "english", None)}$"
-            f"{getattr(self, "native", None)}"
+            f"{getattr(self, 'iso_639_1', None)}$"
+            f"{getattr(self, 'iso_639_2b', None)}$"
+            f"{getattr(self, 'iso_639_2t', None)}$"
+            f"{getattr(self, 'iso_639_3', None)}$"
+            f"{getattr(self, 'iso_639_5', None)}$"
+            f"{getattr(self, 'english', None)}$"
+            f"{getattr(self, 'native', None)}"
         )
 
 

src/zimscraperlib/image/probing.py

@@ -50,7 +50,9 @@ def solarize(r: int, g: int, b: int) -> tuple[int, int, int]:
         sr, sg, sb = solarize(mr, mg, mb)  # pyright: ignore[reportUnknownArgumentType]
 
     return rgb_to_hex(
-        mr, mg, mb  # pyright: ignore[reportUnknownArgumentType]
+        mr,  # pyright: ignore[reportUnknownArgumentType]
+        mg,  # pyright: ignore[reportUnknownArgumentType]
+        mb,  # pyright: ignore[reportUnknownArgumentType]
     ), rgb_to_hex(sr, sg, sb)
 
 

src/zimscraperlib/misc.py

@@ -1,10 +1,6 @@
 """Miscelaneous utils"""
 
-from typing import TypeVar
 
-T = TypeVar("T")
-
-
-def first(*args: T | None, default: T = "") -> T:
+def first[T](*args: T | None, default: T = "") -> T:
     """Return the first non-None value from *args; fallback to an empty string."""
     return next((item for item in args if item is not None), default)