Metadata-Version: 2.4
Name: astrostash
Version: 0.1.0
Summary: An astronomy/astrophysics database building and syncing library
Author-email: Nicholas Kuechel <njkuechel@protonmail.com>
License-Expression: BSD-3-Clause
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: astroquery>=0.4.10
Requires-Dist: pandas>=2.3.0
Requires-Dist: SQLAlchemy>=2.0.43
Provides-Extra: dev
Requires-Dist: build>=0.10.0; extra == "dev"
Requires-Dist: pytest>=8.4.1; extra == "dev"
Requires-Dist: pytest-cov>=6.2.1; extra == "dev"
Requires-Dist: flake8>=7.3.0; extra == "dev"
Dynamic: license-file

![GitHub License](https://img.shields.io/github/license/nkphysics/astrostash)
![GitHub branch check runs](https://img.shields.io/github/check-runs/nkphysics/astrostash/master)


# astrostash

**An astronomy and astrophysics database building/syncing tool**

Astrostash is designed to allow users to "stash" query results from astronomy/astrophysics data sources (e.g., HEASARC) into a local SQLite3 database. This ensures data retention and reduces reliance on external services for recurring queries.

---

## 🌟 Features

- **Local data storage**: Retain copies of query results in a SQLite3 database so you can keep your own copy of the data you use and care about having access to.
- **Efficient querying**: Prioritizes querying from your local database before pulling data externally to limit external requests.

---
## Requirements

python >= 3.10

### 📦 Dependencies

- sqlite3
- `astroquery >= 0.4.10`
- `pandas >= 2.3.0`
- `SQLAlchemy >= 2.0.43`

---

## 🚧 Current State

**Version**: `v0.1.0`  
**Status**: Alpha

**Supported Archives**: 

- HEASARC 

---

## 📥 Installation

1. Clone the repo

2. Run `python -m pip install .`

**Standard and Wheel dists + PyPI COMING SOON**
