coffy 0.2.0

Lightweight local NoSQL, SQL, and Graph embedded database engine

☕ Coffy: Local-First Embedded Database Engine for Python

Coffy is a lightweight, local-first embedded database engine supporting NoSQL, SQL, and Graph models — all in pure Python. Designed for fast prototyping, scripting, and local apps.

---

📦 Installation

pip install coffy

---

🚀 Features

• ✅ Local persistence (JSON, SQLite)
• ✅ In-memory mode (:memory: or None)
• ✅ No server needed
• ✅ Logical and comparison operators
• ✅ Unified query interface

---

🧠 Engines

Engine	Description	Docs
coffy.graph	Local graph database (NetworkX-based)	Graph Docs
coffy.nosql	Document store with chainable queries	NoSQL Docs
coffy.sql	Thin SQLite wrapper	SQL Docs

---

What sets Coffy apart?

Only embedded Python graph DB with:

• ✅ Declarative traversal syntax (match_node_path(...))
• ✅ Label/type filtering, limit/offset, result projection
• ✅ Unified API for both nodes and relationships

Only pure-Python embedded document store with:

• ✅ Auto-indexing on all top-level fields
• ✅ Chainable logical queries (.where(...).eq(...).or_().in_())
• ✅ Merge/lookups across collections (like mini $lookup)
• ✅ JSON persistence or in-memory fallback

---

🔗 Links

• PyPI: coffy
• Source: GitHub
• Graph Documentation: GRAPH_DOCS.md
• SQL Documentation: SQL_DOCS.md
• NoSQL Documentation: NOSQL_DOCS.md

---

⚖️ License

MIT License © 2025 Neel Sarathy