codemap-python 0.1.0__py3-none-any.whl

codemap_cli.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from cli import main as _main
+
+
+def main() -> int:
+    return _main()
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

codemap_python-0.1.0.dist-info/METADATA

@@ -0,0 +1,399 @@
+Metadata-Version: 2.4
+Name: codemap-python
+Version: 0.1.0
+Summary: Local Python code analysis tool - understand architecture, dependencies, and call graphs
+Author-email: ADITYA <aditykushwaha69@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/ADITYA-kus/codemap_ai
+Project-URL: Repository, https://github.com/ADITYA-kus/codemap_ai.git
+Project-URL: Issues, https://github.com/ADITYA-kus/codemap_ai/issues
+Project-URL: Documentation, https://github.com/ADITYA-kus/codemap_ai#readme
+Keywords: code-analysis,python,architecture,call-graph,cli,dashboard,local,privacy
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn>=0.23
+Requires-Dist: jinja2>=3.1
+Requires-Dist: requests>=2.31
+
+# CodeMap
+
+**CodeMap** is a pure local developer tool that analyzes Python codebases and provides:
+
+- 📊 **Architecture Analysis** - Understand code structure, dependencies, and call graphs
+- 🦺 **Call Graph Extraction** - Trace function/method calls across your codebase
+- ⚠️ **Risk Analysis** - Identify complex code patterns and potential issues
+- 📈 **Symbol Indexing** - Search and explore functions, classes, and methods
+- 🌐 **Local Web Dashboard** - Visual code analysis interface
+- 🔐 **Privacy First** - All analysis runs locally, no data leaves your machine
+
+## Requirements
+
+- **Python 3.10+**
+- **pip** (Python package manager)
+- **~5 minutes** to get started
+
+## Quick Start (3 Steps)
+
+### Step 1️⃣: Install CodeMap
+
+```bash
+# Clone the repository
+git clone https://github.com/ADITYA-kus/codemap_ai.git
+cd codemap_ai
+
+# Install as a local package
+pip install -e .
+```
+
+**Verify installation:**
+```bash
+codemap --help
+```
+
+You should see:
+```
+usage: codemap [-h] {analyze,dashboard,open,cache} ...
+```
+
+---
+
+### Step 2️⃣: Analyze Your First Repository
+
+**IMPORTANT:** The `analyze` command REQUIRES the `--path` argument pointing to a directory!
+
+```bash
+# Analyze the demo repo (takes 5-10 seconds)
+codemap analyze --path demo_repo
+```
+
+**Output: JSON analysis data**
+```json
+{
+  "ok": true,
+  "cache_dir": ".codemap_cache/...",
+  "analysis_version": "2.2",
+  "repo_dir": "demo_repo"
+}
+```
+
+**Analyze your own Python project:**
+```bash
+codemap analyze --path /path/to/your/python/project
+```
+
+**Analyze a GitHub repository:**
+```bash
+codemap analyze --github https://github.com/owner/repo
+```
+
+---
+
+### Step 3️⃣: View in Web Dashboard
+
+```bash
+# Start the web dashboard
+codemap dashboard --port 8000
+```
+
+**Open in browser:**
+```
+http://127.0.0.1:8000
+```
+
+You'll see:
+- List of analyzed repositories
+- Call graphs
+- Architecture metrics
+- Risk analysis
+- Symbol search
+
+---
+
+## Common Commands
+
+### Analyze Commands
+```bash
+# ⚠️ REQUIRED: Analyze needs --path argument!
+
+# Analyze a local repository
+codemap analyze --path <repo_directory>
+
+# Analyze a GitHub repository (public)
+codemap analyze --github https://github.com/owner/repo
+
+# Analyze private GitHub repo (requires token)
+codemap analyze --github https://github.com/owner/private-repo --token YOUR_GITHUB_TOKEN
+
+# Force rebuild analysis (ignore cache)
+codemap analyze --path <repo_directory> --rebuild
+
+# Use API for detailed JSON output
+codemap api analyze --path <repo_directory>
+```
+
+### Dashboard Commands
+```bash
+# Start web dashboard (default: localhost:8000)
+codemap dashboard --port 8000
+
+# Start dashboard with auto-reload (development)
+codemap dashboard --port 8000 --reload
+
+# Open dashboard in browser
+codemap open --port 8000
+```
+
+### Cache Management
+```bash
+# List all analyzed repositories
+codemap cache list
+
+# Show cache details for a repository
+codemap cache info <repo_hash>
+
+# Clear a specific repository's cache
+codemap cache clear <repo_hash>
+
+# Show cache retention policy
+codemap cache retention <repo_hash>
+
+# Sweep expired caches (auto-cleanup)
+codemap cache sweep
+```
+
+**Get GitHub Token (for private repos):**
+1. Go to https://github.com/settings/tokens
+2. Click "Generate new token" → "Generate new token (classic)"
+3. Give it a name (e.g., "CodeMap")
+4. Select **`repo`** scope (full control of private repos)
+5. Copy the token and save it somewhere safe
+6. Use in commands: `--token ghp_xxxxx`
+
+**Or pass token via stdin (more secure):**
+```bash
+echo "YOUR_TOKEN" | codemap analyze --github https://github.com/owner/repo --token-stdin
+```
+
+---
+
+## Directory Structure
+
+```
+codemap_ai_clean/
+├── README.md              # This file
+├── cli.py                 # Command-line interface
+├── security_utils.py      # Security & secret redaction
+├── pyproject.toml         # Package configuration
+├── analysis/              # Code analysis engine
+│   ├── core/             # AST parsing, imports
+│   ├── call_graph/       # Call graph building
+│   ├── explain/          # Symbol metadata
+│   ├── architecture/     # Dependency analysis
+│   └── graph/            # Graph indexing
+├── ui/                    # Web dashboard
+│   ├── app.py            # FastAPI server
+│   ├── templates/        # HTML templates
+│   └── static/           # CSS, JavaScript
+├── tests/                 # Test suite
+└── demo_repo/            # Example repository
+```
+
+---
+
+## Features Explained
+
+### 🔍 Symbol Search
+Find all functions, classes, and methods in your codebase:
+
+```bash
+codemap api search --path <repo_path> --query "MyClass"
+codemap api search --path <repo_path> --query "function_name"
+```
+
+### 📊 Call Graph
+Understand how functions call each other:
+
+```bash
+codemap api explain --path <repo_path> --symbol "module.ClassName.method"
+```
+
+### ⚠️ Risk Radar
+Detect complex code patterns and potential issues:
+
+```bash
+codemap api risk_radar --path <repo_path>
+```
+
+### 📈 Impact Analysis
+See which files/functions are affected by changes:
+
+```bash
+codemap api impact --path <repo_path> --target "module.function"
+```
+
+---
+
+
+
+
+
+
+
+
+
+## Privacy & Security
+
+✅ **100% Local**
+- All analysis happens on your machine
+- No data sent to external servers
+- .env files and secrets are never exposed
+
+✅ **Secure Cache**
+- Analysis results cached locally
+- Cache auto-cleared after 14 days (configurable)
+- No credentials stored
+
+✅ **Secret Redaction**
+- API keys automatically masked in output
+- GitHub tokens never logged
+- Safe error messages
+
+---
+
+## Example Workflow
+
+### Local Project Analysis
+```bash
+# 1. Navigate to your Python project
+cd C:\Users\YourName\my_python_project
+
+# 2. Analyze it with CodeMap
+codemap analyze --path .
+# ✅ Analysis complete! Results cached locally
+
+# 3. Start the web dashboard
+codemap dashboard --port 8000
+# ✅ Dashboard running at http://127.0.0.1:8000
+
+# 4. Open in browser
+codemap open --port 8000
+
+# 5. Explore in browser:
+#    - View all repositories
+#    - See call graphs
+#    - Check architecture metrics
+#    - View risk analysis
+
+# 6. Search for a specific class
+codemap api search --path . --query "MyClass"
+
+# 7. Check call graph for a function
+codemap api explain --path . --symbol "mymodule.MyClass.method"
+```
+
+### GitHub Repository Analysis
+```bash
+# 1. Analyze a public GitHub repo
+codemap analyze --github https://github.com/owner/awesome-project
+# ✅ Downloaded and analyzed
+
+# 2. View in dashboard
+codemap dashboard --port 8000
+codemap open --port 8000
+
+# 3. Clean up old repos
+codemap cache list      # See all cached repos
+codemap cache sweep    # Auto-cleanup old ones
+```
+
+---
+
+## Next Steps
+
+1. 🎯 **First analysis** - Try the demo:
+   ```bash
+   codemap analyze --path demo_repo
+   ```
+
+2. 📊 **View results** - Open the dashboard:
+   ```bash
+   codemap dashboard --port 8000
+   ```
+
+3. 📁 **Analyze your code** - Point to your project:
+   ```bash
+   codemap analyze --path ~/my-project
+   ```
+
+4. 🔗 **Try GitHub** - Analyze public repos:
+   ```bash
+   codemap analyze --github https://github.com/owner/repo
+   ```
+
+5. 🚀 **Advanced features** - Explore search, impact, risk analysis:
+   ```bash
+   codemap api search --path . --query "YourClass"
+   ```
+
+---
+
+## Quick Reference
+
+```bash
+# Installation
+pip install -e .
+
+# Most common commands
+codemap analyze --path <directory>              # Analyze local repo
+codemap analyze --github <url>                  # Analyze GitHub repo
+codemap dashboard --port 8000                   # Start dashboard
+codemap open --port 8000                        # Open in browser
+codemap cache list                              # List all analyses
+codemap cache clear <hash>                      # Delete one analysis
+```
+
+---
+
+## Support & Help
+
+✅ **Run without arguments** to see all available commands:
+```bash
+codemap --help
+codemap analyze --help
+codemap dashboard --help
+codemap api --help
+```
+
+✅ **Check requirements:**
+```bash
+python --version          # Should be 3.10+
+pip --version             # Should be installed
+git --version             # For GitHub repos
+```
+
+✅ **Verify repo path:**
+```bash
+# Make sure your repo has Python files
+dir <your_repo>                 # Windows
+ls <your_repo>                  # Linux/Mac
+find <your_repo> -name "*.py"   # Find Python files
+```
+
+---
+
+**Happy coding! 🚀**
+
+---
+
+**GitHub:** https://github.com/ADITYA-kus/codemap_ai
+

codemap_python-0.1.0.dist-info/RECORD

@@ -0,0 +1,58 @@
+cli.py,sha256=boH_c_MEviQtmCetl-nTSMWoHkz6sVLIbv887aUzJEA,72912
+codemap_cli.py,sha256=W6GWcVQsIUQwUq5xTe0R-6hSKOwkqgpJxlosdSEyYco,175
+security_utils.py,sha256=6wmKx3qeYQmyIhc69ENocdclzKjIskhGhbbYzyrOfSs,1958
+analysis/__init__.py,sha256=gk7XcsmXhT6ewXV3CFezT6R5Q8E2RJ_W1lAPYWmloUQ,20
+analysis/architecture/__init__.py,sha256=8Bo3TpyB49uJs6QpQMTWpUR2hJhqEpbkK_E_GW7tYpU,5
+analysis/architecture/architecture_engine.py,sha256=8aWqfvdGHP9gIf03VdLrkn1vF670MzeKXpPVVeP7kh4,5567
+analysis/architecture/dependency_cycles.py,sha256=fu1kQY1N4jmAdCdh2V2g9e8aZRoC17WtGEy6rPStDbI,3342
+analysis/architecture/risk_radar.py,sha256=3nCxjH96cicb_UQ67T4Hk63cIWWgG5syQhlaoFsoWEA,8681
+analysis/call_graph/__init__.py,sha256=w0foWNOGbFJTxtZUs08tnR3MM5mRTfA0xz6DtGRNGOk,22
+analysis/call_graph/call_extractor.py,sha256=ePYwybRNn5U6dZ21wiovtnVzCskaohNMINvaM_zOEaU,2673
+analysis/call_graph/call_graph_builder.py,sha256=h3D2SzvNmyPtVEBvwGTHM2LVsUwxq9MBLEMhkMi8gGc,29
+analysis/call_graph/call_resolver.py,sha256=gdSAy_042xxXby65FfSIMGBYI3yU4-jT-zMvpajHdF8,1600
+analysis/call_graph/context_models.py,sha256=pYCvdJOEdR35p-BO42BtXoJIFdieF6CEp-f_rSFbd0Q,29
+analysis/call_graph/cross_file_resolver.py,sha256=NvCsNijZ6PoBR-U0SHfpUaViQ9av2leh7hEu6yMuOlo,3485
+analysis/call_graph/execution_tracker.py,sha256=kF8zrEdt-H0nbfMTLIWvDKZ0KAwJ_6vIsO1cnHCKQxU,31
+analysis/call_graph/flow_builder.py,sha256=B029swJPLTaB6MazmHfK-XS9rLpg7HSTwiEj176hZ7w,26
+analysis/call_graph/models.py,sha256=bj3YVEVIKhSNrYdczUewhckocjYp9qrdQzV65ICPJvQ,23
+analysis/core/__init__.py,sha256=Sl3CBLE_4V96jffhhcEY6C_-grRWDCQyoB-LVtNnP_A,39
+analysis/core/ast_context.py,sha256=kQZB3jM4Mnqy8VtnlT5Towdo5Rfg6sr2hF-eVxjQY6Q,29
+analysis/core/ast_parser.py,sha256=JKmnMu9jmTj3gktRXamzPp94OjAlPCLCkQ20Xfa9IOE,184
+analysis/core/class_extractor.py,sha256=YJctW3TigWa7gra02qgZJXoVboDDTikkIyPzEDfNiI8,1039
+analysis/core/function_extractor.py,sha256=5y0teAJ8vzGTZ8Te80m9i0ihP8g2jgR2FEcddxIvhwc,436
+analysis/core/import_extractor.py,sha256=hefburHlOhvfHneADTk7Nxi1pAlp29KH7EirLhOjPK0,1262
+analysis/explain/__init__.py,sha256=2FsKrvLP_OgFFTuoFToaXRs6lM3lmz6lpEqjy5Agko8,55
+analysis/explain/docstring_extractor.py,sha256=9AO1ITf48KMg5ezZm_GYJzTlFi8sOBYih3uXlyectWM,1449
+analysis/explain/explain_runner.py,sha256=bgB7PFUidR_aRBr8TdWr3KWNMWsy5o1H_-0IzNQli7M,5587
+analysis/explain/repo_summary_generator.py,sha256=eCNve4-eHG0d2XLJttFA-Bh5suZIvKack_jBRaMHrHc,6474
+analysis/explain/return_analyzer.py,sha256=KjHj7SHWTUMQAzLUi0A8BL5cv5tCxr5XeAw2VG-uyYg,3100
+analysis/explain/risk_flags.py,sha256=QNV101q4PMMIJ_LKv80EwX6uaAysiZC-aGyYTSbwPb8,39
+analysis/explain/signature_extractor.py,sha256=Wx-8tvCArg8B9LtMsvw0O5kd48PsGf0KjiEDF7uzTmc,3430
+analysis/explain/summary_generator.py,sha256=Km39BqMIBFOljlxTy9-NdyFNnVbx14XQXH2NVbnoWRU,9944
+analysis/graph/__init__.py,sha256=JcO7GEPE5fMocTUC1ou9AKGCnv3RwpTKt1CrNKQ-puM,52
+analysis/graph/callgraph_index.py,sha256=34LE8Vgv-z6kVOIoCdKJ19ej550ENEYI-78xuhF6QQE,3770
+analysis/graph/entrypoint_detector.py,sha256=4NDD4z-tAIcryTVcHkV7dMLDOQp3J-QKDFPUcIESRsg,40
+analysis/graph/impact_analyzer.py,sha256=LN23TnFr-4CSvrwC4pI-YbGXaGbg6ZUnktRvC5jByQM,7507
+analysis/indexing/__init__.py,sha256=eiE_smnnd-0xjpMBKDQilIypx5oiLA9N_40xBxDQSe4,54
+analysis/indexing/import_resolver.py,sha256=ZkTyx3RdzrEwdHMVax0uM5D4AjJNEo1FoXAD1rsx5QY,4697
+analysis/indexing/symbol_index.py,sha256=RoBsehau9u0tYB8hUEvN5K4dINgtiGH07qV0vznKAhA,5491
+analysis/runners/__init__.py,sha256=4caStudxQFG1nCXBGpoyV7DvxN5ySfwVm4ENQc46w6s,21
+analysis/runners/phase4_runner.py,sha256=HASv0IsVye7TdxwZ2TQfVjShJ8Q4b533IZ8Hd1CVTWU,4875
+analysis/utils/__init__.py,sha256=sJCGmNWVjSiFK21dDvTzQFMUPyQYNP3b4-Lj42DNA-s,17
+analysis/utils/ast_helpers.py,sha256=qMny-x6kvMt7F1b9Q8HtR2o0nen6bR-MyQsClBzLNpI,20
+analysis/utils/cache_manager.py,sha256=FUuZOO_CSHP_A2cFO4Kk8WQc34AYfqTol2w6n7DmTBE,24579
+analysis/utils/path_resolver.py,sha256=NprapbBX8E1c_5jp2R1OLIYMeqrFeNfaxnmIlwqs9hI,27
+analysis/utils/repo_fetcher.py,sha256=bCUBG0qUypcXXgQPAAdJAaRoQSc75Nd53B7HD72Euno,15105
+ui/__init__.py,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+ui/app.py,sha256=HQQ6oGR-LScaLxXbVklRkZRAF8YIXg3U7JtWymie8js,80878
+ui/device_id.py,sha256=gAan8gMnSY_lDpDSllafK27CSskFT-_OdFw2m8y2QUA,708
+ui/static/app.js,sha256=Qv7VPyBG2hWyX3PT2A0EO5XYcdImObiUctuqK5jHl50,114003
+ui/static/styles.css,sha256=gUEnjAQHh9qy0J2drZEiQyXMYe7y-krK1TX97yi4Q7w,20759
+ui/templates/index.html,sha256=h60_WeamhraIrxwAOifVFMeQ_Yzg7zye5etAjypmxjY,10773
+ui/utils/__init__.py,sha256=8Bo3TpyB49uJs6QpQMTWpUR2hJhqEpbkK_E_GW7tYpU,5
+ui/utils/registry_manager.py,sha256=jEhWMQJ3H1ZtyUP2ObneqFOVDTdDqiBvUh-46-rGFDw,6730
+codemap_python-0.1.0.dist-info/METADATA,sha256=1dcRsNr8nxwc5kkJ0Hb42b7jGKElQ68Fo34aiRnIBuU,10075
+codemap_python-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+codemap_python-0.1.0.dist-info/entry_points.txt,sha256=71TCgwo56CPxSfh-YSmofpNwq4-kSsjmBL_qzJ5kfmk,45
+codemap_python-0.1.0.dist-info/top_level.txt,sha256=JOu1LG-DyeBXc4u2Cn7KznNz-bZExhsf1CB7fV4r-t8,43
+codemap_python-0.1.0.dist-info/RECORD,,

codemap_python-0.1.0.dist-info/WHEEL

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

codemap_python-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+codemap = codemap_cli:main

codemap_python-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,5 @@
+analysis
+cli
+codemap_cli
+security_utils
+ui

security_utils.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+import re
+from typing import Any, Iterable, Optional
+
+
+_GITHUB_TOKEN_RE = re.compile(r"\b(gh[pousr]_[A-Za-z0-9_]{8,})\b")
+_BEARER_RE = re.compile(r"(?i)\bBearer\s+([A-Za-z0-9\-._~+/]+=*)")
+_BASIC_RE = re.compile(r"(?i)\bBasic\s+([A-Za-z0-9\-._~+/]+=*)")
+_URL_CREDENTIALS_RE = re.compile(r"(https?://)([^/\s:@]+):([^@\s/]+)@")
+_API_KEY_RE = re.compile(r"(?i)\b(api[_-]?key|token|secret|password)\s*[:=]\s*['\"]?([^\s'\";]{6,})")
+
+
+def _mask_token(value: str) -> str:
+    token = str(value or "")
+    if token.startswith("gh") and "_" in token:
+        prefix, _ = token.split("_", 1)
+        return f"{prefix}_************"
+    return "********"
+
+
+def redact_secrets(text: str, extra_secrets: Optional[Iterable[str]] = None) -> str:
+    value = str(text or "")
+
+    for secret in (extra_secrets or []):
+        s = str(secret or "").strip()
+        if s:
+            value = value.replace(s, "********")
+
+    value = _GITHUB_TOKEN_RE.sub(lambda m: _mask_token(m.group(1)), value)
+    value = _BEARER_RE.sub("Bearer ********", value)
+    value = _BASIC_RE.sub("Basic ********", value)
+    value = _URL_CREDENTIALS_RE.sub(r"\1***:***@", value)
+
+    def _api_key_sub(match: re.Match) -> str:
+        return f"{match.group(1)}=[REDACTED]"
+
+    value = _API_KEY_RE.sub(_api_key_sub, value)
+    return value
+
+
+def redact_payload(payload: Any, extra_secrets: Optional[Iterable[str]] = None) -> Any:
+    if isinstance(payload, str):
+        return redact_secrets(payload, extra_secrets=extra_secrets)
+    if isinstance(payload, list):
+        return [redact_payload(v, extra_secrets=extra_secrets) for v in payload]
+    if isinstance(payload, tuple):
+        return [redact_payload(v, extra_secrets=extra_secrets) for v in payload]
+    if isinstance(payload, dict):
+        return {k: redact_payload(v, extra_secrets=extra_secrets) for k, v in payload.items()}
+    return payload

ui/__init__.py

@@ -0,0 +1 @@
+