Metadata-Version: 2.4
Name: milvusql
Version: 0.1.1
Summary: PEP 249 DBAPI (sync + async) for Milvus, backed by sqlglot-milvus
Keywords: milvus,dbapi,pep249,vector-search,asyncio
Author: Neko1313
Author-email: Neko1313 <nikita.ribalchencko@yandex.ru>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Framework :: AsyncIO
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Dist: pymilvus>=2.6,<3
Requires-Dist: sqlglot-milvus>=0.1.0,<0.2
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/Callix-Tools/milvusql
Project-URL: Repository, https://github.com/Callix-Tools/milvusql
Project-URL: Issues, https://github.com/Callix-Tools/milvusql/issues
Description-Content-Type: text/markdown

# milvusql

A [PEP 249](https://peps.python.org/pep-0249/) DBAPI for [Milvus](https://milvus.io) — sync and
async — parsing/generating MilvusQL via [`sqlglot-milvus`](https://github.com/Callix-Tools/sqlglot-milvus)
and executing the resulting AST against `pymilvus`.

```bash
pip install milvusql
```

```python
import milvusql

conn = milvusql.connect(uri="./items.db")  # Milvus Lite, or a real server's URI
cur = conn.cursor()
cur.execute("SELECT id FROM items WHERE category = :cat LIMIT 10", {"cat": "book"})
print(cur.fetchall())
```

This is the core of a `uv` workspace: [`milvusql-sqlalchemy`](packages/milvusql-sqlalchemy) and
[`milvusql-django`](packages/milvusql-django) depend on this package as their DBAPI layer, each
installed separately.

**Full docs: https://Callix-Tools.github.io/milvusql-docs/**

Status: early development, not yet published.

## License

MIT
