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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: recon-github
-Version: 0.1.6
+Version: 0.1.7
 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
@@ -11,7 +11,6 @@ Requires-Dist: rich>=15.0.0
 Requires-Dist: typer>=0.27.1
 Description-Content-Type: text/markdown
 
-
 # Recon CLI
 
 Recon is a powerful CLI companion for developers and tools for agents, turning GitHub activity and repository data into useful insights from your terminal.
@@ -25,9 +24,9 @@ Recon is a powerful CLI companion for developers and tools for agents, turning G
 [![License](https://img.shields.io/github/license/owenpalfreymandev/reconcli)](https://github.com/owenpalfreymandev/reconcli/blob/main/LICENSE)
 ## Overview
 
-Recon allows for developers to view basic GitHub analytics in the terminal quickly, rather than opening up their browser. This means it allows agents to interect with the service without having browser capabilities.
+Recon allows developers to view basic GitHub analytics in the terminal quickly, rather than opening up their browser. This means it allows agents to interact with the service without having browser capabilities.
 
-It is powered by [Typer](github.com/fastapi/typer), a library for building fast CLI tools, and made pretty by [Rich](https://github.com/textualize/rich) and it's prebuilt components.
+It is powered by [Typer](github.com/fastapi/typer), a library for building fast CLI tools, and made pretty by [Rich](https://github.com/textualize/rich) and its prebuilt components.
 ## Features
 
 * **GitHub Authentication** — Securely authenticate with GitHub using OAuth device flow.
@@ -41,7 +40,7 @@ It is powered by [Typer](github.com/fastapi/typer), a library for building fast
 
 ## Installation
 
-Since we want you to be able to use Recon from anywhere - not just one directory - we recomend you install it with [uv package manager](https://docs.astral.sh/uv/getting-started/installation/).
+Since we want you to be able to use Recon from anywhere - not just one directory - we recommend you install it with [uv package manager](https://docs.astral.sh/uv/getting-started/installation/).
 
 ```bash
   uv tool install recon-github
@@ -68,7 +67,7 @@ Example output:
 ╭────── Owen Palfreyman ───────╮ ╭──────────────────────────────╮
 │ Repositories  2              │ │                              │
 │ Followers     7              │ │                              │
-│ Following     2              │ │                              │
+│ Following     2                │ │                              │
 │ Location      United Kingdom │ │                              │
 │ Company       —              │ │                              │
 │ Joined        2023-11-02     │ │                              │
@@ -213,7 +212,7 @@ uv run pytest
 uv run pyright
 ```
 
-Be sure to lint before commiting, or it will fail CI/CD:
+Be sure to lint before committing, or it will fail CI/CD:
 ```bash
 uv run ruff check --fix .
 ```
@@ -237,4 +236,4 @@ Recon is developed by Owen Palfreyman.
 GitHub: @owenpalfreymandev
 Repository: owenpalfreymandev/reconcli
 
-*or could could just run `recon details owenpalfreymandev reconcli --contributors` wink wink*
+*or could just run `recon details owenpalfreymandev reconcli --contributors` wink wink*

{recon_github-0.1.6 → recon_github-0.1.7}/README.md

@@ -1,4 +1,3 @@
-
 # Recon CLI
 
 Recon is a powerful CLI companion for developers and tools for agents, turning GitHub activity and repository data into useful insights from your terminal.
@@ -12,9 +11,9 @@ Recon is a powerful CLI companion for developers and tools for agents, turning G
 [![License](https://img.shields.io/github/license/owenpalfreymandev/reconcli)](https://github.com/owenpalfreymandev/reconcli/blob/main/LICENSE)
 ## Overview
 
-Recon allows for developers to view basic GitHub analytics in the terminal quickly, rather than opening up their browser. This means it allows agents to interect with the service without having browser capabilities.
+Recon allows developers to view basic GitHub analytics in the terminal quickly, rather than opening up their browser. This means it allows agents to interact with the service without having browser capabilities.
 
-It is powered by [Typer](github.com/fastapi/typer), a library for building fast CLI tools, and made pretty by [Rich](https://github.com/textualize/rich) and it's prebuilt components.
+It is powered by [Typer](github.com/fastapi/typer), a library for building fast CLI tools, and made pretty by [Rich](https://github.com/textualize/rich) and its prebuilt components.
 ## Features
 
 * **GitHub Authentication** — Securely authenticate with GitHub using OAuth device flow.
@@ -28,7 +27,7 @@ It is powered by [Typer](github.com/fastapi/typer), a library for building fast
 
 ## Installation
 
-Since we want you to be able to use Recon from anywhere - not just one directory - we recomend you install it with [uv package manager](https://docs.astral.sh/uv/getting-started/installation/).
+Since we want you to be able to use Recon from anywhere - not just one directory - we recommend you install it with [uv package manager](https://docs.astral.sh/uv/getting-started/installation/).
 
 ```bash
   uv tool install recon-github
@@ -55,7 +54,7 @@ Example output:
 ╭────── Owen Palfreyman ───────╮ ╭──────────────────────────────╮
 │ Repositories  2              │ │                              │
 │ Followers     7              │ │                              │
-│ Following     2              │ │                              │
+│ Following     2                │ │                              │
 │ Location      United Kingdom │ │                              │
 │ Company       —              │ │                              │
 │ Joined        2023-11-02     │ │                              │
@@ -200,7 +199,7 @@ uv run pytest
 uv run pyright
 ```
 
-Be sure to lint before commiting, or it will fail CI/CD:
+Be sure to lint before committing, or it will fail CI/CD:
 ```bash
 uv run ruff check --fix .
 ```
@@ -224,4 +223,4 @@ Recon is developed by Owen Palfreyman.
 GitHub: @owenpalfreymandev
 Repository: owenpalfreymandev/reconcli
 
-*or could could just run `recon details owenpalfreymandev reconcli --contributors` wink wink*
+*or could just run `recon details owenpalfreymandev reconcli --contributors` wink wink*

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

@@ -67,31 +67,24 @@ def format_languages(languages: dict[str, int], max_languages: int = 5) -> list[
 
 
 @app.command()
-def list():
+def list(
+    boxy: bool = typer.Option(
+        False,
+        "--boxy",
+        help="Render each repository as a panel (not recommended for long lists).",
+    ),
+):
     """See a list of all your repos."""
-    from app.services.github import get_user_repos
+    from app.services.github import get_authenticated_user, get_user_repos
+    from app.ui.repo import display_repository_list
 
+    user = get_authenticated_user()
     repos = get_user_repos()
-
-    for repo in repos:
-        typer.echo(f"{repo['full_name']}")
-        description = repo.get("description") or "—"
-        typer.echo(f"description: {format_description(description)}")
-        typer.echo(
-            f"visibility: {repo.get('visibility') or ('private' if repo.get('private') else 'public')}"
-        )
-        typer.echo(f"language: {repo.get('language') or '—'}")
-        typer.echo(f"default branch: {repo.get('default_branch') or '—'}")
-        typer.echo(
-            f"stars: {repo.get('stargazers_count', 0)}  forks: {repo.get('forks_count', 0)}  open issues: {repo.get('open_issues_count', 0)}"
-        )
-        typer.echo(f"  url: {repo['html_url']}")
-
-        topics = repo.get("topics") or []
-        if topics:
-            typer.echo(f"  topics: {format_topics(topics)}")
-
-        typer.echo("")
+    display_repository_list(
+        repos,
+        user.get("login", "Unknown user"),
+        boxy=boxy,
+    )
 
 
 @app.command()

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

@@ -7,13 +7,143 @@ from rich.text import Text
 console = Console()
 
 
-def build_view_header(title: str, subtitle: str) -> Panel:
+def build_repository_table(repositories: list[dict]) -> Table:
+    """Build the compact repository listing used by ``recon list``."""
+    table_width = _repository_table_width()
+    repository_width = max(13, min(32, table_width - 66))
+    table = Table(
+        title=f"Repositories ({len(repositories)})",
+        title_style="bold cyan",
+        header_style="bold cyan",
+        box=None,
+        show_edge=False,
+        pad_edge=False,
+        padding=(0, 1),
+        collapse_padding=False,
+        width=table_width,
+    )
+    table.add_column(
+        "Repository",
+        no_wrap=True,
+        overflow="ellipsis",
+        width=repository_width,
+        max_width=repository_width,
+    )
+    table.add_column(
+        "Visibility", no_wrap=True, overflow="ellipsis", width=10, max_width=10
+    )
+    table.add_column(
+        "Language", no_wrap=True, overflow="ellipsis", width=9, max_width=9
+    )
+    table.add_column(
+        "Updated", no_wrap=True, overflow="ellipsis", width=10, max_width=10
+    )
+    table.add_column("Branch", no_wrap=True, overflow="ellipsis", width=6, max_width=6)
+    table.add_column("Stars", justify="right", no_wrap=True, width=5)
+    table.add_column("Forks", justify="right", no_wrap=True, width=5)
+    table.add_column("Issues", justify="right", no_wrap=True, width=5)
+
+    for repository in repositories:
+        visibility = repository.get("visibility") or (
+            "private" if repository.get("private") else "public"
+        )
+        table.add_row(
+            str(repository.get("full_name") or repository.get("name") or "—"),
+            str(visibility or "—"),
+            str(repository.get("language") or "—"),
+            _format_updated(repository.get("updated_at")),
+            str(repository.get("default_branch") or "—"),
+            _format_count(repository.get("stargazers_count")),
+            _format_count(repository.get("forks_count")),
+            _format_count(repository.get("open_issues_count")),
+        )
+
+    if not repositories:
+        table.add_row("No repositories found.", *["—"] * 7)
+
+    return table
+
+
+def display_repository_list(
+    repositories: list[dict], username: str, boxy: bool = False
+) -> None:
+    """Render a compact, scan-friendly table of repositories."""
+    width = _repository_box_width() if boxy else _repository_table_width()
+    console.print(build_view_header("List", username, width=width))
+    if boxy:
+        for repository in repositories:
+            console.print(build_repository_panel(repository))
+        if not repositories:
+            console.print(Panel("No repositories found.", width=width))
+        return
+    console.print(build_repository_table(repositories))
+
+
+def build_repository_panel(repository: dict) -> Panel:
+    """Build the box-style repository summary used by ``recon list --boxy``."""
+    from app.commands.repo import format_topics
+
+    visibility = repository.get("visibility") or (
+        "private" if repository.get("private") else "public"
+    )
+    language = repository.get("language") or "—"
+    branch = repository.get("default_branch") or "—"
+    topics = repository.get("topics") or []
+    topic_text = (
+        format_topics([str(topic) for topic in topics]).replace(", ", " · ")
+        if topics
+        else "—"
+    )
+    content = Text()
+    content.append(
+        f"{str(visibility).capitalize()} · {language} · {branch}\n",
+        style="cyan",
+    )
+    content.append(
+        f"Stars {_format_count(repository.get('stargazers_count'))}   "
+        f"Forks {_format_count(repository.get('forks_count'))}   "
+        f"Issues {_format_count(repository.get('open_issues_count'))}\n"
+    )
+    content.append(topic_text, style="dim")
+    return Panel(
+        content,
+        title=str(repository.get("full_name") or repository.get("name") or "—"),
+        width=_repository_box_width(),
+        border_style="cyan",
+    )
+
+
+def _repository_table_width() -> int:
+    """Calculate the shared width for the list table and header."""
+    return min(max(1, console.width - 1), 98)
+
+
+def _repository_box_width() -> int:
+    """Calculate the narrower width used by boxy repository summaries."""
+    return min(max(1, console.width - 1), 72)
+
+
+def _format_count(value: object) -> str:
+    """Format repository counters while keeping missing values predictable."""
+    if value is None:
+        return "0"
+    return f"{value:,}" if isinstance(value, int) else str(value)
+
+
+def _format_updated(value: object) -> str:
+    """Show the date portion of GitHub's ISO timestamp."""
+    if not value:
+        return "—"
+    return str(value).split("T", 1)[0]
+
+
+def build_view_header(title: str, subtitle: str, width: int = 60) -> Panel:
     """Create the shared header used by focused repository views."""
     content = Text(justify="center")
     content.append(title.upper(), style="bold cyan")
     content.append("\n")
     content.append(subtitle, style="bold")
-    return Panel(content, width=60, border_style="cyan")
+    return Panel(content, width=width, border_style="cyan")
 
 
 def display_view_header(title: str, subtitle: str) -> None:

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

@@ -1,6 +1,6 @@
 [project]
 name = "recon-github"
-version = "0.1.6"
+version = "0.1.7"
 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/tests/test_cli_commands.py

@@ -0,0 +1,176 @@
+from unittest.mock import Mock
+
+from typer.testing import CliRunner
+
+from app.cli import app
+from app.commands import auth as auth_command
+from app.commands import me as me_command
+from app.ui.repo import build_repository_table
+
+runner = CliRunner()
+
+
+def test_login_logout_delegate(monkeypatch):
+    login, logout = Mock(), Mock()
+    monkeypatch.setattr(auth_command.auth, "login", login)
+    monkeypatch.setattr(auth_command.auth, "logout", logout)
+    assert runner.invoke(app, ["login"]).exit_code == 0
+    assert runner.invoke(app, ["logout"]).exit_code == 0
+    login.assert_called_once_with()
+    logout.assert_called_once_with()
+
+
+def user():
+    return {
+        "login": "octo",
+        "name": "Octo",
+        "public_repos": 1,
+        "followers": 2,
+        "following": 3,
+        "created_at": "2020-01-01T00:00:00Z",
+    }
+
+
+def test_me_and_scout_display_user(monkeypatch):
+    get_me, get_user, display = (
+        Mock(return_value=user()),
+        Mock(return_value=user()),
+        Mock(),
+    )
+    monkeypatch.setattr("app.services.github.get_authenticated_user", get_me)
+    monkeypatch.setattr("app.services.github.get_user", get_user)
+    monkeypatch.setattr(me_command, "display_user", display)
+    assert runner.invoke(app, ["me"]).exit_code == 0
+    assert runner.invoke(app, ["scout", "octo"]).exit_code == 0
+    get_me.assert_called_once_with()
+    get_user.assert_called_once_with("octo")
+    assert display.call_count == 2
+
+
+def test_list_handles_empty_and_missing_optional_fields(monkeypatch):
+    repo = {"full_name": "o/r", "html_url": "https://github.com/o/r"}
+    monkeypatch.setattr(
+        "app.services.github.get_authenticated_user",
+        Mock(return_value={"login": "octo"}),
+    )
+    monkeypatch.setattr(
+        "app.services.github.get_user_repos", Mock(side_effect=[[], [repo]])
+    )
+    assert runner.invoke(app, ["list"]).exit_code == 0
+    result = runner.invoke(app, ["list"])
+    assert result.exit_code == 0
+    assert "o/r" in result.output
+    assert "LIST" in result.output
+    assert "octo" in result.output
+    assert "Repositories (1)" in result.output
+    assert "—" in result.output
+
+
+def test_list_renders_repository_columns(monkeypatch):
+    monkeypatch.setattr(
+        "app.services.github.get_authenticated_user",
+        Mock(return_value={"login": "octo"}),
+    )
+    monkeypatch.setattr(
+        "app.services.github.get_user_repos",
+        Mock(
+            return_value=[
+                {
+                    "full_name": "octo/a-really-long-repository-name",
+                    "visibility": "public",
+                    "language": "Python",
+                    "updated_at": "2026-09-25T12:34:56Z",
+                    "default_branch": "main",
+                    "stargazers_count": 1_234,
+                    "forks_count": 56,
+                    "open_issues_count": 7,
+                }
+            ]
+        ),
+    )
+
+    result = runner.invoke(app, ["list"])
+
+    assert result.exit_code == 0
+    assert [column.header for column in build_repository_table([{}]).columns] == [
+        "Repository",
+        "Visibility",
+        "Language",
+        "Updated",
+        "Branch",
+        "Stars",
+        "Forks",
+        "Issues",
+    ]
+    assert "1,234" in result.output
+    assert "2026-09-25" in result.output
+    assert "Visibility" in result.output
+    assert "Language" in result.output
+
+
+def test_list_boxy_renders_repository_panels(monkeypatch):
+    monkeypatch.setattr(
+        "app.services.github.get_authenticated_user",
+        Mock(return_value={"login": "octo"}),
+    )
+    monkeypatch.setattr(
+        "app.services.github.get_user_repos",
+        Mock(
+            return_value=[
+                {
+                    "full_name": "octo/reconcli",
+                    "visibility": "public",
+                    "language": "Python",
+                    "default_branch": "main",
+                    "stargazers_count": 0,
+                    "forks_count": 0,
+                    "open_issues_count": 0,
+                    "topics": [
+                        "cli",
+                        "developer-tools",
+                        "github",
+                        "python",
+                        "rich-cli",
+                        "terminal",
+                    ],
+                }
+            ]
+        ),
+    )
+
+    result = runner.invoke(app, ["list", "--boxy"])
+
+    assert result.exit_code == 0
+    assert "LIST" in result.output
+    assert "octo/reconcli" in result.output
+    assert "Public · Python · main" in result.output
+    assert "Stars 0   Forks 0   Issues 0" in result.output
+    assert (
+        "cli · developer-tools · github · python · rich-cli + 1 more..."
+        in result.output
+    )
+    assert "Repositories (" not in result.output
+    assert result.output.count("─" * 70) >= 2
+
+
+def test_details_rejects_both_views():
+    result = runner.invoke(app, ["details", "o", "r", "--contributors", "--languages"])
+    assert result.exit_code != 0
+    assert "Choose either" in result.output
+
+
+def test_details_default_calls_services_and_prints(monkeypatch):
+    details = {"full_name": "o/r", "description": "desc", "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})
+    )
+    monkeypatch.setattr(
+        "app.services.github.get_top_contributors", Mock(return_value=[])
+    )
+    result = runner.invoke(app, ["details", "o", "r"])
+    assert result.exit_code == 0
+    assert "Repository" in result.output
+    assert "Languages" in result.output

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

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

recon_github-0.1.6/tests/test_cli_commands.py

@@ -1,80 +0,0 @@
-from unittest.mock import Mock
-
-from typer.testing import CliRunner
-
-from app.cli import app
-from app.commands import auth as auth_command
-from app.commands import me as me_command
-
-runner = CliRunner()
-
-
-def test_login_logout_delegate(monkeypatch):
-    login, logout = Mock(), Mock()
-    monkeypatch.setattr(auth_command.auth, "login", login)
-    monkeypatch.setattr(auth_command.auth, "logout", logout)
-    assert runner.invoke(app, ["login"]).exit_code == 0
-    assert runner.invoke(app, ["logout"]).exit_code == 0
-    login.assert_called_once_with()
-    logout.assert_called_once_with()
-
-
-def user():
-    return {
-        "login": "octo",
-        "name": "Octo",
-        "public_repos": 1,
-        "followers": 2,
-        "following": 3,
-        "created_at": "2020-01-01T00:00:00Z",
-    }
-
-
-def test_me_and_scout_display_user(monkeypatch):
-    get_me, get_user, display = (
-        Mock(return_value=user()),
-        Mock(return_value=user()),
-        Mock(),
-    )
-    monkeypatch.setattr("app.services.github.get_authenticated_user", get_me)
-    monkeypatch.setattr("app.services.github.get_user", get_user)
-    monkeypatch.setattr(me_command, "display_user", display)
-    assert runner.invoke(app, ["me"]).exit_code == 0
-    assert runner.invoke(app, ["scout", "octo"]).exit_code == 0
-    get_me.assert_called_once_with()
-    get_user.assert_called_once_with("octo")
-    assert display.call_count == 2
-
-
-def test_list_handles_empty_and_missing_optional_fields(monkeypatch):
-    repo = {"full_name": "o/r", "html_url": "https://github.com/o/r"}
-    monkeypatch.setattr(
-        "app.services.github.get_user_repos", Mock(side_effect=[[], [repo]])
-    )
-    assert runner.invoke(app, ["list"]).exit_code == 0
-    result = runner.invoke(app, ["list"])
-    assert result.exit_code == 0
-    assert "o/r" in result.output
-
-
-def test_details_rejects_both_views():
-    result = runner.invoke(app, ["details", "o", "r", "--contributors", "--languages"])
-    assert result.exit_code != 0
-    assert "Choose either" in result.output
-
-
-def test_details_default_calls_services_and_prints(monkeypatch):
-    details = {"full_name": "o/r", "description": "desc", "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})
-    )
-    monkeypatch.setattr(
-        "app.services.github.get_top_contributors", Mock(return_value=[])
-    )
-    result = runner.invoke(app, ["details", "o", "r"])
-    assert result.exit_code == 0
-    assert "Repository" in result.output
-    assert "Languages" in result.output