Metadata-Version: 2.4
Name: databridge-ai-examples
Version: 0.43.0
Summary: DataBridge AI Examples & Tests - 29 use-case tutorials and test suites for DataBridge AI
Project-URL: Homepage, https://github.com/datanexum/DATABRIDGE_AI
Project-URL: Documentation, https://github.com/datanexum/DATABRIDGE_AI/wiki/Pro-Features
Project-URL: Repository, https://github.com/datanexum/DATABRIDGE_AI
Project-URL: Issues, https://github.com/datanexum/DATABRIDGE_AI/issues
Author-email: DataBridge AI Team <support@databridge.ai>
License: Proprietary
License-File: LICENSE
Keywords: data,data-quality,examples,financial,hierarchy,mcp,reconciliation,tests,tutorials
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Database
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Requires-Dist: databridge-ai>=0.40.0
Requires-Dist: pytest-asyncio>=0.21.0
Requires-Dist: pytest-cov>=4.0.0
Requires-Dist: pytest>=7.0.0
Provides-Extra: pro
Requires-Dist: databridge-ai-pro>=0.40.0; extra == 'pro'
Description-Content-Type: text/markdown

# DataBridge AI Examples & Tests

*Use-case tutorials and test suites for DataBridge AI. Part of the **Pro Examples** sub-tier.*

---

## Installation

```bash
# CE tests + beginner use cases (requires databridge-ai base)
pip install databridge-ai-examples

# Include Pro tests + advanced use cases (requires Pro license)
pip install databridge-ai-examples[pro]
```

## Requirements

- Python 3.10+
- `databridge-ai >= 0.40.0` (Community Edition base)
- A valid Pro license key for full access (`DATABRIDGE_LICENSE_KEY` env var)
- Optional: `databridge-ai-pro >= 0.40.0` for Pro test suite

### License Key Configuration

```bash
# Set your license key
export DATABRIDGE_LICENSE_KEY="DB-PRO-YOURKEY-20260101-signature"
```

**License Key Format:** `DB-{TIER}-{CUSTOMER_ID}-{EXPIRY}-{SIGNATURE}`

Contact sales@databridge.ai for pricing and license keys.

## What's Included

### Use-Case Tutorials (19 total)

| Category | Cases | Description |
|----------|-------|-------------|
| **Beginner** | 01-04 | Pizza shop sales, friend matching, school hierarchies, sports comparison |
| **Financial** | 05-11 | SEC EDGAR analysis, Apple/Microsoft financials, balance sheets, full pipelines |
| **Faux Objects** | 12-19 | Domain persona tutorials (financial, oil & gas, manufacturing, SaaS, etc.) |

### Test Suites (47 files)

| Suite | Module | Tests |
|-------|--------|-------|
| `tests/ce/` | Community Edition | Data loading, hashing, fuzzy matching, dbt, data quality, diff utilities |
| `tests/pro/` | Pro Edition | Hierarchy, cortex, catalog, versioning, wright, lineage, observability |
| `tests/conftest.py` | Shared fixtures | Common fixtures and sample data helpers |

## Running Tests

```bash
# Run CE tests only
pytest src/tests/ce/

# Run Pro tests (requires databridge-ai-pro)
pytest src/tests/pro/

# Run all tests with coverage
pytest --cov=databridge_ai_examples src/tests/
```

## Editions

This package is part of the DataBridge AI product family:

| Package | Distribution | License |
|---------|-------------|---------|
| `databridge-ai` | PyPI (public) | MIT (Free) |
| `databridge-ai-pro` | GitHub Packages | Proprietary (License Key) |
| `databridge-ai-examples` | GitHub Packages | Proprietary (Requires Pro Key) |

## License

Proprietary - requires a valid DataBridge AI Pro or Enterprise license key. See [LICENSE](LICENSE) for full terms.

Copyright (c) 2024-2026 DataBridge AI. All Rights Reserved.

## Support

- Sales: sales@databridge.ai
- Support: support@databridge.ai
- Documentation: [GitHub Wiki](https://github.com/datanexum/DATABRIDGE_AI/wiki)
