gitglimpse 0.1.3__tar.gz → 0.1.5__tar.gz

gitglimpse-0.1.5/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: gitglimpse
+Version: 0.1.5
+Summary: Extract structured context from your git history — PR descriptions, standups, weekly reports, and LLM-ready JSON.
+Project-URL: Homepage, https://github.com/dino/gitglimpse
+Project-URL: Repository, https://github.com/dino/gitglimpse
+Project-URL: Bug Tracker, https://github.com/dino/gitglimpse/issues
+Author: Dino
+License: MIT
+License-File: LICENSE
+Keywords: cli,developer-tools,git,standup
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: inquirerpy>=0.3.4
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tomli-w>=1.2
+Requires-Dist: typer[all]>=0.9.0
+Provides-Extra: llm
+Requires-Dist: httpx>=0.27; extra == 'llm'
+Description-Content-Type: text/markdown
+
+# gitglimpse
+
+Extract structured context from your git history — PR descriptions, standups, weekly reports, and LLM-ready JSON.
+
+## Install
+
+```bash
+pip install gitglimpse
+```
+
+## What it does
+
+gitglimpse reads your git log, groups commits into logical tasks, filters noise, extracts ticket IDs from branch names, and outputs structured context — as formatted text or clean JSON.
+
+## Commands
+
+```bash
+glimpse pr                          # PR summary from current branch
+glimpse standup                     # daily context from recent commits
+glimpse week                        # weekly summary grouped by day
+glimpse report                      # markdown report with file details
+glimpse init                        # generate Claude Code / Cursor slash commands
+glimpse config setup                # interactive configuration
+```
+
+## Features
+
+- **Noise filtering** — merge commits, lock files, and formatting changes excluded by default
+- **Ticket detection** — branch names like `feature/PROJ-123` are parsed automatically
+- **Multi-project** — run from a parent directory to aggregate across repos
+- **LLM-optional** — works instantly without AI, or connect Ollama / OpenAI / Anthropic / Gemini for richer output
+- **Editor integration** — slash commands for Claude Code and Cursor
+- **GitHub Action** — auto-generate PR context on every pull request
+- **JSON output** — every command supports `--json` for pipelines and LLM workflows
+
+## Links
+
+- **Website:** [gitglimpse.com](https://gitglimpse.com)
+- **GitHub:** [github.com/dino-zecevic/gitglimpse](https://github.com/dino-zecevic/gitglimpse)
+- **Documentation:** [README on GitHub](https://github.com/dino-zecevic/gitglimpse#readme)
+
+## License
+
+MIT

gitglimpse-0.1.5/PYPI_README.md

@@ -0,0 +1,44 @@
+# gitglimpse
+
+Extract structured context from your git history — PR descriptions, standups, weekly reports, and LLM-ready JSON.
+
+## Install
+
+```bash
+pip install gitglimpse
+```
+
+## What it does
+
+gitglimpse reads your git log, groups commits into logical tasks, filters noise, extracts ticket IDs from branch names, and outputs structured context — as formatted text or clean JSON.
+
+## Commands
+
+```bash
+glimpse pr                          # PR summary from current branch
+glimpse standup                     # daily context from recent commits
+glimpse week                        # weekly summary grouped by day
+glimpse report                      # markdown report with file details
+glimpse init                        # generate Claude Code / Cursor slash commands
+glimpse config setup                # interactive configuration
+```
+
+## Features
+
+- **Noise filtering** — merge commits, lock files, and formatting changes excluded by default
+- **Ticket detection** — branch names like `feature/PROJ-123` are parsed automatically
+- **Multi-project** — run from a parent directory to aggregate across repos
+- **LLM-optional** — works instantly without AI, or connect Ollama / OpenAI / Anthropic / Gemini for richer output
+- **Editor integration** — slash commands for Claude Code and Cursor
+- **GitHub Action** — auto-generate PR context on every pull request
+- **JSON output** — every command supports `--json` for pipelines and LLM workflows
+
+## Links
+
+- **Website:** [gitglimpse.com](https://gitglimpse.com)
+- **GitHub:** [github.com/dino-zecevic/gitglimpse](https://github.com/dino-zecevic/gitglimpse)
+- **Documentation:** [README on GitHub](https://github.com/dino-zecevic/gitglimpse#readme)
+
+## License
+
+MIT

{gitglimpse-0.1.3 → gitglimpse-0.1.5}/pyproject.toml

@@ -4,8 +4,9 @@ build-backend = "hatchling.build"
 
 [project]
 name = "gitglimpse"
-version = "0.1.3"
-description = "Analyze git history and generate standup updates, daily reports, and weekly summaries."
+version = "0.1.5"
+description = "Extract structured context from your git history — PR descriptions, standups, weekly reports, and LLM-ready JSON."
+readme = "PYPI_README.md"
 authors = [{ name = "Dino" }]
 license = { text = "MIT" }
 requires-python = ">=3.11"
@@ -24,13 +25,14 @@ dependencies = [
     "InquirerPy>=0.3.4",
 ]
 
+[project.optional-dependencies]
+llm = ["httpx>=0.27"]
+
 [project.urls]
 Homepage = "https://github.com/dino/gitglimpse"
 Repository = "https://github.com/dino/gitglimpse"
 "Bug Tracker" = "https://github.com/dino/gitglimpse/issues"
 
-[project.optional-dependencies]
-llm = ["httpx>=0.27"]
 
 [project.scripts]
 glimpse = "gitglimpse.cli:app"

gitglimpse-0.1.5/src/gitglimpse/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.5"

{gitglimpse-0.1.3 → gitglimpse-0.1.5}/src/gitglimpse/cli.py

@@ -18,7 +18,6 @@ from gitglimpse.formatters.template import format_standup, format_week_template
 from gitglimpse.git import GitError, get_branch_commits, get_commit_diff, get_commits, get_current_branch_name
 from gitglimpse.grouping import filter_noise_commits, group_commits_into_tasks, is_vague_message
 from gitglimpse.providers import get_provider
-from gitglimpse.providers.local import LocalProvider
 
 app = typer.Typer(
     name="glimpse",
@@ -50,6 +49,7 @@ def _app_callback(
     """Analyze git history and generate standup updates, reports, and summaries."""
 
 console = Console()
+_stderr_console = Console(stderr=True)
 
 # ---------------------------------------------------------------------------
 # Helpers
@@ -214,7 +214,7 @@ def _resolve_repo_paths(
         raise typer.Exit(1)
 
     names = ", ".join(r.name for r in repos)
-    console.print(f"[dim]Found {len(repos)} projects: {names}[/dim]", highlight=False)
+    _stderr_console.print(f"[dim]Found {len(repos)} projects: {names}[/dim]", highlight=False)
     return [(r, r.name) for r in repos]
 
 
@@ -275,6 +275,7 @@ def _print_status_line(
         ctx_mode: str = "commits",
 ) -> None:
     """Print a one-line dim status showing author, context, and active model."""
+    from gitglimpse.providers.local import LocalProvider
     from gitglimpse.providers.openai import OpenAIProvider
     from gitglimpse.providers.claude import ClaudeProvider
     from gitglimpse.providers.gemini import GeminiProvider
@@ -314,6 +315,8 @@ def _resolve_provider(
       2. config default_mode == local-llm / api → get_provider()
       3. anything else → None (template fallback)
     """
+    from gitglimpse.providers.local import LocalProvider
+
     if use_local:
         url = local_url_override or cfg.local_llm_url
         model = model_override or cfg.llm_model or None
@@ -370,6 +373,14 @@ def standup(
             typer.Option("--filter-noise/--no-filter-noise",
                          help="Filter out noise commits (merges, formatting, lock files)."),
         ] = None,
+        fmt: Annotated[
+            Optional[str],
+            typer.Option("--format", help="Output format: 'default' (Rich) or 'markdown'."),
+        ] = None,
+        output: Annotated[
+            Optional[str],
+            typer.Option("--output", "-o", help="Save output to file instead of printing."),
+        ] = None,
         skip_setup: Annotated[
             bool,
             typer.Option("--skip-setup", help="Skip first-run onboarding.", hidden=True),
@@ -382,7 +393,7 @@ def standup(
       glimpse standup
       glimpse standup --since "2 days ago"
       glimpse standup --json
-      glimpse standup --context diffs
+      glimpse standup --format markdown -o daily.md
       glimpse standup --repos "api,frontend,landing"
     """
     cfg = _load_or_onboard(skip_setup)
@@ -439,6 +450,8 @@ def standup(
         print(json_str)
         return
 
+    use_markdown = fmt and fmt.lower() == "markdown"
+
     if filtered_count > 0:
         console.print(f"[dim]Filtered {filtered_count} noise commits (merges, formatting, dependencies)[/dim]",
                       highlight=False)
@@ -446,6 +459,7 @@ def standup(
     active_provider: object | None = None
     llm_output: str | None = None
     if not no_llm:
+        from gitglimpse.providers.local import LocalProvider
         provider = _resolve_provider(cfg, local_llm, local_llm_url, model, context_mode=ctx_mode)
         if provider is not None:
             if isinstance(provider, LocalProvider) and not provider.is_available():
@@ -455,131 +469,28 @@ def standup(
                     )
             else:
                 active_provider = provider
-                llm_output = provider.summarize_standup(tasks, report_date, diff_snippets)
+                if use_markdown:
+                    llm_output = provider.summarize_report(tasks, report_date, diff_snippets)
+                else:
+                    llm_output = provider.summarize_standup(tasks, report_date, diff_snippets)
 
     _print_status_line(resolved_author, active_provider, ctx_mode)
-    if llm_output:
-        console.print(llm_output, markup=False, highlight=False)
-    else:
-        console.print(
-            format_standup(tasks, report_date, group_by=group_by if multi else "project"),
-            highlight=False,
-        )
-
-
-# ---------------------------------------------------------------------------
-# report
-# ---------------------------------------------------------------------------
-
-@app.command()
-def report(
-        no_llm: Annotated[bool, typer.Option("--no-llm", help="Skip LLM, use Markdown formatter.")] = False,
-        local_llm: Annotated[bool, typer.Option("--local-llm", help="Use local LLM (Ollama).")] = False,
-        local_llm_url: Annotated[
-            Optional[str],
-            typer.Option("--local-llm-url", help="Override local LLM base URL."),
-        ] = None,
-        model: Annotated[
-            Optional[str],
-            typer.Option("--model", help="LLM model to use (e.g. qwen2.5-coder:latest)."),
-        ] = None,
-        since: Annotated[
-            str, typer.Option("--since", help="Show commits since this date or period.")] = _SENTINEL_SINCE,
-        author: Annotated[
-            Optional[str],
-            typer.Option("--author", help="Filter by author email."),
-        ] = None,
-        repo: Annotated[
-            Optional[str],
-            typer.Option("--repo", help="Path to git repository. Defaults to current directory."),
-        ] = None,
-        repos: Annotated[
-            Optional[str],
-            typer.Option("--repos", help="Comma-separated list of repo paths for multi-project mode."),
-        ] = None,
-        output: Annotated[
-            Optional[str],
-            typer.Option("--output", "-o", help="Save report to this file instead of printing."),
-        ] = None,
-        context: Annotated[
-            Optional[str],
-            typer.Option("--context", help="LLM context: 'commits', 'diffs', or 'both'."),
-        ] = None,
-        filter_noise: Annotated[
-            Optional[bool],
-            typer.Option("--filter-noise/--no-filter-noise",
-                         help="Filter out noise commits (merges, formatting, lock files)."),
-        ] = None,
-        skip_setup: Annotated[
-            bool,
-            typer.Option("--skip-setup", help="Skip first-run onboarding.", hidden=True),
-        ] = False,
-) -> None:
-    """Generate a daily Markdown report from git commits.
-
-    \b
-    Examples:
-      glimpse report
-      glimpse report -o daily.md
-      glimpse report --since 2025-03-01
-    """
-    cfg = _load_or_onboard(skip_setup)
-    effective = _effective_since(since, cfg.default_since)
-    ctx_mode = context or cfg.context_mode
-    resolved_author = _resolve_author(author, cfg.author_email)
-    do_filter = filter_noise if filter_noise is not None else cfg.filter_noise
-
-    repo_pairs = _resolve_repo_paths(repo, repos)
-    multi = len(repo_pairs) > 1
-
-    filtered_count = 0
-    if multi:
-        tasks, filtered_count = _collect_multi_project(
-            repo_pairs, effective, None, resolved_author, do_filter=do_filter,
-        )
-    else:
-        repo_path = repo_pairs[0][0] if repo_pairs[0][1] else (Path(repo) if repo else None)
-        try:
-            commits = get_commits(repo_path=repo_path, since=effective, author=resolved_author)
-        except GitError as exc:
-            console.print(f"[bold red]Error:[/bold red] {exc}")
-            raise typer.Exit(1)
-        if do_filter:
-            original_count = len(commits)
-            commits = filter_noise_commits(commits)
-            filtered_count = original_count - len(commits)
-        tasks = group_commits_into_tasks(commits)
-
-    report_date = _report_date(effective)
-
-    if filtered_count > 0:
-        console.print(f"[dim]Filtered {filtered_count} noise commits (merges, formatting, dependencies)[/dim]",
-                      highlight=False)
-
-    active_provider: object | None = None
-    llm_output: str | None = None
-    if not no_llm:
-        provider = _resolve_provider(cfg, local_llm, local_llm_url, model, context_mode=ctx_mode)
-        if provider is not None:
-            if isinstance(provider, LocalProvider) and not provider.is_available():
-                if local_llm:
-                    console.print(
-                        "[yellow]⚠ Local LLM not reachable — falling back to Markdown formatter.[/yellow]"
-                    )
-            else:
-                diff_snippets = _collect_diff_snippets(tasks, None, all_commits=True) if ctx_mode in ("diffs",
-                                                                                                      "both") else None
-                active_provider = provider
-                llm_output = provider.summarize_report(tasks, report_date, diff_snippets)
 
-    md = llm_output if llm_output else format_report(tasks, report_date)
-
-    _print_status_line(resolved_author, active_provider, ctx_mode)
-    if output:
-        Path(output).write_text(md, encoding="utf-8")
-        console.print(f"Report saved to [bold]{output}[/bold]")
+    if use_markdown:
+        md = llm_output if llm_output else format_report(tasks, report_date)
+        if output:
+            Path(output).write_text(md, encoding="utf-8")
+            console.print(f"Report saved to [bold]{output}[/bold]")
+        else:
+            console.print(md, markup=False, highlight=False)
     else:
-        console.print(md, markup=False, highlight=False)
+        if llm_output:
+            console.print(llm_output, markup=False, highlight=False)
+        else:
+            console.print(
+                format_standup(tasks, report_date, group_by=group_by if multi else "project"),
+                highlight=False,
+            )
 
 
 # ---------------------------------------------------------------------------
@@ -694,6 +605,7 @@ def week(
     active_provider: object | None = None
     llm_output: str | None = None
     if not no_llm:
+        from gitglimpse.providers.local import LocalProvider
         provider = _resolve_provider(cfg, local_llm, local_llm_url, model, context_mode=ctx_mode)
         if provider is not None:
             if isinstance(provider, LocalProvider) and not provider.is_available():
@@ -825,6 +737,7 @@ def pr(
     active_provider: object | None = None
     llm_output: str | None = None
     if not no_llm:
+        from gitglimpse.providers.local import LocalProvider
         provider = _resolve_provider(cfg, local_llm, local_llm_url, model, context_mode=ctx_mode)
         if provider is not None:
             if isinstance(provider, LocalProvider) and not provider.is_available():
@@ -951,12 +864,6 @@ def init(
     """
     root = Path(repo) if repo else Path.cwd()
 
-    try:
-        cfg = load_config()
-        context_mode = cfg.context_mode
-    except Exception:
-        context_mode = "commits"
-
     targets: list[tuple[Path, str]] = [
         (root / ".claude" / "commands", "Claude Code"),
     ]
@@ -966,8 +873,6 @@ def init(
     created: list[Path] = []
     skipped: list[Path] = []
 
-    console.print(f"[dim]Context mode: {context_mode}  (change with: glimpse config setup)[/dim]")
-
     for commands_dir, tool_name in targets:
         console.print(f"\n[bold]{tool_name}[/bold] → {commands_dir}")
         for name in _COMMAND_TEMPLATES:
@@ -977,16 +882,6 @@ def init(
             except Exception as exc:
                 console.print(f"  [red]Could not read template {name}: {exc}[/red]")
                 continue
-            content = content.replace(
-                "glimpse standup --json",
-                f"glimpse standup --json --context {context_mode}",
-            ).replace(
-                "glimpse week --json",
-                f"glimpse week --json --context {context_mode}",
-            ).replace(
-                "glimpse pr --json",
-                f"glimpse pr --json --context {context_mode}",
-            )
             written = _write_command_file(dest, content, force=force, dry_run=False)
             if written:
                 console.print(f"  [green]✓[/green] Created {dest.relative_to(root)}")
@@ -996,9 +891,14 @@ def init(
 
     console.print()
     if created:
+        commands_dir = created[0].parent
         console.print(
             f"[bold green]Done.[/bold green] "
             f"Created {len(created)} file{'s' if len(created) != 1 else ''}."
         )
+        console.print(
+            f"[dim]Commands use --context both for maximum LLM context. "
+            f"Edit the files in {commands_dir.relative_to(root)}/ to change this.[/dim]"
+        )
     else:
         console.print("[yellow]No files were created.[/yellow]")

{gitglimpse-0.1.3 → gitglimpse-0.1.5}/src/gitglimpse/commands/pr.md

@@ -3,7 +3,7 @@ Generate a pull request summary from your current branch.
 Run the following shell command and capture its output:
 
 ```
-glimpse pr --json
+glimpse pr --json --context both
 ```
 
 Then format the JSON result into a clean PR description using this structure:

{gitglimpse-0.1.3 → gitglimpse-0.1.5}/src/gitglimpse/commands/report.md

@@ -3,7 +3,7 @@ Generate a detailed daily report from your git commits.
 Run the following shell command and capture its output:
 
 ```
-glimpse standup --json
+glimpse standup --json --context both
 ```
 
 Then format the JSON result into a **Markdown daily report** using this structure:

{gitglimpse-0.1.3 → gitglimpse-0.1.5}/src/gitglimpse/commands/standup.md

@@ -3,7 +3,7 @@ Generate a standup update from your recent git commits.
 Run the following shell command and capture its output:
 
 ```
-glimpse standup --json
+glimpse standup --json --context both
 ```
 
 Then format the JSON result into a clean standup update using **exactly** this structure:

{gitglimpse-0.1.3 → gitglimpse-0.1.5}/src/gitglimpse/commands/week.md

@@ -3,7 +3,7 @@ Generate a weekly summary of your git activity.
 Run the following shell command and capture its output:
 
 ```
-glimpse week --json
+glimpse week --json --context both
 ```
 
 Then format the JSON result into a **weekly summary** using this structure:

{gitglimpse-0.1.3 → gitglimpse-0.1.5}/src/gitglimpse/providers/claude.py

@@ -5,8 +5,6 @@ from __future__ import annotations
 from datetime import date
 from typing import TYPE_CHECKING
 
-import httpx
-
 from gitglimpse.providers.base import BaseLLMProvider, _warn, validate_llm_output
 
 if TYPE_CHECKING:
@@ -14,9 +12,18 @@ if TYPE_CHECKING:
 
 _API_URL = "https://api.anthropic.com/v1/messages"
 _ANTHROPIC_VERSION = "2023-06-01"
-_TIMEOUT = httpx.Timeout(connect=30.0, read=120.0, write=30.0, pool=30.0)
 _MAX_TOKENS = 1024
 
+_HTTPX_INSTALL_HINT = "httpx is required for LLM features. Install with: pip install 'gitglimpse[llm]'"
+
+
+def _import_httpx():
+    try:
+        import httpx
+        return httpx
+    except ImportError:
+        raise ImportError(_HTTPX_INSTALL_HINT)
+
 
 class ClaudeProvider(BaseLLMProvider):
     """Anthropic Claude messages provider."""
@@ -27,6 +34,7 @@ class ClaudeProvider(BaseLLMProvider):
         self.context_mode = context_mode
 
     def _chat(self, user_message: str, system_prompt: str | None = None) -> str | None:
+        httpx = _import_httpx()
         if system_prompt is None:
             system_prompt = self.get_system_prompt()
         headers = {
@@ -40,9 +48,10 @@ class ClaudeProvider(BaseLLMProvider):
             "system": system_prompt,
             "messages": [{"role": "user", "content": user_message}],
         }
+        _timeout = httpx.Timeout(connect=30.0, read=120.0, write=30.0, pool=30.0)
         try:
             with _warn.status(f"[dim]Generating with {self.model}...[/dim]"):
-                resp = httpx.post(_API_URL, json=payload, headers=headers, timeout=_TIMEOUT)
+                resp = httpx.post(_API_URL, json=payload, headers=headers, timeout=_timeout)
             if resp.status_code == 401:
                 _warn.print("[yellow]⚠ Claude: invalid API key.[/yellow]")
                 return None

{gitglimpse-0.1.3 → gitglimpse-0.1.5}/src/gitglimpse/providers/gemini.py

@@ -5,15 +5,22 @@ from __future__ import annotations
 from datetime import date
 from typing import TYPE_CHECKING
 
-import httpx
-
 from gitglimpse.providers.base import BaseLLMProvider, _warn, validate_llm_output
 
 if TYPE_CHECKING:
     from gitglimpse.grouping import Task
 
 _API_BASE = "https://generativelanguage.googleapis.com/v1beta/models"
-_TIMEOUT = httpx.Timeout(connect=30.0, read=120.0, write=30.0, pool=30.0)
+
+_HTTPX_INSTALL_HINT = "httpx is required for LLM features. Install with: pip install 'gitglimpse[llm]'"
+
+
+def _import_httpx():
+    try:
+        import httpx
+        return httpx
+    except ImportError:
+        raise ImportError(_HTTPX_INSTALL_HINT)
 
 
 class GeminiProvider(BaseLLMProvider):
@@ -25,6 +32,7 @@ class GeminiProvider(BaseLLMProvider):
         self.context_mode = context_mode
 
     def _chat(self, user_message: str, system_prompt: str | None = None) -> str | None:
+        httpx = _import_httpx()
         if system_prompt is None:
             system_prompt = self.get_system_prompt()
         url = f"{_API_BASE}/{self.model}:generateContent?key={self.api_key}"
@@ -36,9 +44,10 @@ class GeminiProvider(BaseLLMProvider):
                 {"parts": [{"text": user_message}]}
             ],
         }
+        _timeout = httpx.Timeout(connect=30.0, read=120.0, write=30.0, pool=30.0)
         try:
             with _warn.status(f"[dim]Generating with {self.model}...[/dim]"):
-                resp = httpx.post(url, json=payload, timeout=_TIMEOUT)
+                resp = httpx.post(url, json=payload, timeout=_timeout)
             if resp.status_code == 400:
                 _warn.print("[yellow]⚠ Gemini: bad request (check API key or model name).[/yellow]")
                 return None

{gitglimpse-0.1.3 → gitglimpse-0.1.5}/src/gitglimpse/providers/local.py

@@ -5,8 +5,6 @@ from __future__ import annotations
 from datetime import date
 from typing import TYPE_CHECKING
 
-import httpx
-
 from gitglimpse.providers.base import BaseLLMProvider, _warn, validate_llm_output
 
 if TYPE_CHECKING:
@@ -17,6 +15,16 @@ _READ_TIMEOUT = 240.0
 _AVAILABILITY_TIMEOUT = 3.0
 _DEFAULT_MODEL = "qwen2.5-coder:latest"
 
+_HTTPX_INSTALL_HINT = "httpx is required for LLM features. Install with: pip install 'gitglimpse[llm]'"
+
+
+def _import_httpx():
+    try:
+        import httpx
+        return httpx
+    except ImportError:
+        raise ImportError(_HTTPX_INSTALL_HINT)
+
 
 class LocalProvider(BaseLLMProvider):
     """OpenAI-compatible local LLM (Ollama, LM Studio, etc.)."""
@@ -27,6 +35,7 @@ class LocalProvider(BaseLLMProvider):
         model: str | None = None,
         context_mode: str = "commits",
     ) -> None:
+        httpx = _import_httpx()
         self.base_url = base_url.rstrip("/")
         self._explicit_model = model
         self._model_resolved = bool(model)
@@ -41,6 +50,7 @@ class LocalProvider(BaseLLMProvider):
 
     def is_available(self) -> bool:
         """Return True if the local server responds to a quick probe."""
+        httpx = _import_httpx()
         try:
             resp = httpx.get(
                 f"{self.base_url}/models",
@@ -55,6 +65,7 @@ class LocalProvider(BaseLLMProvider):
         if self._model_resolved:
             return
         self._model_resolved = True
+        httpx = _import_httpx()
         try:
             resp = httpx.get(
                 f"{self.base_url}/models",
@@ -68,6 +79,7 @@ class LocalProvider(BaseLLMProvider):
             pass  # keep the default
 
     def _chat(self, user_message: str, system_prompt: str | None = None) -> str | None:
+        httpx = _import_httpx()
         self._auto_detect_model()
         url = f"{self.base_url}/chat/completions"
         if system_prompt is None:

{gitglimpse-0.1.3 → gitglimpse-0.1.5}/src/gitglimpse/providers/openai.py

@@ -5,15 +5,22 @@ from __future__ import annotations
 from datetime import date
 from typing import TYPE_CHECKING
 
-import httpx
-
 from gitglimpse.providers.base import BaseLLMProvider, _warn, validate_llm_output
 
 if TYPE_CHECKING:
     from gitglimpse.grouping import Task
 
 _API_URL = "https://api.openai.com/v1/chat/completions"
-_TIMEOUT = httpx.Timeout(connect=30.0, read=120.0, write=30.0, pool=30.0)
+
+_HTTPX_INSTALL_HINT = "httpx is required for LLM features. Install with: pip install 'gitglimpse[llm]'"
+
+
+def _import_httpx():
+    try:
+        import httpx
+        return httpx
+    except ImportError:
+        raise ImportError(_HTTPX_INSTALL_HINT)
 
 
 class OpenAIProvider(BaseLLMProvider):
@@ -25,6 +32,7 @@ class OpenAIProvider(BaseLLMProvider):
         self.context_mode = context_mode
 
     def _chat(self, user_message: str, system_prompt: str | None = None) -> str | None:
+        httpx = _import_httpx()
         if system_prompt is None:
             system_prompt = self.get_system_prompt()
         headers = {
@@ -38,9 +46,10 @@ class OpenAIProvider(BaseLLMProvider):
                 {"role": "user", "content": user_message},
             ],
         }
+        _timeout = httpx.Timeout(connect=30.0, read=120.0, write=30.0, pool=30.0)
         try:
             with _warn.status(f"[dim]Generating with {self.model}...[/dim]"):
-                resp = httpx.post(_API_URL, json=payload, headers=headers, timeout=_TIMEOUT)
+                resp = httpx.post(_API_URL, json=payload, headers=headers, timeout=_timeout)
             if resp.status_code == 401:
                 _warn.print("[yellow]⚠ OpenAI: invalid API key.[/yellow]")
                 return None

gitglimpse-0.1.3/PKG-INFO

@@ -1,23 +0,0 @@
-Metadata-Version: 2.4
-Name: gitglimpse
-Version: 0.1.3
-Summary: Analyze git history and generate standup updates, daily reports, and weekly summaries.
-Project-URL: Homepage, https://github.com/dino/gitglimpse
-Project-URL: Repository, https://github.com/dino/gitglimpse
-Project-URL: Bug Tracker, https://github.com/dino/gitglimpse/issues
-Author: Dino
-License: MIT
-License-File: LICENSE
-Keywords: cli,developer-tools,git,standup
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.11
-Requires-Dist: inquirerpy>=0.3.4
-Requires-Dist: platformdirs>=4.0
-Requires-Dist: rich>=13.0
-Requires-Dist: tomli-w>=1.2
-Requires-Dist: typer[all]>=0.9.0
-Provides-Extra: llm
-Requires-Dist: httpx>=0.27; extra == 'llm'

gitglimpse-0.1.3/src/gitglimpse/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.1.3"