flowlit-integration

Reusable flowlit executors for a handful of common external systems -- Harvest, Google Sheets, Gmail, Slack -- plus a generic "any data → spreadsheet" executor, and the shared CredentialsProvider abstraction they all resolve secrets through.

Where this sits

flowlit                 the execution engine: DAG plans, the Executor
                         port, the EventBus. Knows nothing about any
                         specific external system.

flowlit-integration      (this package) knows how to talk to a handful
                         of common external systems. Knows nothing about
                         any particular business's use of them.

<client application>    e.g. ccq-automation -- business-specific DAGs,
                         business rules, transport. Imports the
                         executors it needs from here and registers them
                         with flowlit itself.

Installing

Pick only the extras you need -- each pulls in just the third-party SDK(s) that one executor requires:

pip install "flowlit-integration[harvest]"
pip install "flowlit-integration[harvest,gmail,spreadsheet]"
pip install "flowlit-integration[all]"       # everything

Using an executor

Registration is always the client's own explicit job -- importing this package never registers anything with flowlit, and never performs I/O:

from flowlit import register_executor
from flowlit_integration.executors.harvest_executor import HarvestExecutor

register_executor("harvest", HarvestExecutor())

Each executor resolves its own credentials lazily, the first time a step of that type actually runs, via flowlit_integration.credentials's default_credentials_provider() chain (explicit value > environment variable > credentials file > a documented, not-yet-implemented secret- manager extension point) -- see docs/architecture.md and each executor's own module docstring for its specific env-var/spec-field names.

Status

Alpha (pre-1.0: minor version bumps may include breaking changes). Published on PyPI. See CHANGELOG.md for what changed in each release.