Metadata-Version: 2.4
Name: imo-vmdb
Version: 1.5.1
Summary: Imports VMDB CSV files from IMO into a SQL database.
License: MIT
License-File: LICENSE.txt
Keywords: IMO,VMDB,SQL
Author: Janko Richter
Author-email: janko@richtej.de
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Provides-Extra: docs
Provides-Extra: mysql
Provides-Extra: pgsql
Requires-Dist: Sphinx (>=8.0,<9.0) ; extra == "docs"
Requires-Dist: astropy (>=6.0)
Requires-Dist: flask (>=3.0,<4.0)
Requires-Dist: psycopg2 (>=2.9,<3.0) ; extra == "pgsql"
Requires-Dist: pymysql (>=1.0,<2.0) ; extra == "mysql"
Requires-Dist: sphinx-rtd-theme (>=3.0,<4.0) ; extra == "docs"
Project-URL: Bug Tracker, https://github.com/jankorichter/imo-vmdb/issues
Project-URL: Documentation, https://imo-vmdb.readthedocs.io/en/latest/
Project-URL: Homepage, https://github.com/jankorichter/imo-vmdb
Project-URL: Repository, https://github.com/jankorichter/imo-vmdb
Description-Content-Type: text/markdown

# imo-vmdb

*imo-vmdb* imports data from the
[Visual Meteor Database (VMDB)](https://www.imo.net/members/imo_vmdb/)
of the [International Meteor Organization (IMO)](https://www.imo.net/)
into a relational SQL database.

The data is enriched with computed properties (radiant positions, sun/moon position and
illumination) and validated for plausibility.
No analysis is performed by the tool itself — the database is the output.

For full documentation see <https://imo-vmdb.readthedocs.io/en/latest/>.

---

## Quick Start (Docker)

No Python required. Pull and run the web UI:

```bash
docker run --rm \
    -p 8000:8000 \
    -v ./data:/data \
    -e IMO_VMDB_DATABASE_DATABASE=/data/vmdb.db \
    ghcr.io/jankorichter/imo-vmdb
```

Open <http://localhost:8000>.

---

## Developer Setup

**Prerequisites:** Python 3.10+, [Poetry](https://python-poetry.org/docs/#installation)

```bash
git clone https://github.com/jankorichter/imo-vmdb.git
cd imo-vmdb
poetry install
poetry run python -m imo_vmdb
```

**With documentation extras** (required to build Sphinx docs):

```bash
poetry install --extras docs
```

**Run the web UI locally:**

```bash
poetry run python -m imo_vmdb web_server -c config.ini
```

**Run the test suite:**

```bash
poetry run pytest
```

No server needs to be started beforehand. The tests use Flask's built-in test
client, which calls the application directly in-process — no network, no port.
A temporary SQLite database is created automatically for each test run.

**Build Docker image locally:**

```bash
docker compose up --build
```

