check-empty 2.0.0__tar.gz → 3.0.1__tar.gz

{check_empty-2.0.0 → check_empty-3.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: check-empty
-Version: 2.0.0
+Version: 3.0.1
 Summary: Command-line utility, as well as a hook usable by the Python pre-commit framework, and a GitHub Action, to ensure that selected files are empty.
 Keywords: check,command-line,empty,files,github-action,helper,hook,lightweight,pre-commit,prek,tool,utility
 Author: Jonathan Dung
@@ -27,7 +27,7 @@ Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
 Requires-Dist: py7zr==1.1.3 ; extra == '7z'
 Requires-Dist: acefile==0.6.14 ; extra == 'ace'
-Requires-Dist: check-empty[7z,ace,ar,lzh,rar]==2.0.0 ; extra == 'all'
+Requires-Dist: check-empty[7z,ace,ar,lzh,rar]==3.0.1 ; extra == 'all'
 Requires-Dist: arpy==2.4.0 ; extra == 'ar'
 Requires-Dist: lhafile==0.3.1 ; extra == 'lzh'
 Requires-Dist: rarfile==4.5 ; extra == 'rar'
@@ -42,7 +42,7 @@ Provides-Extra: lzh
 Provides-Extra: rar
 Description-Content-Type: text/markdown
 
-# [check-empty](https://pypi.org/p/check-empty)
+# [check-empty](https://pypi.org/project/check-empty/3.0.1)
 
 [![#StandWithPalestine](https://raw.githubusercontent.com/TheBSD/StandWithPalestine/main/badges/StandWithPalestine.svg)](https://github.com/TheBSD/StandWithPalestine/blob/main/docs/README.md)
 
@@ -57,7 +57,8 @@ specified.
 
 ## Prerequisites
 
-Supports every Python 3.10 runtime. There are no other requirements.
+Supports every Python 3.10 runtime. There are no other requirements unless you want to
+check if files in certain types of (compressed) archives are empty.
 
 ## Quickstart
 
@@ -125,7 +126,7 @@ As a pre-commit hook:
 # .pre-commit-config.yaml
 repos:
 - repo: https://github.com/jonathandung/check-empty
-  rev: v2.0.0 # repository version
+  rev: v3.0.1 # repository version
   hooks:
     - id: check-empty # the hook
       args: # example list of arguments
@@ -141,7 +142,7 @@ equivalent in `prek.toml` format:
 ```toml
 [[repos]]
 repo = "https://github.com/jonathandung/check-empty"
-rev = "v2.0.0"
+rev = "v3.0.1"
 
 [[repos.hooks]]
 id = "check-empty"
@@ -165,7 +166,7 @@ or (TOML 1.1+):
 # using multiline inline tables
 [[repos]]
 repo = "https://github.com/jonathandung/check-empty"
-rev = "v2.0.0"
+rev = "v3.0.1"
 hooks = [{
   id = "check-empty",
   args = ["-Q"],
@@ -185,7 +186,7 @@ As a GitHub Actions workflow step:
 
 ```yaml
 steps:
-- uses: jonathandung/check-empty@v2.0.0 # the latest version on the GitHub Actions
+- uses: jonathandung/check-empty@v3.0.1 # the latest version on the GitHub Actions
   # marketplace; this step will fail and subsequent jobs will not run if any file is
   # not empty
   with:

{check_empty-2.0.0 → check_empty-3.0.1}/README.md

@@ -1,4 +1,4 @@
-# [check-empty](https://pypi.org/p/check-empty)
+# [check-empty](https://pypi.org/project/check-empty/3.0.1)
 
 [![#StandWithPalestine](https://raw.githubusercontent.com/TheBSD/StandWithPalestine/main/badges/StandWithPalestine.svg)](https://github.com/TheBSD/StandWithPalestine/blob/main/docs/README.md)
 
@@ -13,7 +13,8 @@ specified.
 
 ## Prerequisites
 
-Supports every Python 3.10 runtime. There are no other requirements.
+Supports every Python 3.10 runtime. There are no other requirements unless you want to
+check if files in certain types of (compressed) archives are empty.
 
 ## Quickstart
 
@@ -81,7 +82,7 @@ As a pre-commit hook:
 # .pre-commit-config.yaml
 repos:
 - repo: https://github.com/jonathandung/check-empty
-  rev: v2.0.0 # repository version
+  rev: v3.0.1 # repository version
   hooks:
     - id: check-empty # the hook
       args: # example list of arguments
@@ -97,7 +98,7 @@ equivalent in `prek.toml` format:
 ```toml
 [[repos]]
 repo = "https://github.com/jonathandung/check-empty"
-rev = "v2.0.0"
+rev = "v3.0.1"
 
 [[repos.hooks]]
 id = "check-empty"
@@ -121,7 +122,7 @@ or (TOML 1.1+):
 # using multiline inline tables
 [[repos]]
 repo = "https://github.com/jonathandung/check-empty"
-rev = "v2.0.0"
+rev = "v3.0.1"
 hooks = [{
   id = "check-empty",
   args = ["-Q"],
@@ -141,7 +142,7 @@ As a GitHub Actions workflow step:
 
 ```yaml
 steps:
-- uses: jonathandung/check-empty@v2.0.0 # the latest version on the GitHub Actions
+- uses: jonathandung/check-empty@v3.0.1 # the latest version on the GitHub Actions
   # marketplace; this step will fail and subsequent jobs will not run if any file is
   # not empty
   with:

{check_empty-2.0.0 → check_empty-3.0.1}/check_empty/__init__.py

@@ -7,26 +7,22 @@ Pre-commit hook, command-line tool and GitHub Action all-in-one.
 
 from __future__ import annotations
 
-import os
-from contextlib import suppress
-
-from . import constants, reporter
+from check_empty import constants, reporter
 
+__all__ = ('Handler', 'check', 'default_reporter')
+__version__ = '3.0.1'
+"""The version of the package."""
+default_reporter: reporter.Reporter = reporter.Reporter()
+"""The default reporter used by :func:`check`."""
 TYPE_CHECKING = False
 if TYPE_CHECKING:
     from collections.abc import Callable, Iterable
-    from types import ModuleType, TracebackType
+    from types import TracebackType
     from typing import Any, SupportsIndex
 
     from _typeshed import FileDescriptorOrPath
     from typing_extensions import Self
 
-__all__ = ('Handler', 'check', 'default_reporter')
-__version__ = '2.0.0'
-"""The version of the package."""
-default_reporter: reporter.Reporter = reporter.Reporter()
-"""The default reporter used by :func:`check`."""
-
 
 class Handler:
     """Used to handle errors when opening a file."""
@@ -36,22 +32,18 @@ class Handler:
     """The file descriptor or string path to the file being handled."""
     c: bool
     """Whether an I/O error was handled."""
-    f: Callable[[str], None]
-    """The function to call when handling an I/O error.
-
-    Should take a string representing the error message as the only argument and
-    preferably return ``None``.
-    """
-    j: Callable[[str], None]
+    f: Callable[[OSError], object]
+    """The function to call on the I/O error being handled."""
+    j: Callable[[str], object]
     """The function to call when handling the case where the file is missing.
 
     Should take the path to the file or a string encapsulating the validity of the file
-    descriptor as the only argument and preferably return ``None``.
+    descriptor as the only argument.
     """
     v: str | None
     """The cached value of :attr:`e`."""
 
-    def __init__(self, *a: Any) -> None:  # ruff: ignore[any-type]
+    def __init__(self, *a: Any):  # ruff: ignore[any-type]
         """Initialize the handler."""
         self.j, self.f, self.a = a
         self.v = None
@@ -71,7 +63,7 @@ class Handler:
             ...
 
     @property
-    def e(self, s: str = 'invalid fd (negative): %d', t: str = 'fd: %d') -> str:  # ruff: ignore[property-with-parameters]
+    def e(self, s: str = 'invalid fd (negative): %d', t: str = 'fd: %d') -> str:
         """The file path itself, or the file descriptor coerced to a string."""
         r = self.v
         if r is None:
@@ -92,7 +84,7 @@ class Handler:
         """
         if t is None or not isinstance(v, OSError):
             return False
-        self.j(self.e) if v.errno == constants.ENOENT else self.f(str(v))
+        self.j(self.e) if v.errno == constants.ENOENT else self.f(v)
         self.c = True
         return True
 
@@ -104,7 +96,7 @@ def check(
     may_not_exist: bool = False,
     verbosity: SupportsIndex = 2,
     recurse_into: SupportsIndex = constants.RecurseInto.NONE,
-    reporter: reporter.abc.ReporterABC = default_reporter,
+    reporter: reporter.abcdef.ReporterABC = default_reporter,
 ) -> int:
     # ruff: ignore[docstring-missing-exception]
     r"""Check the emptiness of files, recursing into directories if passed.
@@ -130,13 +122,15 @@ def check(
         The integer exit code calculated by the reporter.
 
     """
+    from contextlib import suppress
+    from os import fsdecode, scandir, stat
+
     files = list(files)
     if not files:
         return 0
     k, j, t, n, o = [0] * 5, [], 0, len(files), files.pop
     u, e, _ = j.extend, j.pop, lambda v: lambda _, k=k: k.__setitem__(v, k[v] + 1)
     verbosity, recurse_into = (type(x).__index__(x) for x in (verbosity, recurse_into))
-    # ruff: disable[magic-value-comparison]
     if verbosity > 4:
         b = ['']
         f = b.append
@@ -149,7 +143,7 @@ def check(
         v = ra = None
         x = aa = lambda _: None
     if verbosity > 2:
-        z, w = [''], ['']
+        z, w = [''], []
         i = z.append, w.append
     else:
         z = w = None
@@ -159,11 +153,10 @@ def check(
         g = r.append
     else:
         r, g = None, _(3)
-    # ruff: enable[magic-value-comparison]
     zp, tr, rr, z7, ar, lh, ac = map(recurse_into.__and__, constants.ARCHIVE_FORMATS)
     an = bool(recurse_into)
     if an:
-        from . import archives as av
+        from check_empty import archives as av
     md = 'a' if clear else 'r'
     if TYPE_CHECKING:
         import tarfile as tr
@@ -208,20 +201,19 @@ def check(
             else:
                 f(a)
 
-        def v(m: ModuleType, e: str) -> bool:
+        def v(f: Callable[[str], Any], e: type[BaseException]) -> bool:
             nonlocal d
-            with suppress(getattr(m, e)):
-                d = m.open(a)
+            with suppress(e):
+                d = f(a)
                 return True
             return False
 
-        if tr and v(tr, 'TarError'):
+        if tr and v(tr.open, tr.TarError):
             aa(a)
             for r in d.getmembers():
                 a, s = q = r.name, r.size
                 e()
-            if clear:
-                av.purge_tar(d)
+            av.purge_tar(d) if clear else d.close()
         elif zp and zp.is_zipfile(a):
             with zp.ZipFile(a, md) as d:
                 aa(a)
@@ -248,14 +240,14 @@ def check(
                 for r in d.infolist():
                     a, s = q = r.filename, r.file_size
                     w()
-        elif ar and v(ar, 'ArchiveFormatError'):
+        elif ar and v(ar.Archive, ar.ArchiveFormatError):
             aa(a)
             for r in d.infolist():
                 a, s = q = r.name, r.size
                 e()
             if clear:
                 av.purge_ar(d, ar.HEADER_GNU)
-        elif ac and v(ac, 'AceError'):
+        elif ac and v(ac.open, ac.AceError):
             aa(a)
             for r in filter(ac.AceMember.is_reg, d):
                 a, s = q = r.filename, r.size
@@ -278,24 +270,25 @@ def check(
         try:
             return an and ha(a)
         except Exception as e:  # ruff: ignore[blind-except]
-            i[1](str(e))
+            i[1](e)
             return True
 
     while files:
         a, q = o(), None
         m = isinstance(a, int)
         if not m:
-            a = os.fsdecode(a)
+            a = fsdecode(a)
         with Handler(*i, a) as h:
-            q = os.stat(a)  # ruff: ignore[os-stat]
+            q = stat(a)  # ruff: ignore[os-stat]
         if q is None:
             continue
         c = h.e
         if q.st_mode & constants.TYPE_MASK == constants.S_IFDIR:
             if m:
                 raise constants.DIRFD_UNSUPPORTED
-            x(c)
-            u(os.scandir(c))
+            with h:
+                u(scandir(c))
+                x(c)
             continue
         if isinstance(a, str) and hb(a):
             continue
@@ -312,8 +305,9 @@ def check(
         m = e()
         a = m.path
         if m.is_dir():
-            x(a)
-            u(os.scandir(a))
+            with Handler(*i, a):
+                u(scandir(a))
+                x(a)
             continue
         if hb(a):
             continue
@@ -326,8 +320,7 @@ def check(
         t += s
         if clear:
             Handler(*i, a).o()
-    del j
-    x, d = k[1] if z is None else len(z) - 1, k[2] if w is None else len(w) - 1
+    x, d = k[1] if z is None else len(z) - 1, k[2] if w is None else len(w)
     y, p = k[3] if r is None else len(r), k[0] if b is None else len(b) - 1
     reporter.report(z, w, v, b, r, x, y, d, p, n, t, verbosity, clear)
     reporter.reset_out()

{check_empty-2.0.0 → check_empty-3.0.1}/check_empty/__main__.py

@@ -4,9 +4,6 @@ from __future__ import annotations
 
 import check_empty as c
 
-TYPE_CHECKING = False
-if TYPE_CHECKING:
-    from collections.abc import Iterable
 __all__ = ('main',)
 _p = __import__('argparse').ArgumentParser(
     'check-empty',
@@ -43,6 +40,9 @@ f('-a', '--ar', action='store_true', help='recurse into .a, .ar and .lib archive
 f('-7', '--7z', action='store_true', dest='z7', help='recurse into .7z archives')
 f('-l', '--lzh', action='store_true', help='recurse into .lzh and .lha archives')
 f('-A', '--ace', action='store_true', help='recurse into .ace archives')
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Iterable
 
 
 def _r():
@@ -68,15 +68,16 @@ def main(argv: Iterable[str] | None = None) -> int:
         # ruff: ignore[open-file-with-context-handler]
         c.default_reporter.to(open(o, 'w', encoding='utf-8'))
     m = c.constants
-    r = m.RecurseInto.NONE
-    for a in m.ARCHIVE_FORMATS:
-        if getattr(n, a._name_.lower()):
-            r |= a
+    r = m.RecurseInto
     return c.check(
         n.filenames,
         clear=n.clear,
         may_not_exist=n.may_not_exist,
-        recurse_into=r,
+        recurse_into=__import__('functools').reduce(
+            r.__or__,
+            filter(lambda a: getattr(n, a.name.lower()), m.ARCHIVE_FORMATS),
+            r.NONE,
+        ),
         verbosity=2 + n.verbose - n.quiet,
     )
 

{check_empty-2.0.0 → check_empty-3.0.1}/check_empty/archives.py

@@ -3,23 +3,13 @@
 from __future__ import annotations
 
 import os
-from itertools import filterfalse
-from operator import attrgetter
 from tempfile import NamedTemporaryFile
 
-TYPE_CHECKING = False
-if TYPE_CHECKING:
-    import tarfile
-    import zipfile
-    from collections.abc import Callable, Iterable
-    from typing import Final, Literal
-
-    import arpy
-    import py7zr
 __all__ = (
     'AR_FS',
     'AR_MAG',
     'AR_NAME_SIZE',
+    'AR_SKIP',
     'clear_file_in_zip',
     'purge_7z',
     'purge_ar',
@@ -27,13 +17,26 @@ __all__ = (
 )
 _ = __import__('io').BytesIO()
 AR_FS: Final = b'%-16b0           0     0     100644  %-10d`\n%b'
+"""A C-style format string used to create file headers and bodies in ar archives."""
 AR_MAG: Final = b'!<arch>\n'
+"""The magic number for ar archives."""
 AR_NAME_SIZE: Final = 16
+"""The maximum length of a file name in an ar archive before special handling."""
 AR_SKIP: Final[
     frozenset[
         Literal[b'/', b'//', b'/SYM64/', b'__.SYMDEF', b'__.SYMDEF SORTED'] | None
     ]
 ] = frozenset((b'/', b'//', b'/SYM64/', b'__.SYMDEF', b'__.SYMDEF SORTED', None))
+"""The file names to skip when clearing files in an ar archive."""
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    import tarfile
+    import zipfile
+    from collections.abc import Callable, Iterable
+    from typing import Final, Literal
+
+    import py7zr
+    from arpy import Archive
 
 
 def clear_file_in_zip(z: zipfile.ZipFile, i: zipfile.ZipInfo) -> None:
@@ -71,7 +74,7 @@ def purge_tar(t: tarfile.TarFile) -> None:
     os.replace(p.name, x)
 
 
-def purge_ar(a: arpy.Archive, g: int) -> None:
+def purge_ar(a: Archive, g: int) -> None:
     """Clear the contents of each file in a .a, .ar or .lib archive."""
     a.read_all_headers()
     i, n = a.headers, a.file.name
@@ -83,7 +86,9 @@ def purge_ar(a: arpy.Archive, g: int) -> None:
     with NamedTemporaryFile(suffix='.a', delete=False) as f:
         w = f.write
         w(AR_MAG)
-        q = filterfalse(AR_SKIP.__contains__, map(attrgetter('name'), i))
+        q = __import__('itertools').filterfalse(
+            AR_SKIP.__contains__, map(__import__('operator').attrgetter('name'), i)
+        )
         _purge_ar_gnu(tuple(q), w) if i[0].type == g else _purge_ar_bsd(q, w)
     os.replace(f.name, n)
 

{check_empty-2.0.0 → check_empty-3.0.1}/check_empty/constants.py

@@ -4,9 +4,6 @@ from __future__ import annotations
 
 import os
 
-TYPE_CHECKING = False
-if TYPE_CHECKING:
-    from typing import Final
 __all__ = (
     'DIRFD_UNSUPPORTED',
     'ENOENT',
@@ -15,8 +12,11 @@ __all__ = (
     'TYPE_MASK',
     'RecurseInto',
 )
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Final
 TYPE_MASK: Final = 0xF000
-"""This mask extracts the type of a file from its mode bits from :func:`os.stat`."""
+"""The mask that extracts the type of a file from its mode bits from :func:`os.stat`."""
 S_IFDIR: Final = 0x4000
 """Equal to :data:`stat.S_IFDIR`."""
 ENOENT: Final = 2
@@ -58,7 +58,7 @@ class RecurseInto(__import__('enum').IntFlag):
     """Recurse into all archive types."""
 
 
-ARCHIVE_FORMATS: Final = tuple(
+ARCHIVE_FORMATS: Final[tuple[RecurseInto, ...]] = tuple(
     filter(lambda x: x > 0 == x & (x - 1), RecurseInto)
     if __import__('sys').version_info < (3, 11)
     else RecurseInto

{check_empty-2.0.0 → check_empty-3.0.1}/check_empty/reporter/__init__.py

@@ -5,19 +5,18 @@ from __future__ import annotations
 import itertools as i
 import sys as s
 
-from . import abc
-
-TYPE_CHECKING = False
-if TYPE_CHECKING:
-    from typing import IO
+from check_empty.reporter import abcdef, dct as dct
 
 __all__ = ('DelayedReporter', 'Reporter')
+TYPE_CHECKING = False
 
 
-class Reporter(abc.ReporterABC):
+class Reporter(abcdef.ReporterABC):
     """Concrete and default reporter implementation that prints output to a stream."""
 
     if TYPE_CHECKING:
+        from typing import IO
+
         o: IO[str] | None
 
         def to(self, out: IO[str] | None = None) -> IO[str] | None:
@@ -35,7 +34,7 @@ class Reporter(abc.ReporterABC):
     def report(  # ruff: ignore[too-many-arguments, too-many-positional-arguments]
         self,
         z: list[str] | None,
-        w: list[str] | None,
+        w: list[OSError] | None,
         a: list[str] | None,
         b: list[str] | None,
         r: list[tuple[str, int]] | None,
@@ -68,7 +67,7 @@ class Reporter(abc.ReporterABC):
             else '\nAll files were found'
         )
         if w is not None:
-            q('\nError: '.join(w))
+            q('\nError: '.join(i.chain(('',), map(str, w))))
         if d:
             q(f'\n{d} I/O error{"s" if d > 1 else ""} encountered')
         if b is not None:
@@ -93,5 +92,8 @@ class Reporter(abc.ReporterABC):
             q.close()
 
 
-class DelayedReporter(abc.DelayedReporterMixin, Reporter):
+class DelayedReporter(abcdef.DelayedReporterMixin, Reporter):
     """The delayed version of the default reporter."""
+
+
+del TYPE_CHECKING

check_empty-2.0.0/check_empty/reporter/abc.py → check_empty-3.0.1/check_empty/reporter/abcdef.py

@@ -1,17 +1,16 @@
-"""Abstract base classes for reporters."""
+"""Abstract base classes definitions ("abcdef") for reporters."""
 
 from __future__ import annotations
 
 import abc as a
 
-from .exceptions import NoReport
+from check_empty.reporter.exceptions import NoReport
 
+__all__ = ('DelayedReporterMixin', 'ReporterABC')
 TYPE_CHECKING = False
 if TYPE_CHECKING:
     from typing import Any
 
-__all__ = ('DelayedReporterMixin', 'ReporterABC')
-
 
 class ReporterABC(metaclass=a.ABCMeta):
     """Abstract base class for all reporters accepted by :func:`~check_empty.check`."""
@@ -23,7 +22,7 @@ class ReporterABC(metaclass=a.ABCMeta):
     def report(  # ruff: ignore[too-many-arguments, too-many-positional-arguments]
         self,
         z: list[str] | None,
-        w: list[str] | None,
+        w: list[OSError] | None,
         a: list[str] | None,
         b: list[str] | None,
         r: list[tuple[str, int]] | None,
@@ -41,7 +40,7 @@ class ReporterABC(metaclass=a.ABCMeta):
 
         Args:
             z: list of paths to files that were not found.
-            w: list of error messages for files that could not be processed.
+            w: list of I/O errors when processing non-missing files.
             a: list of directories that were recursed into.
             b: list of empty file paths.
             r: list of 2-tuples representing non-empty files and their sizes.
@@ -127,3 +126,6 @@ class DelayedReporterMixin(ReporterABC):
         if a is None:
             raise NoReport(self)
         super().report(*a)
+
+
+del TYPE_CHECKING

check_empty-2.0.0/check_empty/reporter/dict.py → check_empty-3.0.1/check_empty/reporter/dct.py

@@ -4,16 +4,15 @@ from __future__ import annotations
 
 import itertools as i
 
-from . import exceptions as _
-from .abc import ReporterABC
+from check_empty.reporter import exceptions as _
+from check_empty.reporter.abcdef import ReporterABC
 
+__all__ = ('DictReporter', 'SelfReporter')
 TYPE_CHECKING = False
 if TYPE_CHECKING:
     from collections.abc import Iterable, MutableMapping
     from typing import Any, Final
 
-__all__ = ('DictReporter', 'SelfReporter')
-
 
 class DictReporter(ReporterABC):
     """Dump the metrics into a dictionary-like object."""
@@ -63,7 +62,7 @@ class DictReporter(ReporterABC):
                 The previous output mapping, or ``None`` if no redirection is in effect.
             """
 
-    def __init__(self, keys: Iterable[str | None] | None = None) -> None:
+    def __init__(self, keys: Iterable[str | None] | None = None):
         """Initialize the reporter.
 
         Args:
@@ -139,3 +138,6 @@ class SelfReporter(DictReporter):
             This is only implemented at type-check time because the exact attributes
             and their types are not statically known.
             """
+
+
+del TYPE_CHECKING

{check_empty-2.0.0 → check_empty-3.0.1}/check_empty/reporter/exceptions.py

@@ -2,13 +2,6 @@
 
 from __future__ import annotations
 
-TYPE_CHECKING = False
-if TYPE_CHECKING:
-    from typing import ClassVar
-
-    from .abc import DelayedReporterMixin, ReporterABC
-    from .dict import DictReporter
-
 __all__ = (
     'IncorrectKeynames',
     'IncorrectKeynamesLength',
@@ -17,6 +10,12 @@ __all__ = (
     'NoReport',
     'ReporterError',
 )
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import ClassVar
+
+    from check_empty.reporter.abcdef import DelayedReporterMixin, ReporterABC
+    from check_empty.reporter.dct import DictReporter
 
 
 class ReporterError(Exception):
@@ -27,7 +26,7 @@ class ReporterError(Exception):
     message: ClassVar[str]
     """The message of the exception."""
 
-    def __init__(self, reporter: ReporterABC) -> None:
+    def __init__(self, reporter: ReporterABC):
         """Initialize the exception.
 
         Args:
@@ -46,7 +45,7 @@ class NoReport(ReporterError):
 
 
 class IncorrectKeynames(ReporterError):
-    """A :class:`check_empty.reporter.dict.DictReporter` got invalid ``keys``."""
+    """A :class:`check_empty.reporter.dct.DictReporter` got invalid ``keys``."""
 
     reporter: DictReporter
     """The reporter concerned."""
@@ -65,6 +64,11 @@ class IncorrectKeynamesType(IncorrectKeynames):
 
 
 class NoOutputMapping(ReporterError):
-    """A :class:`check_empty.reporter.dict.DictReporter` had no output mapping."""
+    """A :class:`check_empty.reporter.dct.DictReporter` had no output mapping."""
 
+    reporter: DictReporter
+    """The reporter concerned."""
     message = 'no mapping to output to'
+
+
+del TYPE_CHECKING

{check_empty-2.0.0 → check_empty-3.0.1}/pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["uv_build>=0.12.18"]
+requires = ["uv_build>=0.12.19"]
 build-backend = "uv_build"
 
 [dependency-groups]
@@ -55,7 +55,7 @@ license-files = [
 name = "check-empty"
 readme = "README.md"
 requires-python = ">=3.10"
-version = "2.0.0"
+version = "3.0.1"
 
 [[project.authors]]
 name = "Jonathan Dung"
@@ -68,7 +68,7 @@ email = "jonathandung@yahoo.com"
 [project.optional-dependencies]
 7z = ["py7zr==1.1.3"]
 ace = ["acefile==0.6.14"]
-all = ["check-empty[7z,ace,ar,lzh,rar]==2.0.0"]
+all = ["check-empty[7z,ace,ar,lzh,rar]==3.0.1"]
 ar = ["arpy==2.4.0"]
 lzh = ["lhafile==0.3.1"]
 rar = ["rarfile==4.5"]
@@ -77,7 +77,7 @@ rar = ["rarfile==4.5"]
 check-empty = "check_empty.__main__:main"
 
 [tool.ruff]
-required-version = ">=0.16.8"
+required-version = ">=0.16.9"
 target-version = "py310"
 
 [tool.ruff.analyze]
@@ -95,17 +95,12 @@ ignore = [
     "builtin-open",
     "complex-structure",
     "error-suffix-on-exception-name",
-    "implicit-namespace-package",
     "import-outside-top-level",
     "incorrect-blank-line-before-class",
     "meta-class-abc-meta",
     "multi-line-summary-second-line",
     "non-empty-init-module",
     "os-replace",
-    "too-many-branches",
-    "too-many-locals",
-    "too-many-statements",
-    "unnecessary-dunder-call",
 ]
 preview = true
 select = ["ALL"]
@@ -115,6 +110,9 @@ docstring-quotes = "double"
 inline-quotes = "single"
 multiline-quotes = "double"
 
+[tool.ruff.lint.flake8-annotations]
+mypy-init-return = true
+
 [tool.ruff.lint.isort]
 combine-as-imports = true
 
@@ -123,20 +121,18 @@ combine-as-imports = true
     "D",
     "missing-type-args",
 ]
+"!check_empty/__init__.py" = ["missing-copyright-notice"]
+"check_empty/__init__.py" = ["PLR"]
+"check_empty/__main__.py" = ["missing-return-type-private-function"]
+"docs/source/conf.py" = ["implicit-namespace-package"]
 "test_check_empty.py" = [
     "ANN",
     "D",
 ]
-"!check_empty/__init__.py" = ["missing-copyright-notice"]
-"check_empty/__main__.py" = ["missing-return-type-private-function"]
 
 [tool.ruff.lint.pydocstyle]
 convention = "google"
 
-[tool.ruff.lint.pylint]
-max-args = 6
-max-nested-blocks = 6
-
 [tool.ty.analysis]
 respect-type-ignore-comments = false
 
@@ -157,7 +153,7 @@ redundant-condition = "ignore"
 unsound-assignment = "ignore"
 
 [tool.uv]
-required-version = ">=0.12.18"
+required-version = ">=0.12.19"
 
 [tool.uv.build-backend]
 module-name = "check_empty"

{check_empty-2.0.0 → check_empty-3.0.1}/pyproject.toml.orig

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["uv_build>=0.12.18"]
+requires = ["uv_build>=0.12.19"]
 build-backend = "uv_build"
 
 [dependency-groups]
@@ -16,12 +16,12 @@ maintainers = [{name = "Jonathan Dung", email = "jonathandung@yahoo.com"}]
 name = "check-empty"
 readme = "README.md"
 requires-python = ">=3.10"
-version = "2.0.0"
+version = "3.0.1"
 
 [project.optional-dependencies]
 "7z" = ["py7zr==1.1.3"]
 ace = ["acefile==0.6.14"]
-all = ["check-empty[7z,ace,ar,lzh,rar]==2.0.0"]
+all = ["check-empty[7z,ace,ar,lzh,rar]==3.0.1"]
 ar = ["arpy==2.4.0"]
 lzh = ["lhafile==0.3.1"]
 rar = ["rarfile==4.5"]
@@ -30,7 +30,7 @@ rar = ["rarfile==4.5"]
 check-empty = "check_empty.__main__:main"
 
 [tool.ruff]
-required-version = ">=0.16.8"
+required-version = ">=0.16.9"
 target-version = "py310"
 
 [tool.ruff.analyze]
@@ -40,7 +40,7 @@ type-checking-imports = false
 quote-style = "single"
 
 [tool.ruff.lint]
-ignore = ["COM", "FBT", "PT", "bad-quotes-inline-string", "builtin-open", "complex-structure", "error-suffix-on-exception-name", "implicit-namespace-package", "import-outside-top-level", "incorrect-blank-line-before-class", "meta-class-abc-meta", "multi-line-summary-second-line", "non-empty-init-module", "os-replace", "too-many-branches", "too-many-locals", "too-many-statements", "unnecessary-dunder-call"]
+ignore = ["COM", "FBT", "PT", "bad-quotes-inline-string", "builtin-open", "complex-structure", "error-suffix-on-exception-name", "import-outside-top-level", "incorrect-blank-line-before-class", "meta-class-abc-meta", "multi-line-summary-second-line", "non-empty-init-module", "os-replace"]
 preview = true
 select = ["ALL"]
 
@@ -49,22 +49,23 @@ docstring-quotes = "double"
 inline-quotes = "single"
 multiline-quotes = "double"
 
+[tool.ruff.lint.flake8-annotations]
+mypy-init-return = true
+
 [tool.ruff.lint.isort]
 combine-as-imports = true
 
 [tool.ruff.lint.per-file-ignores]
 "action.py" = ["D", "missing-type-args"]
-"test_check_empty.py" = ["ANN", "D"]
 "!check_empty/__init__.py" = ["missing-copyright-notice"]
+"check_empty/__init__.py" = ["PLR"]
 "check_empty/__main__.py" = ["missing-return-type-private-function"]
+"docs/source/conf.py" = ["implicit-namespace-package"]
+"test_check_empty.py" = ["ANN", "D"]
 
 [tool.ruff.lint.pydocstyle]
 convention = "google"
 
-[tool.ruff.lint.pylint]
-max-args = 6
-max-nested-blocks = 6
-
 [tool.ty.analysis]
 respect-type-ignore-comments = false
 
@@ -81,7 +82,7 @@ include = ["check_empty/__init__.py"]
 rules = {possibly-unresolved-reference = "ignore", redundant-condition = "ignore", unsound-assignment = "ignore"}
 
 [tool.uv]
-required-version = ">=0.12.18"
+required-version = ">=0.12.19"
 
 [tool.uv.build-backend]
 module-name = "check_empty"