travelmaxx 0.1.0__tar.gz

travelmaxx-0.1.0/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: travelmaxx
+Version: 0.1.0
+Summary: Search award flights across 14 mileage programs from your terminal
+License-Expression: MIT
+Project-URL: Homepage, https://travelmaxx.app
+Project-URL: Documentation, https://travelmaxx.app/cli/docs
+Keywords: awards,flights,miles,points,travel
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: respx>=0.22; extra == "dev"
+
+# travelmaxx
+
+Search award flights across 14 mileage programs from your terminal, powered by
+[TravelMaxx](https://travelmaxx.app).
+
+```sh
+curl -fsSL https://travelmaxx.app/cli | sh
+travelmaxx login
+travelmaxx search SFO NRT --date 2026-10-05 --programs ALASKA
+```
+
+## Install
+
+Any of:
+
+```sh
+curl -fsSL https://travelmaxx.app/cli | sh        # auto-detects uv/pipx/pip
+uv tool install travelmaxx
+pipx install travelmaxx
+brew install travelmaxx/travelmaxx/travelmaxx     # once the tap is live
+```
+
+Requires Python 3.10+ (macOS or Linux), an active TravelMaxx subscription, and
+Roame credentials linked at <https://travelmaxx.app/dashboard/settings>.
+
+## Sign in
+
+```sh
+travelmaxx login              # opens your browser; click Approve
+travelmaxx login --no-browser # headless/SSH: 6-digit code at travelmaxx.app/activate
+travelmaxx whoami
+travelmaxx logout
+```
+
+Tokens are stored in `~/.config/travelmaxx/credentials.json` (chmod 600) and
+refresh automatically for 30 days. Your Roame credentials never touch this
+machine — searches run through the TravelMaxx server.
+
+## Search
+
+```sh
+# Single date (always pass --programs when you know them: 40-50x faster)
+travelmaxx search SFO NRT --date 2026-10-05 --programs ALASKA
+
+# Business class, 2 passengers, flexible ±2 days
+travelmaxx search SFO CDG --date 2026-09-12 --class BUSINESS \
+  --programs ALASKA,UNITED --pax 2 --days-around 2
+
+# A whole month in parallel, with a live progress bar
+travelmaxx search SFO NRT --date-range november --programs ALASKA
+
+# Explicit range / year / "next year"
+travelmaxx search SFO HEL --date-range 2026-09-12:2026-10-18 --programs ALASKA
+```
+
+Options: `--sort points|duration`, `--limit N`, `--max-wait SECONDS` (5–120;
+results are marked `partial` if the search returns early), `--min-results N`,
+`--max-workers N` (range searches), `--json`, `--output-file FILE`.
+
+Programs: `ALASKA, UNITED, DELTA, JETBLUE, LIFEMILES` (fast) ·
+`AMERICAN, QANTAS, EMIRATES, VIRGIN_ATLANTIC, VIRGIN_AUSTRALIA, CLUB_PREMIER,
+ETIHAD, FLYING_BLUE, GOL` (slower).
+
+## Alerts & discovery
+
+```sh
+travelmaxx alerts create SFO NRT --class BUSINESS --max-points 75000
+travelmaxx alerts list
+travelmaxx alerts delete <uuid>
+travelmaxx discover --limit 10
+```
+
+## JSON output
+
+`--json` prints the full API response. Single-date searches return
+`{"fares": [...], "percent_completed": 100, "partial": false}`; job-based
+searches return `{"status", "percent", "fares_count", "fares", ...}`.
+Each fare:
+
+```json
+{
+  "departure_date": "2026-10-05",
+  "origin": "SFO", "destination": "NRT",
+  "mileage_program": "ALASKA",
+  "award_points": 75000, "surcharge_usd": 18.1,
+  "num_stops": 0, "duration_minutes": 630,
+  "cabin_classes": ["BUSINESS"], "operating_airlines": ["JL"],
+  "equipment_types": ["77W"], "available_seats": 2, "roame_score": 1684
+}
+```
+
+## Configuration
+
+| Env var | Purpose |
+|---|---|
+| `TRAVELMAXX_API_URL` | Point at a different server (also `--server URL`) |
+| `XDG_CONFIG_HOME` | Relocate the config dir (default `~/.config/travelmaxx`) |
+
+## Development
+
+```sh
+cd cli
+python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
+.venv/bin/pytest
+.venv/bin/travelmaxx --server http://localhost:8000 login
+```
+
+Design doc: `../CLI.md`. Releases: tag `cli-vX.Y.Z` (see
+`.github/workflows/release-cli.yml`).

travelmaxx-0.1.0/README.md

@@ -0,0 +1,109 @@
+# travelmaxx
+
+Search award flights across 14 mileage programs from your terminal, powered by
+[TravelMaxx](https://travelmaxx.app).
+
+```sh
+curl -fsSL https://travelmaxx.app/cli | sh
+travelmaxx login
+travelmaxx search SFO NRT --date 2026-10-05 --programs ALASKA
+```
+
+## Install
+
+Any of:
+
+```sh
+curl -fsSL https://travelmaxx.app/cli | sh        # auto-detects uv/pipx/pip
+uv tool install travelmaxx
+pipx install travelmaxx
+brew install travelmaxx/travelmaxx/travelmaxx     # once the tap is live
+```
+
+Requires Python 3.10+ (macOS or Linux), an active TravelMaxx subscription, and
+Roame credentials linked at <https://travelmaxx.app/dashboard/settings>.
+
+## Sign in
+
+```sh
+travelmaxx login              # opens your browser; click Approve
+travelmaxx login --no-browser # headless/SSH: 6-digit code at travelmaxx.app/activate
+travelmaxx whoami
+travelmaxx logout
+```
+
+Tokens are stored in `~/.config/travelmaxx/credentials.json` (chmod 600) and
+refresh automatically for 30 days. Your Roame credentials never touch this
+machine — searches run through the TravelMaxx server.
+
+## Search
+
+```sh
+# Single date (always pass --programs when you know them: 40-50x faster)
+travelmaxx search SFO NRT --date 2026-10-05 --programs ALASKA
+
+# Business class, 2 passengers, flexible ±2 days
+travelmaxx search SFO CDG --date 2026-09-12 --class BUSINESS \
+  --programs ALASKA,UNITED --pax 2 --days-around 2
+
+# A whole month in parallel, with a live progress bar
+travelmaxx search SFO NRT --date-range november --programs ALASKA
+
+# Explicit range / year / "next year"
+travelmaxx search SFO HEL --date-range 2026-09-12:2026-10-18 --programs ALASKA
+```
+
+Options: `--sort points|duration`, `--limit N`, `--max-wait SECONDS` (5–120;
+results are marked `partial` if the search returns early), `--min-results N`,
+`--max-workers N` (range searches), `--json`, `--output-file FILE`.
+
+Programs: `ALASKA, UNITED, DELTA, JETBLUE, LIFEMILES` (fast) ·
+`AMERICAN, QANTAS, EMIRATES, VIRGIN_ATLANTIC, VIRGIN_AUSTRALIA, CLUB_PREMIER,
+ETIHAD, FLYING_BLUE, GOL` (slower).
+
+## Alerts & discovery
+
+```sh
+travelmaxx alerts create SFO NRT --class BUSINESS --max-points 75000
+travelmaxx alerts list
+travelmaxx alerts delete <uuid>
+travelmaxx discover --limit 10
+```
+
+## JSON output
+
+`--json` prints the full API response. Single-date searches return
+`{"fares": [...], "percent_completed": 100, "partial": false}`; job-based
+searches return `{"status", "percent", "fares_count", "fares", ...}`.
+Each fare:
+
+```json
+{
+  "departure_date": "2026-10-05",
+  "origin": "SFO", "destination": "NRT",
+  "mileage_program": "ALASKA",
+  "award_points": 75000, "surcharge_usd": 18.1,
+  "num_stops": 0, "duration_minutes": 630,
+  "cabin_classes": ["BUSINESS"], "operating_airlines": ["JL"],
+  "equipment_types": ["77W"], "available_seats": 2, "roame_score": 1684
+}
+```
+
+## Configuration
+
+| Env var | Purpose |
+|---|---|
+| `TRAVELMAXX_API_URL` | Point at a different server (also `--server URL`) |
+| `XDG_CONFIG_HOME` | Relocate the config dir (default `~/.config/travelmaxx`) |
+
+## Development
+
+```sh
+cd cli
+python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
+.venv/bin/pytest
+.venv/bin/travelmaxx --server http://localhost:8000 login
+```
+
+Design doc: `../CLI.md`. Releases: tag `cli-vX.Y.Z` (see
+`.github/workflows/release-cli.yml`).

travelmaxx-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[project]
+name = "travelmaxx"
+description = "Search award flights across 14 mileage programs from your terminal"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+dynamic = ["version"]
+dependencies = [
+    "httpx>=0.27",
+]
+keywords = ["awards", "flights", "miles", "points", "travel"]
+classifiers = [
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://travelmaxx.app"
+Documentation = "https://travelmaxx.app/cli/docs"
+
+[project.scripts]
+travelmaxx = "travelmaxx_cli.main:main"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "respx>=0.22",
+]
+
+[build-system]
+requires = ["setuptools>=75"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.dynamic]
+version = { attr = "travelmaxx_cli.__version__" }
+
+[tool.setuptools.packages.find]
+where = ["src"]

travelmaxx-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

travelmaxx-0.1.0/src/travelmaxx.egg-info/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: travelmaxx
+Version: 0.1.0
+Summary: Search award flights across 14 mileage programs from your terminal
+License-Expression: MIT
+Project-URL: Homepage, https://travelmaxx.app
+Project-URL: Documentation, https://travelmaxx.app/cli/docs
+Keywords: awards,flights,miles,points,travel
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: respx>=0.22; extra == "dev"
+
+# travelmaxx
+
+Search award flights across 14 mileage programs from your terminal, powered by
+[TravelMaxx](https://travelmaxx.app).
+
+```sh
+curl -fsSL https://travelmaxx.app/cli | sh
+travelmaxx login
+travelmaxx search SFO NRT --date 2026-10-05 --programs ALASKA
+```
+
+## Install
+
+Any of:
+
+```sh
+curl -fsSL https://travelmaxx.app/cli | sh        # auto-detects uv/pipx/pip
+uv tool install travelmaxx
+pipx install travelmaxx
+brew install travelmaxx/travelmaxx/travelmaxx     # once the tap is live
+```
+
+Requires Python 3.10+ (macOS or Linux), an active TravelMaxx subscription, and
+Roame credentials linked at <https://travelmaxx.app/dashboard/settings>.
+
+## Sign in
+
+```sh
+travelmaxx login              # opens your browser; click Approve
+travelmaxx login --no-browser # headless/SSH: 6-digit code at travelmaxx.app/activate
+travelmaxx whoami
+travelmaxx logout
+```
+
+Tokens are stored in `~/.config/travelmaxx/credentials.json` (chmod 600) and
+refresh automatically for 30 days. Your Roame credentials never touch this
+machine — searches run through the TravelMaxx server.
+
+## Search
+
+```sh
+# Single date (always pass --programs when you know them: 40-50x faster)
+travelmaxx search SFO NRT --date 2026-10-05 --programs ALASKA
+
+# Business class, 2 passengers, flexible ±2 days
+travelmaxx search SFO CDG --date 2026-09-12 --class BUSINESS \
+  --programs ALASKA,UNITED --pax 2 --days-around 2
+
+# A whole month in parallel, with a live progress bar
+travelmaxx search SFO NRT --date-range november --programs ALASKA
+
+# Explicit range / year / "next year"
+travelmaxx search SFO HEL --date-range 2026-09-12:2026-10-18 --programs ALASKA
+```
+
+Options: `--sort points|duration`, `--limit N`, `--max-wait SECONDS` (5–120;
+results are marked `partial` if the search returns early), `--min-results N`,
+`--max-workers N` (range searches), `--json`, `--output-file FILE`.
+
+Programs: `ALASKA, UNITED, DELTA, JETBLUE, LIFEMILES` (fast) ·
+`AMERICAN, QANTAS, EMIRATES, VIRGIN_ATLANTIC, VIRGIN_AUSTRALIA, CLUB_PREMIER,
+ETIHAD, FLYING_BLUE, GOL` (slower).
+
+## Alerts & discovery
+
+```sh
+travelmaxx alerts create SFO NRT --class BUSINESS --max-points 75000
+travelmaxx alerts list
+travelmaxx alerts delete <uuid>
+travelmaxx discover --limit 10
+```
+
+## JSON output
+
+`--json` prints the full API response. Single-date searches return
+`{"fares": [...], "percent_completed": 100, "partial": false}`; job-based
+searches return `{"status", "percent", "fares_count", "fares", ...}`.
+Each fare:
+
+```json
+{
+  "departure_date": "2026-10-05",
+  "origin": "SFO", "destination": "NRT",
+  "mileage_program": "ALASKA",
+  "award_points": 75000, "surcharge_usd": 18.1,
+  "num_stops": 0, "duration_minutes": 630,
+  "cabin_classes": ["BUSINESS"], "operating_airlines": ["JL"],
+  "equipment_types": ["77W"], "available_seats": 2, "roame_score": 1684
+}
+```
+
+## Configuration
+
+| Env var | Purpose |
+|---|---|
+| `TRAVELMAXX_API_URL` | Point at a different server (also `--server URL`) |
+| `XDG_CONFIG_HOME` | Relocate the config dir (default `~/.config/travelmaxx`) |
+
+## Development
+
+```sh
+cd cli
+python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
+.venv/bin/pytest
+.venv/bin/travelmaxx --server http://localhost:8000 login
+```
+
+Design doc: `../CLI.md`. Releases: tag `cli-vX.Y.Z` (see
+`.github/workflows/release-cli.yml`).

travelmaxx-0.1.0/src/travelmaxx.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+README.md
+pyproject.toml
+src/travelmaxx.egg-info/PKG-INFO
+src/travelmaxx.egg-info/SOURCES.txt
+src/travelmaxx.egg-info/dependency_links.txt
+src/travelmaxx.egg-info/entry_points.txt
+src/travelmaxx.egg-info/requires.txt
+src/travelmaxx.egg-info/top_level.txt
+src/travelmaxx_cli/__init__.py
+src/travelmaxx_cli/api.py
+src/travelmaxx_cli/auth.py
+src/travelmaxx_cli/config.py
+src/travelmaxx_cli/main.py
+src/travelmaxx_cli/render.py
+src/travelmaxx_cli/commands/__init__.py
+src/travelmaxx_cli/commands/alerts.py
+src/travelmaxx_cli/commands/auth_cmds.py
+src/travelmaxx_cli/commands/discover.py
+src/travelmaxx_cli/commands/search.py
+tests/test_cli.py

travelmaxx-0.1.0/src/travelmaxx.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

travelmaxx-0.1.0/src/travelmaxx.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+travelmaxx = travelmaxx_cli.main:main

travelmaxx-0.1.0/src/travelmaxx.egg-info/requires.txt

@@ -0,0 +1,5 @@
+httpx>=0.27
+
+[dev]
+pytest>=8.0
+respx>=0.22

travelmaxx-0.1.0/src/travelmaxx.egg-info/top_level.txt

@@ -0,0 +1 @@
+travelmaxx_cli

travelmaxx-0.1.0/src/travelmaxx_cli/__init__.py

@@ -0,0 +1,3 @@
+"""TravelMaxx CLI — award flight search from your terminal."""
+
+__version__ = "0.1.0"

travelmaxx-0.1.0/src/travelmaxx_cli/api.py

@@ -0,0 +1,90 @@
+"""HTTP client for the TravelMaxx /api/v1 REST API."""
+
+from __future__ import annotations
+
+import httpx
+
+from . import auth, config
+
+
+class APIError(Exception):
+    def __init__(self, status: int, code: str, message: str):
+        super().__init__(message)
+        self.status = status
+        self.code = code
+
+
+def _friendly(status: int, code: str, message: str) -> APIError:
+    if status == 402:
+        message = "Active subscription required — start a trial at https://travelmaxx.app/subscribe"
+    elif status == 409:
+        message = ("No Roame account linked — connect it at "
+                   "https://travelmaxx.app/dashboard/settings")
+    return APIError(status, code, message)
+
+
+class APIClient:
+    def __init__(self, server: str | None = None):
+        self._creds = auth.get_valid_credentials(server)
+        self._server = self._creds["server"]
+        self._http = httpx.Client(base_url=self._server, timeout=180.0)
+
+    def close(self):
+        self._http.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *exc):
+        self.close()
+
+    def _request(self, method: str, path: str, *, retry_auth: bool = True, **kwargs):
+        headers = {"Authorization": f"Bearer {self._creds['access_token']}"}
+        resp = self._http.request(method, path, headers=headers, **kwargs)
+        if resp.status_code == 401 and retry_auth:
+            self._creds = auth.refresh_credentials(self._creds)
+            return self._request(method, path, retry_auth=False, **kwargs)
+        if resp.status_code >= 400:
+            try:
+                body = resp.json()
+                code, message = body.get("error", ""), body.get("message", "")
+            except Exception:
+                code, message = f"http_{resp.status_code}", resp.text[:200]
+            raise _friendly(resp.status_code, code, message or code)
+        return resp.json()
+
+    # ── Endpoints ───────────────────────────────────────────────────────
+
+    def me(self) -> dict:
+        return self._request("GET", "/api/v1/me")
+
+    def search(self, **body) -> dict:
+        return self._request("POST", "/api/v1/search",
+                             json={k: v for k, v in body.items() if v is not None})
+
+    def create_search_job(self, **body) -> dict:
+        return self._request("POST", "/api/v1/search/jobs",
+                             json={k: v for k, v in body.items() if v is not None})
+
+    def get_search_job(self, job_id: str, include_fares: bool = True,
+                       sort_by: str = "points", limit: int = 500) -> dict:
+        return self._request(
+            "GET", f"/api/v1/search/jobs/{job_id}",
+            params={"include_fares": str(include_fares).lower(),
+                    "sort_by": sort_by, "limit": limit})
+
+    def cancel_search_job(self, job_id: str) -> dict:
+        return self._request("DELETE", f"/api/v1/search/jobs/{job_id}")
+
+    def list_alerts(self) -> list[dict]:
+        return self._request("GET", "/api/v1/alerts")
+
+    def create_alert(self, **body) -> dict:
+        return self._request("POST", "/api/v1/alerts",
+                             json={k: v for k, v in body.items() if v is not None})
+
+    def delete_alert(self, uuid: str) -> dict:
+        return self._request("DELETE", f"/api/v1/alerts/{uuid}")
+
+    def discover(self, limit: int = 20) -> list[dict]:
+        return self._request("GET", "/api/v1/discover", params={"limit": limit})