Python 3.14 support, pyproject.toml and CI modernization

Author: zigai

.editorconfig

@@ -6,6 +6,7 @@ indent_size = 4
 charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
+end_of_line = lf
 
-[{*.yaml, *.yml}]
+[*.{yaml,yml}]
 indent_size = 2

.github/workflows/python-publish.yml

@@ -1,20 +1,20 @@
-name: Upload Python Package
-on:
-  release:
-    types: [published]
-jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Install uv
-        uses: astral-sh/setup-uv@v3
-      - name: Set up Python
-        run: uv python install 3.12
-      - name: Build and publish
-        env:
-          TWINE_USERNAME: __token__
-          TWINE_PASSWORD: ${{ secrets.TOKEN }}
-        run: |
-          uv build
-          uv run --with twine twine upload dist/*
+name: Upload Python Package
+on:
+  release:
+    types: [published]
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+      - name: Set up Python
+        run: uv python install 3.12
+      - name: Build and publish
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.TOKEN }}
+        run: |
+          uv build
+          uv run --with twine twine upload dist/*

.github/workflows/tests.yml

@@ -6,16 +6,11 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [
-          "3.10",
-          "3.11",
-          "3.12",
-          "3.13"
-        ]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Install uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v7
 
       - name: Set up Python ${{ matrix.python-version }}
         run: uv python install ${{ matrix.python-version }}

.pre-commit-config.yaml

@@ -8,8 +8,8 @@ repos:
       - id: check-toml
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.8.4
+    rev: v0.14.2
     hooks:
-      - id: ruff
-        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-check
+        args: [--fix, --exit-zero]
       - id: ruff-format

Justfile

@@ -1,41 +1,62 @@
 @_:
-   just --list
+  just --list
 
 _require-uv:
-   @uv --version > /dev/null || (echo "Please install uv: https://docs.astral.sh/uv/" && exit 1)
+  @uv --version > /dev/null || (echo "Please install uv: https://docs.astral.sh/uv/" && exit 1)
 
 _require-hatch:
   @hatch --version > /dev/null || (echo "Please install hatch: uv tool install hatch" && exit 1)
 
 # check code style and potential issues
 lint:
-   ruff check
-
-# fix automatically fixable linting issues
-fix:
-   ruff check --fix
+  ruff check
 
 # format code
 format:
-   ruff format
+  ruff format
+
+# fix automatically fixable linting issues
+fix:
+  ruff check --fix
 
 # run tests across all supported Python versions
 test: _require-hatch
-   hatch run test:test
-
-# run all quality checks
-check: format lint test
+  hatch run test:test
 
 # build the package
 build: _require-uv
-   uv build
+  uv build
 
-# setup development environment
+# setup or update local dev environment, keeps previously installed extras
 dev: _require-uv
-   uv sync --extra dev
-   uv run pre-commit install
+  uv sync --inexact --extra dev
+  uv run pre-commit install
+
+# run tests with coverage and show a coverage report
+coverage:
+  coverage run -m pytest
+  coverage report
 
 # clean build artifacts and caches
 clean:
-   rm -rf .venv .pytest_cache .mypy_cache .ruff_cache
-   find . -type d -name "__pycache__" -exec rm -r {} +
+  rm -rf .venv .pytest_cache .mypy_cache .ruff_cache
+  find . -type d -name "__pycache__" -exec rm -r {} +
+
+# static type check with mypy
+typecheck: _require-uv
+    uv run mypy
+
+# check code for common misspellings
+spell:
+    codespell
+
+# run all quality checks
+check: format lint coverage typecheck spell
+
+# list available recipes
+help:
+    just --list
+
+alias fmt := format
+alias cov := coverage
+alias mypy := typecheck

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "objinspect"
-version = "0.3.0"
+version = "0.3.1"
 description = "A high-level library for Python object inspection"
 authors = [{ name = "Žiga Ivanšek", email = "ziga.ivansek@gmail.com" }]
 license = { file = "LICENSE" }
@@ -25,6 +25,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
 ]
 
 keywords = [
@@ -39,27 +40,62 @@ keywords = [
     "function-signature",
 ]
 
-
 [project.optional-dependencies]
-test = ["pytest"]
-dev = ["pytest", "black", "ruff", "pre-commit"]
+test = ["pytest", "coverage"]
+dev = ["pytest", "coverage", "ruff", "pre-commit", "codespell", "mypy"]
 
 [project.urls]
 Repository = "https://github.com/zigai/objinspect"
-Documentation = "https://objinspect.readthedocs.io"
 Issues = "https://github.com/zigai/objinspect/issues"
 Homepage = "https://github.com/zigai/objinspect"
+Documentation = "https://objinspect.readthedocs.io"
 
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
+[tool.hatch.envs.test]
+features = ["test"]
+installer = "uv"
+
+[[tool.hatch.envs.test.matrix]]
+python = ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+[tool.hatch.envs.test.scripts]
+test = "pytest -v {args}"
+cov = "coverage run -m pytest {args}"
+
 [tool.hatch.build.targets.wheel]
 packages = ["objinspect"]
 
-[tool.black]
-line-length = 100
-target_version = ['py310', 'py311', 'py312', 'py313']
+[tool.coverage.run]
+source = ["objinspect"]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    'pragma: no cover',
+    'raise NotImplementedError',
+    'if TYPE_CHECKING:',
+    'if typing.TYPE_CHECKING:',
+]
+omit = ["tests/*", "tests/**"]
+
+[tool.mypy]
+python_version = "3.10"
+files = ["objinspect"]
+exclude = ["^tests/"]
+
+disallow_untyped_defs = true
+disallow_untyped_calls = true
+disallow_any_generics = true
+no_implicit_optional = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+warn_return_any = true
+warn_unused_configs = true
+strict_equality = true
+ignore_missing_imports = true
 
 [tool.ruff]
 line-length = 100
@@ -74,13 +110,13 @@ select = [
     'YTT',     # flake8-2020
     'B',       # flake8-bugbear
     "PLE",     # pylint
-    'PYI006',  # flake8-pyi
-    'PYI019',  # flake8-pyi
-    'PYI024',  # flake8-pyi
-    'PYI030',  # flake8-pyi
-    'PYI062',  # flake8-pyi
-    'PYI063',  # flake8-pyi
-    'PYI066',  # flake8-pyi
+    'PYI006',
+    'PYI019',
+    'PYI024',
+    'PYI030',
+    'PYI062',
+    'PYI063',
+    'PYI066',
     "RUF001",
     "RUF002",
     "RUF003",
@@ -134,33 +170,7 @@ ignore = [
     "UP007",
     "UP038",
 ]
-isort = { known-first-party = ["objinspect", 'tests'] }
-pydocstyle = { convention = 'google' }
-
-exclude = [
-    ".bzr",
-    ".direnv",
-    ".eggs",
-    ".git",
-    ".hg",
-    ".mypy_cache",
-    ".nox",
-    ".pants.d",
-    ".pytype",
-    ".ruff_cache",
-    ".svn",
-    ".tox",
-    ".venv",
-    "__pypackages__",
-    "_build",
-    "buck-out",
-    "build",
-    "dist",
-    "node_modules",
-    "venv",
-    "tests/*",
-    "tests/**/*",
-]
+exclude = ["build", "tests/**"]
 
 [tool.ruff.lint.per-file-ignores]
 "__init__.py" = [
@@ -173,14 +183,13 @@ exclude = [
 quote-style = "double"
 indent-style = "space"
 skip-magic-trailing-comma = false
-line-ending = "auto"
+line-ending = "lf"
 
-[tool.hatch.envs.test]
-features = ["test"]
-installer = "uv"
+[tool.ruff.lint.isort]
+known-first-party = ["objinspect", "tests"]
 
-[[tool.hatch.envs.test.matrix]]
-python = ["3.10", "3.11", "3.12", "3.13"]
+[tool.ruff.lint.pydocstyle]
+convention = "google"
 
-[tool.hatch.envs.test.scripts]
-test = "pytest -v"
+[tool.codespell]
+skip = '.git,uv.lock'