harp-astro 0.1.0__tar.gz

harp_astro-0.1.0/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: harp-astro
+Version: 0.1.0
+Summary: HARP - Horizon-Aware Recommender and Planner for deep-sky astrophotography sessions
+Author-email: Stefano Zaghi <stefano.zaghi@gmail.com>
+License: GPL-3.0-or-later OR BSD-2-Clause OR BSD-3-Clause OR MIT
+Project-URL: Homepage, https://szaghi.github.io/harp/
+Project-URL: Documentation, https://szaghi.github.io/harp/
+Project-URL: Repository, https://github.com/szaghi/harp
+Project-URL: Bug Tracker, https://github.com/szaghi/harp/issues
+Keywords: astronomy,astrophotography,deep-sky,planner,session,telescope
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: License :: OSI Approved :: BSD License
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13
+Requires-Dist: numpy>=1.26
+Requires-Dist: astropy>=6.0
+Requires-Dist: astroplan>=0.9
+Requires-Dist: pyongc>=1.1
+Requires-Dist: matplotlib>=3.8
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-cov>=5; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: ruff>=0.8; extra == "dev"
+
+<div align="center">
+
+# HARP
+
+#### *image the sky your balcony can actually see*
+
+### **H**orizon-**A**ware **R**ecommender and **P**lanner
+
+> A CLI planner for deep-sky astrophotography sessions. Given a date, a site, your
+> telescope + camera, the **real horizon of your spot** and the Moon, HARP ranks the
+> targets you can actually image tonight — usable windows, Moon impact, and mosaic
+> framing tailored to your rig.
+
+[![Version](https://img.shields.io/pypi/v/harp-astro?label=version)](https://pypi.org/project/harp-astro/)
+[![CI](https://github.com/szaghi/harp/actions/workflows/ci.yml/badge.svg)](https://github.com/szaghi/harp/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue?logo=python&logoColor=white)](https://www.python.org/)
+[![GitHub issues](https://img.shields.io/github/issues/szaghi/harp.svg)](https://github.com/szaghi/harp/issues)
+
+[![License: GPL v3](https://img.shields.io/badge/license-GPL%20v3-blue)](licensing/LICENSE.gpl3.md)
+[![License: BSD-2](https://img.shields.io/badge/license-BSD--2--Clause-blue)](licensing/LICENSE.bsd-2.md)
+[![License: BSD-3](https://img.shields.io/badge/license-BSD--3--Clause-blue)](licensing/LICENSE.bsd-3.md)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](licensing/LICENSE.mit.md)
+
+<div>
+<table>
+<tr>
+<td><b>🧱 Horizon-aware visibility</b><br><sub>Measure your site's obstructions once as an azimuth-dependent mask (<code>.hrz</code>, N.I.N.A.-compatible). A target counts as observable only when its altitude clears the ridge/wall <em>in its own direction</em> — not against an idealized flat horizon. <a href="https://szaghi.github.io/harp/guide/usage#build-a-horizon-file">Horizon guide</a></sub></td>
+<td><b>⏱️ Continuous imaging windows</b><br><sub>Per target: total usable hours during astronomical darkness plus the longest <em>continuous</em> run before it enters a blocked sector — the number you actually size exposures and mosaic panels on. <a href="https://szaghi.github.io/harp/guide/usage#reading-the-output">Reading the output</a></sub></td>
+</tr>
+<tr>
+<td><b>🏆 Desirability ranking</b><br><sub>Every target gets a 0-100 score: a weighted geometric mean of continuous window, total hours, peak altitude (inverse-airmass), Moon verdict, and how well the object fills your field of view — so one hopeless factor sinks a target instead of averaging away. <code>--sort hours</code> restores the classic order.</sub></td>
+<td><b>🌙 Moon impact model</b><br><sub>Phase and separation folded into a per-target verdict — <code>none</code>, <code>ok(NB)</code>, <code>low/med/high</code> — with narrowband auto-derived from the object type: planetaries, supernova remnants and HII regions shrug at a Moon that ruins broadband RGB.</sub></td>
+</tr>
+<tr>
+<td><b>🖼️ Mosaic framing &amp; panel coordinates</b><br><sub>Your focal length + sensor decide <code>1 frame</code> or <code>mosaic NxM</code>; <code>harp mosaic</code> then emits the actual per-panel RA/Dec centers (overlap-aware, position-angle rotated, correct at any declination) — plus single-frame crop suggestions for the monsters. <a href="https://szaghi.github.io/harp/guide/usage#mosaic-panel-coordinates">Mosaic guide</a></sub></td>
+<td><b>🎯 N.I.N.A. integration</b><br><sub>The same <code>.hrz</code> horizon drives both tools, and <code>--nina</code> exports ranked targets or mosaic panels as CSVs N.I.N.A.'s sequencer imports directly — verified against N.I.N.A.'s actual parser source. Plan in HARP, shoot in N.I.N.A., retype nothing. <a href="https://szaghi.github.io/harp/guide/usage#nina-integration">N.I.N.A. guide</a></sub></td>
+</tr>
+<tr>
+<td><b>🔭 Offline catalogues + your own</b><br><sub>Curated large emission nebulae (deliberately <em>not</em> magnitude-filtered), full Messier/NGC/IC via <a href="https://github.com/mattiaverga/PyOngc">pyongc</a> (<code>--catalogs M,NGC,IC</code>), and a user targets file that overrides everything (<code>--targets</code>). Cross-identification dedup: M42 and NGC1976 are one object, M43 stays its own. No network at run time.</sub></td>
+<td><b>📈 Table, CSV, charts</b><br><sub>A ranked terminal table, a CSV for your session log, and altitude charts with the horizon obstruction band and the usable window overlaid — one command, all artifacts, all greppable and scriptable.</sub></td>
+</tr>
+</table>
+</div>
+
+**[Full documentation](https://szaghi.github.io/harp/)** — installation, usage, horizon measuring, configuration
+
+</div>
+
+---
+
+## What HARP does
+
+```bash
+harp plan                                    # tonight, default site/optics from config
+harp plan 2026-08-15 --site balcony --optics newton800
+harp plan --catalogs M,NGC,IC --targets my_targets.yaml   # full catalog + your objects
+harp plan --nina tonight.csv                 # export ranked targets for N.I.N.A.
+harp mosaic IC1396 --pa 30 --nina panels.csv # per-panel coords -> N.I.N.A. sequencer
+harp list                                    # sites and optics defined in the config
+harp horizon points.yaml -o balcony.hrz      # measured vertices -> .hrz horizon file
+```
+
+```
+=== Night 2026-08-15 | Castelli Balcony 41.7380,12.8899 ===
+Astronomical darkness: 21:53 -> 04:32 local
+Moon: ~12% illuminated  |  above horizon: below horizon all night
+Setup: 800 mm + custom 23.5x15.7
+Field of view: 101' x 67'  |  horizon: balcony.hrz
+
+ # object                 score kind      const   hrs cont       window altMx   az moonSep   Moon  frame
+--------------------------------------------------------------------------------------------------------
+ 1 NGC281 Pacman             99 Nebula    Cas     6.7  6.7  21:53-04:28    75    0     127   none  1 frame
+ 2 NGC7380 Wizard            99 Nebula    Cep     5.2  5.2  21:53-03:03    73    0     124   none  1 frame
+ 3 NGC1039                   99 Open Clus Per     6.7  6.7  21:53-04:28    71   78     128   none  1 frame
+ 4 IC59/63 Ghost of Cas      99 Nebula    Cas     6.7  6.7  21:53-04:28    71  360     122   none  1 frame
+ 5 Sh2-155 Cave              98 Nebula    Cep     5.8  5.8  21:53-03:38    69    0     121   none  1 frame
+```
+
+![Altitude charts](examples/altitude_charts.example.png)
+
+The typical flow: **measure the horizon once → generate the `.hrz` → load it
+in N.I.N.A. and in HARP → plan the night → export the ranked targets (or the
+mosaic panels) straight into N.I.N.A.'s sequencer.** See
+[`examples/`](examples/) for a working config, horizon file, and sample outputs.
+
+## The name
+
+A *harp* is the celestial Lyre — the constellation **Lyra**, home of Vega and the
+Ring Nebula. And the acronym leads with the input most planners ignore: your
+horizon.
+
+## Installation
+
+```bash
+pip install harp-astro
+```
+
+The distribution is `harp-astro` (the bare PyPI name is squatted by an empty
+project; a PEP 541 request is pending) — the installed package and the CLI
+command are plain `harp`.
+
+From source:
+
+```bash
+git clone https://github.com/szaghi/harp
+cd harp
+make dev
+```
+
+## Configuration
+
+Sites (position + `.hrz` + timezone) and optical setups (focal + sensor) live in
+`sites.yaml`, searched in the current directory and `~/.config/harp/`.
+Precedence: **CLI option > config value > built-in default**. Details in the
+[usage guide](https://szaghi.github.io/harp/guide/usage).
+
+## Development
+
+```bash
+make dev     # editable install with dev extras into .venv
+make test    # pytest with coverage
+make lint    # ruff check + format check (read-only)
+make fmt     # ruff auto-fix + format
+```
+
+Releases: `./release.sh --major|--minor|--patch|X.Y.Z` (trunk model on `main`;
+tag push triggers CI → PyPI).
+
+## Authors
+
+**Stefano Zaghi** ([@szaghi](https://github.com/szaghi))
+>HPC/CFD researcher by day, balcony astrophotographer by night. Owns a Newton 200/800 f/4 and a balcony whose entire southern hemisphere is a wall. Measured the horizon with a phone compass while fending off a magnetized railing, then wrote a planner rather than accept that M8 belongs to the neighbours.
+
+**Claude** ([Anthropic](https://www.anthropic.com))
+>Large language model, second author, zero telescopes. Has never seen the night sky — or anything else — yet computed where the Moon would be at 03:46 and was right. Refactored the whole toolkit between dusk and dawn, no coffee involved; accepts payment in tokens and byte-identical CSVs.
+
+## License
+
+Multi-licensed under GPL-3.0-or-later, BSD-2-Clause, BSD-3-Clause, and MIT —
+choose the one that fits your use. See [`licensing/`](licensing/).

harp_astro-0.1.0/README.md

@@ -0,0 +1,140 @@
+<div align="center">
+
+# HARP
+
+#### *image the sky your balcony can actually see*
+
+### **H**orizon-**A**ware **R**ecommender and **P**lanner
+
+> A CLI planner for deep-sky astrophotography sessions. Given a date, a site, your
+> telescope + camera, the **real horizon of your spot** and the Moon, HARP ranks the
+> targets you can actually image tonight — usable windows, Moon impact, and mosaic
+> framing tailored to your rig.
+
+[![Version](https://img.shields.io/pypi/v/harp-astro?label=version)](https://pypi.org/project/harp-astro/)
+[![CI](https://github.com/szaghi/harp/actions/workflows/ci.yml/badge.svg)](https://github.com/szaghi/harp/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue?logo=python&logoColor=white)](https://www.python.org/)
+[![GitHub issues](https://img.shields.io/github/issues/szaghi/harp.svg)](https://github.com/szaghi/harp/issues)
+
+[![License: GPL v3](https://img.shields.io/badge/license-GPL%20v3-blue)](licensing/LICENSE.gpl3.md)
+[![License: BSD-2](https://img.shields.io/badge/license-BSD--2--Clause-blue)](licensing/LICENSE.bsd-2.md)
+[![License: BSD-3](https://img.shields.io/badge/license-BSD--3--Clause-blue)](licensing/LICENSE.bsd-3.md)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](licensing/LICENSE.mit.md)
+
+<div>
+<table>
+<tr>
+<td><b>🧱 Horizon-aware visibility</b><br><sub>Measure your site's obstructions once as an azimuth-dependent mask (<code>.hrz</code>, N.I.N.A.-compatible). A target counts as observable only when its altitude clears the ridge/wall <em>in its own direction</em> — not against an idealized flat horizon. <a href="https://szaghi.github.io/harp/guide/usage#build-a-horizon-file">Horizon guide</a></sub></td>
+<td><b>⏱️ Continuous imaging windows</b><br><sub>Per target: total usable hours during astronomical darkness plus the longest <em>continuous</em> run before it enters a blocked sector — the number you actually size exposures and mosaic panels on. <a href="https://szaghi.github.io/harp/guide/usage#reading-the-output">Reading the output</a></sub></td>
+</tr>
+<tr>
+<td><b>🏆 Desirability ranking</b><br><sub>Every target gets a 0-100 score: a weighted geometric mean of continuous window, total hours, peak altitude (inverse-airmass), Moon verdict, and how well the object fills your field of view — so one hopeless factor sinks a target instead of averaging away. <code>--sort hours</code> restores the classic order.</sub></td>
+<td><b>🌙 Moon impact model</b><br><sub>Phase and separation folded into a per-target verdict — <code>none</code>, <code>ok(NB)</code>, <code>low/med/high</code> — with narrowband auto-derived from the object type: planetaries, supernova remnants and HII regions shrug at a Moon that ruins broadband RGB.</sub></td>
+</tr>
+<tr>
+<td><b>🖼️ Mosaic framing &amp; panel coordinates</b><br><sub>Your focal length + sensor decide <code>1 frame</code> or <code>mosaic NxM</code>; <code>harp mosaic</code> then emits the actual per-panel RA/Dec centers (overlap-aware, position-angle rotated, correct at any declination) — plus single-frame crop suggestions for the monsters. <a href="https://szaghi.github.io/harp/guide/usage#mosaic-panel-coordinates">Mosaic guide</a></sub></td>
+<td><b>🎯 N.I.N.A. integration</b><br><sub>The same <code>.hrz</code> horizon drives both tools, and <code>--nina</code> exports ranked targets or mosaic panels as CSVs N.I.N.A.'s sequencer imports directly — verified against N.I.N.A.'s actual parser source. Plan in HARP, shoot in N.I.N.A., retype nothing. <a href="https://szaghi.github.io/harp/guide/usage#nina-integration">N.I.N.A. guide</a></sub></td>
+</tr>
+<tr>
+<td><b>🔭 Offline catalogues + your own</b><br><sub>Curated large emission nebulae (deliberately <em>not</em> magnitude-filtered), full Messier/NGC/IC via <a href="https://github.com/mattiaverga/PyOngc">pyongc</a> (<code>--catalogs M,NGC,IC</code>), and a user targets file that overrides everything (<code>--targets</code>). Cross-identification dedup: M42 and NGC1976 are one object, M43 stays its own. No network at run time.</sub></td>
+<td><b>📈 Table, CSV, charts</b><br><sub>A ranked terminal table, a CSV for your session log, and altitude charts with the horizon obstruction band and the usable window overlaid — one command, all artifacts, all greppable and scriptable.</sub></td>
+</tr>
+</table>
+</div>
+
+**[Full documentation](https://szaghi.github.io/harp/)** — installation, usage, horizon measuring, configuration
+
+</div>
+
+---
+
+## What HARP does
+
+```bash
+harp plan                                    # tonight, default site/optics from config
+harp plan 2026-08-15 --site balcony --optics newton800
+harp plan --catalogs M,NGC,IC --targets my_targets.yaml   # full catalog + your objects
+harp plan --nina tonight.csv                 # export ranked targets for N.I.N.A.
+harp mosaic IC1396 --pa 30 --nina panels.csv # per-panel coords -> N.I.N.A. sequencer
+harp list                                    # sites and optics defined in the config
+harp horizon points.yaml -o balcony.hrz      # measured vertices -> .hrz horizon file
+```
+
+```
+=== Night 2026-08-15 | Castelli Balcony 41.7380,12.8899 ===
+Astronomical darkness: 21:53 -> 04:32 local
+Moon: ~12% illuminated  |  above horizon: below horizon all night
+Setup: 800 mm + custom 23.5x15.7
+Field of view: 101' x 67'  |  horizon: balcony.hrz
+
+ # object                 score kind      const   hrs cont       window altMx   az moonSep   Moon  frame
+--------------------------------------------------------------------------------------------------------
+ 1 NGC281 Pacman             99 Nebula    Cas     6.7  6.7  21:53-04:28    75    0     127   none  1 frame
+ 2 NGC7380 Wizard            99 Nebula    Cep     5.2  5.2  21:53-03:03    73    0     124   none  1 frame
+ 3 NGC1039                   99 Open Clus Per     6.7  6.7  21:53-04:28    71   78     128   none  1 frame
+ 4 IC59/63 Ghost of Cas      99 Nebula    Cas     6.7  6.7  21:53-04:28    71  360     122   none  1 frame
+ 5 Sh2-155 Cave              98 Nebula    Cep     5.8  5.8  21:53-03:38    69    0     121   none  1 frame
+```
+
+![Altitude charts](examples/altitude_charts.example.png)
+
+The typical flow: **measure the horizon once → generate the `.hrz` → load it
+in N.I.N.A. and in HARP → plan the night → export the ranked targets (or the
+mosaic panels) straight into N.I.N.A.'s sequencer.** See
+[`examples/`](examples/) for a working config, horizon file, and sample outputs.
+
+## The name
+
+A *harp* is the celestial Lyre — the constellation **Lyra**, home of Vega and the
+Ring Nebula. And the acronym leads with the input most planners ignore: your
+horizon.
+
+## Installation
+
+```bash
+pip install harp-astro
+```
+
+The distribution is `harp-astro` (the bare PyPI name is squatted by an empty
+project; a PEP 541 request is pending) — the installed package and the CLI
+command are plain `harp`.
+
+From source:
+
+```bash
+git clone https://github.com/szaghi/harp
+cd harp
+make dev
+```
+
+## Configuration
+
+Sites (position + `.hrz` + timezone) and optical setups (focal + sensor) live in
+`sites.yaml`, searched in the current directory and `~/.config/harp/`.
+Precedence: **CLI option > config value > built-in default**. Details in the
+[usage guide](https://szaghi.github.io/harp/guide/usage).
+
+## Development
+
+```bash
+make dev     # editable install with dev extras into .venv
+make test    # pytest with coverage
+make lint    # ruff check + format check (read-only)
+make fmt     # ruff auto-fix + format
+```
+
+Releases: `./release.sh --major|--minor|--patch|X.Y.Z` (trunk model on `main`;
+tag push triggers CI → PyPI).
+
+## Authors
+
+**Stefano Zaghi** ([@szaghi](https://github.com/szaghi))
+>HPC/CFD researcher by day, balcony astrophotographer by night. Owns a Newton 200/800 f/4 and a balcony whose entire southern hemisphere is a wall. Measured the horizon with a phone compass while fending off a magnetized railing, then wrote a planner rather than accept that M8 belongs to the neighbours.
+
+**Claude** ([Anthropic](https://www.anthropic.com))
+>Large language model, second author, zero telescopes. Has never seen the night sky — or anything else — yet computed where the Moon would be at 03:46 and was right. Refactored the whole toolkit between dusk and dawn, no coffee involved; accepts payment in tokens and byte-identical CSVs.
+
+## License
+
+Multi-licensed under GPL-3.0-or-later, BSD-2-Clause, BSD-3-Clause, and MIT —
+choose the one that fits your use. See [`licensing/`](licensing/).

harp_astro-0.1.0/pyproject.toml

@@ -0,0 +1,114 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+# Distribution name: the bare "harp" is squatted on PyPI by an empty project
+# (PEP 541 request pending); import package and CLI command remain "harp".
+name = "harp-astro"
+version = "0.1.0"
+description = "HARP - Horizon-Aware Recommender and Planner for deep-sky astrophotography sessions"
+readme = "README.md"
+license = { text = "GPL-3.0-or-later OR BSD-2-Clause OR BSD-3-Clause OR MIT" }
+requires-python = ">=3.11"
+authors = [
+    { name = "Stefano Zaghi", email = "stefano.zaghi@gmail.com" },
+]
+keywords = ["astronomy", "astrophotography", "deep-sky", "planner", "session", "telescope"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
+    "License :: OSI Approved :: BSD License",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Astronomy",
+]
+dependencies = [
+    "typer>=0.12",
+    "rich>=13",
+    "numpy>=1.26",
+    "astropy>=6.0",
+    "astroplan>=0.9",
+    "pyongc>=1.1",
+    "matplotlib>=3.8",
+    "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "pytest-cov>=5", "build>=1.2", "ruff>=0.8"]
+
+[project.urls]
+Homepage      = "https://szaghi.github.io/harp/"
+Documentation = "https://szaghi.github.io/harp/"
+Repository    = "https://github.com/szaghi/harp"
+"Bug Tracker" = "https://github.com/szaghi/harp/issues"
+
+[project.scripts]
+harp = "harp.cli:app"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"harp" = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=harp --cov-report=term-missing"
+
+[tool.coverage.run]
+source = ["harp"]
+branch = true
+omit = ["*/harp/__main__.py"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+]
+
+# ── Ruff ──────────────────────────────────────────────────────────────────────
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # pyflakes
+    "I",      # isort
+    "N",      # pep8-naming
+    "UP",     # pyupgrade
+    "B",      # flake8-bugbear
+    "SIM",    # flake8-simplify
+    "RUF",    # ruff-specific rules
+    "S",      # flake8-bandit (security)
+    "T20",    # flake8-print
+    "PIE",    # flake8-pie
+    "PT",     # flake8-pytest-style
+    "RET",    # flake8-return
+    "C4",     # flake8-comprehensions
+]
+ignore = [
+    "E501",   # line length — handled by formatter
+    "B008",   # function call in default argument — typer's Option/Argument pattern
+    "T201",   # print — CLI tool prints to the terminal by design
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["S101", "PT011"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["harp"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"

harp_astro-0.1.0/setup.cfg

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

harp_astro-0.1.0/src/harp/__init__.py

@@ -0,0 +1,12 @@
+"""HARP - Horizon-Aware Recommender and Planner.
+
+A CLI planner that selects deep-sky targets for an astrophotography session
+from the observing date, site location, telescope+camera rig, the site's free
+horizon profile, and the Moon status.
+"""
+
+from __future__ import annotations
+
+# Version mirror — pyproject.toml is the canonical source; release.sh keeps
+# both in sync.
+__version__ = "0.1.0"

harp_astro-0.1.0/src/harp/__main__.py

@@ -0,0 +1,8 @@
+"""Allow running as ``python -m harp``."""
+
+from __future__ import annotations
+
+from harp.cli import app
+
+if __name__ == "__main__":
+    app()