paradoxmachines-dlt-sources 0.1.0a3

Open-source dlt verified sources maintained by Paradox Machines

paradoxmachines-dlt-sources

Open-source dlt verified sources maintained by Paradox Machines.

This repo follows the structural conventions of dlt-hub/verified-sources — each source is a self-contained folder under paradox_dlt_sources/ with its own README, helpers, settings, and requirements.

Install

Two supported flows:

A. As a PyPI dependency (recommended for production)

pip install paradoxmachines-dlt-sources

Pinnable, reproducible, no scaffolding.

B. Via dlt init (scaffold a starter project)

Each source is also mirrored at sources/<name>/ so dlt's CLI can scaffold a standalone project the same way it does for dlt-hub/verified-sources:

dlt init attio duckdb --location https://github.com/Paradox-Machines/dlt-sources

This drops attio/, attio_pipeline.py, requirements.txt, and .dlt/{secrets,config}.toml into your cwd, with secret keys pre-populated from the source signature. Substitute any of agree_com, attio, github, hubspot, notion, pipedrive, quickbooks, stripe for the source name, and any dlt destination for duckdb. Run dlt init --list-sources --location <url> to enumerate.

Maintainers: the sources/ tree is generated. After editing any paradox_dlt_sources/<name>/, run python scripts/sync_dlt_init_layout.py to mirror the changes. CI runs --check to fail PRs that drift.

Sources

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

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

Usage (PyPI flow)

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:

[sources.attio]
api_key = "your_attio_api_key"

For the dlt init flow, the scaffolded <source>_pipeline.py is the equivalent demo — import paths are bare (from attio import attio_source) because the source folder lands at your project root.

License

Apache 2.0 — see LICENSE.