gitputra 0.2.0__tar.gz → 0.2.2__tar.gz

{gitputra-0.2.0 → gitputra-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitputra
-Version: 0.2.0
+Version: 0.2.2
 Summary: AI-powered GitHub repo analyzer CLI — analyze, chat, and visualize any codebase. Run 'gitputra info' to see all commands and features.
 Author-email: Adityava Gangopadhyay <adityava49cse@gmail.com>
 License: MIT
@@ -18,6 +18,7 @@ Requires-Dist: reportlab<5.0,>=4.0
 Requires-Dist: google-generativeai<1.0,>=0.5
 Requires-Dist: openai<2.0,>=1.0
 Requires-Dist: anthropic<1.0,>=0.25
+Requires-Dist: pdfplumber<1.0,>=0.9
 
 # 🔍 GitPutra
 
@@ -46,6 +47,7 @@ Requires-Dist: anthropic<1.0,>=0.25
 - 📄 **Multilingual PDF Reports** — Exports analysis as a styled PDF in ~110 languages
 - 🗂️ **Smart Indexing** — Skips re-embedding if a repo is already indexed; run `clear-db` to reset
 - 📁 **48+ File Types** — Supports Python, C/C++, Java, Go, Rust, JS/TS, and many more
+- 🧠 **Context Export** — Export your entire codebase as a portable Markdown file to paste into any AI tool
 
 ---
 
@@ -64,7 +66,12 @@ Requires Python 3.10+
 ### Analyze a Repository
 
 ```bash
+# Remote repo
 gitputra analyze https://github.com/user/repo --ai gemini --key YOUR_API_KEY
+
+# Local codebase (no cloning)
+gitputra analyze ./my-project --local --ai gemini --key YOUR_API_KEY
+gitputra analyze "C:\path\with spaces\project" --local --ai gemini --key YOUR_API_KEY
 ```
 
 With options:
@@ -75,6 +82,9 @@ gitputra analyze https://github.com/user/repo --ai openai --key YOUR_KEY --lang
 
 # Use Claude, skip PDF
 gitputra analyze https://github.com/user/repo --ai claude --key YOUR_KEY --no-pdf
+
+# Analyze a specific branch
+gitputra analyze https://github.com/user/repo --branch dev --ai gemini --key YOUR_API_KEY
 ```
 
 Outputs saved to `./output/`:
@@ -82,10 +92,16 @@ Outputs saved to `./output/`:
 - `diagram.png` — Dependency graph
 - `mermaid.txt` — Mermaid flowchart source
 
+---
+
 ### Chat with a Repository
 
 ```bash
+# Remote repo
 gitputra chat https://github.com/user/repo --ai gemini --key YOUR_API_KEY
+
+# Local codebase
+gitputra chat ./my-project --local --ai gemini --key YOUR_API_KEY
 ```
 
 ```
@@ -98,33 +114,59 @@ gitputra chat https://github.com/user/repo --ai gemini --key YOUR_API_KEY
 
 > If `analyze` was already run on the repo, `chat` reuses the existing index automatically.
 
-### Analyze or Chat with a Specific Branch
-
 ```bash
-# Analyze a specific branch
-gitputra analyze https://github.com/user/repo --branch dev --ai gemini --key YOUR_API_KEY
-
 # Chat with a specific branch
 gitputra chat https://github.com/user/repo --branch feature/my-branch --ai gemini --key YOUR_API_KEY
 ```
 
 > If `--branch` is not specified, the repo's default branch is used.
 
-### Clear the Local Index
+---
 
-```bash
-gitputra clear-db
-```
+### Export Codebase Context
 
-### Show Info & Capabilities
+Export your entire codebase as a single Markdown file you can paste into any AI tool (Claude, ChatGPT, Gemini…) to continue work without re-explaining the project.
 
 ```bash
-gitputra info
+# Local codebase — fast, no API key needed (no AI summaries)
+gitputra export-context ./my-project
+
+# With AI summaries (requires --use-ai and an API key)
+gitputra export-context ./my-project --use-ai --ai gemini --key YOUR_API_KEY
+gitputra export-context ./my-project --use-ai --ai claude --key YOUR_API_KEY
+
+# Remote GitHub repo
+gitputra export-context https://github.com/user/repo --remote --ai gemini --key YOUR_API_KEY
+
+# Remote repo, specific branch, with AI summaries
+gitputra export-context https://github.com/user/repo --remote --branch dev --use-ai --ai gemini --key YOUR_API_KEY
+
+# Scan current directory
+gitputra export-context
+
+# Path with spaces — wrap in quotes
+gitputra export-context "C:\Users\you\My Project"
 ```
 
-### Check Version
+Output saved to `./output/context_<project_name>_<timestamp>.md`
+
+**How to use the exported file:**
+1. Open the `.md` file
+2. Paste it into any AI chat (Claude, ChatGPT, Gemini…)
+3. Say: *"Here is my codebase context. Read it and help me continue."*
+
+---
+
+### Other Commands
 
 ```bash
+# Wipe the local ChromaDB index
+gitputra clear-db
+
+# Show all commands, supported AIs, languages, and file extensions
+gitputra info
+
+# Check version
 gitputra --version
 ```
 
@@ -146,7 +188,7 @@ gitputra --version
 
 ```env
 API_KEY=your_api_key_here
-GEMINI_API_KEY=your_gemini_key  # only needed for --ai claude with chat
+GEMINI_API_KEY=your_gemini_key  # only needed for --ai claude with chat/RAG
 ```
 
 **Option 2 — CLI flag:**

{gitputra-0.2.0 → gitputra-0.2.2}/README.md

@@ -25,6 +25,7 @@
 - 📄 **Multilingual PDF Reports** — Exports analysis as a styled PDF in ~110 languages
 - 🗂️ **Smart Indexing** — Skips re-embedding if a repo is already indexed; run `clear-db` to reset
 - 📁 **48+ File Types** — Supports Python, C/C++, Java, Go, Rust, JS/TS, and many more
+- 🧠 **Context Export** — Export your entire codebase as a portable Markdown file to paste into any AI tool
 
 ---
 
@@ -43,7 +44,12 @@ Requires Python 3.10+
 ### Analyze a Repository
 
 ```bash
+# Remote repo
 gitputra analyze https://github.com/user/repo --ai gemini --key YOUR_API_KEY
+
+# Local codebase (no cloning)
+gitputra analyze ./my-project --local --ai gemini --key YOUR_API_KEY
+gitputra analyze "C:\path\with spaces\project" --local --ai gemini --key YOUR_API_KEY
 ```
 
 With options:
@@ -54,6 +60,9 @@ gitputra analyze https://github.com/user/repo --ai openai --key YOUR_KEY --lang
 
 # Use Claude, skip PDF
 gitputra analyze https://github.com/user/repo --ai claude --key YOUR_KEY --no-pdf
+
+# Analyze a specific branch
+gitputra analyze https://github.com/user/repo --branch dev --ai gemini --key YOUR_API_KEY
 ```
 
 Outputs saved to `./output/`:
@@ -61,10 +70,16 @@ Outputs saved to `./output/`:
 - `diagram.png` — Dependency graph
 - `mermaid.txt` — Mermaid flowchart source
 
+---
+
 ### Chat with a Repository
 
 ```bash
+# Remote repo
 gitputra chat https://github.com/user/repo --ai gemini --key YOUR_API_KEY
+
+# Local codebase
+gitputra chat ./my-project --local --ai gemini --key YOUR_API_KEY
 ```
 
 ```
@@ -77,33 +92,59 @@ gitputra chat https://github.com/user/repo --ai gemini --key YOUR_API_KEY
 
 > If `analyze` was already run on the repo, `chat` reuses the existing index automatically.
 
-### Analyze or Chat with a Specific Branch
-
 ```bash
-# Analyze a specific branch
-gitputra analyze https://github.com/user/repo --branch dev --ai gemini --key YOUR_API_KEY
-
 # Chat with a specific branch
 gitputra chat https://github.com/user/repo --branch feature/my-branch --ai gemini --key YOUR_API_KEY
 ```
 
 > If `--branch` is not specified, the repo's default branch is used.
 
-### Clear the Local Index
+---
 
-```bash
-gitputra clear-db
-```
+### Export Codebase Context
 
-### Show Info & Capabilities
+Export your entire codebase as a single Markdown file you can paste into any AI tool (Claude, ChatGPT, Gemini…) to continue work without re-explaining the project.
 
 ```bash
-gitputra info
+# Local codebase — fast, no API key needed (no AI summaries)
+gitputra export-context ./my-project
+
+# With AI summaries (requires --use-ai and an API key)
+gitputra export-context ./my-project --use-ai --ai gemini --key YOUR_API_KEY
+gitputra export-context ./my-project --use-ai --ai claude --key YOUR_API_KEY
+
+# Remote GitHub repo
+gitputra export-context https://github.com/user/repo --remote --ai gemini --key YOUR_API_KEY
+
+# Remote repo, specific branch, with AI summaries
+gitputra export-context https://github.com/user/repo --remote --branch dev --use-ai --ai gemini --key YOUR_API_KEY
+
+# Scan current directory
+gitputra export-context
+
+# Path with spaces — wrap in quotes
+gitputra export-context "C:\Users\you\My Project"
 ```
 
-### Check Version
+Output saved to `./output/context_<project_name>_<timestamp>.md`
+
+**How to use the exported file:**
+1. Open the `.md` file
+2. Paste it into any AI chat (Claude, ChatGPT, Gemini…)
+3. Say: *"Here is my codebase context. Read it and help me continue."*
+
+---
+
+### Other Commands
 
 ```bash
+# Wipe the local ChromaDB index
+gitputra clear-db
+
+# Show all commands, supported AIs, languages, and file extensions
+gitputra info
+
+# Check version
 gitputra --version
 ```
 
@@ -125,7 +166,7 @@ gitputra --version
 
 ```env
 API_KEY=your_api_key_here
-GEMINI_API_KEY=your_gemini_key  # only needed for --ai claude with chat
+GEMINI_API_KEY=your_gemini_key  # only needed for --ai claude with chat/RAG
 ```
 
 **Option 2 — CLI flag:**

{gitputra-0.2.0 → gitputra-0.2.2}/gitputra/cli.py

@@ -1,12 +1,13 @@
 import click
 from dotenv import load_dotenv
 from . import corelogic as core
+from . import context_export as ctx
 
 load_dotenv()
 
 
 @click.group()
-@click.version_option("0.2.0", prog_name="gitputra")
+@click.version_option("0.2.2", prog_name="gitputra")
 def main():
     """🔍 Gitputra — AI-powered GitHub repo analyzer."""
     pass
@@ -16,8 +17,8 @@ def main():
 # ANALYZE
 # ─────────────────────────────────────────────
 @main.command()
-@click.argument("url")
-@click.option("--branch", default=None, help="Branch to clone (default: repo default branch).")
+@click.argument("url", default=".")
+@click.option("--branch", default=None, help="Branch to clone (default: repo default branch). Ignored with --local.")
 @click.option(
     "--ai", "ai_choice",
     type=click.Choice(["gemini", "openai", "claude"], case_sensitive=False),
@@ -41,28 +42,46 @@ def main():
     "--no-diagram", is_flag=True, default=False,
     help="Skip diagram generation."
 )
-def analyze(url, branch, ai_choice, key, lang, no_pdf, no_diagram):
+@click.option(
+    "--local", is_flag=True, default=False,
+    help="Analyze a local directory instead of cloning a GitHub URL."
+)
+def analyze(url, branch, ai_choice, key, lang, no_pdf, no_diagram, local):
     """Clone a GitHub repo and generate an AI analysis report.
 
     \b
-    Example:
+    Remote repo:
         gitputra analyze https://github.com/user/repo --ai gemini --key AIza...
+    \b
+    Local codebase:
+        gitputra analyze ./my-project --local --ai gemini --key AIza...
+        gitputra analyze "C:\\path\\with spaces\\project" --local --ai gemini --key AIza...
     """
     if not key:
-        raise click.UsageError("API key required. Use --key or set API_KEY in .env")
+        key = click.prompt("🔑 Enter API key", hide_input=True)
 
     core.init(ai_choice.lower(), key, lang)
 
-    repo_path, repo_name = core.clone_repo(url, branch)
+    if local:
+        import os
+        repo_path = os.path.abspath(url.strip())
+        repo_name = os.path.basename(repo_path)
+        if not os.path.isdir(repo_path):
+            click.secho(f"❌ Directory not found: {repo_path}", fg="red")
+            raise SystemExit(1)
+        click.secho(f"📂 Analyzing local directory: {repo_path}", fg="cyan")
+    else:
+        repo_path, repo_name = core.clone_repo(url, branch)
+
     files = core.load_files(repo_path)
 
     if not files:
         click.secho("❌ No supported source files found.", fg="red")
         raise SystemExit(1)
 
-    collection = core.get_collection(repo_name)
+    collection = core.get_collection(repo_name, branch)
     if collection.count() == 0:
-        core.store_chunks(files, repo_name)
+        core.store_chunks(files, repo_name, branch)
     else:
         click.secho("ℹ️  Using existing index (run 'clear-db' to re-index).", fg="cyan")
 
@@ -84,8 +103,8 @@ def analyze(url, branch, ai_choice, key, lang, no_pdf, no_diagram):
 # CHAT
 # ─────────────────────────────────────────────
 @main.command()
-@click.argument("url")
-@click.option("--branch", default=None, help="Branch to clone (default: repo default branch).")
+@click.argument("url", default=".")
+@click.option("--branch", default=None, help="Branch to clone (default: repo default branch). Ignored with --local.")
 @click.option(
     "--ai", "ai_choice",
     type=click.Choice(["gemini", "openai", "claude"], case_sensitive=False),
@@ -97,34 +116,49 @@ def analyze(url, branch, ai_choice, key, lang, no_pdf, no_diagram):
     help="API key (or set API_KEY in .env). Avoid passing directly to keep it out of shell history."
 )
 @click.option("--lang", default="English", show_default=True)
-def chat(url, branch, ai_choice, key, lang):
+@click.option(
+    "--local", is_flag=True, default=False,
+    help="Chat about a local directory instead of cloning a GitHub URL."
+)
+def chat(url, branch, ai_choice, key, lang, local):
     """Start an interactive RAG chat about a repo.
 
     \b
-    Example:
+    Remote repo:
         gitputra chat https://github.com/user/repo --ai gemini
+    \b
+    Local codebase:
+        gitputra chat ./my-project --local --ai gemini --key AIza...
         Type 'exit' or Ctrl+C to quit.
     """
     if not key:
-        raise click.UsageError("API key required. Use --key or set API_KEY in .env")
-
+        key = click.prompt("🔑 Enter API key", hide_input=True)
     core.init(ai_choice.lower(), key, lang)
 
-    repo_path, repo_name = core.clone_repo(url, branch)
+    if local:
+        import os
+        repo_path = os.path.abspath(url.strip())
+        repo_name = os.path.basename(repo_path)
+        if not os.path.isdir(repo_path):
+            click.secho(f"❌ Directory not found: {repo_path}", fg="red")
+            raise SystemExit(1)
+        click.secho(f"📂 Using local directory: {repo_path}", fg="cyan")
+    else:
+        repo_path, repo_name = core.clone_repo(url, branch)
 
-    collection = core.get_collection(repo_name)
+    collection = core.get_collection(repo_name, branch)
     if collection.count() == 0:
-        click.secho("📂 No existing index found — indexing repo now...", fg="yellow")
+        click.secho("📂 No existing index found — indexing now...", fg="yellow")
         files = core.load_files(repo_path)
         if not files:
             click.secho("❌ No supported source files found.", fg="red")
             raise SystemExit(1)
-        core.store_chunks(files, repo_name)
-        click.secho("✅ Repo indexed.", fg="green")
+        core.store_chunks(files, repo_name, branch)
+        click.secho("✅ Indexed.", fg="green")
     else:
         click.secho("✅ Using existing index.", fg="cyan")
 
-    click.secho(f"\n💬 Chat mode [{repo_name}] — ask anything about the repo. Type 'exit' to quit.\n", fg="cyan")
+    click.secho(f"\n💬 Chat mode [{repo_name}] — ask anything about the codebase. Type 'exit' to quit.\n", fg="cyan")
 
     while True:
         try:
@@ -137,10 +171,76 @@ def chat(url, branch, ai_choice, key, lang):
             click.echo("Bye!")
             break
 
-        answer = core.query_rag(question, repo_name)
+        answer = core.query_rag(question, repo_name, branch)
         click.echo(f"\n{answer}\n")
 
 
+# ─────────────────────────────────────────────
+# EXPORT CONTEXT
+# ─────────────────────────────────────────────
+@main.command("export-context")
+@click.argument("project_path", default=".", metavar="PROJECT_PATH", type=click.Path())
+@click.option("--branch", default=None, help="Branch to clone (only used with --remote).")
+@click.option("--remote", is_flag=True, default=False, help="Treat PROJECT_PATH as a GitHub URL and clone it first.")
+
+@click.option(
+    "--ai", "ai_choice",
+    type=click.Choice(["gemini", "openai", "claude"], case_sensitive=False),
+    default="gemini", show_default=True,
+    help="AI provider to use for summaries."
+)
+@click.option(
+    "--key",
+    envvar="API_KEY", default=None,
+    help="API key (or set API_KEY in .env)."
+)
+@click.option(
+    "--lang", default="English", show_default=True,
+    help="Language for AI-generated summaries."
+)
+@click.option(
+    "--use-ai", "no_ai", is_flag=True, default=True, flag_value=False,
+    help="Use LLM to generate AI summaries and project overview (requires --ai and --key)."
+)
+def export_context_cmd(project_path, branch, remote, ai_choice, key, lang, no_ai):
+    """Export a portable context file from a local or remote codebase.
+
+    Scans PROJECT_PATH (defaults to current directory), generates AI summaries
+    of every file, and writes a single Markdown file you can paste into any AI
+    tool (Claude, ChatGPT, Gemini ...) to continue work without re-explaining
+    the project.
+
+    \b
+    IMPORTANT — wrap paths in quotes if they contain spaces:
+        gitputra export-context "C:\\Users\\you\\My Project"
+
+    \b
+    Examples:
+        gitputra export-context ./my-project                              (fast, no key needed)
+        gitputra export-context "C:\\path\\with spaces\\project"
+        gitputra export-context ./my-project --use-ai --ai gemini --key AIza...
+        gitputra export-context ./my-project --use-ai --ai claude --key sk-ant-...
+        gitputra export-context                                           (scans current dir)
+    """
+    if remote:
+        project_path, _ = core.clone_repo(project_path, branch)
+
+    if no_ai:
+        gen_fn = lambda _prompt: None
+    else:
+        if not key:
+            key = click.prompt("🔑 Enter API key", hide_input=True)
+        core.init(ai_choice.lower(), key, lang)
+        gen_fn = core.safe_generate
+
+    ctx.export_context(
+        project_path     = project_path,
+        safe_generate_fn = gen_fn,
+        language         = lang,
+        skip_ai          = no_ai,
+    )
+
+
 # ─────────────────────────────────────────────
 # CLEAR DB
 # ─────────────────────────────────────────────
@@ -161,7 +261,7 @@ def info():
     """Show supported AIs, languages, extensions, and commands."""
     click.secho("\n 🔍 GitPutra — AI-powered GitHub Repo Analyzer", fg="cyan", bold=True)
     click.secho("   🤖 Chat with your codebase using Gemini, OpenAI or Claude", fg="bright_cyan")
-    click.secho("   🏷️ Version:     0.2.0", fg="cyan")
+    click.secho("   🏷️ Version:     0.2.2", fg="cyan")
     click.secho("   👨‍💻 Author:      Adityava Gangopadhyay", fg="magenta")
     click.secho("   💼 Email:       adityava49cse@gmail.com", fg="bright_magenta")
     click.secho("   🔗 LinkedIn:    https://www.linkedin.com/in/adityava-gangopadhyay/", fg="blue")
@@ -171,13 +271,19 @@ def info():
     
     click.secho("📦 Commands:", fg="yellow", bold=True)
     commands = [
-        ("analyze", "Clone a repo and generate a full AI report (supports --branch)"),
-        ("chat",    "Interactive RAG-based Q&A about a repo (supports --branch)"),
-        ("clear-db","Wipe the local ChromaDB index"),
-        ("info",    "Show this info screen"),
+        ("analyze <url>",         "Clone & analyze a remote GitHub repo"),
+        ("analyze <path> --local","Analyze a local codebase (no cloning)"),
+        ("chat <url>",            "RAG chat about a remote GitHub repo"),
+        ("chat <path> --local",   "RAG chat about a local codebase"),
+        ("export-context",        "Export portable context .md (AI off by default)"),
+        ("export-context <path>", "Export context .md from local dir (AI off by default)"),
+        ("export-context <url> --remote", "Export context .md from remote GitHub repo"),
+        ("clear-db",              "Wipe the local ChromaDB index"),
+        ("info",                  "Show this info screen"),
+
     ]
     for cmd, desc in commands:
-        click.echo(f"   {'gitputra ' + cmd:<25} {desc}")
+        click.echo(f"   {'gitputra ' + cmd:<40} {desc}")
 
     click.secho("\n🤖 Supported AI Providers:", fg="yellow", bold=True)
     ais = [