usethis-python · nathanjmcdougall · Mar 22, 2026 · Mar 22, 2026 · Mar 22, 2026 · Mar 22, 2026
diff --git a/pyproject.toml b/pyproject.toml
@@ -211,7 +211,6 @@ reportAny = false
 reportAssignmentType = false
 reportCallInDefaultInitializer = false
 reportExplicitAny = false
-reportImplicitOverride = false
 reportImplicitStringConcatenation = false
 reportMissingParameterType = false
 reportMissingTypeArgument = false

diff --git a/src/usethis/_backend/uv/toml.py b/src/usethis/_backend/uv/toml.py
@@ -1,11 +1,14 @@
 from pathlib import Path
 
+from typing_extensions import override
+
 from usethis._file.toml.io_ import TOMLFileManager
 
 
 class UVTOMLManager(TOMLFileManager):
     """Class to manage the uv.toml file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path("uv.toml")
diff --git a/src/usethis/_config_file.py b/src/usethis/_config_file.py
@@ -4,6 +4,8 @@
 from pathlib import Path
 from typing import TYPE_CHECKING
 
+from typing_extensions import override
+
 from usethis._backend.uv.toml import UVTOMLManager
 from usethis._file.ini.io_ import INIFileManager
 from usethis._file.pyproject_toml.io_ import PyprojectTOMLManager
@@ -45,6 +47,7 @@ class DotCodespellRCManager(INIFileManager):
     """Class to manage the .codespellrc file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path(".codespellrc")
 
@@ -53,6 +56,7 @@ class DotCoverageRCManager(INIFileManager):
     """Class to manage the .coveragerc file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path(".coveragerc")
 
@@ -61,6 +65,7 @@ class DotCoverageRCTOMLManager(TOMLFileManager):
     """Class to manage the .coveragerc.toml file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path(".coveragerc.toml")
 
@@ -69,6 +74,7 @@ class DotImportLinterManager(INIFileManager):
     """Class to manage the .importlinter file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path(".importlinter")
 
@@ -77,6 +83,7 @@ class DotPytestINIManager(INIFileManager):
     """Class to manage the .pytest.ini file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path(".pytest.ini")
 
@@ -85,6 +92,7 @@ class DotRuffTOMLManager(TOMLFileManager):
     """Class to manage the .ruff.toml file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path(".ruff.toml")
 
@@ -93,6 +101,7 @@ class MkDocsYMLManager(YAMLFileManager):
     """Class to manage the mkdocs.yml file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path("mkdocs.yml")
 
@@ -101,6 +110,7 @@ class PytestINIManager(INIFileManager):
     """Class to manage the pytest.ini file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path("pytest.ini")
 
@@ -109,6 +119,7 @@ class RuffTOMLManager(TOMLFileManager):
     """Class to manage the ruff.toml file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path("ruff.toml")
 
@@ -117,6 +128,7 @@ class ToxINIManager(INIFileManager):
     """Class to manage the tox.ini file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path("tox.ini")
 
@@ -125,6 +137,7 @@ class DotTyTOMLManager(TOMLFileManager):
     """Class to manage the .ty.toml file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path(".ty.toml")
 
@@ -133,5 +146,6 @@ class TyTOMLManager(TOMLFileManager):
     """Class to manage the ty.toml file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path("ty.toml")
diff --git a/src/usethis/_file/ini/io_.py b/src/usethis/_file/ini/io_.py
@@ -8,7 +8,7 @@
 from configupdater import ConfigUpdater as INIDocument
 from configupdater import Option, Section
 from pydantic import TypeAdapter
-from typing_extensions import assert_never
+from typing_extensions import assert_never, override
 
 from usethis._file.ini.errors import (
     INIDecodeError,
@@ -42,12 +42,14 @@
 class INIFileManager(KeyValueFileManager, metaclass=ABCMeta):
     _content_by_path: ClassVar[dict[Path, INIDocument | None]] = {}
 
+    @override
     def __enter__(self) -> Self:
         try:
             return super().__enter__()
         except UnexpectedFileOpenError as err:
             raise UnexpectedINIOpenError(err) from None
 
+    @override
     def read_file(self) -> INIDocument:
         try:
             return super().read_file()
@@ -59,38 +61,45 @@ def read_file(self) -> INIDocument:
             msg = f"Failed to decode '{self.name}':\n{err}"
             raise INIDecodeError(msg) from None
 
+    @override
     def _dump_content(self) -> str:
         if self._content is None:
             msg = "Content is None, cannot dump."
             raise ValueError(msg)
 
         return str(self._content)
 
+    @override
     def _parse_content(self, content: str) -> INIDocument:
         updater = INIDocument()
         updater.read_string(content)
         return updater
 
+    @override
     def get(self) -> INIDocument:
         return super().get()
 
+    @override
     def commit(self, document: INIDocument) -> None:
         return super().commit(document)
 
     @property
+    @override
     def _content(self) -> INIDocument | None:
         return super()._content
 
     @_content.setter
     def _content(self, value: INIDocument | None) -> None:
         self._content_by_path[self.path] = value
 
+    @override
     def _validate_lock(self) -> None:
         try:
             super()._validate_lock()
         except UnexpectedFileIOError as err:
             raise UnexpectedINIIOError(err) from None
 
+    @override
     def __contains__(self, keys: Sequence[Key]) -> bool:
         """Check if the INI file contains a value at the given key.
 
@@ -114,6 +123,7 @@ def __contains__(self, keys: Sequence[Key]) -> bool:
                     return True
         return False
 
+    @override
     def __getitem__(self, item: Sequence[Key]) -> object:
         keys = item
 
@@ -146,6 +156,7 @@ def __getitem__(self, item: Sequence[Key]) -> object:
             )
             raise KeyError(msg)
 
+    @override
     def set_value(
         self,
         *,
@@ -338,6 +349,7 @@ def _validated_append(
         else:
             root[section_key][option_key].append(value)
 
+    @override
     def __delitem__(self, keys: Sequence[Key]) -> None:
         """Delete a value in the INI file.
 
@@ -417,6 +429,7 @@ def _delete_strkeys(self, strkeys: Sequence[str]) -> None:
 
         self.commit(root)
 
+    @override
     def extend_list(self, *, keys: Sequence[Key], values: Sequence[object]) -> None:
         """Extend a list in the INI file.
 
@@ -495,6 +508,7 @@ def _remove_from_list_in_option(
         elif len(new_values) > 1:
             root[section_key][option_key].set_values(new_values)
 
+    @override
     def remove_from_list(
         self, *, keys: Sequence[Key], values: Sequence[object]
     ) -> None:

diff --git a/src/usethis/_file/pyproject_toml/errors.py b/src/usethis/_file/pyproject_toml/errors.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from typing_extensions import override
+
 from usethis._file.toml.errors import (
     TOMLDecodeError,
     TOMLError,
@@ -28,6 +30,7 @@ class PyprojectTOMLDecodeError(TOMLDecodeError, PyprojectTOMLError):
     """Raised when a pyproject.toml file cannot be decoded."""
 
     @property
+    @override
     def name(self) -> str:
         """The name of the file that could not be decoded."""
         return "pyproject.toml"
@@ -45,6 +48,7 @@ class PyprojectTOMLProjectSectionError(FileConfigError, PyprojectTOMLError):
     """Raised when the 'project' section is missing or invalid in 'pyproject.toml'."""
 
     @property
+    @override
     def name(self) -> str:
         """The name of the file that has a configuration error."""
         return "pyproject.toml"

diff --git a/src/usethis/_file/pyproject_toml/io_.py b/src/usethis/_file/pyproject_toml/io_.py
@@ -3,6 +3,8 @@
 from pathlib import Path
 from typing import TYPE_CHECKING
 
+from typing_extensions import override
+
 from usethis._file.pyproject_toml.errors import (
     PyprojectTOMLDecodeError,
     PyprojectTOMLNotFoundError,
@@ -35,15 +37,18 @@ class PyprojectTOMLManager(TOMLFileManager):
     """Manages the pyproject.toml file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path("pyproject.toml")
 
+    @override
     def __enter__(self) -> Self:
         try:
             return super().__enter__()
         except UnexpectedTOMLOpenError as err:
             raise UnexpectedPyprojectTOMLOpenError(err) from None
 
+    @override
     def read_file(self) -> TOMLDocument:
         try:
             return super().read_file()
@@ -54,12 +59,14 @@ def read_file(self) -> TOMLDocument:
         except TOMLDecodeError as err:
             raise PyprojectTOMLDecodeError(err) from None
 
+    @override
     def _validate_lock(self) -> None:
         try:
             super()._validate_lock()
         except UnexpectedTOMLIOError as err:
             raise UnexpectedPyprojectTOMLIOError(err) from None
 
+    @override
     def set_value(
         self, *, keys: Sequence[Key], value: Any, exists_ok: bool = False
     ) -> None:
@@ -69,6 +76,7 @@ def set_value(
         except TOMLValueAlreadySetError as err:
             raise PyprojectTOMLValueAlreadySetError(err) from None
 
+    @override
     def __delitem__(self, keys: Sequence[Key]) -> None:
         """Remove a value from the pyproject.toml configuration file."""
         try:

diff --git a/src/usethis/_file/setup_cfg/errors.py b/src/usethis/_file/setup_cfg/errors.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from typing_extensions import override
+
 from usethis._file.ini.errors import (
     INIDecodeError,
     INIError,
@@ -23,6 +25,7 @@ class SetupCFGDecodeError(INIDecodeError, SetupCFGError):
     """Raised when a setup.cfg file cannot be decoded."""
 
     @property
+    @override
     def name(self) -> str:
         """The name of the file that could not be decoded."""
         return "setup.cfg"

diff --git a/src/usethis/_file/setup_cfg/io_.py b/src/usethis/_file/setup_cfg/io_.py
@@ -3,6 +3,8 @@
 from pathlib import Path
 from typing import TYPE_CHECKING
 
+from typing_extensions import override
+
 from usethis._file.ini.errors import (
     INIDecodeError,
     ININotFoundError,
@@ -35,15 +37,18 @@ class SetupCFGManager(INIFileManager):
     """Manages the setup.cfg file."""
 
     @property
+    @override
     def relative_path(self) -> Path:
         return Path("setup.cfg")
 
+    @override
     def __enter__(self) -> Self:
         try:
             return super().__enter__()
         except UnexpectedINIOpenError as err:
             raise UnexpectedSetupCFGOpenError(err) from None
 
+    @override
     def read_file(self) -> INIDocument:
         try:
             return super().read_file()
@@ -54,12 +59,14 @@ def read_file(self) -> INIDocument:
         except INIDecodeError as err:
             raise SetupCFGDecodeError(err) from None
 
+    @override
     def _validate_lock(self) -> None:
         try:
             super()._validate_lock()
         except UnexpectedINIIOError as err:
             raise UnexpectedSetupCFGIOError(err) from None
 
+    @override
     def set_value(
         self, *, keys: Sequence[Key], value: Any, exists_ok: bool = False
     ) -> None:
@@ -69,6 +76,7 @@ def set_value(
         except INIValueAlreadySetError as err:
             raise SetupCFGValueAlreadySetError(err) from None
 
+    @override
     def __delitem__(self, keys: Sequence[Key]) -> None:
         """Remove a value from the pyproject.toml configuration file."""
         try: