paradoxmachines-dlt-sources 0.1.0a7

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, invoice_line_items

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.