🔧 chore: modernize tooling and bump deps (#470)

Replace mypy with ty for type checking as it provides faster feedback
and simpler configuration. Adopt pytest 9's native TOML config format
([tool.pytest] with dotted keys). Drop the unused prettier xml plugin
and configure print-width/prose-wrap to match project conventions.

Remove the outdated black code style badge since the project uses ruff.
Fix release.yml bot author exclusion patterns to use the [bot] suffix.
Bump all dev dependencies to their latest releases.

Signed-off-by: Bernát Gábor <[email protected]>

Author: gaborbernat

.github/release.yml

@@ -1,5 +1,5 @@
 changelog:
   exclude:
     authors:
-      - dependabot
-      - pre-commit-ci
+      - dependabot[bot]
+      - pre-commit-ci[bot]

.pre-commit-config.yaml

@@ -13,17 +13,17 @@ repos:
     rev: v2.4.1
     hooks:
       - id: codespell
-        additional_dependencies: ["tomli>=2.2.1"]
+        additional_dependencies: ["tomli>=2.4"]
   - repo: https://github.com/tox-dev/tox-toml-fmt
-    rev: "v1.2.2"
+    rev: "v1.5.4"
     hooks:
       - id: tox-toml-fmt
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: "v2.11.1"
+    rev: "v2.15.2"
     hooks:
       - id: pyproject-fmt
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.14.14"
+    rev: "v0.15.0"
     hooks:
       - id: ruff-format
       - id: ruff-check
@@ -32,9 +32,7 @@ repos:
     rev: "v3.8.1" # Use the sha / tag you want to point at
     hooks:
       - id: prettier
-        additional_dependencies:
-          - [email protected]
-          - "@prettier/[email protected]"
+        args: ["--print-width=120", "--prose-wrap=always"]
   - repo: meta
     hooks:
       - id: check-hooks-apply

README.md

@@ -1,12 +1,8 @@
 # filelock
 
 [![PyPI](https://img.shields.io/pypi/v/filelock)](https://pypi.org/project/filelock/)
-[![Supported Python
-versions](https://img.shields.io/pypi/pyversions/filelock.svg)](https://pypi.org/project/filelock/)
-[![Documentation
-status](https://readthedocs.org/projects/py-filelock/badge/?version=latest)](https://py-filelock.readthedocs.io/en/latest/?badge=latest)
-[![Code style:
-black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Supported Python versions](https://img.shields.io/pypi/pyversions/filelock.svg)](https://pypi.org/project/filelock/)
+[![Documentation status](https://readthedocs.org/projects/py-filelock/badge/?version=latest)](https://py-filelock.readthedocs.io/en/latest/?badge=latest)
 [![Downloads](https://static.pepy.tech/badge/filelock/month)](https://pepy.tech/project/filelock)
 [![check](https://github.com/tox-dev/py-filelock/actions/workflows/check.yaml/badge.svg)](https://github.com/tox-dev/py-filelock/actions/workflows/check.yaml)
 

pyproject.toml

@@ -2,7 +2,7 @@
 build-backend = "hatchling.build"
 requires = [
   "hatch-vcs>=0.5",
-  "hatchling>=1.27",
+  "hatchling>=1.28",
 ]
 
 [project]
@@ -54,39 +54,37 @@ dev = [
   { include-group = "test" },
   { include-group = "type" },
 ]
-
 test = [
   "covdefaults>=2.3",
-  "diff-cover>=9.7.1",
-  "pytest>=8.4.2",
-  "pytest-asyncio>=1.2",
+  "diff-cover>=10.2",
+  "pytest>=9.0.2",
+  "pytest-asyncio>=1.3",
   "pytest-cov>=7",
   "pytest-mock>=3.15.1",
   "pytest-timeout>=2.4",
-  "virtualenv>=20.34",
+  "virtualenv>=20.36.1",
 ]
 type = [
-  "mypy>=1.18.2",
-  "typing-extensions>=4.15; python_version<'3.11'",
+  "ty>=0.0.16",
   { include-group = "test" },
 ]
 docs = [
-  "furo>=2025.9.25",
-  "sphinx>=8.2.3",
-  "sphinx-autodoc-typehints>=3.2",
+  "furo>=2025.12.19",
+  "sphinx>=9.1",
+  "sphinx-autodoc-typehints>=3.6.2",
+]
+coverage = [
+  "covdefaults>=2.3",
+  "coverage[toml]>=7.13.4",
+  "diff-cover>=10.2",
 ]
 fix = [
-  "pre-commit-uv>=4.1.5",
+  "pre-commit-uv>=4.2",
 ]
 pkg-meta = [
   "check-wheel-contents>=0.6.3",
   "twine>=6.2",
-  "uv>=0.8.22",
-]
-coverage = [
-  "covdefaults>=2.3",
-  "coverage[toml]>=7.10.7",
-  "diff-cover>=9.7.1",
+  "uv>=0.10.2",
 ]
 
 [tool.hatch]
@@ -112,7 +110,7 @@ lint.ignore = [
   "D203",   # `one-blank-line-before-class` (D203) and `no-blank-line-before-class` (D211) are incompatible
   "D205",   # 1 blank line required between summary line and description
   "D212",   # `multi-line-summary-first-line` (D212) and `multi-line-summary-second-line` (D213) are incompatible
-  "D301",   #  Use `r"""` if any backslashes in a docstring
+  "D301",   # Use `r"""` if any backslashes in a docstring
   "D401",   # First line of docstring should be in imperative mood
   "DOC",    # no support yet
   "ISC001", # Conflict with formatter
@@ -143,46 +141,39 @@ ignore-words-list = "master"
 [tool.pyproject-fmt]
 max_supported_python = "3.14"
 
-[tool.pytest.ini_options]
-asyncio_default_fixture_loop_scope = "session"
-testpaths = [
+[tool.pytest]
+ini_options.asyncio_default_fixture_loop_scope = "session"
+ini_options.testpaths = [
   "tests",
 ]
-verbosity_assertions = 2
-filterwarnings = [
+ini_options.verbosity_assertions = 2
+ini_options.filterwarnings = [
   "error",
   "ignore:unclosed database in <sqlite3.Connection object at:ResourceWarning",
   "ignore:unclosed file <_io.TextIOWrapper:ResourceWarning",
 ]
 
 [tool.coverage]
-html.show_contexts = true
-html.skip_covered = false
+run.parallel = true
+run.plugins = [
+  "covdefaults",
+]
+paths.other = [
+  ".",
+  "*/filelock",
+  "*\\filelock",
+]
 paths.source = [
   "src",
   ".tox/*/lib/*/site-packages",
   ".tox\\*\\Lib\\site-packages",
   "**/src",
   "**\\src",
 ]
-paths.other = [
-  ".",
-  "*/filelock",
-  "*\\filelock",
-]
 report.fail_under = 76
-run.parallel = true
-run.plugins = [
-  "covdefaults",
-]
+html.show_contexts = true
+html.skip_covered = false
 
-[tool.mypy]
-python_version = "3.11"
-show_error_codes = true
-strict = true
-overrides = [
-  { module = [
-    "appdirs.*",
-    "jnius.*",
-  ], ignore_missing_imports = true },
-]
+[tool.ty]
+environment.python-version = "3.14"
+src.exclude = [ "docs/" ]

src/filelock/_api.py

@@ -79,6 +79,8 @@ class ThreadLocalFileContext(FileLockContext, local):
 
 
 class FileLockMeta(ABCMeta):
+    _instances: WeakValueDictionary[str, BaseFileLock]
+
     def __call__(  # noqa: PLR0913
         cls,
         lock_file: str | os.PathLike[str],
@@ -91,7 +93,7 @@ def __call__(  # noqa: PLR0913
         **kwargs: Any,  # capture remaining kwargs for subclasses  # noqa: ANN401
     ) -> BaseFileLock:
         if is_singleton:
-            instance = cls._instances.get(str(lock_file))  # type: ignore[attr-defined]
+            instance = cls._instances.get(str(lock_file))
             if instance:
                 params_to_check = {
                     "thread_local": (thread_local, instance.is_thread_local()),
@@ -128,13 +130,13 @@ def __call__(  # noqa: PLR0913
             **kwargs,
         }
 
-        present_params = inspect.signature(cls.__init__).parameters  # type: ignore[misc]
+        present_params = inspect.signature(cls.__init__).parameters
         init_params = {key: value for key, value in all_params.items() if key in present_params}
 
         instance = super().__call__(lock_file, **init_params)
 
         if is_singleton:
-            cls._instances[str(lock_file)] = instance  # type: ignore[attr-defined]
+            cls._instances[str(lock_file)] = instance
 
         return cast("BaseFileLock", instance)
 

src/filelock/asyncio.py

@@ -70,7 +70,7 @@ async def __aexit__(  # noqa: D105
 
 
 class AsyncFileLockMeta(FileLockMeta):
-    def __call__(  # type: ignore[override] # noqa: PLR0913
+    def __call__(  # ty: ignore[invalid-method-override]  # noqa: PLR0913
         cls,  # noqa: N805
         lock_file: str | os.PathLike[str],
         timeout: float = -1,
@@ -179,7 +179,7 @@ def loop(self) -> asyncio.AbstractEventLoop | None:
         """::return: the event loop."""
         return self._context.loop
 
-    async def acquire(  # type: ignore[override]
+    async def acquire(  # ty: ignore[invalid-method-override]
         self,
         timeout: float | None = None,
         poll_interval: float = 0.05,
@@ -247,7 +247,7 @@ async def acquire(  # type: ignore[override]
             raise
         return AsyncAcquireReturnProxy(lock=self)
 
-    async def release(self, force: bool = False) -> None:  # type: ignore[override]  # noqa: FBT001, FBT002
+    async def release(self, force: bool = False) -> None:  # ty: ignore[invalid-method-override]  # noqa: FBT001, FBT002
         """
         Releases the file lock. Please note, that the lock is only completely released, if the lock counter is 0.
         Also note, that the lock file itself is not automatically deleted.

tests/test_async_filelock.py

@@ -162,12 +162,12 @@ async def test_coroutine_function(tmp_path: Path) -> None:
     acquired = released = False
 
     class AioFileLock(BaseAsyncFileLock):
-        async def _acquire(self) -> None:  # type: ignore[override]
+        async def _acquire(self) -> None:  # ty: ignore[invalid-method-override]
             nonlocal acquired
             acquired = True
             self._context.lock_file_fd = 1
 
-        async def _release(self) -> None:  # type: ignore[override]
+        async def _release(self) -> None:  # ty: ignore[invalid-method-override]
             nonlocal released
             released = True
             self._context.lock_file_fd = None

tests/test_filelock.py

@@ -779,10 +779,10 @@ def test_singleton_locks_are_deleted_when_no_external_references_exist(
 @pytest.mark.skipif(hasattr(sys, "pypy_version_info"), reason="del() does not trigger GC in PyPy")
 @pytest.mark.parametrize("lock_type", [FileLock, SoftFileLock])
 def test_singleton_instance_tracking_is_unique_per_subclass(lock_type: type[BaseFileLock]) -> None:
-    class Lock1(lock_type):  # type: ignore[valid-type, misc]
+    class Lock1(lock_type):  # ty: ignore[unsupported-base]
         pass
 
-    class Lock2(lock_type):  # type: ignore[valid-type, misc]
+    class Lock2(lock_type):  # ty: ignore[unsupported-base]
         pass
 
     assert isinstance(Lock1._instances, WeakValueDictionary)  # noqa: SLF001

tests/test_virtualenv.py

@@ -2,7 +2,7 @@
 
 from typing import TYPE_CHECKING
 
-from virtualenv import cli_run  # type: ignore[import-untyped]
+from virtualenv import cli_run
 
 if TYPE_CHECKING:
     from pathlib import Path

tox.toml

@@ -1,4 +1,4 @@
-requires = [ "tox>=4.30.2" ]
+requires = [ "tox>=4.34.1" ]
 env_list = [ "fix", "3.14t", "3.14", "3.13", "3.12", "3.11", "3.10", "coverage", "type", "docs", "pkg_meta" ]
 skip_missing_interpreters = true
 
@@ -33,7 +33,6 @@ commands = [
       "--cov-report",
       "xml:{env_tmp_dir}{/}coverage.xml",
     ] },
-
     "tests",
   ],
   { replace = "posargs", extend = true, default = [
@@ -46,6 +45,20 @@ commands = [
   ] },
 ]
 
+[env.fix]
+description = "format the code base to adhere to our styles, and complain about what we cannot do automatically"
+skip_install = true
+dependency_groups = [ "fix" ]
+pass_env = [
+  { replace = "ref", of = [
+    "env_run_base",
+    "pass_env",
+  ], extend = true },
+  "PROGRAMDATA",
+  "DISABLE_PRE_COMMIT_UV_PATCH",
+]
+commands = [ [ "pre-commit", "run", "--all-files", "--show-diff-on-failure", { replace = "posargs", extend = true } ] ]
+
 [env.coverage]
 description = "combine coverage files and generate diff (against DIFF_AGAINST defaulting to origin/main)"
 skip_install = true
@@ -73,24 +86,10 @@ commands = [
 parallel_show_output = true
 depends = [ "3.14t", "3.14", "3.13", "3.12", "3.11", "3.10" ]
 
-[env.fix]
-description = "format the code base to adhere to our styles, and complain about what we cannot do automatically"
-skip_install = true
-dependency_groups = [ "fix" ]
-pass_env = [
-  { replace = "ref", of = [
-    "env_run_base",
-    "pass_env",
-  ], extend = true },
-  "PROGRAMDATA",
-  "DISABLE_PRE_COMMIT_UV_PATCH",
-]
-commands = [ [ "pre-commit", "run", "--all-files", "--show-diff-on-failure", { replace = "posargs", extend = true } ] ]
-
 [env.type]
 description = "run type check on code base"
 dependency_groups = [ "type" ]
-commands = [ [ "mypy", "src{/}filelock" ], [ "mypy", "tests" ] ]
+commands = [ [ "ty", "check", "--output-format", "concise", "--error-on-warning", "." ] ]
 
 [env.docs]
 description = "build documentation"
@@ -105,7 +104,7 @@ commands = [
     "--color",
     "-b",
     "html",
-    { replace = "posargs", default = [  ], extend = true },
+    { replace = "posargs", default = [], extend = true },
     "-W",
   ],
   [