Metadata-Version: 2.4
Name: NexoraDataBase
Version: 0.2.1
Summary: NexoraDB hybrid database engine with Python API
Author: NexoraDB Team
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/BlackProgrammer-prog/NexoraDB
Project-URL: Repository, https://github.com/BlackProgrammer-prog/NexoraDB
Project-URL: Issues, https://github.com/BlackProgrammer-prog/NexoraDB/issues
Keywords: database,graph-database,hybrid-database,query-engine,fastapi,nexoradb
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: C++
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <3.11,>=3.10
Description-Content-Type: text/markdown
Requires-Dist: cryptography>=42.0.0
Requires-Dist: lark>=1.1.9
Requires-Dist: fastapi>=0.111.0
Requires-Dist: uvicorn[standard]>=0.30.0
Requires-Dist: pydantic>=2.7.0
Requires-Dist: argon2-cffi>=23.1.0
Requires-Dist: python-socketio>=5.11.0
Requires-Dist: websocket-client>=1.8.0
Requires-Dist: textual>=0.86.0
Provides-Extra: api
Requires-Dist: fastapi>=0.111.0; extra == "api"
Requires-Dist: uvicorn[standard]>=0.30.0; extra == "api"
Requires-Dist: pydantic>=2.7.0; extra == "api"
Requires-Dist: argon2-cffi>=23.1.0; extra == "api"
Requires-Dist: python-socketio>=5.11.0; extra == "api"
Requires-Dist: websocket-client>=1.8.0; extra == "api"
Requires-Dist: textual>=0.86.0; extra == "api"
Provides-Extra: dashboard
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
Requires-Dist: ruff>=0.5.0; extra == "dev"
Requires-Dist: mypy>=1.10.0; extra == "dev"
Requires-Dist: build>=1.2.0; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"
Requires-Dist: Faker>=26.0.0; extra == "dev"
Provides-Extra: all
Requires-Dist: fastapi>=0.111.0; extra == "all"
Requires-Dist: uvicorn[standard]>=0.30.0; extra == "all"
Requires-Dist: pydantic>=2.7.0; extra == "all"
Requires-Dist: argon2-cffi>=23.1.0; extra == "all"
Requires-Dist: python-socketio>=5.11.0; extra == "all"
Requires-Dist: websocket-client>=1.8.0; extra == "all"
Requires-Dist: textual>=0.86.0; extra == "all"

# NexoraDB

NexoraDB is a hybrid document and graph database engine with a Python API,
FastAPI administration service, NexoraQL parser, CLI, and bundled web dashboard.

For installation, usage, architecture, and development documentation, see the
[project repository](https://github.com/BlackProgrammer-prog/NexoraDB).

NexoraDB is licensed under the Apache License 2.0.

## Platform support

The `0.1.x` binary wheels bundle the native C++ database engine and currently
support **Ubuntu Linux on x86_64 with CPython 3.10 only**. Windows, macOS,
other Linux distributions, ARM processors, PyPy, and other Python versions
are not supported by this initial release.

## Install from PyPI

Create a virtual environment and install the package:

```bash
python3.10 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install NexoraDataBase
```

The package name on PyPI is `NexoraDataBase`; the name used in Python code is
`nexoradb`. Confirm that the native engine loads correctly:

```bash
python -c "import nexoradb; print(nexoradb.__version__)"
```

## Basic usage

```python
import nexoradb

db = nexoradb.DocEngine("./nexoradb-data")
db.create_collection("users")
db.insert_one("users", '{"_id":"u1","name":"Alice","age":28}')

user = db.find_by_id("users", "u1")
print(user.data)
```

Upgrade to the latest published version with:

```bash
pip install --upgrade NexoraDataBase
```
