filefilter 0.1.1__py3-none-any.whl

filefilter/__init__.py

@@ -0,0 +1,20 @@
+__version__ = "0.1.1"
+
+from .config import Config
+from .matcher import collect_files
+import json
+
+
+def filter_paths(config_json: str, resolve_base: str = 'cwd'):
+    """
+    Given a JSON string defining 'root_dir' and 'filters',
+    returns a list of file paths matching the rules.
+
+    Parameters:
+      - config_json: JSON string with 'root_dir' and 'filters'
+      - resolve_base: 'cwd' (default) to resolve root_dir relative to current working directory,
+                      'script' to resolve relative to this library's script directory.
+    """
+    data = json.loads(config_json)
+    cfg = Config(data, resolve_base=resolve_base)
+    return collect_files(cfg)

filefilter/config.py

@@ -0,0 +1,93 @@
+import os
+import re
+from fnmatch import fnmatch
+
+
+def normalize_path(p: str) -> str:
+    """
+    Collapse backslashes and multiple slashes to '/', trim whitespace.
+    """
+    p = re.sub(r"[\\/]+", "/", p)
+    return p.strip()
+
+
+def parse_dir_patterns(patterns):
+    """
+    Parse directory glob patterns into:
+      - root-only patterns (first segment match)
+      - anywhere patterns (any ancestor segment)
+    Strips '**/' prefix and '/**' suffix, handles leading '/' for root-only.
+    """
+    root_patts = []
+    any_patts = []
+    for raw in patterns:
+        p = normalize_path(raw)
+        low = p.lower()
+        anchored = p.startswith("/")
+        # remove recursive markers for internal logic
+        low = re.sub(r"^\*\*/", "", low)
+        low = re.sub(r"/\*\*$", "", low)
+        low = low.rstrip("/")
+        if not low:
+            continue
+        if anchored:
+            root_patts.append(low)
+        else:
+            any_patts.append(low)
+    return root_patts, any_patts
+
+
+def parse_file_patterns(patterns):
+    """
+    Normalize and lowercase filename patterns (wildcards '*' only).
+    """
+    return [normalize_path(p).lower() for p in patterns]
+
+
+def parse_extensions(patterns):
+    """
+    Normalize and lowercase extensions, ensure leading '.'.
+    """
+    out = []
+    for e in patterns:
+        norm = normalize_path(e).lower().lstrip('.')
+        out.append('.' + norm)
+    return out
+
+
+class Config:
+    def __init__(self, data: dict, resolve_base: str = ''):
+        """
+        Initialize configuration from a dict.
+
+        Parameters:
+          - data: parsed JSON dict containing 'root_dir' and 'filters'
+          - resolve_base: 'cwd' or 'script'
+        """
+        raw_root = normalize_path(data['root_dir'])
+        # Resolve absolute or relative root_dir
+        if os.path.isabs(raw_root):
+            root = raw_root
+        else:
+            if resolve_base == '':
+                base_dir = os.getcwd()
+                
+            else:
+                base_dir = normalize_path(resolve_base)
+            root = os.path.join(base_dir, raw_root)
+        self.root_dir = os.path.normpath(root)
+
+        inc = data['filters']['include']
+        exc = data['filters']['exclude']
+
+        # Include/Exclude directory patterns
+        self.inc_dirs_root, self.inc_dirs_any = parse_dir_patterns(inc.get('dirs', []))
+        self.exc_dirs_root, self.exc_dirs_any = parse_dir_patterns(exc.get('dirs', []))
+
+        # Include/Exclude filename patterns
+        self.include_files = parse_file_patterns(inc.get('files', []))
+        self.exclude_files = parse_file_patterns(exc.get('files', []))
+
+        # Include/Exclude extensions
+        self.inc_exts = parse_extensions(inc.get('extensions', []))
+        self.exc_exts = parse_extensions(exc.get('extensions', []))

filefilter/matcher.py

@@ -0,0 +1,82 @@
+import os
+from fnmatch import fnmatch
+from .config import normalize_path, Config
+
+
+def should_include(full_path: str, cfg: Config) -> bool:
+    """
+    Determine if a file should be included based on the config rules.
+    """
+    rel = os.path.relpath(full_path, cfg.root_dir)
+    rel = normalize_path(rel).lower()
+    segments = rel.split('/')
+    name = segments[-1]
+    ancestors = segments[:-1]
+    _, ext = os.path.splitext(name)
+
+    # 1) Include-files override
+    for patt in cfg.include_files:
+        if fnmatch(name, patt):
+            return True
+
+    # 2) Exclude by extension
+    if ext in cfg.exc_exts:
+        return False
+
+    # 3) Exclude by filename
+    for patt in cfg.exclude_files:
+        if fnmatch(name, patt):
+            return False
+
+    # 4) Exclude by directory (root-only)
+    if ancestors and cfg.exc_dirs_root:
+        first = ancestors[0]
+        for patt in cfg.exc_dirs_root:
+            if fnmatch(first, patt):
+                return False
+    # Exclude by directory (anywhere)
+    for seg in ancestors:
+        for patt in cfg.exc_dirs_any:
+            if fnmatch(seg, patt):
+                return False
+
+    # 5) Include by directory if patterns exist
+    if cfg.inc_dirs_root or cfg.inc_dirs_any:
+        ok = False
+        if ancestors and cfg.inc_dirs_root:
+            first = ancestors[0]
+            for patt in cfg.inc_dirs_root:
+                if fnmatch(first, patt):
+                    ok = True
+                    break
+        if not ok and cfg.inc_dirs_any:
+            for seg in ancestors:
+                for patt in cfg.inc_dirs_any:
+                    if fnmatch(seg, patt):
+                        ok = True
+                        break
+                if ok:
+                    break
+        if not ok:
+            return False
+
+    # 6) Include by extension
+    if cfg.inc_exts and ext not in cfg.inc_exts:
+        return False
+
+    return True
+
+
+def collect_files(cfg: Config) -> list:
+    """
+    Walk root_dir and collect files passing should_include.
+    """
+    matches = []
+    for root, _, files in os.walk(cfg.root_dir, followlinks=False):
+        for fn in files:
+            full = os.path.join(root, fn)
+            if os.path.islink(full):
+                continue
+            if should_include(full, cfg):
+                matches.append(os.path.normpath(full))
+    return matches

filefilter-0.1.1.dist-info/METADATA

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: filefilter
+Version: 0.1.1
+Summary: Filter files in a directory tree based on configurable glob rules.
+Author-email: "Ioannis D (devcoons)" <support@devcoons.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/devcoons/filefilter
+Project-URL: Issues, https://github.com/devcoons/filefilter/issues
+Keywords: filefilter
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+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
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pip-tools; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Dynamic: license-file
+
+# filefilter
+
+Filter files in a directory tree using include/exclude rules with globs.
+
+## Features
+
+- Include/exclude by directory patterns (`**`, `*`, explicit root `/`).
+- Include/exclude by filename patterns (`*`, no `?`).
+- Include/exclude by file extension.
+- Config driven via JSON.
+
+## Installation
+
+```bash
+pip install filefilter

filefilter-0.1.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+filefilter/__init__.py,sha256=BBMGl2EO42zyAEwBrzUjC9yTPxzcJAyCdFUV55gs4is,687
+filefilter/config.py,sha256=m6iArbwjYAarWV5N7xpGxVvWlBy6bzuctL1hRRclmsU,2899
+filefilter/matcher.py,sha256=3rWd-fyldrj9KgWMWmkcWbg1hb3kg4jIvXg3Tj1asyY,2443
+filefilter-0.1.1.dist-info/licenses/LICENSE,sha256=soCkgLf6GpZWygVKSaEqRTpCVLep_xs-V21hMwaVD50,1097
+filefilter-0.1.1.dist-info/METADATA,sha256=k3gZmIN23yr04eST-YyvzsqeRmODOg1ErXyO9_Csmko,1588
+filefilter-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+filefilter-0.1.1.dist-info/top_level.txt,sha256=DHSDZ8eUvqz4i1YKV4IwONi3MO9xxf5OGKiTsw1FH_I,11
+filefilter-0.1.1.dist-info/RECORD,,

filefilter-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

filefilter-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ioannis D. (devcoons)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

filefilter-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+filefilter