Metadata-Version: 2.4
Name: nc-db
Version: 0.1.5
Summary: Simple document-oriented library for PostgresSql and Pydantic. High performance w/ support for large jsonb objects and fast querying using  native b-tree indexes.
License: Proprietary
Author: Dave Beck
Author-email: dave@pixelthin.com
Requires-Python: >=3.14,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: psycopg[binary,pool] (>=3.3.1,<4.0.0)
Requires-Dist: pydantic (>=2.11.7,<3.0.0)
Requires-Dist: pydantic-settings (>=2.12.0,<3.0.0)
Requires-Dist: pytest-asyncio (>=1.3.0,<2.0.0)
Description-Content-Type: text/markdown

# nc-db
The nc-db package provides an easy way to use the document/object oriented capabilites of Postgres while maintaining good performance with large object by using B-tree indexes instead of GINs.

Serialization and deserialization is handled for you with pydantic.

## Contents

```
nc_db/            # Python source: Db, handlers, queries, metadata classes, etc.
tests/           # Pytest suite and fixtures (isolated schemas)
k8s/              # K8s StatefulSet, init SQL, and ops scripts
pyproject.toml    # Poetry + pytest configuration
.github/          # Issue and PR templates
README.md         # This file (schema diagram below)
```

## Run Tests
`cd nc_db`
` poetry run pytest`

## Publish
```
python -m build
python -m twine upload dist/*
```
