fileutils-dir 0.1.3__tar.gz

fileutils_dir-0.1.3/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: fileutils-dir
+Version: 0.1.3
+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.3/README.md

@@ -0,0 +1,50 @@
+# 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.3/fileutils/__init__.py

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

fileutils_dir-0.1.3/fileutils/files.py

@@ -0,0 +1,47 @@
+from collections.abc import Iterable
+from pathlib import Path
+
+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(
+        paths: Iterable[str] | None = None,
+        ext: Iterable[str] | None = None,
+        dtype: Iterable[str] | None = None,
+) -> list[str]:
+    paths = paths or ["."]
+    ext = ext or []
+    dtype = dtype or []
+
+    normalized_extensions = {
+        e.lower() if e.startswith(".") else f".{e.lower()}"
+        for e in ext
+    }
+
+    for file_type in dtype:
+        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 paths:
+        for item in Path(path).iterdir():
+            if not item.is_file():
+                continue
+
+            if not normalized_extensions or item.suffix.lower() in normalized_extensions:
+                files_to_return.append(str(item))
+
+    return files_to_return

fileutils_dir-0.1.3/fileutils_dir.egg-info/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: fileutils-dir
+Version: 0.1.3
+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.3/fileutils_dir.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+fileutils/__init__.py
+fileutils/files.py
+fileutils_dir.egg-info/PKG-INFO
+fileutils_dir.egg-info/SOURCES.txt
+fileutils_dir.egg-info/dependency_links.txt
+fileutils_dir.egg-info/top_level.txt

fileutils_dir-0.1.3/fileutils_dir.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fileutils_dir-0.1.3/fileutils_dir.egg-info/top_level.txt

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

fileutils_dir-0.1.3/pyproject.toml

@@ -0,0 +1,14 @@
+[project]
+name = "fileutils-dir"
+version = "0.1.3"
+description = "Small utilities for listing files in directories"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+  {name = "Jatavallabhula Sarat Anirudh"}
+]
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"

fileutils_dir-0.1.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+