sqlite-database

SQLite Database

NOTICE!: This project is renamed to LuminaDB, please use LuminaDB instead of this~

SQLite Database is a lightweight, developer-friendly wrapper for SQLite—designed to feel as intuitive as Laravel's Eloquent ORM, but in Python.

[!WARNING] ⚠️ This library is still pre-1.0, which means it's not optimized for high performance or low memory usage (yet). Use with care. If you run into serious issues, feel free to open an issue—we’re listening.

🚀 Usage & Demo

Curious how it works in action? Check out the live example here: sqlite-database demo

📦 Installation

The library is available via PyPI:

pip install sqlite-database

Prefer to install directly from GitHub? You can still do this the old-school way:

pip install https://github.com/RimuEirnarn/sqlite_database/archive/refs/tags/<latest-version>.zip

✨ Features

A quick feature overview is available in Features.md

Or check out the full short docs at: 📚 sqlite-database.rtfd.io

📖 Origin Story & Acknowledgements

Wondering why this exists? Read the History.md to learn what led to the birth of this project.

Pre-contributor: just ChatGPT—so blame the AI if anything’s weird.

🤝 Contributing

Found a bug? Got an idea? Want to improve something?

• Open an issue for anything noteworthy.
• PRs are welcome—as long as they align with the project's vision and design goals.

🛠️ Development Setup

Thanks for considering contributing to sqlite_database! Here's what you'll need:

• Testing: pytest
• Linting: pylint
• Docs: sphinx

Dependencies are split between:

• dev-requirements.txt (core development)
• docs-requirements.txt (documentation)

To get started:

git clone https://github.com/RimuEirnarn/sqlite_database
cd sqlite_database

python -m venv .venv
source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows

pip install -r ./dev-requirements.txt
./bin/check.sh

The check.sh script will run:

pylint --rcfile ./dev-config/pylint.toml sqlite_database
pytest --config-file ./dev-config/pytest.ini

Simple and clean.

📄 License

This project is licensed under the BSD 3-Clause "New" or "Revised" License.

Read the full license here: LICENSE