Initial Commit

Signed-off-by: Daniel Henry <iamdanhenry@gmail.com>

.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

.python-version

@@ -0,0 +1 @@
+3.14

dumpy.py

@@ -0,0 +1,83 @@
+from pathlib import Path
+import pathspec
+import argparse
+import mimetypes
+
+def get_file_description(path: Path):
+    mime_type, _ =  mimetypes.guess_type(path)
+    return mime_type or "Unknown mimetype"
+
+def output_metadata(path: Path, root: Path):
+    desc = get_file_description(path)
+    relative_path = path.relative_to(root)
+    print("#################")
+    print(f"## Filename: {relative_path}")
+    print(f"## Mimetype: {desc}")
+    print("#################")
+
+def get_ignore_spec(root: Path):
+    gitignore_path = root / ".gitignore"
+    if gitignore_path.exists():
+        with gitignore_path.open("r") as f:
+            return pathspec.PathSpec.from_lines('gitwildmatch', f)
+    return None
+
+def should_include(path: Path, spec: pathspec.PathSpec | None, root: Path, include_git_dir: bool = False):
+    relative_path = path.relative_to(root)
+    if ".git" in path.parts and not include_git_dir:
+        return False
+
+    if spec is None:
+        return True
+    
+    return not spec.match_file(str(relative_path))
+
+def walk_filesystem(ignore_gitignore: bool, include_git_dir: bool = False):
+    root = Path(".")
+
+    spec = None
+    if not ignore_gitignore:
+        spec = get_ignore_spec(root)        
+
+    for path in root.rglob("*"):
+        if path.is_file():
+            # print the filename (for now)
+            if should_include(path, spec, root, include_git_dir):
+                output_metadata(path, root)
+                success, content = get_file_contents(path)
+                if success:
+                    print("## File Contents:")
+                    print(content)
+                    print("\n")
+
+def get_file_contents(path: Path) -> tuple[bool, str]:
+
+    try:
+        with path.open("r", encoding="utf-8") as f:
+            return (True, f.read())
+    except (UnicodeDecodeError, PermissionError):
+        return (False, "")
+
+def main():
+
+    parser = argparse.ArgumentParser(description="Dumpy: A tool for providing a text representation of a project formatted in a way that LLMs will understand.")
+
+    parser.add_argument(
+        "--no-gitignore",
+        action="store_true",
+        help="Ignore the .gitignore file and include all files"
+    )
+
+    parser.add_argument(
+        "--include-git-dir",
+        action="store_true",
+        help="Include the .git directory in the output"
+    )
+
+    args = parser.parse_args()
+
+    walk_filesystem(ignore_gitignore=args.no_gitignore)
+
+if __name__ == "__main__":
+    main()
+

pyproject.toml

@@ -0,0 +1,9 @@
+[project]
+name = "dumpy"
+version = "0.1.0"
+description = "Used for dumping directories into the command prompt in a way that LLMs will understand"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = [
+    "pathspec>=1.0.3",
+]

uv.lock

@@ -0,0 +1,23 @@
+version = 1
+revision = 3
+requires-python = ">=3.14"
+
+[[package]]
+name = "dumpy"
+version = "0.1.0"
+source = { virtual = "." }
+dependencies = [
+    { name = "pathspec" },
+]
+
+[package.metadata]
+requires-dist = [{ name = "pathspec", specifier = ">=1.0.3" }]
+
+[[package]]
+name = "pathspec"
+version = "1.0.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/4c/b2/bb8e495d5262bfec41ab5cb18f522f1012933347fb5d9e62452d446baca2/pathspec-1.0.3.tar.gz", hash = "sha256:bac5cf97ae2c2876e2d25ebb15078eb04d76e4b98921ee31c6f85ade8b59444d", size = 130841, upload-time = "2026-01-09T15:46:46.009Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/32/2b/121e912bd60eebd623f873fd090de0e84f322972ab25a7f9044c056804ed/pathspec-1.0.3-py3-none-any.whl", hash = "sha256:e80767021c1cc524aa3fb14bedda9c34406591343cc42797b386ce7b9354fb6c", size = 55021, upload-time = "2026-01-09T15:46:44.652Z" },
+]