Metadata-Version: 2.4
Name: lunardump
Version: 0.1.0
Summary: A lightweight, zero-trust CLI tool built in Python to automate, encrypt, and stream database backups directly to multi-cloud storage.
Project-URL: Homepage, https://github.com/indhifarhandika/LunarDump
Project-URL: Repository, https://github.com/indhifarhandika/LunarDump
Project-URL: Bug Tracker, https://github.com/indhifarhandika/LunarDump/issues
Project-URL: Funding, https://ko-fi.com/indhifarhandika
Author: Indhi Farhandika R
License: MIT
License-File: LICENSE
Keywords: backup,cli,database,encryption,gcs,mongodb,mysql,postgres,s3
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
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
Classifier: Topic :: System :: Archiving :: Backup
Requires-Python: >=3.10
Requires-Dist: boto3>=1.28.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer[all]>=0.9.0
Provides-Extra: dev
Requires-Dist: build>=1.0.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: twine>=4.0.0; extra == 'dev'
Provides-Extra: gcs
Requires-Dist: google-cloud-storage>=2.10.0; extra == 'gcs'
Description-Content-Type: text/markdown

# 🌖 LunarDump

> **Secure, Automated, and Zero-Trust Database Backup Engine**

**LunarDump** is a modern, developer-friendly Command-Line Interface (CLI) tool designed to streamline and secure your database backup workflows. Built with Python, it automates the entire lifecycle of database disaster recovery—from streaming dumps without memory overhead, applying military-grade AES-256 encryption, to syncing backups directly across cloud providers.

---

### ✨ Key Features

* 🗄️ **Multi-Engine Support:** Seamlessly handles PostgreSQL, MySQL, MariaDB, and MongoDB out-of-the-box.
* 🔐 **Zero-Trust Encryption:** End-to-end AES-256-GCM encryption applied locally before any data leaves your server.
* ⚡ **Memory-Efficient Streaming:** Streams database dumps and compresses them on-the-fly, preventing memory spikes even on multi-gigabyte databases.
* ☁️ **Multi-Cloud Syncing:** Direct integration with AWS S3, Google Cloud Storage, Cloudflare R2, and S3-compatible providers (like MinIO).
* 🧹 **Automated Retention Cleaner:** Automatically purges outdated backup archives based on your custom retention policy.
* 🔔 **Instant Telemetry:** Real-time progress indicators via Rich Terminal UI and automatic status alerts to Telegram, Slack, or Discord webhooks.

---

### 🚀 Why LunarDump?

Traditional shell script backups are fragile, hard to maintain, and often store unencrypted data on local disks. **LunarDump** solves these pain points by offering an enterprise-grade, configuration-driven pipeline in a single, easy-to-use CLI.

```bash
# Example: Run full backup pipeline via configuration file
lunardump run --config config.yaml

# Example: Verify connectivity to database, cloud storage, and webhooks
lunardump config check
```

### ☕ Support the Project

If you find **LunarDump** useful, please consider supporting its development:

[![Ko-Fi](https://img.shields.io/badge/Ko--Fi-FF5252?style=for-the-badge&logo=kofi&logoColor=white)](https://ko-fi.com/indhifarhandika)