Rename package to opensky

Author: Federico De Ponte

.env.example

@@ -1,8 +1,11 @@
 # Optional: Duffel API (free unlimited searches)
 # Sign up at https://duffel.com
-# SKYROUTE_DUFFEL_TOKEN=duffel_test_xxxxx
+# OPENSKY_DUFFEL_TOKEN=duffel_test_xxxxx
+# Legacy fallback: SKYROUTE_DUFFEL_TOKEN=duffel_test_xxxxx
 
 # Optional: Amadeus API (free tier: 2,000 calls/month)
 # Sign up at https://developers.amadeus.com
-# SKYROUTE_AMADEUS_KEY=your_api_key
-# SKYROUTE_AMADEUS_SECRET=your_api_secret
+# OPENSKY_AMADEUS_KEY=your_api_key
+# OPENSKY_AMADEUS_SECRET=your_api_secret
+# Legacy fallback: SKYROUTE_AMADEUS_KEY=your_api_key
+# Legacy fallback: SKYROUTE_AMADEUS_SECRET=your_api_secret

.github/workflows/ci.yml

@@ -62,16 +62,17 @@ jobs:
 
       - name: Run CLI smoke checks
         run: |
-          skyroute --version | grep -q "skyroute "
-          skyroute demo --json > /tmp/demo.json
+          opensky --version | grep -q "opensky "
+          skyroute --version | grep -q "opensky "
+          opensky demo --json > /tmp/demo.json
           python - <<'PY'
           import json
           from pathlib import Path
 
           data = json.loads(Path("/tmp/demo.json").read_text())
           assert data, "demo output is empty"
           PY
-          skyroute zones > /tmp/zones.txt
+          opensky zones > /tmp/zones.txt
           grep -q "Active Conflict Zones" /tmp/zones.txt
 
       - name: Upload build artifacts

.github/workflows/release.yml

@@ -124,7 +124,7 @@ jobs:
 
     environment:
       name: pypi
-      url: https://pypi.org/project/skyroute/
+      url: https://pypi.org/project/opensky-cli/
 
     steps:
       - name: Download build artifacts

README.md

@@ -1,6 +1,6 @@
 # opensky
 
-`skyroute` is an open-source flight search CLI that aggregates Google Flights, Duffel, and Amadeus results, then flags itineraries that transit through risky airports, land in risky countries, or appear to overfly whole-country conflict zones on regional segments.
+`opensky` is an open-source flight search CLI that aggregates Google Flights, Duffel, and Amadeus results, then flags itineraries that transit through risky airports, land in risky countries, or appear to overfly whole-country conflict zones on regional segments.
 
 ## What The Engine Evaluates Today
 
@@ -17,7 +17,13 @@ It does not ingest filed routings, live FIR closures, or airline-specific detour
 
 Requires Python 3.11+.
 
-Install directly from GitHub:
+Install from PyPI:
+
+```bash
+pip install opensky-cli
+```
+
+GitHub install still works:
 
 ```bash
 pip install "git+https://github.com/buildingopen/opensky.git"
@@ -34,75 +40,77 @@ pip install -e .
 
 Copy `.env.example` to `.env` and fill in any API keys you have. Google Flights works without any keys.
 
+`skyroute` remains available as a compatibility command for now, but `opensky` is the canonical CLI.
+
 ## Quick Demo
 
 See the full output without any API keys or network calls:
 
 ```bash
-skyroute demo
-skyroute demo --show-risky
+opensky demo
+opensky demo --show-risky
 ```
 
-![skyroute demo](demo.gif)
+![opensky demo](demo.gif)
 
 ## Providers
 
-`skyroute` supports three providers. Google Flights is always available. Duffel and Amadeus activate automatically when their env vars are set.
+`opensky` supports three providers. Google Flights is always available. Duffel and Amadeus activate automatically when their env vars are set.
 
 | Provider | Env vars | Notes |
 |----------|----------|-------|
 | Google Flights | none (default) | Scrapes Google Flights. Needs a residential IP. |
-| [Duffel](https://duffel.com) | `SKYROUTE_DUFFEL_TOKEN` | API-based search. |
-| [Amadeus](https://developers.amadeus.com) | `SKYROUTE_AMADEUS_KEY` + `SKYROUTE_AMADEUS_SECRET` | API-based search. |
+| [Duffel](https://duffel.com) | `OPENSKY_DUFFEL_TOKEN` | Fallback: `SKYROUTE_DUFFEL_TOKEN`. |
+| [Amadeus](https://developers.amadeus.com) | `OPENSKY_AMADEUS_KEY` + `OPENSKY_AMADEUS_SECRET` | Fallback: legacy `SKYROUTE_AMADEUS_KEY` + `SKYROUTE_AMADEUS_SECRET`. |
 
 When multiple providers are configured, results are aggregated and deduplicated. If one provider fails, the CLI reports partial results. If every provider fails, the command exits non-zero.
 
 Use `--provider` / `-p` to limit to a single provider:
 
 ```bash
-skyroute search BLR HAM 2026-04-10 --provider duffel
+opensky search BLR HAM 2026-04-10 --provider duffel
 ```
 
 ## Usage
 
 ### Single route search
 
 ```bash
-skyroute search BLR HAM 2026-04-10
-skyroute search BLR HAM 2026-04-10 --currency EUR --show-risky
-skyroute search BLR HAM 2026-04-10 --json
-skyroute search BLR HAM 2026-04-10 --provider duffel
+opensky search BLR HAM 2026-04-10
+opensky search BLR HAM 2026-04-10 --currency EUR --show-risky
+opensky search BLR HAM 2026-04-10 --json
+opensky search BLR HAM 2026-04-10 --provider duffel
 ```
 
 ### Multi-route scan
 
 Generate a config file:
 
 ```bash
-skyroute config init
+opensky config init
 ```
 
 Edit `scan.toml` with your origins, destinations, and dates, then:
 
 ```bash
-skyroute scan --config scan.toml
-skyroute scan --config scan.toml --workers 5 --json -o results.json
+opensky scan --config scan.toml
+opensky scan --config scan.toml --workers 5 --json -o results.json
 ```
 
 Scans are cached. If interrupted, rerun the same command to reuse cached provider results.
 
 ### Conflict zones
 
 ```bash
-skyroute zones
-skyroute zones --update
+opensky zones
+opensky zones --update
 ```
 
 ### Cache management
 
 ```bash
-skyroute cache stats
-skyroute cache clear
+opensky cache stats
+opensky cache clear
 ```
 
 ## Scan Config
@@ -140,7 +148,7 @@ CPH = 5
 
 ## Safety Data
 
-`skyroute` ships with a bundled conflict-zone database based on:
+`opensky` ships with a bundled conflict-zone database based on:
 
 - [EASA Conflict Zone Information Bulletins (CZIB)](https://www.easa.europa.eu/en/domains/air-operations/czibs)
 - [Safe Airspace](https://safeairspace.net)
@@ -149,7 +157,7 @@ CPH = 5
 
 The dataset maps countries and specific airports to `SAFE`, `CAUTION`, `HIGH_RISK`, and `DO_NOT_FLY`. Whole-country zones also use bundled country geometry for regional overflight screening.
 
-Run `skyroute zones --update` to fetch the latest dataset from GitHub.
+Run `opensky zones --update` to fetch the latest dataset from GitHub.
 
 This is informational only. Always check official NOTAMs and airline advisories before booking.
 

RELEASING.md

@@ -26,9 +26,15 @@ PyPI publish is gated behind the repository variable `PYPI_PUBLISH=true`.
 
 To enable it:
 
-1. Create the package on PyPI.
+1. Create the `opensky-cli` package on PyPI.
 2. Configure trusted publishing for this GitHub repository in PyPI.
 3. Create the GitHub Actions environment `pypi` if you want environment protection rules.
 4. Set the repository variable `PYPI_PUBLISH` to `true`.
 
 Once that is configured, the same tag-based release workflow publishes the built distributions to PyPI after the GitHub release assets are created.
+
+Public install target:
+
+```bash
+pip install opensky-cli
+```

pyproject.toml

@@ -3,9 +3,9 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [project]
-name = "skyroute"
-version = "0.1.0"
-description = "Flight search CLI with itinerary conflict-zone flagging"
+name = "opensky-cli"
+version = "0.1.1"
+description = "OpenSky flight search CLI with itinerary and overflight conflict-zone flagging"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.11"
@@ -32,7 +32,8 @@ dependencies = [
 ]
 
 [project.scripts]
-skyroute = "skyroute.cli:app"
+opensky = "opensky.cli:app"
+skyroute = "opensky.cli:app"
 
 [project.urls]
 Homepage = "https://github.com/buildingopen/opensky"
@@ -48,7 +49,7 @@ exclude = [
 ]
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/skyroute"]
+packages = ["src/opensky", "src/skyroute"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

src/opensky/__init__.py

@@ -0,0 +1,3 @@
+"""opensky - flight search with itinerary and overflight conflict-zone flagging."""
+
+__version__ = "0.1.1"

src/opensky/__main__.py

@@ -0,0 +1,3 @@
+from opensky.cli import app
+
+app()