fileutils-dir 0.1.2__py3-none-any.whl

fileutils/__init__.py

@@ -0,0 +1,5 @@
+# fileutils/__init__.py
+
+from .files import in_dir
+
+__all__ = ["in_dir"]

fileutils/files.py

@@ -0,0 +1,72 @@
+from pathlib import Path
+from typing import Iterable
+from collections.abc import Iterable
+
+FILE_TYPES = {
+    "image": [".jpg", ".jpeg", ".png", ".webp", ".bmp", ".gif", ".tiff"],
+    "text": [".txt", ".md", ".rst", ".log"],
+    "pdf": [".pdf"],
+    "doc": [".doc", ".docx", ".odt"],
+    "sheet": [".xls", ".xlsx", ".ods", ".csv"],
+    "presentation": [".ppt", ".pptx", ".odp"],
+    "code": [
+        ".py", ".js", ".ts", ".java", ".c", ".cpp", ".h",
+        ".go", ".rs", ".rb", ".php", ".sh"
+    ],
+    "data": [".json", ".yaml", ".yml", ".xml", ".toml"],
+    "audio": [".mp3", ".wav", ".flac", ".ogg", ".aac", ".m4a"],
+    "video": [".mp4", ".mkv", ".avi", ".mov", ".webm"],
+    "archive": [".zip", ".tar", ".gz", ".bz2", ".7z", ".rar"],
+}
+
+
+def in_dir(
+    directories: Iterable[str] | None = None,
+    extensions: Iterable[str] | None = None,
+    types: Iterable[str] | None = None,
+) -> list[str]:
+    """
+    Return files from the given directories:\n.
+    - If 'directories' are not given, only the PWD is considered.
+    - If `extensions` or `types` are provided, only matching files are returned.
+    - If neither is provided, all files in the PWD are returned.
+    """
+    if isinstance(directories, str):
+        types = [directories]
+        directories = None
+    if directories is None:
+        directories = ["."]
+    if extensions is None:
+        extensions = []
+    if types is None:
+        types = []
+
+    normalized_extensions = {
+        ext.lower() if ext.startswith(".") else f".{ext.lower()}"
+        for ext in extensions
+    }
+
+    for file_type in types:
+        key = file_type.strip().lower()
+        try:
+            normalized_extensions.update(FILE_TYPES[key])
+        except KeyError:
+            raise ValueError(f"Unknown file type: {file_type}")
+
+    files_to_return: list[str] = []
+
+    for path in directories:
+        for item in Path(path).iterdir():
+            if not item.is_file():
+                continue
+
+            # If no filters, accept everything
+            if not normalized_extensions:
+                files_to_return.append(str(item))
+                continue
+
+            # Otherwise, filter by extension
+            if item.suffix.lower() in normalized_extensions:
+                files_to_return.append(str(item))
+
+    return files_to_return

fileutils_dir-0.1.2.dist-info/METADATA

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: fileutils-dir
+Version: 0.1.2
+Summary: Small utilities for listing files in directories
+Author: Jatavallabhula Sarat Anirudh
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# fileutils
+
+Small utilities for working with files and directories.
+
+Currently provides a helper to list files in one or more directories,
+optionally filtered by file extension or file type.
+
+Installation (local development)
+
+    pip install -e .
+
+Usage
+
+    from fileutils import in_dir
+
+    # All files in current directory
+    files = in_dir()
+
+    # All Python files
+    files = in_dir(extensions=[".py"])
+
+    # Files by type
+    files = in_dir(types=["code"])
+
+    # Multiple directories
+    files = in_dir(directories=["src", "tests"], types=["code"])
+
+Behavior
+
+- Defaults to the current directory (.)
+- If no extensions or types are provided, all files are returned
+- If both are provided, the result is the union of both filters
+- Only files are returned (directories are ignored)
+
+Supported types
+
+Common file groups such as:
+- code
+- text
+- image
+- pdf
+- audio
+- video
+- archive
+
+See source for the full mapping.
+
+License
+
+MIT

fileutils_dir-0.1.2.dist-info/RECORD

@@ -0,0 +1,6 @@
+fileutils/__init__.py,sha256=3u-pHKVodcCPECMcj95lrkk8nr7tl6_HRqiQOw6YbBM,78
+fileutils/files.py,sha256=j4knqqqwS8iOywxapZjJHx8kQee1SB0u6dzrVYdIhIA,2375
+fileutils_dir-0.1.2.dist-info/METADATA,sha256=_yHXInJ_ccb18DhVFmBjVp20UezeofZy5KqVhgwWAyQ,1239
+fileutils_dir-0.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+fileutils_dir-0.1.2.dist-info/top_level.txt,sha256=kZPCAZpYo7OkmwY_R2a4ifuMINdW5AZd2JaNHDSXQYQ,10
+fileutils_dir-0.1.2.dist-info/RECORD,,

fileutils_dir-0.1.2.dist-info/WHEEL

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

fileutils_dir-0.1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+fileutils