Skip to content

armgit / Aleph

Public Imported from GitHub
0

Give satellite imagery, terrain data, buildings, streetview photos to your LLM

Better CLI arg names

Belluxxc0065ed803b0
diff --git a/aleph.py b/aleph.py
index 3a588d9..8f12bee 100644
--- a/aleph.py
+++ b/aleph.py
@@ -218,7 +218,7 @@ def main(argv=None):
save_only = action == "create" and args.plan
if action != "export":
describe(run)
- if not (save_only or args.no_plan) and not proceed():
+ if not (save_only or args.yes) and not proceed():
print("Cancelled.", file=sys.stderr)
if as_json:
emit(dict(command="capture", action=action, status="cancelled"), True)
diff --git a/docs/cli.md b/docs/cli.md
index 92d632f..d05acc0 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -20,9 +20,9 @@ Satellite captures produce `satellite.tif`, a lossless RGBA Cloud Optimized GeoT
Each capture also includes `satellite.png` with identical full-resolution pixels and transparency.
-Choose the saved satellite tile format with `satellite --satellite-format png`
-or `satellite --satellite-format jpg` (default). For area captures, use
-`capture create --satellite-format png`; the dashboard has the same choice
+Choose the saved satellite tile format with `satellite --tile-format png`
+or `satellite --tile-format jpg` (default). For area captures, use
+`capture create --tile-format png`; the dashboard has the same choice
under **Advanced → Satellite → Tile format**. This only changes files in
`satellite/patches/`: both `satellite.png` and `satellite.tif` are always generated.
Missing tiles remain transparent PNGs, including when JPEG is selected.
@@ -91,7 +91,7 @@ Capture all available data inside a rectangle (Street View, satellite imagery, O
alephgeo capture create --bbox 41.8895 12.4910 41.8910 12.4940 -o captures
```
-The command shows an estimate and asks before downloading. Add `--no-plan` to skip the prompt, or `--plan` to save a plan for later.
+The command shows an estimate and asks before downloading. Add `--yes` to skip the prompt, or `--plan` to save a plan for later.
To download only map data and terrain:
@@ -119,7 +119,7 @@ Add `--json` for one JSON result on stdout; progress stays on stderr.
```sh
alephgeo satellite --at 41.8902 12.4922 -o captures --json > result.json
-alephgeo capture create --bbox 41.8895 12.4910 41.8910 12.4940 -o captures --no-plan --json
+alephgeo capture create --bbox 41.8895 12.4910 41.8910 12.4940 -o captures --yes --json
```
For all options, run `alephgeo COMMAND --help` (for example, `alephgeo streetview --help` or `alephgeo capture create --help`).
diff --git a/src/cli.py b/src/cli.py
index 112719f..1dc2214 100644
--- a/src/cli.py
+++ b/src/cli.py
@@ -119,7 +119,7 @@ def _satellite_command(commands):
satellite.add_argument("--zoom", type=int, help="satellite zoom, 1–21 (default: 19)")
_network_options(satellite)
- satellite.add_argument("--satellite-format", choices=("jpg", "png"), default="jpg", help="saved tile format; merged PNG and COG are always produced (default: jpg)")
+ satellite.add_argument("--tile-format", dest="satellite_format", choices=("jpg", "png"), default="jpg", help="saved tile format; merged PNG and COG are always produced (default: jpg)")
_output_options(satellite, directory=True)
@@ -133,8 +133,8 @@ def _capture_command(commands):
# Planning and confirmation.
planning = area.add_mutually_exclusive_group()
planning.add_argument("--plan", action="store_true", help="save a plan without downloading imagery")
- no_plan_help = "start without the confirmation prompt"
- planning.add_argument("--no-plan", action="store_true", help=no_plan_help)
+ yes_help = "start without the confirmation prompt"
+ planning.add_argument("--yes", action="store_true", help=yes_help)
# Street View coverage, camera, and photo format.
area.add_argument("--depth", choices=("main", "roads", "all"), help="road/path selection (default: roads)")
@@ -145,7 +145,7 @@ def _capture_command(commands):
# Satellite imagery.
area.add_argument("--satellite-zoom", type=int, help="satellite zoom, 1–21 (default: 18)")
- area.add_argument("--satellite-format", choices=("jpg", "png"), help="saved satellite tile format; merged PNG and COG are always produced (default: jpg)")
+ area.add_argument("--tile-format", dest="satellite_format", choices=("jpg", "png"), help="saved satellite tile format; merged PNG and COG are always produced (default: jpg)")
# Terrain resolution.
area.add_argument("--terrain-zoom", type=int, help="terrain zoom, 1–14 (default: 14)")
@@ -159,7 +159,7 @@ def _capture_command(commands):
resume_help = "Continue a saved or planned run"
resume = actions.add_parser("resume", help=resume_help, description=resume_help)
resume.add_argument("folder", type=Path, help="timestamped run directory containing manifest.json")
- resume.add_argument("--no-plan", action="store_true", help=no_plan_help)
+ resume.add_argument("--yes", action="store_true", help=yes_help)
_cache_options(resume)
_output_options(resume)