Metadata-Version: 2.4
Name: paradoxmachines-dlt-sources
Version: 0.1.0a2
Summary: Open-source dlt verified sources maintained by Paradox Machines
Project-URL: Homepage, https://github.com/paradox-machines/dlt-sources
Project-URL: Repository, https://github.com/paradox-machines/dlt-sources
Project-URL: Issues, https://github.com/paradox-machines/dlt-sources/issues
Author-email: Paradox Machines <opensource@paradoxmachines.com>
License: Apache-2.0
License-File: LICENSE
Keywords: data-pipelines,dlt,etl,verified-sources
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: cryptography>=41
Requires-Dist: dlt<2,>=1.0
Requires-Dist: pyjwt>=2.8
Requires-Dist: requests>=2.31
Provides-Extra: dev
Requires-Dist: duckdb>=1.0; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: responses<1.0,>=0.25; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Requires-Dist: types-pyjwt; extra == 'dev'
Requires-Dist: types-requests; extra == 'dev'
Description-Content-Type: text/markdown

# paradoxmachines-dlt-sources

Open-source [dlt](https://dlthub.com) verified sources maintained by
[Paradox Machines](https://paradoxmachines.com).

This repo follows the structural conventions of
[dlt-hub/verified-sources](https://github.com/dlt-hub/verified-sources)
— each source is a self-contained folder under `paradox_dlt_sources/`
with its own README, helpers, settings, and requirements.

## Install

```bash
pip install paradoxmachines-dlt-sources
```

## Sources

| Source | Status | Resources |
|---|---|---|
| [agree_com](paradox_dlt_sources/agree_com/README.md) | beta | agreements, contacts, invoices, schedules |
| [attio](paradox_dlt_sources/attio/README.md) | beta | companies, people, deals, lists, notes |
| [github](paradox_dlt_sources/github/README.md) | beta | organizations, users, repositories, pull_requests, commits, pull_request_commits, pull_request_stats |
| [hubspot](paradox_dlt_sources/hubspot/README.md) | beta | companies, contacts, deals, engagements, deal_pipelines |
| [notion](paradox_dlt_sources/notion/README.md) | beta | users, databases, pages, blocks, comments |
| [pipedrive](paradox_dlt_sources/pipedrive/README.md) | beta | persons, deals, leads, activities, organizations, stages, users_recents |
| [quickbooks](paradox_dlt_sources/quickbooks/README.md) | beta | 24 entities (invoices, customers, accounts, transactions, …) |
| [stripe](paradox_dlt_sources/stripe/README.md) | beta | charges, customers, invoices, refunds |

More sources coming as we port them from our internal pipeline. See
[CONTRIBUTING.md](CONTRIBUTING.md) for the porting checklist.

## Usage

```python
import dlt
from paradox_dlt_sources.attio import attio_source

pipeline = dlt.pipeline(
    pipeline_name="attio_demo",
    destination="duckdb",
    dataset_name="attio_data",
)
pipeline.run(attio_source())  # api_key resolved from .dlt/secrets.toml
```

Configure `.dlt/secrets.toml`:

```toml
[sources.attio]
api_key = "your_attio_api_key"
```

## License

Apache 2.0 — see [LICENSE](LICENSE).
