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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: check-empty
-Version: 1.2.3
+Version: 2.0.0
 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
@@ -15,9 +15,6 @@ Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -28,13 +25,27 @@ Classifier: Programming Language :: Python :: 3.16
 Classifier: Programming Language :: Python :: Free Threading :: 3 - Stable
 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: arpy==2.4.0 ; extra == 'ar'
+Requires-Dist: lhafile==0.3.1 ; extra == 'lzh'
+Requires-Dist: rarfile==4.5 ; extra == 'rar'
 Maintainer: Jonathan Dung
 Maintainer-email: Jonathan Dung <jonathandung@yahoo.com>
-Requires-Python: >=3.6
+Requires-Python: >=3.10
+Provides-Extra: 7z
+Provides-Extra: ace
+Provides-Extra: all
+Provides-Extra: ar
+Provides-Extra: lzh
+Provides-Extra: rar
 Description-Content-Type: text/markdown
 
 # [check-empty](https://pypi.org/p/check-empty)
 
+[![#StandWithPalestine](https://raw.githubusercontent.com/TheBSD/StandWithPalestine/main/badges/StandWithPalestine.svg)](https://github.com/TheBSD/StandWithPalestine/blob/main/docs/README.md)
+
 A simple, dependency-free [pre-commit](https://pre-commit.com) /
 [prek](https://prek.j178.dev) hook, CLI, library and
 [GitHub Action](https://github.com/marketplace/actions/check-empty-files) conglomerate
@@ -46,8 +57,7 @@ specified.
 
 ## Prerequisites
 
-Supports CPython 3.6+, PyPy 7.0+, GraalPy 19.0+ out-of-the-box, and most likely every
-Python 3.6 runtime you can think of. This is the only requirement to use this tool.
+Supports every Python 3.10 runtime. There are no other requirements.
 
 ## Quickstart
 
@@ -115,7 +125,7 @@ As a pre-commit hook:
 # .pre-commit-config.yaml
 repos:
 - repo: https://github.com/jonathandung/check-empty
-  rev: v1.2.3 # repository version
+  rev: v2.0.0 # repository version
   hooks:
     - id: check-empty # the hook
       args: # example list of arguments
@@ -131,7 +141,7 @@ equivalent in `prek.toml` format:
 ```toml
 [[repos]]
 repo = "https://github.com/jonathandung/check-empty"
-rev = "v1.2.3"
+rev = "v2.0.0"
 
 [[repos.hooks]]
 id = "check-empty"
@@ -155,7 +165,7 @@ or (TOML 1.1+):
 # using multiline inline tables
 [[repos]]
 repo = "https://github.com/jonathandung/check-empty"
-rev = "v1.2.3"
+rev = "v2.0.0"
 hooks = [{
   id = "check-empty",
   args = ["-Q"],
@@ -175,13 +185,11 @@ As a GitHub Actions workflow step:
 
 ```yaml
 steps:
-- uses: jonathandung/check-empty@v1.2.3 # the latest version on the GitHub Actions
+- uses: jonathandung/check-empty@v2.0.0 # 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:
     python-version: '3.14' # run the script on the latest stable Python version
-    # Python down to 3.6 is supported but not recommended due to end-of-life
-    verbosity: 1
     filenames: |
       src/mylib/py.typed
       docs/.nojekyll
@@ -194,26 +202,34 @@ steps:
 
 Also see the GitHub Action
 [manifest](https://github.com/jonathandung/check-empty/blob/main/action.yaml), which
-contains the accepted action inputs and descriptions thereof.
+contains the accepted action inputs, action outputs produced and their respective
+descriptions.
 
 ## Notes
 
-1. If your file name starts with a hyphen, to avoid having it misinterpreted as a flag,
-use a command of the form `check-empty -- -this_is_actually_a_file.txt`.
+1. If your file name starts with a hyphen, use a command of the form
+`check-empty -- -this_is_actually_a_file.txt` to avoid having the filename
+misinterpreted as a flag.
 2. Forward slashes can be used even on Windows, so there is no need to escape anything.
 3. Glob patterns are supported on \*nix only. If on Windows, use a shell like Git Bash.
 4. To pass an
 [argfile](https://docs.python.org/3/library/argparse.html#fromfile-prefix-chars), use
 the `@` prefix, and escape files whose names actually start with `@` using the
 double-hyphen syntax.
-5. It may be unintuitive that a directory being "empty" means all its files are empty,
-but this project explicitly targets files, since version control systems track files
-rather than directories.
-6. The program does not recurse into archives, since identification of compressed
-archives would require reading the first few bytes of each file seen, which is
-error-prone and inefficient.
-
-## Additional Links
+5. It may be unintuitive that a directory or archive being "empty" means all its files
+are empty, but this project explicitly targets files, since version control systems
+track files rather than directories.
+6. The program can recurse into some archives if specified, but it requires certain
+libraries to be installed to do so for certain formats. .7z (corresponding to the `7z`
+extra) needs `py7zr`, .rar (the `rar` extra) needs `rarfile`, .lha / .lzh (the `lzh`
+extra) needs `lhafile`, .a / .ar / .lib (the `ar` extra) needs `arpy`, .ace (the `ace`
+extra) needs `acefile`. These may also slow down the checking significantly for large
+directories, since magic numbers must be read for every file and the I/O overhead
+accumulates. All the above extras are included in the `all` extra.
+7. Keep weird characters in your filenames to a minimum. They may become a problem in
+GitHub Actions usage.
+
+## Additional links
 
 - [API and CLI Reference](https://check-empty.readthedocs.io)
 - [Releases](https://github.com/jonathandung/check-empty/releases)
@@ -227,15 +243,15 @@ to read the
 and the
 [contributing guide](https://github.com/jonathandung/.github/blob/main/CONTRIBUTING.md).
 
-To build the docs locally (needs Python 3.12+), install with the `docs`
-[group](https://packaging.python.org/en/latest/specifications/dependency-groups),
-preferably into a virtual environment.
+To build the docs locally (needs Python 3.12+ because of Sphinx), install with the
+`docs` [group](https://packaging.python.org/en/latest/specifications/dependency-groups)
+using a package manager that supports it (e.g. pip 25.1+ or uv 0.4.27+), preferably
+into a virtual environment.
 
 Tests are run with:
 
 ```bash
-python -m test_check_empty # explicit; or
-python -m unittest discover # alternative
+python -m test_check_empty
 ```
 
 at the project root. `pytest` is not needed.

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

@@ -1,5 +1,7 @@
 # [check-empty](https://pypi.org/p/check-empty)
 
+[![#StandWithPalestine](https://raw.githubusercontent.com/TheBSD/StandWithPalestine/main/badges/StandWithPalestine.svg)](https://github.com/TheBSD/StandWithPalestine/blob/main/docs/README.md)
+
 A simple, dependency-free [pre-commit](https://pre-commit.com) /
 [prek](https://prek.j178.dev) hook, CLI, library and
 [GitHub Action](https://github.com/marketplace/actions/check-empty-files) conglomerate
@@ -11,8 +13,7 @@ specified.
 
 ## Prerequisites
 
-Supports CPython 3.6+, PyPy 7.0+, GraalPy 19.0+ out-of-the-box, and most likely every
-Python 3.6 runtime you can think of. This is the only requirement to use this tool.
+Supports every Python 3.10 runtime. There are no other requirements.
 
 ## Quickstart
 
@@ -80,7 +81,7 @@ As a pre-commit hook:
 # .pre-commit-config.yaml
 repos:
 - repo: https://github.com/jonathandung/check-empty
-  rev: v1.2.3 # repository version
+  rev: v2.0.0 # repository version
   hooks:
     - id: check-empty # the hook
       args: # example list of arguments
@@ -96,7 +97,7 @@ equivalent in `prek.toml` format:
 ```toml
 [[repos]]
 repo = "https://github.com/jonathandung/check-empty"
-rev = "v1.2.3"
+rev = "v2.0.0"
 
 [[repos.hooks]]
 id = "check-empty"
@@ -120,7 +121,7 @@ or (TOML 1.1+):
 # using multiline inline tables
 [[repos]]
 repo = "https://github.com/jonathandung/check-empty"
-rev = "v1.2.3"
+rev = "v2.0.0"
 hooks = [{
   id = "check-empty",
   args = ["-Q"],
@@ -140,13 +141,11 @@ As a GitHub Actions workflow step:
 
 ```yaml
 steps:
-- uses: jonathandung/check-empty@v1.2.3 # the latest version on the GitHub Actions
+- uses: jonathandung/check-empty@v2.0.0 # 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:
     python-version: '3.14' # run the script on the latest stable Python version
-    # Python down to 3.6 is supported but not recommended due to end-of-life
-    verbosity: 1
     filenames: |
       src/mylib/py.typed
       docs/.nojekyll
@@ -159,26 +158,34 @@ steps:
 
 Also see the GitHub Action
 [manifest](https://github.com/jonathandung/check-empty/blob/main/action.yaml), which
-contains the accepted action inputs and descriptions thereof.
+contains the accepted action inputs, action outputs produced and their respective
+descriptions.
 
 ## Notes
 
-1. If your file name starts with a hyphen, to avoid having it misinterpreted as a flag,
-use a command of the form `check-empty -- -this_is_actually_a_file.txt`.
+1. If your file name starts with a hyphen, use a command of the form
+`check-empty -- -this_is_actually_a_file.txt` to avoid having the filename
+misinterpreted as a flag.
 2. Forward slashes can be used even on Windows, so there is no need to escape anything.
 3. Glob patterns are supported on \*nix only. If on Windows, use a shell like Git Bash.
 4. To pass an
 [argfile](https://docs.python.org/3/library/argparse.html#fromfile-prefix-chars), use
 the `@` prefix, and escape files whose names actually start with `@` using the
 double-hyphen syntax.
-5. It may be unintuitive that a directory being "empty" means all its files are empty,
-but this project explicitly targets files, since version control systems track files
-rather than directories.
-6. The program does not recurse into archives, since identification of compressed
-archives would require reading the first few bytes of each file seen, which is
-error-prone and inefficient.
-
-## Additional Links
+5. It may be unintuitive that a directory or archive being "empty" means all its files
+are empty, but this project explicitly targets files, since version control systems
+track files rather than directories.
+6. The program can recurse into some archives if specified, but it requires certain
+libraries to be installed to do so for certain formats. .7z (corresponding to the `7z`
+extra) needs `py7zr`, .rar (the `rar` extra) needs `rarfile`, .lha / .lzh (the `lzh`
+extra) needs `lhafile`, .a / .ar / .lib (the `ar` extra) needs `arpy`, .ace (the `ace`
+extra) needs `acefile`. These may also slow down the checking significantly for large
+directories, since magic numbers must be read for every file and the I/O overhead
+accumulates. All the above extras are included in the `all` extra.
+7. Keep weird characters in your filenames to a minimum. They may become a problem in
+GitHub Actions usage.
+
+## Additional links
 
 - [API and CLI Reference](https://check-empty.readthedocs.io)
 - [Releases](https://github.com/jonathandung/check-empty/releases)
@@ -192,15 +199,15 @@ to read the
 and the
 [contributing guide](https://github.com/jonathandung/.github/blob/main/CONTRIBUTING.md).
 
-To build the docs locally (needs Python 3.12+), install with the `docs`
-[group](https://packaging.python.org/en/latest/specifications/dependency-groups),
-preferably into a virtual environment.
+To build the docs locally (needs Python 3.12+ because of Sphinx), install with the
+`docs` [group](https://packaging.python.org/en/latest/specifications/dependency-groups)
+using a package manager that supports it (e.g. pip 25.1+ or uv 0.4.27+), preferably
+into a virtual environment.
 
 Tests are run with:
 
 ```bash
-python -m test_check_empty # explicit; or
-python -m unittest discover # alternative
+python -m test_check_empty
 ```
 
 at the project root. `pytest` is not needed.

check_empty-2.0.0/check_empty/__init__.py

@@ -0,0 +1,334 @@
+# Copyright © 2026 Jonathan Dung. All rights reserved.
+# SPDX-License-Identifier: MIT
+"""Utility to check the emptiness of files.
+
+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
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable, Iterable
+    from types import ModuleType, 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."""
+
+    __slots__ = 'a', 'c', 'f', 'j', 'v'
+    a: int | str
+    """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]
+    """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``.
+    """
+    v: str | None
+    """The cached value of :attr:`e`."""
+
+    def __init__(self, *a: Any) -> None:  # ruff: ignore[any-type]
+        """Initialize the handler."""
+        self.j, self.f, self.a = a
+        self.v = None
+
+    def __enter__(self) -> Self:
+        """Enter the handler context.
+
+        Returns:
+            The handler itself.
+        """
+        self.c = False
+        return self
+
+    def o(self) -> None:
+        """Clear the file immediately."""
+        with self, open(self.a, 'wb'):
+            ...
+
+    @property
+    def e(self, s: str = 'invalid fd (negative): %d', t: str = 'fd: %d') -> str:  # ruff: ignore[property-with-parameters]
+        """The file path itself, or the file descriptor coerced to a string."""
+        r = self.v
+        if r is None:
+            a = self.a
+            self.v = r = (t, s)[a < 0] % a if isinstance(a, int) else a
+        return r
+
+    def __exit__(
+        self,
+        t: type[BaseException] | None,
+        v: BaseException | None,
+        _: TracebackType | None,
+    ) -> bool:
+        """Exit the handler context.
+
+        Returns:
+            Whether there was an exception that is to be suppressed.
+        """
+        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.c = True
+        return True
+
+
+def check(
+    files: Iterable[FileDescriptorOrPath],
+    *,
+    clear: bool = False,
+    may_not_exist: bool = False,
+    verbosity: SupportsIndex = 2,
+    recurse_into: SupportsIndex = constants.RecurseInto.NONE,
+    reporter: reporter.abc.ReporterABC = default_reporter,
+) -> int:
+    # ruff: ignore[docstring-missing-exception]
+    r"""Check the emptiness of files, recursing into directories if passed.
+
+    If using a custom reporter and you want to use all the information that can be
+    gathered during the check, remember to pass a ``verbosity`` greater than or equal
+    to 5, since some parameters to :meth:`~check_empty.reporter.Reporter.report` will
+    take values of ``None`` otherwise.
+
+    Args:
+        files: an iterable of file descriptors or paths representing the files and
+          directories to check; directory descriptors (\*nix) are not supported.
+        clear: if ``True``, clear the contents of non-empty files; directories, notably,
+          are not purged, but all files within should become empty.
+        may_not_exist: if ``True``, do not treat absent files or directories as errors.
+        verbosity: how much detail the program should print to stdout.
+        recurse_into: a bitwise or of flags indicating which types of archives to
+          recurse into; by default, all archives are treated as regular files.
+        reporter: The reporter to use for reporting the results. All output of this
+          function is produced by the reporter.
+
+    Returns:
+        The integer exit code calculated by the reporter.
+
+    """
+    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
+    else:
+        b, f = None, _(0)
+    if verbosity > 3:
+        v, ra = [''], ['']
+        x, aa = v.append, ra.append
+    else:
+        v = ra = None
+        x = aa = lambda _: None
+    if verbosity > 2:
+        z, w = [''], ['']
+        i = z.append, w.append
+    else:
+        z = w = None
+        i = _(1), _(2)
+    if verbosity > 1:
+        r = []
+        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
+    md = 'a' if clear else 'r'
+    if TYPE_CHECKING:
+        import tarfile as tr
+        import zipfile as zp
+
+        import acefile as ac
+        import arpy as ar
+        import lhafile as lh
+        import py7zr as z7
+        import rarfile as rr
+    else:
+        if tr:
+            import tarfile as tr
+        if zp:
+            import zipfile as zp
+        if ac:
+            import acefile as ac
+        if ar:
+            import arpy as ar
+        if lh:
+            import lhafile as lh
+        if z7:
+            import py7zr as z7
+        if rr:
+            import rarfile as rr
+
+    def ha(a: str) -> bool:
+
+        def c() -> None:
+            nonlocal t
+            g(q)
+            t += s
+
+        def e() -> None:
+            c() if s else f(a)
+
+        def w() -> None:
+            if s:
+                if clear:
+                    raise NotImplementedError(m)
+                c()
+            else:
+                f(a)
+
+        def v(m: ModuleType, e: str) -> bool:
+            nonlocal d
+            with suppress(getattr(m, e)):
+                d = m.open(a)
+                return True
+            return False
+
+        if tr and v(tr, 'TarError'):
+            aa(a)
+            for r in d.getmembers():
+                a, s = q = r.name, r.size
+                e()
+            if clear:
+                av.purge_tar(d)
+        elif zp and zp.is_zipfile(a):
+            with zp.ZipFile(a, md) as d:
+                aa(a)
+                for r in d.infolist():
+                    a, s = q = r.filename, r.file_size
+                    if s:
+                        c()
+                        if clear:
+                            av.clear_file_in_zip(d, r)
+                    else:
+                        f(a)
+        elif z7 and z7.is_7zfile(a):
+            with z7.SevenZipFile(a) as d:
+                aa(a)
+                for r in d.files:
+                    a, s = q = r.filename, r.origin.stat().st_size
+                    e()
+                if clear:
+                    av.purge_7z(d)
+        elif rr and rr.is_rarfile(a):
+            m = 'Cannot clear files in RAR archives'
+            with rr.RarFile(a) as d:
+                aa(a)
+                for r in d.infolist():
+                    a, s = q = r.filename, r.file_size
+                    w()
+        elif ar and v(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'):
+            aa(a)
+            for r in filter(ac.AceMember.is_reg, d):
+                a, s = q = r.filename, r.size
+                w()
+        elif lh:
+            try:
+                d = lh.LhaFile(a)
+            except (RuntimeError, lh.BadLhafile):
+                return False
+            m = 'Cannot clear files in LHA archives'
+            aa(a)
+            for r in d.filelist:
+                a, s = q = r.filename, r.file_size
+                w()
+        else:
+            return False
+        return True
+
+    def hb(a: str) -> bool:
+        try:
+            return an and ha(a)
+        except Exception as e:  # ruff: ignore[blind-except]
+            i[1](str(e))
+            return True
+
+    while files:
+        a, q = o(), None
+        m = isinstance(a, int)
+        if not m:
+            a = os.fsdecode(a)
+        with Handler(*i, a) as h:
+            q = os.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))
+            continue
+        if isinstance(a, str) and hb(a):
+            continue
+        s = q.st_size
+        if not s:
+            f(c)
+            continue
+        g((c, s))
+        t += s
+        if clear:
+            h.o()
+    del o, files
+    while j:
+        m = e()
+        a = m.path
+        if m.is_dir():
+            x(a)
+            u(os.scandir(a))
+            continue
+        if hb(a):
+            continue
+        n += 1
+        s = m.stat().st_size
+        if not s:
+            f(a)
+            continue
+        g((a, s))
+        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
+    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()
+    return reporter.calculate_result(*map(bool, (y, x and not may_not_exist, d)))

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

@@ -1,4 +1,4 @@
-"""Implementation of the main routine. Also exports the argument parser."""
+"""Implementation of the main routine."""
 
 from __future__ import annotations
 
@@ -33,6 +33,16 @@ f(
 f('-Q', '--quiet', action='count', default=0, help='decrease output verbosity')
 f('-V', '--verbose', action='count', default=0, help='increase output verbosity')
 f('-o', '--out', help='write output to this file instead of stdout')
+f = _p.add_argument_group(
+    'archive recursion', 'options for recursing into archives'
+).add_argument
+f('-z', '--zip', action='store_true', help='recurse into .zip archives')
+f('-t', '--tar', action='store_true', help='recurse into .tar archives')
+f('-r', '--rar', action='store_true', help='recurse into .rar archives')
+f('-a', '--ar', action='store_true', help='recurse into .a, .ar and .lib archives')
+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')
 
 
 def _r():
@@ -57,10 +67,16 @@ def main(argv: Iterable[str] | None = None) -> int:
     if o is not None:
         # 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
     return c.check(
         n.filenames,
         clear=n.clear,
         may_not_exist=n.may_not_exist,
+        recurse_into=r,
         verbosity=2 + n.verbose - n.quiet,
     )