arccos-api 0.3.0__tar.gz → 0.4.0__tar.gz

{arccos_api-0.3.0/arccos_api.egg-info → arccos_api-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arccos-api
-Version: 0.3.0
+Version: 0.4.0
 Summary: Unofficial Python CLI and client library for the Arccos Golf API
 Author: Paul Frederiksen
 License: MIT
@@ -84,12 +84,15 @@ arccos clubs       # smart club distances
 | `arccos bests` | All-time personal bests (lowest score, longest drive, etc.) |
 | `arccos overview` | Performance summary — scoring avg + handicap breakdown |
 | `arccos scoring` | Scoring trend with visual bar chart |
-| `arccos courses` | List courses you've played (or `--search` any course) |
+| `arccos compare <a> <b>` | Side-by-side hole-by-hole round comparison |
+| `arccos courses` | List courses you've played (or `--search` to filter) |
 | `arccos pace` | Pace of play analysis by course (color-coded) |
 | `arccos stats` | Strokes gained analysis (defaults to latest round) |
+| `arccos trends` | Handicap trend chart over recent rounds |
 | `arccos club-shots <id>` | Shot history for a specific club |
 | `arccos up-and-down` | Scramble / strokes-to-get-down stats |
 | `arccos export` | Export rounds to JSON, CSV, or NDJSON (`--detail` for hole data) |
+| `arccos completions <shell>` | Generate bash/zsh/fish completion script |
 | `arccos logout` | Clear cached credentials |
 
 Every command supports `--json` for raw JSON output and `--help` for usage info.
@@ -119,15 +122,23 @@ arccos clubs --after 2025-01-01       # distances from this year only
 arccos bests                          # all-time personal bests
 arccos overview                       # scoring avg + handicap breakdown
 arccos scoring                        # scoring trend with bar chart
+arccos trends                         # handicap trend chart
 arccos up-and-down                    # scramble stats
 
+# Compare rounds
+arccos compare 26685289 26762935      # side-by-side hole comparison
+
 # Courses
 arccos courses                        # all courses played
-arccos courses --search "torrey"      # search any course by name
+arccos courses --search "torrey"      # filter by name or city
 
 # Club detail
 arccos club-shots 1                   # shot history for club ID 1
 
+# Shell completions
+eval "$(arccos completions bash)"     # enable tab completion
+eval "$(arccos completions zsh)"      # for zsh
+
 # Pace of play
 arccos pace                           # all rounds, slowest courses first
 arccos pace -n 20                     # last 20 rounds only
@@ -381,15 +392,6 @@ Coverage report: `htmlcov/index.html`. Minimum threshold: 80% (configured in `py
 - `arccos logout` removes the local credential file but does **not** revoke server-side tokens. If you suspect your credentials were compromised, change your Arccos password.
 - The export command restricts output paths to your home directory or current working directory.
 
-## Known Gaps
-
-- [ ] SGA endpoint auth (`/v2/sga/shots/` returns 40102 — may need HMAC via `secret`)
-- [ ] Social/feed endpoints (`/users/{id}/feed`, follows, etc.)
-- [ ] Driving range session data (`roundType=range`)
-- [ ] Async client (`httpx`)
-
-PRs welcome.
-
 ## Disclaimer
 
 Not affiliated with, endorsed by, or connected to Arccos Golf LLC.

{arccos_api-0.3.0 → arccos_api-0.4.0}/README.md

@@ -49,12 +49,15 @@ arccos clubs       # smart club distances
 | `arccos bests` | All-time personal bests (lowest score, longest drive, etc.) |
 | `arccos overview` | Performance summary — scoring avg + handicap breakdown |
 | `arccos scoring` | Scoring trend with visual bar chart |
-| `arccos courses` | List courses you've played (or `--search` any course) |
+| `arccos compare <a> <b>` | Side-by-side hole-by-hole round comparison |
+| `arccos courses` | List courses you've played (or `--search` to filter) |
 | `arccos pace` | Pace of play analysis by course (color-coded) |
 | `arccos stats` | Strokes gained analysis (defaults to latest round) |
+| `arccos trends` | Handicap trend chart over recent rounds |
 | `arccos club-shots <id>` | Shot history for a specific club |
 | `arccos up-and-down` | Scramble / strokes-to-get-down stats |
 | `arccos export` | Export rounds to JSON, CSV, or NDJSON (`--detail` for hole data) |
+| `arccos completions <shell>` | Generate bash/zsh/fish completion script |
 | `arccos logout` | Clear cached credentials |
 
 Every command supports `--json` for raw JSON output and `--help` for usage info.
@@ -84,15 +87,23 @@ arccos clubs --after 2025-01-01       # distances from this year only
 arccos bests                          # all-time personal bests
 arccos overview                       # scoring avg + handicap breakdown
 arccos scoring                        # scoring trend with bar chart
+arccos trends                         # handicap trend chart
 arccos up-and-down                    # scramble stats
 
+# Compare rounds
+arccos compare 26685289 26762935      # side-by-side hole comparison
+
 # Courses
 arccos courses                        # all courses played
-arccos courses --search "torrey"      # search any course by name
+arccos courses --search "torrey"      # filter by name or city
 
 # Club detail
 arccos club-shots 1                   # shot history for club ID 1
 
+# Shell completions
+eval "$(arccos completions bash)"     # enable tab completion
+eval "$(arccos completions zsh)"      # for zsh
+
 # Pace of play
 arccos pace                           # all rounds, slowest courses first
 arccos pace -n 20                     # last 20 rounds only
@@ -346,15 +357,6 @@ Coverage report: `htmlcov/index.html`. Minimum threshold: 80% (configured in `py
 - `arccos logout` removes the local credential file but does **not** revoke server-side tokens. If you suspect your credentials were compromised, change your Arccos password.
 - The export command restricts output paths to your home directory or current working directory.
 
-## Known Gaps
-
-- [ ] SGA endpoint auth (`/v2/sga/shots/` returns 40102 — may need HMAC via `secret`)
-- [ ] Social/feed endpoints (`/users/{id}/feed`, follows, etc.)
-- [ ] Driving range session data (`roundType=range`)
-- [ ] Async client (`httpx`)
-
-PRs welcome.
-
 ## Disclaimer
 
 Not affiliated with, endorsed by, or connected to Arccos Golf LLC.

arccos_api-0.4.0/arccos/cli/__init__.py

@@ -0,0 +1,78 @@
+"""
+arccos CLI — pull your Arccos Golf data from the terminal.
+
+Uses the reverse-engineered Arccos Golf API. Not affiliated with Arccos Golf LLC.
+"""
+
+from __future__ import annotations
+
+import click
+from rich import box
+from rich.console import Console
+from rich.table import Table
+
+from . import auth, rounds, stats
+
+_console = Console(stderr=True)
+
+
+class RichGroup(click.Group):
+    """Click group that renders help with Rich formatting."""
+
+    def format_help(self, ctx: click.Context, formatter: click.HelpFormatter) -> None:
+        _console.print(
+            "\n[bold cyan]arccos[/bold cyan] — Your Arccos Golf data in the terminal.\n"
+        )
+
+        table = Table(box=box.SIMPLE, show_header=False, padding=(0, 2))
+        table.add_column(style="bold green", no_wrap=True)
+        table.add_column(style="dim")
+
+        cmds = [
+            ("login", "Authenticate and save credentials"),
+            ("rounds", "List recent rounds with +/- and course names"),
+            ("round <id>", "Hole-by-hole detail for a round"),
+            ("compare <a> <b>", "Side-by-side round comparison"),
+            ("handicap", "Current handicap index breakdown"),
+            ("clubs", "Smart club distances with make/model"),
+            ("club-shots <id>", "Shot history for a specific club"),
+            ("courses", "Courses you've played (--search to filter)"),
+            ("bests", "All-time personal bests"),
+            ("overview", "Scoring avg + handicap breakdown"),
+            ("scoring", "Scoring trend with bar chart"),
+            ("trends", "Handicap trend over time"),
+            ("pace", "Pace of play by course"),
+            ("stats", "Strokes gained analysis"),
+            ("up-and-down", "Scramble / strokes-to-get-down stats"),
+            ("export", "Export rounds to JSON/CSV/NDJSON"),
+            ("completions", "Generate shell completion script"),
+            ("logout", "Clear cached credentials"),
+        ]
+        for cmd, desc in cmds:
+            table.add_row(f"arccos {cmd}", desc)
+
+        _console.print(table)
+        _console.print(
+            "\n[dim]All commands support [bold]--json[/bold] and [bold]--help[/bold]. "
+            "Credentials cached in ~/.arccos_creds.json.[/dim]\n"
+        )
+
+
+@click.group(cls=RichGroup)
+@click.version_option(package_name="arccos-api", prog_name="arccos")
+def cli():
+    """arccos — Your Arccos Golf data in the terminal."""
+
+
+# Register all command submodules
+auth.register(cli)
+rounds.register(cli)
+stats.register(cli)
+
+
+def main():
+    cli()
+
+
+if __name__ == "__main__":
+    main()

{arccos_api-0.3.0 → arccos_api-0.4.0}/arccos/cli/auth.py

@@ -12,6 +12,7 @@ from ._helpers import console, err_console
 def register(cli: click.Group) -> None:
     cli.add_command(login)
     cli.add_command(logout)
+    cli.add_command(completions)
 
 
 @click.command()
@@ -53,3 +54,31 @@ def logout():
         )
     else:
         console.print("[dim]No cached credentials found.[/dim]")
+
+
+@click.command()
+@click.argument("shell", type=click.Choice(["bash", "zsh", "fish"]))
+def completions(shell: str):
+    """Generate shell completion script.
+
+    \b
+    Usage:
+      eval "$(arccos completions bash)"
+      eval "$(arccos completions zsh)"
+      arccos completions fish | source
+
+    \b
+    To install permanently, add the eval line to your shell profile
+    (~/.bashrc, ~/.zshrc, or ~/.config/fish/completions/arccos.fish).
+    """
+    import os
+    import subprocess
+
+    env = {**os.environ, "_ARCCOS_COMPLETE": f"{shell}_source"}
+    result = subprocess.run(
+        ["arccos"],
+        env=env,
+        capture_output=True,
+        text=True,
+    )
+    click.echo(result.stdout)

{arccos_api-0.3.0 → arccos_api-0.4.0}/arccos/cli/rounds.py

@@ -26,6 +26,7 @@ from ._helpers import (
 def register(cli: click.Group) -> None:
     cli.add_command(rounds)
     cli.add_command(round_detail)
+    cli.add_command(compare)
     cli.add_command(export)
     cli.add_command(pace)
     cli.add_command(scoring)
@@ -239,6 +240,127 @@ def round_detail(round_id: int, as_json: bool):
     console.print(table)
 
 
+# ---------------------------------------------------------------------------
+# compare
+# ---------------------------------------------------------------------------
+
+@click.command()
+@click.argument("round_a", type=int)
+@click.argument("round_b", type=int)
+@click.option("--json", "as_json", is_flag=True, help="Output raw JSON.")
+def compare(round_a: int, round_b: int, as_json: bool):
+    """Compare two rounds side-by-side, hole by hole.
+
+    \b
+    Examples:
+      arccos compare 26685289 26762935
+    """
+    client = _get_client()
+
+    with console.status("Fetching rounds\u2026"):
+        meta_a = client.rounds.get(round_a)
+        meta_b = client.rounds.get(round_b)
+        course_map, par_map = _build_course_map(client)
+
+    if as_json:
+        _output_json({"round_a": meta_a, "round_b": meta_b})
+        return
+
+    def _course_name(meta: dict) -> str:
+        cid: int = meta.get("courseId", 0)
+        return course_map.get(cid) or meta.get("courseName") or str(cid or "\u2014")
+
+    def _ou(meta: dict) -> str:
+        shots = meta.get("noOfShots")
+        cid: int = meta.get("courseId", 0)
+        par = par_map.get(cid)
+        if shots and par and meta.get("noOfHoles") == 18:
+            return f" ({shots - par:+d})"
+        return ""
+
+    # Summary panel
+    date_a = (meta_a.get("startTime") or "")[:10]
+    date_b = (meta_b.get("startTime") or "")[:10]
+    score_a = meta_a.get("noOfShots", "\u2014")
+    score_b = meta_b.get("noOfShots", "\u2014")
+
+    summary = (
+        f"[bold cyan]Round A:[/bold cyan] {date_a}  {_course_name(meta_a)}  "
+        f"[bold]{score_a}{_ou(meta_a)}[/bold]\n"
+        f"[bold cyan]Round B:[/bold cyan] {date_b}  {_course_name(meta_b)}  "
+        f"[bold]{score_b}{_ou(meta_b)}[/bold]"
+    )
+    console.print(Panel(summary, title="[bold]Round Comparison[/bold]", expand=False))
+
+    holes_a = {h["holeId"]: h for h in meta_a.get("holes", [])}
+    holes_b = {h["holeId"]: h for h in meta_b.get("holes", [])}
+
+    if not holes_a and not holes_b:
+        console.print("[dim]No hole data available for either round.[/dim]")
+        return
+
+    all_holes = sorted(set(holes_a.keys()) | set(holes_b.keys()))
+
+    table = Table(
+        box=box.ROUNDED,
+        header_style="bold cyan",
+        title="[bold]Hole-by-Hole Comparison[/bold]",
+    )
+    table.add_column("Hole", justify="right")
+    table.add_column("A", justify="right", style="bold")
+    table.add_column("B", justify="right", style="bold")
+    table.add_column("Diff", justify="right")
+    table.add_column("A Putts", justify="right", style="dim")
+    table.add_column("B Putts", justify="right", style="dim")
+
+    total_a = total_b = total_putts_a = total_putts_b = 0
+    for h_id in all_holes:
+        ha = holes_a.get(h_id, {})
+        hb = holes_b.get(h_id, {})
+        sa = ha.get("noOfShots")
+        sb = hb.get("noOfShots")
+        pa = ha.get("putts")
+        pb = hb.get("putts")
+
+        sa_s = str(sa) if sa is not None else "\u2014"
+        sb_s = str(sb) if sb is not None else "\u2014"
+        pa_s = str(pa) if pa is not None else "\u2014"
+        pb_s = str(pb) if pb is not None else "\u2014"
+
+        if sa is not None and sb is not None:
+            diff = sb - sa
+            color = "green" if diff < 0 else "red" if diff > 0 else "dim"
+            diff_s = f"[{color}]{diff:+d}[/{color}]"
+        else:
+            diff_s = ""
+
+        if sa:
+            total_a += sa
+        if sb:
+            total_b += sb
+        if pa:
+            total_putts_a += pa
+        if pb:
+            total_putts_b += pb
+
+        table.add_row(str(h_id), sa_s, sb_s, diff_s, pa_s, pb_s)
+
+    # Totals
+    table.add_section()
+    total_diff = total_b - total_a
+    diff_color = "green" if total_diff < 0 else "red" if total_diff > 0 else "dim"
+    table.add_row(
+        "[bold]Tot[/bold]",
+        f"[bold]{total_a}[/bold]",
+        f"[bold]{total_b}[/bold]",
+        f"[{diff_color}][bold]{total_diff:+d}[/bold][/{diff_color}]",
+        f"[bold]{total_putts_a}[/bold]",
+        f"[bold]{total_putts_b}[/bold]",
+    )
+
+    console.print(table)
+
+
 # ---------------------------------------------------------------------------
 # export
 # ---------------------------------------------------------------------------

{arccos_api-0.3.0 → arccos_api-0.4.0}/arccos/cli/stats.py

@@ -1,7 +1,8 @@
-"""Stats-related CLI commands: handicap, clubs, stats, bests, overview, courses."""
+"""Stats-related CLI commands: handicap, clubs, stats, bests, overview, courses, trends."""
 
 from __future__ import annotations
 
+import builtins as _builtins
 import sys
 
 import click
@@ -12,6 +13,8 @@ from rich.text import Text
 
 from ._helpers import _get_client, _output_json, console, err_console
 
+builtins_list = _builtins.list
+
 
 def register(cli: click.Group) -> None:
     cli.add_command(handicap)
@@ -20,6 +23,7 @@ def register(cli: click.Group) -> None:
     cli.add_command(stats)
     cli.add_command(bests)
     cli.add_command(overview)
+    cli.add_command(trends)
     cli.add_command(courses)
     cli.add_command(up_and_down)
 
@@ -551,7 +555,7 @@ def club_shots(club_id: int, limit: int, as_json: bool):
     # Try to resolve club name
     try:
         bag = client.clubs.bag(str(bag_id))
-        bag_club = next(
+        bag_club: dict = next(
             (c for c in bag.get("clubs", []) if c["clubId"] == club_id), {}
         )
         club_type = bag_club.get("clubType", club_id)
@@ -632,3 +636,79 @@ def up_and_down(as_json: bool):
                         table.add_row(f"{section}.{k}", display)
 
     console.print(table)
+
+
+# ---------------------------------------------------------------------------
+# trends
+# ---------------------------------------------------------------------------
+
+@click.command()
+@click.option("--rounds", "-n", default=20, show_default=True,
+              help="Number of rounds to include.")
+@click.option("--json", "as_json", is_flag=True, help="Output raw JSON.")
+def trends(rounds: int, as_json: bool):
+    """Show handicap trend over recent rounds."""
+    client = _get_client()
+
+    with console.status("Fetching handicap history\u2026"):
+        data = client.handicap.history(rounds=rounds)
+
+    if as_json:
+        _output_json(data)
+        return
+
+    if not data or not isinstance(data, builtins_list):
+        console.print("[dim]No handicap history available.[/dim]")
+        return
+
+    # Extract HCP values
+    entries = []
+    for entry in data:
+        if isinstance(entry, dict) and "userHcp" in entry:
+            entries.append(entry)
+
+    if not entries:
+        console.print("[dim]No handicap data found in history.[/dim]")
+        return
+
+    hcps = [e["userHcp"] for e in entries]
+    best = min(hcps)
+    worst = max(hcps)
+    current = hcps[0]
+    change = hcps[0] - hcps[-1] if len(hcps) > 1 else 0.0
+
+    # Summary
+    change_color = "green" if change < 0 else "red" if change > 0 else "dim"
+    console.print(
+        f"\n[bold]Handicap Trend[/bold] [dim]({len(entries)} rounds)[/dim]\n"
+        f"  Current: [bold cyan]{current:.1f}[/bold cyan]    "
+        f"Best: [bold green]{best:.1f}[/bold green]    "
+        f"Worst: [bold red]{worst:.1f}[/bold red]    "
+        f"Change: [{change_color}]{change:+.1f}[/{change_color}]\n"
+    )
+
+    # Sparkline chart
+    hcp_min = min(hcps) - 1
+    hcp_max = max(hcps) + 1
+    hcp_range = hcp_max - hcp_min if hcp_max != hcp_min else 1
+
+    table = Table(
+        box=box.ROUNDED,
+        header_style="bold cyan",
+        title="[bold]HCP Over Time[/bold] (newest first)",
+    )
+    table.add_column("Round", justify="right", style="dim")
+    table.add_column("HCP", justify="right", style="bold")
+    table.add_column("", width=20)
+
+    for i, entry in enumerate(entries):
+        hcp = entry["userHcp"]
+        rid = str(entry.get("roundId", i + 1))
+        # Normalized bar position (lower = better for golf)
+        bar_len = int((hcp - hcp_min) / hcp_range * 18) + 1
+        color = "green" if hcp <= best + 1 else "red" if hcp >= worst - 1 else "yellow"
+        bar = f"[{color}]{'█' * bar_len}[/{color}]"
+        table.add_row(rid, f"{hcp:.1f}", bar)
+
+    console.print(table)
+    console.print("[dim]Lower = better. Green = near best, red = near worst.[/dim]")

{arccos_api-0.3.0 → arccos_api-0.4.0}/arccos/exceptions.py

@@ -6,7 +6,7 @@ Custom exceptions for the Arccos API client.
 class ArccosError(Exception):
     """Base exception for all Arccos API errors."""
 
-    def __init__(self, message: str, status_code: int = None, error_code: int = None):
+    def __init__(self, message: str, status_code: int | None = None, error_code: int | None = None):
         super().__init__(message)
         self.status_code = status_code
         self.error_code = error_code

{arccos_api-0.3.0 → arccos_api-0.4.0}/arccos/resources/courses.py

@@ -24,7 +24,7 @@ class CoursesResource:
         print(course["courseName"])
     """
 
-    def __init__(self, http: HttpClient, user_id: str = None):
+    def __init__(self, http: HttpClient, user_id: str | None = None):
         self._http = http
         self._user_id = user_id
 

{arccos_api-0.3.0 → arccos_api-0.4.0}/arccos/resources/rounds.py

@@ -6,11 +6,15 @@ Endpoint prefix: /users/{userId}/rounds
 
 from __future__ import annotations
 
+import builtins
 from collections.abc import Iterator
 from datetime import datetime
 
 from .._http import HttpClient
 
+# Alias to avoid shadowing by the RoundsResource.list method
+_list = builtins.list
+
 
 class RoundsResource:
     """
@@ -127,7 +131,7 @@ class RoundsResource:
         """
         return self._http.get(f"/users/{self._user_id}/rounds/{round_id}")
 
-    def holes(self, round_id: int | str) -> list[dict]:
+    def holes(self, round_id: int | str) -> _list[dict]:
         """
         Fetch hole-by-hole data for a round.
 
@@ -143,7 +147,7 @@ class RoundsResource:
     # Analysis helpers
     # ------------------------------------------------------------------
 
-    def pace_of_play(self, rounds: list[dict] = None) -> dict:
+    def pace_of_play(self, rounds: _list[dict] | None = None) -> dict:
         """
         Compute pace of play (round duration) per course.
 

{arccos_api-0.3.0 → arccos_api-0.4.0/arccos_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arccos-api
-Version: 0.3.0
+Version: 0.4.0
 Summary: Unofficial Python CLI and client library for the Arccos Golf API
 Author: Paul Frederiksen
 License: MIT
@@ -84,12 +84,15 @@ arccos clubs       # smart club distances
 | `arccos bests` | All-time personal bests (lowest score, longest drive, etc.) |
 | `arccos overview` | Performance summary — scoring avg + handicap breakdown |
 | `arccos scoring` | Scoring trend with visual bar chart |
-| `arccos courses` | List courses you've played (or `--search` any course) |
+| `arccos compare <a> <b>` | Side-by-side hole-by-hole round comparison |
+| `arccos courses` | List courses you've played (or `--search` to filter) |
 | `arccos pace` | Pace of play analysis by course (color-coded) |
 | `arccos stats` | Strokes gained analysis (defaults to latest round) |
+| `arccos trends` | Handicap trend chart over recent rounds |
 | `arccos club-shots <id>` | Shot history for a specific club |
 | `arccos up-and-down` | Scramble / strokes-to-get-down stats |
 | `arccos export` | Export rounds to JSON, CSV, or NDJSON (`--detail` for hole data) |
+| `arccos completions <shell>` | Generate bash/zsh/fish completion script |
 | `arccos logout` | Clear cached credentials |
 
 Every command supports `--json` for raw JSON output and `--help` for usage info.
@@ -119,15 +122,23 @@ arccos clubs --after 2025-01-01       # distances from this year only
 arccos bests                          # all-time personal bests
 arccos overview                       # scoring avg + handicap breakdown
 arccos scoring                        # scoring trend with bar chart
+arccos trends                         # handicap trend chart
 arccos up-and-down                    # scramble stats
 
+# Compare rounds
+arccos compare 26685289 26762935      # side-by-side hole comparison
+
 # Courses
 arccos courses                        # all courses played
-arccos courses --search "torrey"      # search any course by name
+arccos courses --search "torrey"      # filter by name or city
 
 # Club detail
 arccos club-shots 1                   # shot history for club ID 1
 
+# Shell completions
+eval "$(arccos completions bash)"     # enable tab completion
+eval "$(arccos completions zsh)"      # for zsh
+
 # Pace of play
 arccos pace                           # all rounds, slowest courses first
 arccos pace -n 20                     # last 20 rounds only
@@ -381,15 +392,6 @@ Coverage report: `htmlcov/index.html`. Minimum threshold: 80% (configured in `py
 - `arccos logout` removes the local credential file but does **not** revoke server-side tokens. If you suspect your credentials were compromised, change your Arccos password.
 - The export command restricts output paths to your home directory or current working directory.
 
-## Known Gaps
-
-- [ ] SGA endpoint auth (`/v2/sga/shots/` returns 40102 — may need HMAC via `secret`)
-- [ ] Social/feed endpoints (`/users/{id}/feed`, follows, etc.)
-- [ ] Driving range session data (`roundType=range`)
-- [ ] Async client (`httpx`)
-
-PRs welcome.
-
 ## Disclaimer
 
 Not affiliated with, endorsed by, or connected to Arccos Golf LLC.

{arccos_api-0.3.0 → arccos_api-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "arccos-api"
-version = "0.3.0"
+version = "0.4.0"
 description = "Unofficial Python CLI and client library for the Arccos Golf API"
 readme = "README.md"
 license = {text = "MIT"}

{arccos_api-0.3.0 → arccos_api-0.4.0}/tests/test_cli.py

@@ -841,3 +841,121 @@ class TestUpAndDownCommand:
         result = runner.invoke(cli, ["up-and-down", "--json"])
         data = json.loads(result.output)
         assert data["totalAttempts"] == 50
+
+
+# ---------------------------------------------------------------------------
+# compare
+# ---------------------------------------------------------------------------
+
+class TestCompareCommand:
+    @patch(_ROUNDS_GET_CLIENT)
+    def test_compare_table(self, mock_get, runner):
+        client = _mock_client()
+        client.rounds.get.side_effect = [
+            {
+                "roundId": 1, "courseId": 100, "noOfShots": 85, "noOfHoles": 18,
+                "startTime": "2025-06-01T08:00:00Z",
+                "holes": [
+                    {"holeId": 1, "noOfShots": 5, "putts": 2},
+                    {"holeId": 2, "noOfShots": 4, "putts": 2},
+                    {"holeId": 3, "noOfShots": 3, "putts": 1},
+                ],
+            },
+            {
+                "roundId": 2, "courseId": 100, "noOfShots": 82, "noOfHoles": 18,
+                "startTime": "2025-07-01T08:00:00Z",
+                "holes": [
+                    {"holeId": 1, "noOfShots": 4, "putts": 1},
+                    {"holeId": 2, "noOfShots": 4, "putts": 2},
+                    {"holeId": 3, "noOfShots": 4, "putts": 2},
+                ],
+            },
+        ]
+        mock_get.return_value = client
+
+        result = runner.invoke(cli, ["compare", "1", "2"])
+        assert result.exit_code == 0
+        assert "Round A" in result.output
+        assert "Round B" in result.output
+        assert "Comparison" in result.output
+
+    @patch(_ROUNDS_GET_CLIENT)
+    def test_compare_json(self, mock_get, runner):
+        client = _mock_client()
+        client.rounds.get.side_effect = [
+            {"roundId": 1, "holes": []},
+            {"roundId": 2, "holes": []},
+        ]
+        mock_get.return_value = client
+
+        result = runner.invoke(cli, ["compare", "--json", "1", "2"])
+        data = json.loads(result.output)
+        assert "round_a" in data
+        assert "round_b" in data
+
+
+# ---------------------------------------------------------------------------
+# trends
+# ---------------------------------------------------------------------------
+
+class TestTrendsCommand:
+    @patch(_STATS_GET_CLIENT)
+    def test_trends_chart(self, mock_get, runner):
+        client = _mock_client()
+        client.handicap.history.return_value = [
+            {"roundId": 1, "userHcp": -15.0, "driveHcp": -10.0},
+            {"roundId": 2, "userHcp": -16.0, "driveHcp": -11.0},
+            {"roundId": 3, "userHcp": -14.5, "driveHcp": -9.5},
+        ]
+        mock_get.return_value = client
+
+        result = runner.invoke(cli, ["trends"])
+        assert result.exit_code == 0
+        assert "Handicap Trend" in result.output
+        assert "-15.0" in result.output
+        assert "-16.0" in result.output
+
+    @patch(_STATS_GET_CLIENT)
+    def test_trends_json(self, mock_get, runner):
+        client = _mock_client()
+        client.handicap.history.return_value = [{"userHcp": -15.0}]
+        mock_get.return_value = client
+
+        result = runner.invoke(cli, ["trends", "--json"])
+        data = json.loads(result.output)
+        assert data[0]["userHcp"] == -15.0
+
+    @patch(_STATS_GET_CLIENT)
+    def test_trends_empty(self, mock_get, runner):
+        client = _mock_client()
+        client.handicap.history.return_value = []
+        mock_get.return_value = client
+
+        result = runner.invoke(cli, ["trends"])
+        assert result.exit_code == 0
+        assert "No handicap history" in result.output
+
+
+# ---------------------------------------------------------------------------
+# completions
+# ---------------------------------------------------------------------------
+
+class TestCompletionsCommand:
+    def test_completions_bash(self, runner):
+        result = runner.invoke(cli, ["completions", "bash"])
+        assert result.exit_code == 0
+
+    def test_completions_invalid(self, runner):
+        result = runner.invoke(cli, ["completions", "powershell"])
+        assert result.exit_code != 0
+
+
+# ---------------------------------------------------------------------------
+# rich help
+# ---------------------------------------------------------------------------
+
+class TestRichHelp:
+    def test_help_renders(self, runner):
+        result = runner.invoke(cli, ["--help"])
+        assert result.exit_code == 0
+        assert "arccos" in result.output

arccos_api-0.3.0/arccos/cli/__init__.py

@@ -1,56 +0,0 @@
-"""
-arccos CLI — pull your Arccos Golf data from the terminal.
-
-Uses the reverse-engineered Arccos Golf API. Not affiliated with Arccos Golf LLC.
-"""
-
-from __future__ import annotations
-
-import click
-
-from . import auth, rounds, stats
-
-
-@click.group()
-@click.version_option(package_name="arccos-api", prog_name="arccos")
-def cli():
-    """
-    \b
-    arccos — Your Arccos Golf data in the terminal.
-
-    \b
-    Quick start:
-      arccos login                 Authenticate and save credentials
-      arccos rounds                Your recent rounds
-      arccos round <id>            Hole-by-hole round detail
-      arccos handicap              Current handicap index
-      arccos clubs                 Smart club distances
-      arccos courses               Courses you've played
-      arccos pace                  Pace of play by course
-      arccos stats                 Strokes gained analysis
-      arccos bests                 Personal bests (all-time records)
-      arccos overview              Overall stats summary
-      arccos scoring               Scoring trend over recent rounds
-      arccos club-shots <id>       Shot history for a specific club
-      arccos up-and-down           Scramble / up-and-down stats
-      arccos export                Export rounds to JSON/CSV
-      arccos logout                Clear cached credentials
-
-    \b
-    Credentials are cached in ~/.arccos_creds.json after first login.
-    Set ARCCOS_EMAIL and ARCCOS_PASSWORD to skip the prompts.
-    """
-
-
-# Register all command submodules
-auth.register(cli)
-rounds.register(cli)
-stats.register(cli)
-
-
-def main():
-    cli()
-
-
-if __name__ == "__main__":
-    main()