usepr 0.1.2__py3-none-any.whl

usepr/cli/commands/generate_command.py

@@ -0,0 +1,178 @@
+"""GenerateCommand - CLI command."""
+
+from __future__ import annotations
+
+import os
+from typing import Annotated, Optional
+
+import pyperclip
+import typer
+from rich.panel import Panel
+from rich.syntax import Syntax
+from usecli import BaseCommand, Prompt, console, theme
+
+from usepr.configs.dspy import configure_dspy
+from usepr.services.pr_summary_service import (
+    gather_commits,
+    generate_summary,
+    get_templates,
+)
+from usepr.utils.github import PrTemplate
+
+
+class GenerateCommand(BaseCommand):
+    def signature(self) -> str:
+        return "generate"
+
+    def description(self) -> str:
+        return "Description for generate command"
+
+    def aliases(self) -> list[str]:
+        return ["gen"]
+
+    def _prompt_for_template(self, templates: list[PrTemplate]) -> PrTemplate | None:
+        """Prompt the user to select a PR template, or skip."""
+        if not templates:
+            return None
+
+        if len(templates) == 1:
+            t = templates[0]
+            label = t.name or os.path.basename(t.path)
+            use = (
+                (
+                    Prompt.ask(
+                        f"\n[bold {theme.ACCENT}]Found PR template:[/bold {theme.ACCENT}] {label} — use it?",
+                        default="y",
+                        choices=["y", "n"],
+                        show_choices=False,
+                    )
+                    or ""
+                )
+                .lower()
+                .strip()
+            )
+            return t if use == "y" else None
+
+        console.print(
+            f"\n[bold {theme.ACCENT}]Found {len(templates)} PR templates:[/bold {theme.ACCENT}]"
+        )
+        for i, t in enumerate(templates, 1):
+            label = t.name or os.path.basename(t.path)
+            console.print(f"  {i}. {label} [dim]({t.path})[/dim]")
+
+        console.print("  0. [dim]Skip template[/dim]")
+
+        choice = Prompt.ask(
+            "Select a template number",
+            default="0",
+        )
+        try:
+            idx = int(choice) if choice else 0
+        except ValueError:
+            return None
+        if idx == 0 or idx > len(templates):
+            return None
+        return templates[idx - 1]
+
+    def handle(
+        self,
+        model: Annotated[
+            Optional[str],
+            typer.Option("-m", "--model", help="Override the default LLM model."),
+        ] = None,
+    ) -> None:
+
+        configure_dspy(model)
+
+        repo = os.path.abspath(".")
+
+        console.clear()
+        console.print(f"[bold {theme.PRIMARY}]Pull Request Summary Generator")
+
+        from usepr.utils.git import get_default_branch
+
+        default_branch = get_default_branch(repo).strip()
+        base_branch = (
+            Prompt.ask(
+                f"\n[bold {theme.ACCENT}]Base branch to diff against[/bold {theme.ACCENT}] [dim](default: {default_branch})[/dim]",
+                default="",
+            )
+            or ""
+        ).strip()
+
+        if not base_branch:
+            base_branch = default_branch
+
+        commit_ctx = gather_commits(repo, base_branch)
+
+        if not commit_ctx.commits:
+            console.print(
+                "[red]No commits found between the specified tags or branches."
+            )
+            return
+
+        # proceed = Prompt.ask(
+        #     "Do you want to proceed with generating the summary?",
+        #     default="y",
+        #     choices=["y", "n"],
+        #     show_choices=False,
+        # )
+        # if proceed and proceed.lower() != "y":
+        #     console.print("Aborting summary generation.")
+        #     return
+
+        related_issues = Prompt.ask(
+            "List any related issues or tasks (comma-separated), or leave blank if none:",
+            default="",
+        )
+
+        templates = get_templates(repo)
+        selected_template = self._prompt_for_template(templates)
+        template_content = selected_template.content if selected_template else None
+
+        result = generate_summary(
+            commits=commit_ctx.commits,
+            related_issues=related_issues,
+            template=template_content,
+        )
+
+        console.print()
+
+        summary_md = Syntax(
+            result.summary,
+            "markdown",
+            theme="monokai",
+            line_numbers=False,
+            word_wrap=True,
+        )
+        console.print(
+            Panel(
+                summary_md,
+                title="Pull Request Summary",
+                border_style=theme.SECONDARY,
+                title_align="left",
+            )
+        )
+
+        copy_to_clipboard = (
+            (
+                Prompt.ask(
+                    f"\n[bold {theme.WARNING}]Copy to clipboard?[/bold {theme.WARNING}]",
+                    default="y",
+                    choices=["y", "n"],
+                )
+                or ""
+            )
+            .lower()
+            .strip()
+        )
+        if copy_to_clipboard in ["y", "yes"]:
+            try:
+                pyperclip.copy(result.summary)
+                console.print(
+                    f"[bold {theme.SECONDARY}]✓ Summary copied to clipboard![/bold {theme.SECONDARY}]"
+                )
+            except Exception as e:
+                console.print(
+                    f"[bold {theme.ERROR}]✗ Failed to copy to clipboard: {e}[/bold {theme.ERROR}]"
+                )

usepr/cli/templates/command.py.j2

@@ -0,0 +1,67 @@
+"""{{ class_name }} - CLI command."""
+
+from __future__ import annotations
+
+from usecli import Argument, BaseCommand, Confirm, Menu, Option, Prompt, console, theme
+
+
+class {{ class_name }}(BaseCommand):
+    def signature(self) -> str:
+        return "{{ command_name }}"
+
+    def description(self) -> str:
+        return "Description for {{ command_name }} command"
+
+    # def aliases(self) -> list[str]:
+    #    return ["{{ command_name[:3] }}"]
+
+    def handle(
+        self,
+        name: str = Argument(..., help="An example argument"),
+        verbose: bool = Option(False, "--verbose", "-v", help="Enable verbose output"),
+    ) -> None:
+        console.print(
+            f"[bold {theme.SUCCESS}]Executing {{ command_name }}[/bold {theme.SUCCESS}]"
+        )
+        console.print(f"Hello, {name}!")
+
+        if verbose:
+            console.print("[dim]Verbose mode enabled[/dim]")
+
+        # Example: Text input prompt
+        favorite_color = Prompt.ask(
+            "What's your favorite color?",
+            choices=["red", "green", "blue", "yellow"],
+        )
+        console.print(
+            f"You chose: [bold {theme.ACCENT}]{favorite_color}[/bold {theme.ACCENT}]"
+        )
+
+        # Example: Confirmation prompt (only when verbose)
+        if verbose:
+            if not Confirm.ask("Do you want to continue?"):
+                console.print(f"[{theme.WARNING}]Cancelled by user[/{theme.WARNING}]")
+                return
+            console.print(f"[{theme.SUCCESS}]Proceeding...[/{theme.SUCCESS}]")
+
+        # Example: Single-select menu
+        single_choice = Menu.select(
+            ["Option A", "Option B", "Option C"],
+            title="Pick one option:",
+        )
+        if single_choice:
+            console.print(f"You selected: {single_choice}")
+
+        # Example: Multi-select menu
+        multi_choices = Menu.multi_select(
+            ["Feature 1", "Feature 2", "Feature 3", "Feature 4"],
+            title="Select multiple features (space to select, enter to confirm):",
+        )
+        if multi_choices:
+            console.print(f"You selected {len(multi_choices)} features:")
+            for choice in multi_choices:
+                console.print(f"  - {choice}")
+
+        console.print(
+            f"[bold {theme.PRIMARY}]Command completed![/bold {theme.PRIMARY}]"
+        )

usepr/cli/themes/default.toml

@@ -0,0 +1,29 @@
+[colors]
+# Core semantic colors
+primary = "#60D7FF"
+secondary = "#5EFF87"
+accent = "#F5FE53"
+
+success = "#5EFF87" # Green
+error = "#FE686B"   # Red
+warning = "#F5FE53" # Yellow
+info = "#60D7FF"    # Teal / Blue
+
+# Text
+foreground = "#FFFFFF"       # Text
+foreground_muted = "#BBBBBB" # Subtext
+
+# Surfaces
+background = "#000000"   # Base
+border = "#60D7FF"       # Surface 
+border_focus = "#5EFF87" # Focus Ring
+
+# UI semantics
+command = "#60D7FF"
+option = "#60D7FF"
+link = "#60D7FF"
+prompt = "#5EFF87"
+
+panel_primary = "#5EFF87"
+panel_secondary = "#60D7FF"
+panel_accent = "#F5FE53"

usepr/cli/themes/title.txt

@@ -0,0 +1,7 @@
+                         ▀██▀▀█▄  ▀██▀▀█▄   
+ ▄▄▄ ▄▄▄   ▄▄▄▄    ▄▄▄▄   ██   ██  ██   ██  
+  ██  ██  ██▄ ▀  ▄█▄▄▄██  ██▄▄▄█▀  ██▀▀█▀   
+  ██  ██  ▄ ▀█▄▄ ██       ██       ██   █▄  
+  ▀█▄▄▀█▄ █▀▄▄█▀  ▀█▄▄▄▀ ▄██▄     ▄██▄  ▀█▀ 
+                                           
+ █████▓▓▓▓▓▒▒▒▒▒░░░░░░░░░░░░▒▒▒▒▒▓▓▓▓▓█████

usepr/cli/usecli.config.toml

@@ -0,0 +1,11 @@
+[usecli]
+command_name = "usepr"
+title = "usepr"
+title_file = "themes/title.txt"
+title_font = "ansi_regular"
+description = "Generate Pull Request based on git diff"
+commands_dir = "commands"
+templates_dir = "templates"
+themes_dir = "themes"
+theme = "default"
+hide_inspire = true

usepr/configs/dspy.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+import dspy
+import yaml
+
+APPLICATION_NAME = "usepr"
+
+DEFAULT_MODEL = "openrouter/openai/gpt-oss-120b"
+
+DEFAULT_EXTRA_BODY: dict[str, Any] = {
+    "provider": {"order": ["groq"], "allow_fallbacks": False}
+}
+
+CONFIG_DIR = Path.home() / ".config" / "usepr"
+CONFIG_FILE = CONFIG_DIR / "config.yml"
+
+
+def load_config() -> dict[str, Any]:
+    """Load configuration from ~/.config/usepr/config.yml."""
+    if not CONFIG_FILE.exists():
+        return {}
+    try:
+        with open(CONFIG_FILE) as f:
+            data = yaml.safe_load(f)
+        return data if isinstance(data, dict) else {}
+    except (yaml.YAMLError, OSError):
+        return {}
+
+
+def get_lm(model: str | None = None) -> dspy.LM:
+    """Get a configured DSPy LM instance.
+
+    Priority: explicit model arg > config file > default.
+    """
+    config = load_config()
+
+    resolved_model = model or config.get("model") or DEFAULT_MODEL
+
+    extra_body = config.get("extra_body", DEFAULT_EXTRA_BODY)
+    cache = config.get("cache", False)
+
+    return dspy.LM(
+        resolved_model,
+        cache=cache,
+        extra_body=extra_body,
+        extra_headers={
+            "HTTP-Referer": f"http://{APPLICATION_NAME}.local",
+            "X-Title": APPLICATION_NAME,
+        },
+    )
+
+
+def configure_dspy(model: str | None = None) -> None:
+    """Configure DSPy with the resolved LM."""
+    lm = get_lm(model)
+    dspy.configure(lm=lm)

usepr/modules/pull_request_summary_generator.py

@@ -0,0 +1,35 @@
+import dspy
+
+from usepr.signatures.pull_request_summary_generator import (
+    RULES,
+    TEMPLATE_RULES,
+    PullRequestSummaryGeneratorSignature,
+)
+
+
+class PullRequestSummaryGeneratorModule(dspy.Module):
+    def __init__(self, callbacks=None):
+        super().__init__(callbacks)
+        self.diff_to_pull_request_summary = dspy.ChainOfThought(
+            PullRequestSummaryGeneratorSignature
+        )
+
+    def forward(
+        self,
+        commits: str,
+        related_issues: str | None = None,
+        template: str | None = None,
+    ):
+        if template:
+            rules = TEMPLATE_RULES
+        elif not related_issues or not related_issues.strip():
+            rules = RULES[2:]
+        else:
+            rules = RULES
+        result = self.diff_to_pull_request_summary(
+            commits=commits,
+            rules=rules,
+            related_issues=related_issues,
+            template=template,
+        )
+        return result

usepr/services/__init__.py

@@ -0,0 +1 @@
+"""Services layer for business logic."""

usepr/services/pr_summary_service.py

@@ -0,0 +1,115 @@
+"""PR Summary generation service - business logic layer."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Optional
+
+from usepr.modules.pull_request_summary_generator import (
+    PullRequestSummaryGeneratorModule,
+)
+from usepr.utils.git import (
+    ensure_git_repo,
+    get_commits_between,
+    get_default_branch,
+    parse_commits,
+    resolve_ref,
+)
+from usepr.utils.github import PrTemplate, find_pr_templates
+
+
+@dataclass
+class SummaryResult:
+    """Result from PR summary generation."""
+
+    reasoning: str
+    summary: str
+
+
+@dataclass
+class CommitContext:
+    """Context about commits for summary generation."""
+
+    commits: list[str]
+    base_branch: str
+    default_branch: str
+
+
+def get_default_branch_name(repo_path: str) -> str:
+    """Get the default branch name for the repository.
+
+    Args:
+        repo_path: Absolute path to the repository.
+
+    Returns:
+        The default branch name (e.g., 'main' or 'master').
+    """
+    return get_default_branch(repo_path).strip()
+
+
+def gather_commits(repo_path: str, base_branch: str) -> CommitContext:
+    """Gather commits between base branch and HEAD.
+
+    Args:
+        repo_path: Absolute path to the repository.
+        base_branch: The base branch to diff against.
+
+    Returns:
+        CommitContext with parsed commits and branch info.
+
+    Raises:
+        SystemExit: If not a git repository or ref cannot be resolved.
+    """
+    ensure_git_repo(repo_path)
+
+    default_branch = get_default_branch_name(repo_path)
+    prev_tag = resolve_ref(repo_path, base_branch)
+
+    commit_text = get_commits_between(repo_path, prev_tag, "HEAD")
+    commits = parse_commits(commit_text)
+
+    return CommitContext(
+        commits=commits,
+        base_branch=base_branch,
+        default_branch=default_branch,
+    )
+
+
+def generate_summary(
+    commits: list[str],
+    related_issues: Optional[str] = None,
+    template: Optional[str] = None,
+) -> SummaryResult:
+    """Generate a PR summary from commits.
+
+    Args:
+        commits: List of commit messages.
+        related_issues: Optional comma-separated related issues.
+        template: Optional PR template content.
+
+    Returns:
+        SummaryResult with reasoning and summary.
+    """
+    program = PullRequestSummaryGeneratorModule()
+    result = program(
+        commits=commits,
+        related_issues=related_issues,
+        template=template,
+    )
+
+    return SummaryResult(
+        reasoning=result.reasoning,
+        summary=result.summary,
+    )
+
+
+def get_templates(repo_path: str) -> list[PrTemplate]:
+    """Find PR templates in the repository.
+
+    Args:
+        repo_path: Absolute path to the repository.
+
+    Returns:
+        List of found PR templates.
+    """
+    return find_pr_templates(repo_path)

usepr/signatures/pull_request_summary_generator.py

@@ -0,0 +1,44 @@
+from typing import List, Optional
+
+import dspy
+
+RULES = [
+    "Start the summary with a # Summary header.",
+    "The next section should be ## Linked Issues, listing any related issues or tasks.",
+    "Follow with a ## Description section that details the changes made in the pull request.",
+    "Use bullet points for each major change.",
+    "Keep the summary concise and to the point.",
+    "Highlight any breaking changes or important updates.",
+    "Avoid technical jargon; use clear and simple language.",
+]
+
+TEMPLATE_RULES = [
+    "The output MUST follow the structure of the provided PR template.",
+    "Fill in every section of the template with relevant content derived from the commits.",
+    "Preserve the template's headings, checkbox placeholders, and formatting exactly.",
+    "If a template section does not apply, write 'N/A' rather than omitting it.",
+    "Do not add sections that are not in the template.",
+    "If no template is provided, use the default summary rules instead.",
+]
+
+
+class PullRequestSummaryGeneratorSignature(dspy.Signature):
+    """Generate a concise summary of a pull request based on a list of conventional commit messages. The summary should highlight the main changes introduced by the commits, and may include markdown tables or mermaid diagrams for better visualization when appropriate."""
+
+    rules: List[str] = dspy.InputField(
+        desc="A list of rules to follow when generating the summary."
+    )
+    commits: List[str] = dspy.InputField(desc="A list of conventional commit messages.")
+    related_issues: Optional[str] = dspy.InputField(
+        default=None, desc="A list of related issues or tasks, if any."
+    )
+    template: Optional[str] = dspy.InputField(
+        default=None,
+        desc="A GitHub pull request template to fill out. When provided, the summary must follow this template's structure and fill in each section.",
+    )
+    reasoning: str = dspy.OutputField(
+        desc="Step-by-step reasoning about the commits and how they contribute to the summary."
+    )
+    summary: str = dspy.OutputField(
+        desc="A summary of the pull request based on the provided commits, following the template structure if one was provided."
+    )

usepr/utils/git.py

@@ -0,0 +1,126 @@
+import subprocess
+import sys
+from typing import List, Optional
+
+from usecli import console
+
+
+def run(cmd: list[str], cwd: Optional[str] = None) -> str:
+    """
+    Run a command and return its output as a string.
+
+    Args:
+        cmd: List of command arguments.
+        cwd: Optional working directory.
+
+    Returns:
+        The command output as a string.
+    """
+    return (
+        subprocess.check_output(cmd, stderr=subprocess.STDOUT, cwd=cwd)
+        .decode("utf-8", errors="replace")
+        .strip()
+    )
+
+
+def ensure_git_repo(repo_path: str) -> None:
+    """
+    Ensure the given path is a git repository.
+
+    Args:
+        repo_path: Path to the repository.
+
+    Raises:
+        SystemExit: If not a git repository.
+    """
+    try:
+        run(["git", "rev-parse", "--is-inside-work-tree"], cwd=repo_path)
+    except subprocess.CalledProcessError:
+        sys.stderr.write(f"[error] Not a git repository: {repo_path}\n")
+        sys.exit(2)
+
+
+def get_commits_between(
+    repo_path: str, prev_tag: Optional[str], latest_tag: str = "HEAD"
+) -> str:
+    """
+    Get commit messages between two tags.
+
+    Args:
+        repo_path: Path to the repository.
+        prev_tag: Previous tag, or None to use default branch.
+        latest_tag: Latest tag.
+
+    Returns:
+        Formatted commit messages as string.
+    """
+    # Format: subject, newline, newline, body, separator
+    fmt = "%s%n%n%b----"
+    if prev_tag is None:
+        prev_tag = get_default_branch(repo_path)
+    rng = f"{prev_tag}..{latest_tag}"
+    result = subprocess.run(
+        ["git", "log", "--no-merges", f"--format={fmt}", rng],
+        cwd=repo_path,
+        capture_output=True,
+        text=True,
+        check=True,
+    )
+    text = result.stdout.strip()
+    # Remove trailing separator
+    if text.endswith("----"):
+        text = text[:-4].rstrip()
+    return text
+
+
+def get_default_branch(repo_path: str) -> str:
+    """Get the default branch of the repository (main or master)."""
+    try:
+        result = subprocess.run(
+            ["git", "symbolic-ref", "refs/remotes/origin/HEAD"],
+            cwd=repo_path,
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        return result.stdout.strip().split("/")[-1]
+    except subprocess.CalledProcessError:
+        # Fallback: check if 'main' exists, else 'master'
+        try:
+            subprocess.run(
+                ["git", "show-ref", "--verify", "--quiet", "refs/heads/main"],
+                cwd=repo_path,
+                check=True,
+            )
+            return "main"
+        except subprocess.CalledProcessError:
+            return "master"
+
+
+def resolve_ref(repo_path: str, ref: str) -> str:
+    """Resolve a ref, trying the bare name first then origin/<ref>."""
+    for candidate in [ref, f"origin/{ref}"]:
+        result = subprocess.run(
+            ["git", "rev-parse", "--verify", candidate],
+            cwd=repo_path,
+            capture_output=True,
+        )
+        if result.returncode == 0:
+            return candidate
+    console.print(
+        f"[bold red]Error: Could not resolve ref '{ref}'. Make sure the branch exists locally or on the remote.[/bold red]"
+    )
+    sys.exit(1)
+
+
+def parse_commits(commit_text: str) -> List[str]:
+    """
+    Parse the commit output into a list of individual commit messages.
+
+    Args:
+        commit_text: The formatted commit messages string from get_commits_between.
+
+    Returns:
+        List of individual commit messages.
+    """
+    return [commit.strip() for commit in commit_text.split("----") if commit.strip()]

usepr/utils/github.py

@@ -0,0 +1,85 @@
+"""Utilities for detecting and reading GitHub PR templates."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+from typing import List, Optional
+
+
+@dataclass
+class PrTemplate:
+    """A detected PR template."""
+
+    path: str
+    content: str
+    name: Optional[str] = None
+
+
+TEMPLATE_FILENAMES = ["PULL_REQUEST_TEMPLATE.md"]
+
+TEMPLATE_DIR_NAME = "PULL_REQUEST_TEMPLATE"
+
+GITHUB_DIR = ".github"
+
+
+def _read_text(path: Path) -> Optional[str]:
+    """Read a text file, returning None if unreadable."""
+    try:
+        return path.read_text(encoding="utf-8").strip()
+    except (OSError, UnicodeDecodeError):
+        return None
+
+
+def find_pr_templates(repo_path: str) -> List[PrTemplate]:
+    """
+    Find all PR templates in the repository.
+
+    Searches the following locations in order:
+      1. .github/PULL_REQUEST_TEMPLATE.md
+      2. .github/PULL_REQUEST_TEMPLATE/*.md (all .md files in the directory)
+      3. PULL_REQUEST_TEMPLATE.md (repo root)
+
+    Args:
+        repo_path: Absolute path to the repository root.
+
+    Returns:
+        List of PrTemplate objects found. Empty list if none found.
+    """
+    root = Path(repo_path)
+    templates: List[PrTemplate] = []
+
+    # 1. .github/PULL_REQUEST_TEMPLATE.md
+    github_dir = root / GITHUB_DIR
+    for filename in TEMPLATE_FILENAMES:
+        candidate = github_dir / filename
+        content = _read_text(candidate)
+        if content:
+            templates.append(
+                PrTemplate(path=str(candidate), content=content, name=None)
+            )
+
+    # 2. .github/PULL_REQUEST_TEMPLATE/*.md
+    template_dir = github_dir / TEMPLATE_DIR_NAME
+    if template_dir.is_dir():
+        for md_file in sorted(template_dir.glob("*.md")):
+            content = _read_text(md_file)
+            if content:
+                templates.append(
+                    PrTemplate(
+                        path=str(md_file),
+                        content=content,
+                        name=md_file.stem,
+                    )
+                )
+
+    # 3. Root-level PULL_REQUEST_TEMPLATE.md
+    for filename in TEMPLATE_FILENAMES:
+        candidate = root / filename
+        content = _read_text(candidate)
+        if content:
+            templates.append(
+                PrTemplate(path=str(candidate), content=content, name=None)
+            )
+
+    return templates

usepr-0.1.2.dist-info/METADATA

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: usepr
+Version: 0.1.2
+Summary: Add your description here
+Author: Edward Boswell
+Author-email: Edward Boswell <thememium@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Requires-Dist: dspy>=3.2.1
+Requires-Dist: pyperclip>=1.11.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: rich>=15.0.0
+Requires-Dist: typer>=0.26.7
+Requires-Dist: usecli>=0.1.67
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/thememium/usepr
+Project-URL: Documentation, https://github.com/thememium/usepr
+Project-URL: Repository, https://github.com/thememium/usepr.git
+Project-URL: Issues, https://github.com/thememium/usepr/issues
+Project-URL: Changelog, https://github.com/thememium/usepr/blob/master/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+<a name="readme-top"></a>
+
+<div align="center">
+  <a href="https://github.com/thememium/usepr">
+    <img src="https://raw.githubusercontent.com/thememium/usepr/refs/heads/master/docs/images/usepr-logo-dark-bg.png" alt="usePR" width="360" height="162">
+  </a>
+
+  <p align="center">
+    <em>AI-powered PR summary generator for Git repositories</em>
+  </p>
+
+  <p align="center">
+    <a href="#table-of-contents"><strong>Explore the Documentation »</strong></a>
+    <br />
+    <a href="https://github.com/thememium/usepr/issues">Report Bug</a>
+    ·
+    <a href="https://github.com/thememium/usepr/issues">Request Feature</a>
+  </p>
+</div>
+
+<!-- TABLE OF CONTENTS -->
+
+<a name="table-of-contents"></a>
+
+<details>
+  <summary>Table of Contents</summary>
+  <ol>
+    <li><a href="#about">About</a></li>
+    <li><a href="#quick-start">Quick Start</a></li>
+    <li><a href="#usage">Usage</a></li>
+    <li><a href="#development">Development</a></li>
+    <li><a href="#contributing">Contributing</a></li>
+    <li><a href="#license">License</a></li>
+  </ol>
+</details>
+
+<!-- ABOUT -->
+
+## About
+
+usepr (`usepr`) is a Python CLI that generates pull request summaries from your git commits using AI (DSPy). It analyzes your commit history and produces well-structured, meaningful PR descriptions.
+
+- **AI-powered summaries** - Uses DSPy ChainOfThought to understand and summarize your changes
+- **Template support** - Automatically detects and uses PR templates from your repository
+- **Flexible diffing** - Generate summaries between any branches, tags, or commits
+- **Interactive prompts** - Guided workflow with base branch and issue selection
+- **Clipboard integration** - Copy generated summaries directly to clipboard
+- **Model override** - Use different LLM models via the `-m` flag
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+<!-- QUICK START -->
+
+## Quick Start
+
+### Install usepr with uv (recommended)
+
+```sh
+uv tool install usepr
+```
+
+### Install with pipx (alternative)
+
+```sh
+pipx install usepr
+```
+
+### Generate a PR summary
+
+```sh
+usepr generate
+```
+
+This will prompt you to select a base branch, optionally link related issues, and generate a summary from your commits.
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+<!-- USAGE -->
+
+## Usage
+
+### Generate a PR Summary
+
+```sh
+usepr generate
+```
+
+The interactive workflow will:
+
+1. Detect your repository's default branch
+2. Prompt for a base branch to diff against
+3. Gather commits between base and HEAD
+4. Ask for related issues (optional)
+5. Detect and offer PR templates (if any)
+6. Generate and display the summary
+7. Offer to copy to clipboard
+
+### Use a Custom Model
+
+Set your API key as an environment variable for the provider you're using:
+
+```sh
+export OPENAI_API_KEY="sk-..."
+export ANTHROPIC_API_KEY="sk-ant-..."
+```
+
+Then run with the `provider/model` format:
+
+```sh
+usepr generate -m openai/gpt-4o
+usepr generate -m anthropic/claude-sonnet-4-20250514
+usepr generate -m openrouter/google/gemini-2.5-flash
+```
+
+### Use the Short Alias
+
+```sh
+usepr gen
+```
+
+### Available Commands
+
+```
+generate (gen)  Generate a PR summary from commits
+help            Show help
+```
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+<!-- DEVELOPMENT -->
+
+## Development
+
+Common tasks:
+
+```sh
+uv run poe clean-full
+uv run poe test
+uv run poe lint
+uv run poe format
+```
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+<!-- CONTRIBUTING -->
+
+## Contributing
+
+Quick workflow:
+
+1. Fork and branch: `git checkout -b feature/name`
+2. Make changes
+3. Run checks: `uv run poe clean-full`
+4. Commit and push
+5. Open a Pull Request
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+<!-- LICENSE -->
+
+## License
+
+License information has not been added yet.
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+---
+
+<div align="center">
+  <p>
+    <sub>Built by <a href="https://github.com/thememium">thememium</a></sub>
+  </p>
+</div>

usepr-0.1.2.dist-info/RECORD

@@ -0,0 +1,24 @@
+usepr/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+usepr/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+usepr/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+usepr/cli/commands/generate_command.py,sha256=-ouv_Mg-PoPTqoa8NrawC0_Ht82R_fy09ynN90PHsC4,5309
+usepr/cli/templates/command.py.j2,sha256=glpKmz98KtFTZmmYtPYUeFrUqUfRJTFCYIQMKnaPQ-M,2322
+usepr/cli/themes/default.toml,sha256=tNtI6yTUgbnTevSO2Q9RN06oH1FXs0H7_cAfIB8GY0I,583
+usepr/cli/themes/title.txt,sha256=JiHOBLFhhhnd0c_jngSj2JqXV0-yaF61L3nRavCmsWs,619
+usepr/cli/usecli.config.toml,sha256=63P9KMcDIRXtS22TsJb6S8Opcv1xt6MNCkMPur3xrkA,278
+usepr/configs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+usepr/configs/dspy.py,sha256=w1KnqU6zA-5LMh0nrsc3I0_VzPqmko3UCSC1cE4cQDM,1476
+usepr/modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+usepr/modules/pull_request_summary_generator.py,sha256=l2F4nTt1CHe8llxQVI3gihafpvtU5VVhLTPTZO4LXjE,948
+usepr/services/__init__.py,sha256=kMCe_42FMbwfHA6AT5yB7O2KB-mB89K46ZOamy-40Ak,41
+usepr/services/pr_summary_service.py,sha256=LTOXcmgm79FMS0YJ2m1REL_1iXTHUOPXT2C1fRTTHkQ,2781
+usepr/signatures/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+usepr/signatures/pull_request_summary_generator.py,sha256=1uMweJNqNLOk2DBBK2lhKUPi0W-TcTBJM8QUWdh6jhk,2214
+usepr/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+usepr/utils/git.py,sha256=Nn3DSDuprgqGvB4AldCiVT3YYLmJAC6DEpDP7tHZ_eo,3581
+usepr/utils/github.py,sha256=LW1ZHpv2nVD0qejYMqw0VUwknv4oZ1pDARKk0avyky0,2369
+usepr-0.1.2.dist-info/licenses/LICENSE,sha256=3URXXqgUcmPG_29EcFLqyGt7EWNGU709amKh90jCQIA,1081
+usepr-0.1.2.dist-info/WHEEL,sha256=8ZlpUMJ7mlDirmlHRhDirEx_nPnARrwDjeE92mlk68E,81
+usepr-0.1.2.dist-info/entry_points.txt,sha256=sVOvvsPgBzAE5AHTqZ9EqwKy5Bcc50bvlgUvHUf-_nQ,39
+usepr-0.1.2.dist-info/METADATA,sha256=9fQD_N4u2DAtgeMy4b1qNs-iNaFpuGWnqAwwnPqEyQY,4872
+usepr-0.1.2.dist-info/RECORD,,

usepr-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.21
+Root-Is-Purelib: true
+Tag: py3-none-any

usepr-0.1.2.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+usepr = usecli:main
+

usepr-0.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026–present Edward Boswell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.