codemap-cli 0.1.0__tar.gz

codemap_cli-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: codemap-cli
+Version: 0.1.0
+Summary: A deterministic filesystem mapper optimized for AI context
+Author: Purva Sanjay Patel
+Requires-Python: >=3.9
+Requires-Dist: typer

codemap_cli-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[project]
+name = "codemap-cli"
+version = "0.1.0"
+description = "A deterministic filesystem mapper optimized for AI context"
+authors = [{ name = "Purva Sanjay Patel" }]
+dependencies = ["typer"]
+requires-python = ">=3.9"
+
+[project.scripts]
+codemap = "codemap.cli:app"
+
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"

codemap_cli-0.1.0/setup.cfg

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

codemap_cli-0.1.0/src/codemap/cli.py

@@ -0,0 +1,74 @@
+import typer
+from pathlib import Path
+from .root import find_project_root, detect_plugin
+from .scanner import build_tree
+from .formatter import format_tree
+from .writer import build_markdown, write_file
+
+app = typer.Typer(invoke_without_command=True)
+
+
+@app.callback()
+def main():
+    start_path = Path.cwd()
+
+    root = find_project_root(start_path)
+
+    if not root:
+        typer.secho(
+            "Error: No project root detected.",
+            fg=typer.colors.RED,
+        )
+        raise typer.Exit(code=1)
+
+    if root != start_path:
+        typer.secho(
+            f"Detected project root at: {root}",
+            fg=typer.colors.CYAN,
+        )
+
+    plugin = detect_plugin(root)
+
+    output_file = root / "codemap.md"
+
+    # Build tree
+    tree = build_tree(root, plugin)
+    tree_text = format_tree(tree)
+
+    # Build full markdown content
+    new_content = build_markdown(
+        tree_text,
+        root,
+        plugin.name if plugin else "unknown",
+    )
+
+    if output_file.exists():
+        old_content = output_file.read_text(encoding="utf-8")
+
+        # Extract old tree block
+        if "```" in old_content:
+            old_tree = old_content.split("```")[1].strip()
+        else:
+            old_tree = ""
+
+        if old_tree == tree_text.strip():
+            typer.secho(
+                "No structural changes detected. codemap.md is up to date.",
+                fg=typer.colors.BLUE,
+            )
+            raise typer.Exit()
+
+        # Structure changed → rewrite file with new timestamp
+        write_file(output_file, new_content)
+
+        typer.secho(
+            "codemap.md updated successfully.",
+            fg=typer.colors.YELLOW,
+        )
+    else:
+        write_file(output_file, new_content)
+
+        typer.secho(
+            "codemap.md generated successfully.",
+            fg=typer.colors.GREEN,
+        )

codemap_cli-0.1.0/src/codemap/constants.py

@@ -0,0 +1,11 @@
+GLOBAL_IGNORE = [
+    ".git",
+    ".idea",
+    ".vscode",
+]
+
+GLOBAL_HIDDEN_FILES = [
+    ".env",
+    ".env.local",
+    ".env.production",
+]

codemap_cli-0.1.0/src/codemap/formatter.py

@@ -0,0 +1,18 @@
+def format_tree(tree):
+    lines = [tree["name"]]
+
+    def _format(node, prefix=""):
+        children = node.get("children", [])
+        total = len(children)
+
+        for index, child in enumerate(children):
+            connector = "└── " if index == total - 1 else "├── "
+            line = prefix + connector + child["name"]
+            lines.append(line)
+
+            if child["type"] == "dir" and not child.get("collapsed"):
+                extension = "    " if index == total - 1 else "│   "
+                _format(child, prefix + extension)
+
+    _format(tree)
+    return "\n".join(lines)

codemap_cli-0.1.0/src/codemap/plugins/base.py

@@ -0,0 +1,23 @@
+class BasePlugin:
+    name = "base"
+
+    # Files that indicate the current framework
+    detection_files = []
+
+    # Files to ignore when scanning the code
+    ignore = set()
+
+    # Show folder but do not traverse inside
+    collapse = set()
+
+    # Files that should never be shown
+    hidden_files = set()
+
+    def matches(self, root_path):
+        from pathlib import Path
+
+        for file in self.detection_files:
+            if (Path(root_path) / file).exists():
+                return True
+        return False
+

codemap_cli-0.1.0/src/codemap/plugins/javascript.py

@@ -0,0 +1,22 @@
+from .base import BasePlugin
+
+
+class JavaScriptPlugin(BasePlugin):
+    name = "javascript"
+
+    detection_files = ["package.json"]
+
+    ignore = {
+        ".next",
+        "dist",
+        "build",
+    }
+
+    collapse = {
+        "node_modules",
+    }
+
+    hidden_files = {
+        ".env",
+        ".env.local",
+    }

codemap_cli-0.1.0/src/codemap/plugins/python.py

@@ -0,0 +1,23 @@
+from .base import BasePlugin
+
+class PythonPlugin(BasePlugin):
+    name = "python"
+
+    detection_files = ["pyproject.toml","requirements.txt","setup.py"]
+
+    ignore = {
+        "__pycache__",
+        ".venv",
+        "venv",
+        "env",
+        ".env",
+        ".mypy_cache",
+        ".pytest_cache",
+    }
+
+    collapse = set()
+
+    hidden_files = {
+        ".env",
+        ".env.local",
+    }

codemap_cli-0.1.0/src/codemap/root.py

@@ -0,0 +1,29 @@
+from pathlib import Path
+from .plugins.python import PythonPlugin
+from .plugins.javascript import JavaScriptPlugin
+
+PLUGINS = [
+    PythonPlugin(),
+    JavaScriptPlugin(),
+]
+
+def find_project_root(start_path: Path) -> Path | None:
+    current = start_path.resolve()
+
+    while current != current.parent:
+        for plugin in PLUGINS:
+            for marker in plugin.detection_files:
+                if (current / marker).exists():
+                    return current
+        if (current / ".git").exists():
+            return current
+        current = current.parent
+
+    return None
+
+
+def detect_plugin(root_path: Path):
+    for plugin in PLUGINS:
+        if plugin.matches(root_path):
+            return plugin
+    return None

codemap_cli-0.1.0/src/codemap/scanner.py

@@ -0,0 +1,49 @@
+from pathlib import Path
+from .constants import GLOBAL_IGNORE, GLOBAL_HIDDEN_FILES
+
+
+def build_tree(path: Path, plugin):
+    name = path.name
+
+    if path.is_file():
+        return {
+            "type": "file",
+            "name": name,
+        }
+
+    children = []
+
+    for item in sorted(path.iterdir(), key=lambda x: x.name.lower()):
+        if item.name in GLOBAL_IGNORE:
+            continue
+
+        if plugin and item.name in plugin.ignore:
+            continue
+
+        if item.name in GLOBAL_HIDDEN_FILES:
+            continue
+
+        if plugin and item.name in plugin.hidden_files:
+            continue
+            
+        if item.name.endswith(".egg-info"):
+            continue
+
+        if item.is_dir() and plugin and item.name in plugin.collapse:
+            children.append({
+                "type": "dir",
+                "name": item.name,
+                "collapsed": True,
+            })
+            continue
+
+        children.append(build_tree(item, plugin))
+
+        if item.name == "codemap.md":
+            continue
+
+    return {
+        "type": "dir",
+        "name": name,
+        "children": children,
+    }

codemap_cli-0.1.0/src/codemap/writer.py

@@ -0,0 +1,20 @@
+from datetime import datetime
+
+
+def build_markdown(tree_text: str, root_path, plugin_name: str) -> str:
+    header = (
+        "# CodeMap\n\n"
+        f"Generated: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}\n"
+        f"Root: {root_path}\n"
+        f"Framework: {plugin_name}\n\n"
+        "```\n"
+    )
+
+    footer = "\n```\n"
+
+    return header + tree_text + footer
+
+
+def write_file(output_path, content: str):
+    with open(output_path, "w", encoding="utf-8") as f:
+        f.write(content)

codemap_cli-0.1.0/src/codemap_cli.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: codemap-cli
+Version: 0.1.0
+Summary: A deterministic filesystem mapper optimized for AI context
+Author: Purva Sanjay Patel
+Requires-Python: >=3.9
+Requires-Dist: typer

codemap_cli-0.1.0/src/codemap_cli.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+README.md
+pyproject.toml
+src/codemap/__init__.py
+src/codemap/cli.py
+src/codemap/constants.py
+src/codemap/formatter.py
+src/codemap/root.py
+src/codemap/scanner.py
+src/codemap/writer.py
+src/codemap/plugins/__init__.py
+src/codemap/plugins/base.py
+src/codemap/plugins/javascript.py
+src/codemap/plugins/python.py
+src/codemap_cli.egg-info/PKG-INFO
+src/codemap_cli.egg-info/SOURCES.txt
+src/codemap_cli.egg-info/dependency_links.txt
+src/codemap_cli.egg-info/entry_points.txt
+src/codemap_cli.egg-info/requires.txt
+src/codemap_cli.egg-info/top_level.txt

codemap_cli-0.1.0/src/codemap_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

codemap_cli-0.1.0/src/codemap_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+codemap = codemap.cli:app

codemap_cli-0.1.0/src/codemap_cli.egg-info/requires.txt

@@ -0,0 +1 @@
+typer

codemap_cli-0.1.0/src/codemap_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+codemap