recon-github 0.1.7__tar.gz → 1.0.0__tar.gz

recon_github-0.1.7/.agents/rich-ui-architect.md → recon_github-1.0.0/.github/agents/rich-ui-architect.agent.md

@@ -1,3 +1,8 @@
+---
+name: rich-ui-architect
+description: "Design and implement consistent, reusable Rich terminal UI for the Recon CLI."
+---
+
 # Recon CLI — UI/UX & Rich Component Agent
 
 You are the UI/UX and terminal-interface agent for **Recon CLI**, a Python CLI application for exploring GitHub profiles and repositories.

{recon_github-0.1.7 → recon_github-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: recon-github
-Version: 0.1.7
+Version: 1.0.0
 Summary: Recon is a powerful CLI companion for developers and tools for agents, turning GitHub activity and repository data into useful insights from your terminal
 License-File: LICENSE
 Requires-Python: >=3.12

{recon_github-0.1.7 → recon_github-1.0.0}/app/commands/repo.py

@@ -105,7 +105,6 @@ def details(
         get_repo_details,
         get_top_contributors,
     )
-    from app.ui.repo import display_view_header
 
     details = get_repo_details(owner, repo)
 
@@ -153,43 +152,6 @@ def details(
         get_top_contributors(owner, repo, limit=5),
     )
 
-    display_view_header("Details", details.get("full_name", f"{owner}/{repo}"))
+    from app.ui.repo import display_repo_details
 
-    # Repo Details
-    typer.echo("Repository")
-    typer.echo("-----------")
-    typer.echo(f"{details.get('full_name', f'{owner}/{repo}')}")  # Name
-    description = details.get("description") or "—"
-    typer.echo(f"description: {format_description(description)}")  # Description
-    typer.echo(
-        f"visibility: {details.get('visibility') or ('private' if details.get('private') else 'public')}"  # Visibility
-    )
-    typer.echo(
-        f"url: {details.get('html_url') or f'https://github.com/{owner}/{repo}'}"
-    )  # URL
-
-    # Stats
-    typer.echo("")
-    typer.echo("Stats")
-    typer.echo("-----------")
-    typer.echo(f"stars: {details.get('stargazers_count') or 0}")  # Stars
-    typer.echo(f"forks: {details.get('forks_count')}")  # Forks
-    typer.echo(f"issues: {details.get('open_issues_count') or 0}")  # Issues
-    typer.echo(f"size: {format_size(details.get('size'))}")  # Size
-
-    typer.echo("")
-    typer.echo("Contributions")
-    typer.echo("-----------")
-    if not contributions:
-        typer.echo("No contributor data returned.")
-    else:
-        for contributor in contributions:
-            typer.echo(f"{contributor['login']}: {contributor['commits']} commits")
-
-    # Tech
-    typer.echo("")
-    typer.echo("Languages")
-    typer.echo("---------")
-
-    for language in format_languages(language_data):
-        typer.echo(language)
+    display_repo_details(details, language_data, contributions)

{recon_github-0.1.7 → recon_github-1.0.0}/app/ui/repo.py

@@ -187,7 +187,7 @@ def format_bytes(size: int | None) -> str:
 
 def display_repo_details(
     details: dict,
-    languages: list[str],
+    languages: dict[str, int],
     contributions: list[dict],
 ):
     """Display a repository overview."""
@@ -197,70 +197,51 @@ def display_repo_details(
     visibility = details.get("visibility") or (
         "private" if details.get("private") else "public"
     )
-    primary_language = details.get("language") or "—"
     url = details.get("html_url") or "—"
 
     header_panel = build_view_header("Details", full_name)
 
-    # Statistics
-    stats = Table(
-        show_header=False,
-        box=None,
-        pad_edge=False,
-    )
-
-    stats.add_column("Metric", style="dim")
-    stats.add_column("Value", justify="right")
-
-    stats.add_row(
-        "★ Stars",
-        str(details.get("stargazers_count") or 0),
-    )
-    stats.add_row(
-        "⑂ Forks",
-        str(details.get("forks_count") or 0),
-    )
-    stats.add_row(
-        "! Issues",
-        str(details.get("open_issues_count") or 0),
-    )
-    stats.add_row(
-        "Size",
-        format_size(details.get("size")),
-    )
-
-    stats_panel = Panel(
-        stats,
-        title="Statistics",
-        expand=False,
-    )
-
     # Contributions
     contribution_table = Table(
         show_header=False,
         box=None,
         pad_edge=False,
+        padding=(0, 1),
     )
 
     contribution_table.add_column("Contributor")
     contribution_table.add_column("Commits", justify="right")
+    contribution_table.add_column("Share", justify="right")
 
-    if contributions:
-        for contributor in contributions:
+    ranked_contributions = contributions[:5]
+    if ranked_contributions:
+        total_commits = sum(
+            int(contributor.get("commits") or 0) for contributor in ranked_contributions
+        )
+        for index, contributor in enumerate(ranked_contributions):
+            commits = int(contributor.get("commits") or 0)
+            percentage = commits / total_commits * 100 if total_commits else 0
             contribution_table.add_row(
-                contributor["login"],
-                str(contributor["commits"]),
+                str(contributor.get("login") or "Unknown"),
+                _format_count(commits),
+                _overview_bar_label(
+                    percentage, spaced=index < len(ranked_contributions) - 1
+                ),
             )
     else:
         contribution_table.add_row(
             "No contributor data",
             "—",
+            "",
         )
+    for _ in range(len(ranked_contributions) if ranked_contributions else 1, 5):
+        contribution_table.add_row("", "", "")
 
     contributions_panel = Panel(
         contribution_table,
-        title="Contributions",
+        title="Contributors",
         expand=False,
+        border_style="cyan",
     )
 
     # Languages
@@ -268,51 +249,82 @@ def display_repo_details(
         show_header=False,
         box=None,
         pad_edge=False,
+        expand=True,
+        padding=(0, 1),
     )
 
     language_table.add_column("Language")
-    language_table.add_column("Usage")
+    language_table.add_column("Usage", justify="right")
 
-    for language in languages:
-        language_name, percentage = language.split(": ")
-        language_table.add_row(
-            language_name,
-            percentage,
-        )
+    if not languages:
+        language_table.add_row("No language data returned.", "")
+    else:
+        total_bytes = sum(languages.values())
+        ranked_languages = sorted(
+            languages.items(), key=lambda item: item[1], reverse=True
+        )[:5]
+        for index, (language, byte_count) in enumerate(ranked_languages):
+            percentage = byte_count / total_bytes * 100 if total_bytes else 0
+            language_table.add_row(
+                language,
+                _overview_bar_label(
+                    percentage, spaced=index < len(ranked_languages) - 1
+                ),
+            )
+        for _ in range(min(len(languages), 5), 5):
+            language_table.add_row("", "")
+    if not languages:
+        for _ in range(1, 5):
+            language_table.add_row("", "")
 
     languages_panel = Panel(
         language_table,
         title="Languages",
         expand=False,
+        border_style="cyan",
     )
 
-    console.print(header_panel)
-    console.print(Text(description, style="dim"))
-    console.print(
-        Text.assemble(
-            (visibility.capitalize(), "cyan"),
-            ("    "),
-            (primary_language, "green"),
-        )
+    repository = Table(show_header=False, box=None, pad_edge=False, expand=True)
+    repository.add_column("Label", style="dim", no_wrap=True)
+    repository.add_column("Value", overflow="fold")
+    repository.add_row("Description", description)
+    repository.add_row("Visibility", visibility.capitalize())
+    repository.add_row("URL", url)
+    repository.add_row("★ Stars", str(details.get("stargazers_count") or 0))
+    repository.add_row("⑂ Forks", str(details.get("forks_count") or 0))
+    repository.add_row("! Issues", str(details.get("open_issues_count") or 0))
+    repository.add_row("Size", format_size(details.get("size")))
+    repository_panel = Panel(
+        repository,
+        title="Repository",
+        border_style="cyan",
+        width=60,
     )
-    console.print()
 
+    console.print(header_panel)
+    console.print()
     console.print(
         Columns(
-            [stats_panel, contributions_panel],
+            [contributions_panel, languages_panel],
             expand=False,
             equal=True,
+            padding=(0, 0),
         )
     )
+    console.print()
+    console.print(repository_panel)
 
-    console.print(languages_panel)
 
-    console.print(
-        Text(
-            f"↗ {url}",
-            style="dim",
-        )
-    )
+def _progress_bar(percentage: float, width: int = 12) -> str:
+    """Build a compact proportional bar for overview panels."""
+    filled = round(max(0, min(100, percentage)) / 100 * width)
+    return f"[green]{'█' * filled}[/green]"
+
+
+def _overview_bar_label(percentage: float, spaced: bool = True) -> str:
+    """Render an overview bar with a compact line of breathing room."""
+    suffix = "\n" if spaced else ""
+    return f"{_progress_bar(percentage)} {percentage:.1f}%{suffix}"
 
 
 def display_contributors(

{recon_github-0.1.7 → recon_github-1.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "recon-github"
-version = "0.1.7"
+version = "1.0.0"
 description = "Recon is a powerful CLI companion for developers and tools for agents, turning GitHub activity and repository data into useful insights from your terminal"
 readme = "README.md"
 requires-python = ">=3.12"

{recon_github-0.1.7 → recon_github-1.0.0}/tests/test_cli_commands.py

@@ -160,17 +160,53 @@ def test_details_rejects_both_views():
 
 
 def test_details_default_calls_services_and_prints(monkeypatch):
-    details = {"full_name": "o/r", "description": "desc", "size": 1}
+    details = {
+        "full_name": "o/r",
+        "description": "desc",
+        "visibility": "public",
+        "html_url": "https://github.com/o/r",
+        "stargazers_count": 3,
+        "forks_count": 2,
+        "open_issues_count": 1,
+        "size": 1,
+    }
     monkeypatch.setattr(
         "app.services.github.get_repo_details", Mock(return_value=details)
     )
     monkeypatch.setattr(
-        "app.services.github.get_languages", Mock(return_value={"Python": 1})
+        "app.services.github.get_languages",
+        Mock(
+            return_value={
+                "Python": 6,
+                "Rust": 5,
+                "Go": 4,
+                "JavaScript": 3,
+                "HTML": 2,
+                "CSS": 1,
+            }
+        ),
     )
     monkeypatch.setattr(
-        "app.services.github.get_top_contributors", Mock(return_value=[])
+        "app.services.github.get_top_contributors",
+        Mock(
+            return_value=[
+                {"login": "octo", "commits": 6},
+                {"login": "user2", "commits": 5},
+                {"login": "user3", "commits": 4},
+                {"login": "user4", "commits": 3},
+                {"login": "user5", "commits": 2},
+                {"login": "user6", "commits": 1},
+            ]
+        ),
     )
     result = runner.invoke(app, ["details", "o", "r"])
     assert result.exit_code == 0
+    assert "DETAILS" in result.output
+    assert "Contributors" in result.output
     assert "Repository" in result.output
     assert "Languages" in result.output
+    assert "octo" in result.output
+    assert "user5" in result.output
+    assert "user6" not in result.output
+    assert "CSS" not in result.output
+    assert "Stats" not in result.output

{recon_github-0.1.7 → recon_github-1.0.0}/uv.lock

@@ -423,7 +423,7 @@ wheels = [
 
 [[package]]
 name = "recon-github"
-version = "0.1.7"
+version = "1.0.0"
 source = { editable = "." }
 dependencies = [
     { name = "dotenv" },