avios-cli 0.1.6__tar.gz → 0.2.0__tar.gz

{avios_cli-0.1.6 → avios_cli-0.2.0}/CHANGELOG.md

@@ -6,6 +6,19 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-07-24
+
+### Added
+- **`transactions`, `pending` and `overview` now work.** The manage-avios API
+  only needed an `x-avios-opco` header (not a separate session, as previously
+  thought) — it's now sent automatically. `transactions` renders date /
+  description / Avios (coloured +/-) / type and respects `--limit`; the TUI shows
+  real transactions too.
+- Typed `Transaction` model (identifier, dateProcessed, description, type,
+  partner, amount, categories) and a `NamedRef` helper.
+- `AVIOS_OPCO` setting (default `BAEC` = British Airways Executive Club) for other
+  Avios programmes.
+
 ## [0.1.6] - 2026-07-24
 
 ### Fixed
@@ -107,7 +120,8 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 - Reward-flight **availability** search is not yet implemented (needs a British
   Airways capture).
 
-[Unreleased]: https://github.com/alexechoi/avios-cli/compare/v0.1.6...HEAD
+[Unreleased]: https://github.com/alexechoi/avios-cli/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/alexechoi/avios-cli/compare/v0.1.6...v0.2.0
 [0.1.6]: https://github.com/alexechoi/avios-cli/compare/v0.1.5...v0.1.6
 [0.1.5]: https://github.com/alexechoi/avios-cli/compare/v0.1.4...v0.1.5
 [0.1.4]: https://github.com/alexechoi/avios-cli/compare/v0.1.3...v0.1.4

{avios_cli-0.1.6 → avios_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: avios-cli
-Version: 0.1.6
+Version: 0.2.0
 Summary: A CLI and TUI for avios.com — view your Avios balance and transactions from the terminal.
 Project-URL: Homepage, https://github.com/alexechoi/avios-cli
 Project-URL: Repository, https://github.com/alexechoi/avios-cli
@@ -120,20 +120,15 @@ expires after ~a day; just run `avios login` again. Run `avios logout` to remove
 
 ```bash
 avios balance                  # total / individual / household Avios
+avios transactions --limit 20  # recent transactions (date, description, Avios, type)
+avios pending                  # pending Avios
+avios overview                 # dashboard summary
 avios whoami                   # name, tier, membership, email
 avios raw /shell/api/users/current/accounts   # hit any endpoint directly
 ```
 
-Add `--json` to `balance` or `whoami` for scriptable output.
-
-**Experimental** (need the `manage-avios` app session, which the cookie/SSO login
-can't yet establish — these currently return "session expired"):
-
-```bash
-avios transactions --limit 20
-avios pending
-avios overview
-```
+Add `--json` to `balance`, `transactions`, `pending` or `whoami` for scriptable
+output. Non-BA Avios programmes can set `AVIOS_OPCO` (default `BAEC`).
 
 ## TUI
 

{avios_cli-0.1.6 → avios_cli-0.2.0}/README.md

@@ -85,20 +85,15 @@ expires after ~a day; just run `avios login` again. Run `avios logout` to remove
 
 ```bash
 avios balance                  # total / individual / household Avios
+avios transactions --limit 20  # recent transactions (date, description, Avios, type)
+avios pending                  # pending Avios
+avios overview                 # dashboard summary
 avios whoami                   # name, tier, membership, email
 avios raw /shell/api/users/current/accounts   # hit any endpoint directly
 ```
 
-Add `--json` to `balance` or `whoami` for scriptable output.
-
-**Experimental** (need the `manage-avios` app session, which the cookie/SSO login
-can't yet establish — these currently return "session expired"):
-
-```bash
-avios transactions --limit 20
-avios pending
-avios overview
-```
+Add `--json` to `balance`, `transactions`, `pending` or `whoami` for scriptable
+output. Non-BA Avios programmes can set `AVIOS_OPCO` (default `BAEC`).
 
 ## TUI
 

{avios_cli-0.1.6 → avios_cli-0.2.0}/src/avios/__init__.py

@@ -3,4 +3,4 @@
 View your Avios balance, transactions and account details from the terminal.
 """
 
-__version__ = "0.1.6"
+__version__ = "0.2.0"

{avios_cli-0.1.6 → avios_cli-0.2.0}/src/avios/cli.py

@@ -20,7 +20,7 @@ from rich.table import Table
 from avios import __version__
 from avios.auth import LoginError, import_from_browser, login_via_browser
 from avios.client import AviosClient
-from avios.models import Balance
+from avios.models import Balance, Transaction
 from avios.session import NotAuthenticated, Session, SessionExpired
 
 app = typer.Typer(
@@ -78,19 +78,6 @@ def _print_json(data: Any) -> None:
     console.print_json(data=data)
 
 
-def _render_records(records: list[dict[str, Any]], title: str) -> None:
-    if not records:
-        console.print(f"[dim]No {title.lower()}.[/]")
-        return
-    keys = [k for k, v in records[0].items() if not isinstance(v, dict | list)][:6]
-    table = Table(title=title)
-    for key in keys:
-        table.add_column(key)
-    for record in records:
-        table.add_row(*[str(record.get(key, "")) for key in keys])
-    console.print(table)
-
-
 # -- auth commands -----------------------------------------------------------
 @app.command()
 def login(
@@ -172,36 +159,53 @@ def _render_balance(result: Balance) -> None:
     console.print(table)
 
 
+def _render_transactions(items: list[Transaction], title: str) -> None:
+    if not items:
+        console.print(f"[dim]No {title.lower()}.[/]")
+        return
+    table = Table(title=title)
+    table.add_column("Date")
+    table.add_column("Description")
+    table.add_column("Avios", justify="right")
+    table.add_column("Type")
+    for txn in items:
+        date = (txn.date_processed or "")[:10]
+        desc = (txn.description or "").splitlines()[0][:44] if txn.description else ""
+        amount = f"{txn.amount:+,}" if txn.amount is not None else ""
+        colour = "green" if (txn.amount or 0) >= 0 else "red"
+        kind = txn.type.value if txn.type else ""
+        table.add_row(date, desc, f"[{colour}]{amount}[/]", kind or "")
+    console.print(table)
+
+
 @app.command()
 def transactions(
     limit: int = typer.Option(20, help="Number of transactions to show."),
     json_out: bool = JSON_OPTION,
 ) -> None:
-    """List recent Avios transactions (experimental; needs the manage-avios session)."""
+    """List recent Avios transactions."""
     with _handle_errors():
         items = _client().get_transactions(limit=limit)
-    records = [item.as_dict() for item in items]
     if json_out:
-        _print_json(records)
+        _print_json([item.as_dict() for item in items])
         return
-    _render_records(records, "Transactions")
+    _render_transactions(items, "Transactions")
 
 
 @app.command()
 def pending(json_out: bool = JSON_OPTION) -> None:
-    """List pending Avios transactions (experimental; needs the manage-avios session)."""
+    """List pending Avios transactions."""
     with _handle_errors():
         items = _client().get_pending_transactions()
-    records = [item.as_dict() for item in items]
     if json_out:
-        _print_json(records)
+        _print_json([item.as_dict() for item in items])
         return
-    _render_records(records, "Pending")
+    _render_transactions(items, "Pending")
 
 
 @app.command()
 def overview() -> None:
-    """Show the dashboard overview (experimental; needs the manage-avios session)."""
+    """Show the dashboard overview (raw JSON)."""
     with _handle_errors():
         result = _client().get_overview()
     _print_json(result.as_dict())

{avios_cli-0.1.6 → avios_cli-0.2.0}/src/avios/client.py

@@ -47,11 +47,16 @@ class AviosClient:
     def get_overview(self) -> Overview:
         return Overview.model_validate(self.session.get_json(endpoints.OVERVIEW))
 
-    def get_transactions(self, limit: int | None = None) -> list[Transaction]:
-        payload = self.session.get_json(endpoints.TRANSACTIONS)
-        items = _extract_list(payload)
+    def get_transactions(self, limit: int = 50) -> list[Transaction]:
+        # `offset` is a server-side page hint; slice to `limit` for an exact count.
+        offset = limit if limit and limit > 0 else 1000
+        path = f"{endpoints.TRANSACTIONS}?startRecord=1&offset={offset}&status=completed"
+        payload = self.session.get_json(path)
+        items = (
+            payload.get("transactions", []) if isinstance(payload, dict) else _extract_list(payload)
+        )
         transactions = [Transaction.model_validate(item) for item in items]
-        return transactions[:limit] if limit is not None else transactions
+        return transactions[:limit] if limit and limit > 0 else transactions
 
     def get_pending_transactions(self) -> list[Transaction]:
         payload = self.session.get_json(endpoints.TRANSACTIONS_PENDING)

{avios_cli-0.1.6 → avios_cli-0.2.0}/src/avios/config.py

@@ -39,6 +39,9 @@ class Settings(BaseSettings):
     user_agent: str = DEFAULT_USER_AGENT
     config_dir: Path = Field(default_factory=_default_config_dir)
     request_timeout: float = 20.0
+    # Operating company code sent as `x-avios-opco`; required by the manage-avios
+    # API. "BAEC" = British Airways Executive Club (override with AVIOS_OPCO).
+    opco: str = "BAEC"
 
     @property
     def state_path(self) -> Path:

{avios_cli-0.1.6 → avios_cli-0.2.0}/src/avios/models.py

@@ -11,7 +11,7 @@ from __future__ import annotations
 
 from typing import Any
 
-from pydantic import BaseModel, ConfigDict
+from pydantic import BaseModel, ConfigDict, Field
 
 
 class AviosModel(BaseModel):
@@ -35,12 +35,24 @@ class Balance(AviosModel):
     household: int | None = None
 
 
-class Transaction(AviosModel):
-    """A single Avios statement entry.
+class NamedRef(AviosModel):
+    """A ``{value, id}`` reference (transaction type, partner, ...)."""
 
-    Concrete fields are pinned once live transaction payloads are observed; until
-    then every key is preserved via ``extra='allow'``.
-    """
+    value: str | None = None
+    id: str | None = None
+
+
+class Transaction(AviosModel):
+    """A single Avios statement entry (from the manage-avios transactions API)."""
+
+    identifier: str | None = None
+    date_processed: str | None = Field(default=None, alias="dateProcessed")
+    description: str | None = None
+    type: NamedRef | None = None
+    partner: NamedRef | None = None
+    amount: int | None = None
+    categories: list[str] = Field(default_factory=list)
+    record_index: int | None = Field(default=None, alias="recordIndex")
 
 
 class Account(AviosModel):

{avios_cli-0.1.6 → avios_cli-0.2.0}/src/avios/session.py

@@ -95,6 +95,8 @@ class Session:
             "accept": "application/json, text/plain, */*",
             "user-agent": self.settings.user_agent,
             "referer": f"{self.settings.base_url}/manage-avios/dashboard",
+            # Required by the manage-avios API (401 without it).
+            "x-avios-opco": self.settings.opco,
             "cookie": cookie,
         }
         return httpx.Client(

{avios_cli-0.1.6 → avios_cli-0.2.0}/src/avios/tui/app.py

@@ -21,7 +21,6 @@ from avios.tui.art import banner_text
 from avios.tui.widgets import BalanceDisplay
 
 TRANSACTIONS_TO_SHOW = 50
-MAX_COLUMNS = 6
 
 
 class AviosApp(App[None]):
@@ -87,15 +86,17 @@ class AviosApp(App[None]):
         table = self.query_one("#transactions", DataTable)
         table.loading = False
         table.clear(columns=True)
-        records = [txn.as_dict() for txn in transactions]
-        if not records:
+        if not transactions:
             table.add_column("info")
             table.add_row("No transactions")
             return
-        keys = [k for k, v in records[0].items() if not isinstance(v, dict | list)][:MAX_COLUMNS]
-        table.add_columns(*keys)
-        for record in records:
-            table.add_row(*[str(record.get(key, "")) for key in keys])
+        table.add_columns("Date", "Description", "Avios", "Type")
+        for txn in transactions:
+            date = (txn.date_processed or "")[:10]
+            desc = (txn.description or "").splitlines()[0][:44] if txn.description else ""
+            amount = f"{txn.amount:+,}" if txn.amount is not None else ""
+            kind = txn.type.value if txn.type else ""
+            table.add_row(date, desc, amount, kind)
 
 
 def run(client: AviosClient | None = None) -> None:

avios_cli-0.2.0/tests/fixtures/transactions.json

@@ -0,0 +1,25 @@
+{
+  "totalRecords": 2,
+  "transactions": [
+    {
+      "identifier": "2139440378",
+      "dateProcessed": "2026-07-21T11:37:35.000Z",
+      "description": "UBER",
+      "type": {"value": "Collection", "id": "DV_COL"},
+      "partner": {"value": "UBER", "id": "UBR"},
+      "amount": 50,
+      "categories": ["collectingAvios"],
+      "recordIndex": 1
+    },
+    {
+      "identifier": "2023965591",
+      "dateProcessed": "2025-12-10T21:37:04.000Z",
+      "description": "Tokyo Haneda to London Heathrow\nClass: Club World\nBA0008",
+      "type": {"value": "Reward Flight", "id": "FLT_RWD"},
+      "partner": {"value": "British Airways", "id": "BA"},
+      "amount": -52000,
+      "categories": ["flights"],
+      "recordIndex": 2
+    }
+  ]
+}

{avios_cli-0.1.6 → avios_cli-0.2.0}/tests/test_cli.py

@@ -30,12 +30,26 @@ class FakeClient:
     def get_balance(self) -> Balance:
         return Balance(balance=100, individual=100, household=200)
 
-    def get_transactions(self, limit: int | None = None) -> list[Transaction]:
+    def get_transactions(self, limit: int = 50) -> list[Transaction]:
         items = [
-            Transaction.model_validate({"date": "2026-07-01", "avios": 100}),
-            Transaction.model_validate({"date": "2026-06-01", "avios": 50}),
+            Transaction.model_validate(
+                {
+                    "dateProcessed": "2026-07-01T09:00:00.000Z",
+                    "description": "UBER",
+                    "type": {"value": "Collection", "id": "DV_COL"},
+                    "amount": 100,
+                }
+            ),
+            Transaction.model_validate(
+                {
+                    "dateProcessed": "2026-06-01T09:00:00.000Z",
+                    "description": "Deliveroo UK",
+                    "type": {"value": "BA Avios eStore", "id": "BA_AV_ESTORE"},
+                    "amount": 50,
+                }
+            ),
         ]
-        return items[:limit] if limit is not None else items
+        return items[:limit]
 
     def get_pending_transactions(self) -> list[Transaction]:
         return []
@@ -100,7 +114,8 @@ def test_transactions_respects_limit(fake_client: None) -> None:
 def test_transactions_json(fake_client: None) -> None:
     result = runner.invoke(app, ["transactions", "--json"])
     assert result.exit_code == 0
-    assert '"avios"' in result.stdout
+    assert '"amount"' in result.stdout
+    assert '"dateProcessed"' in result.stdout
 
 
 def test_whoami(fake_client: None) -> None:

{avios_cli-0.1.6 → avios_cli-0.2.0}/tests/test_client.py

@@ -1,9 +1,4 @@
-"""Tests for the typed API client.
-
-The transactions/accounts fixtures are representative, not confirmed shapes, so
-these tests assert on counts and field pass-through (via ``extra='allow'``) rather
-than a rigid schema. The balance shape is confirmed.
-"""
+"""Tests for the typed API client (balance, transactions, profile, ...)."""
 
 from __future__ import annotations
 
@@ -19,8 +14,12 @@ from avios.config import Settings
 from avios.session import Session, SessionExpired
 
 
-def _client(settings: Settings, routes: dict[str, Any]) -> AviosClient:
+def _client(
+    settings: Settings, routes: dict[str, Any], captured: list[httpx.Request] | None = None
+) -> AviosClient:
     def handler(request: httpx.Request) -> httpx.Response:
+        if captured is not None:
+            captured.append(request)
         if request.url.path not in routes:
             return httpx.Response(404, json={})
         body = routes[request.url.path]
@@ -40,28 +39,21 @@ def test_get_balance(settings: Settings, load_fixture: Callable[[str], Any]) ->
     assert balance.household == 112430
 
 
-def test_get_transactions_from_bare_list(
-    settings: Settings, load_fixture: Callable[[str], Any]
-) -> None:
-    client = _client(settings, {endpoints.TRANSACTIONS: load_fixture("transactions.json")})
-    txns = client.get_transactions()
-    assert len(txns) == 3
-    assert txns[0].as_dict()["description"] == "Flight BA286 SFO-LHR"
-
-
-def test_get_transactions_respects_limit(
-    settings: Settings, load_fixture: Callable[[str], Any]
-) -> None:
-    client = _client(settings, {endpoints.TRANSACTIONS: load_fixture("transactions.json")})
-    assert len(client.get_transactions(limit=2)) == 2
-
-
-def test_get_transactions_from_wrapped_object(settings: Settings) -> None:
-    payload = {"total": 1, "transactions": [{"date": "2026-07-01", "avios": 100}]}
-    client = _client(settings, {endpoints.TRANSACTIONS: payload})
-    txns = client.get_transactions()
-    assert len(txns) == 1
-    assert txns[0].as_dict()["avios"] == 100
+def test_get_transactions(settings: Settings, load_fixture: Callable[[str], Any]) -> None:
+    captured: list[httpx.Request] = []
+    client = _client(
+        settings, {endpoints.TRANSACTIONS: load_fixture("transactions.json")}, captured
+    )
+    txns = client.get_transactions(limit=2)
+    assert len(txns) == 2
+    assert txns[0].type is not None and txns[0].type.value == "Collection"
+    assert txns[0].amount == 50
+    assert txns[1].amount == -52000
+    # Sends the required opco header and the limit as offset.
+    req = captured[-1]
+    assert req.headers["x-avios-opco"] == "BAEC"
+    assert "offset=2" in str(req.url)
+    assert "status=completed" in str(req.url)
 
 
 def test_get_profile(settings: Settings) -> None:

{avios_cli-0.1.6 → avios_cli-0.2.0}/tests/test_models.py

@@ -29,6 +29,25 @@ def test_balance_extras_are_optional() -> None:
 def test_extra_fields_are_preserved() -> None:
     txn = Transaction.model_validate({"date": "2026-07-01", "avios": 500, "unknown": "x"})
     dumped = txn.as_dict()
-    assert dumped["date"] == "2026-07-01"
-    assert dumped["avios"] == 500
     assert dumped["unknown"] == "x"
+
+
+def test_transaction_parses_real_shape() -> None:
+    txn = Transaction.model_validate(
+        {
+            "identifier": "2139440378",
+            "dateProcessed": "2026-07-21T11:37:35.000Z",
+            "description": "UBER",
+            "type": {"value": "Collection", "id": "DV_COL"},
+            "partner": {"value": "UBER", "id": "UBR"},
+            "amount": 50,
+            "categories": ["collectingAvios"],
+            "recordIndex": 1,
+        }
+    )
+    assert txn.identifier == "2139440378"
+    assert txn.date_processed == "2026-07-21T11:37:35.000Z"
+    assert txn.type is not None and txn.type.value == "Collection"
+    assert txn.partner is not None and txn.partner.id == "UBR"
+    assert txn.amount == 50
+    assert txn.categories == ["collectingAvios"]

{avios_cli-0.1.6 → avios_cli-0.2.0}/tests/test_session.py

@@ -67,6 +67,7 @@ def test_client_requires_authentication(settings: Settings) -> None:
 def test_get_json_returns_parsed_body(settings: Settings) -> None:
     def handler(request: httpx.Request) -> httpx.Response:
         assert request.headers["cookie"] == "appSession=abc"
+        assert request.headers["x-avios-opco"] == "BAEC"
         return httpx.Response(200, json={"balance": 75751})
 
     session = _session(settings, httpx.MockTransport(handler))

{avios_cli-0.1.6 → avios_cli-0.2.0}/tests/test_tui.py

@@ -17,10 +17,14 @@ class FakeClient:
     def get_balance(self) -> Balance:
         return Balance(balance=100, individual=100, household=200)
 
-    def get_transactions(self, limit: int | None = None) -> list[Transaction]:
+    def get_transactions(self, limit: int = 50) -> list[Transaction]:
         return [
-            Transaction.model_validate({"date": "2026-07-01", "avios": 100}),
-            Transaction.model_validate({"date": "2026-06-01", "avios": 50}),
+            Transaction.model_validate(
+                {"dateProcessed": "2026-07-01T09:00:00Z", "description": "UBER", "amount": 100}
+            ),
+            Transaction.model_validate(
+                {"dateProcessed": "2026-06-01T09:00:00Z", "description": "Flight", "amount": -5000}
+            ),
         ]
 
 

avios_cli-0.1.6/tests/fixtures/transactions.json

@@ -1,5 +0,0 @@
-[
-  {"date": "2026-07-01", "description": "Flight BA286 SFO-LHR", "avios": 4200},
-  {"date": "2026-06-15", "description": "Tesco groceries", "avios": 150},
-  {"date": "2026-06-02", "description": "Redemption: LHR-JFK", "avios": -50000}
-]