Metadata-Version: 2.4
Name: drc-vantage
Version: 1.0.11
Summary: Python SDK for the DRC Vantage data platform
Project-URL: Homepage, https://github.com/nathan294/vantage
Project-URL: Repository, https://github.com/nathan294/vantage
Project-URL: Issues, https://github.com/nathan294/vantage/issues
Author: DRC
License-Expression: LicenseRef-Proprietary
Keywords: analytics,data,governance,postgresql,sdk,vantage
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.13
Requires-Dist: boto3>=1.43.46
Requires-Dist: langchain-core>=0.3.0
Requires-Dist: langchain-openai>=0.3.0
Requires-Dist: loguru>=0.7.3
Requires-Dist: numpy>=2.5.1
Requires-Dist: pillow>=11.0.0
Requires-Dist: psycopg[binary]>=3.3.4
Requires-Dist: pydantic>=2.13.4
Requires-Dist: resend>=2.32.2
Requires-Dist: scikit-learn>=1.9.0
Requires-Dist: sqlalchemy>=2.0.51
Description-Content-Type: text/markdown

# DRC Vantage SDK

Python SDK for the [Vantage](https://github.com/nathan294/vantage) data platform: dataset sync, validation, analysis, KPI computation, and smart cockpit pipelines.

## Requirements

- Python 3.13+

## Installation

### PyPI (production)

```bash
pip install drc-vantage
```

Avec uv :

```bash
uv add drc-vantage
```

### TestPyPI (pré-release)

Les dépendances transitives ne sont pas toutes sur TestPyPI — ajoute PyPI comme index par défaut :

```bash
uv pip install --index testpypi --default-index https://pypi.org/simple/ drc-vantage==1.0.10
```

Pour épingler le SDK sur TestPyPI dans un projet uv, ajoute dans `pyproject.toml` :

```toml
[tool.uv.sources]
drc-vantage = { index = "testpypi" }
```

Puis `uv add drc-vantage`. L'index `testpypi` est déclaré dans le [`pyproject.toml` à la racine du repo](../../pyproject.toml) ; copie le bloc `[[tool.uv.index]]` si besoin.

## Publication

Voir [PUBLISHING.md](PUBLISHING.md) pour publier sur TestPyPI puis PyPI avec `uv publish --index testpypi` ou `uv publish --index pypi`.

## Quick start

```python
from vantage import Client, Dataset

client = Client(
    postgres_host="localhost",
    postgres_user="postgres",
    postgres_password="secret",
    postgres_database="vantage",
)

dataset = Dataset(
    client=client,
    location={"schema": "marts", "table": "customers"},
    dataset_name="Customers",
    dataset_type="TABLE",
)
dataset.sync()
```

## License

Proprietary. All rights reserved.
