codemap-cli 0.1.0__py3-none-any.whl

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/constants.py

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

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/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/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/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/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/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/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.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,16 @@
+codemap/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codemap/cli.py,sha256=8VcVKxe6uZWjj7ddmVCEvIY62La0YdFSPM7GM0posvQ,1927
+codemap/constants.py,sha256=ELbCJ4ORJQI4oentnP4K7rrSFsbpkKiNkOxRo9V28s8,149
+codemap/formatter.py,sha256=DvZjlAmwAwV707DS3x5YVMqp1GkEJokumm7Mn2E18Pw,627
+codemap/root.py,sha256=CF9EmkojPcDT502YI1OcYcqFeS9UPykANP6Y6KNPTzA,757
+codemap/scanner.py,sha256=BskhRyrjn0Q4EzWRMbH0mTrjldTqmQbv35HPyKPgClQ,1183
+codemap/writer.py,sha256=0zAFx0enFuZJXZ7Ha4WKHFeVDUHcsoyLzuI0aYEXtWE,515
+codemap/plugins/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codemap/plugins/base.py,sha256=PxLByzaQag3ZiyRuFz_yJBv_iMqsECUHys5H0FcjC9c,541
+codemap/plugins/javascript.py,sha256=tapB1xF4Q_yVe5qK5NpExTvPGksYJuX5nJNjXBTeCvE,337
+codemap/plugins/python.py,sha256=SYT5ygo4BlosTyVuEyYgsR0cQPUfJ36xpU6mU0VtS5s,420
+codemap_cli-0.1.0.dist-info/METADATA,sha256=SHhXAaE1FYvactX6qQ-4_AZmbkbQKFwam1H3vMpOeos,201
+codemap_cli-0.1.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+codemap_cli-0.1.0.dist-info/entry_points.txt,sha256=K4QNwvaqaYXHZDLYvzb6lAj0O0Q--84HV5kMbhXhtaE,44
+codemap_cli-0.1.0.dist-info/top_level.txt,sha256=y3cIjxmjvwNiAspXYGejsYO5jxkQ4UXIEgLe3iHpL8g,8
+codemap_cli-0.1.0.dist-info/RECORD,,

codemap_cli-0.1.0.dist-info/WHEEL

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

codemap_cli-0.1.0.dist-info/entry_points.txt

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

codemap_cli-0.1.0.dist-info/top_level.txt

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