A framework for writing Airbyte Connectors.
Connector Development Kit (Python)
The Airbyte Python CDK is a framework for rapidly developing production-grade Airbyte connectors. The CDK currently offers helpers specific for creating Airbyte source connectors for:
- HTTP APIs (REST APIs, GraphQL, etc..)
- Singer Taps
- Generic Python sources (anything not covered by the above)
The CDK provides an improved developer experience by providing basic implementation structure and abstracting away low-level glue boilerplate.
This document is a general introduction to the CDK. Readers should have basic familiarity with the Airbyte Specification before proceeding.
Generate an empty connector using the code generator. First clone the Airbyte repository then from the repository root run
cd airbyte-integrations/connector-templates/generator ./generate.sh
then follow the interactive prompt. Next, find all
TODOs in the generated project directory -- they're accompanied by lots of comments explaining what you'll need to do in order to implement your connector. Upon completing all TODOs properly, you should have a functioning connector.
Additionally, you can follow this tutorial for a complete walkthrough of creating an HTTP connector using the Airbyte CDK.
Concepts & Documentation
See the concepts docs for a tour through what the API offers.
Simple Python connectors using the barebones
First time setup
python points to python >=3.9.
Setup a virtual env:
python -m venv .venv source .venv/bin/activate pip install -e ".[dev]" # [dev] installs development-only dependencies
- Iterate on the code locally
- Run tests via
pytest -s unit_tests
- Perform static type checks using
MyPyconfiguration is in
type_check_and_test.shscript bundles both type checking and testing in one convenient command. Feel free to use it!
All tests are located in the
unit_tests directory. Run
pytest --cov=airbyte_cdk unit_tests/ to run them. This also presents a test coverage report.
Publishing a new version to PyPi
- Bump the package version in
- Open a PR
- An Airbyte member must comment
/publish-cdk dry-run=trueto publish the package to test.pypi.org or
/publish-cdk dry-run=falseto publish it to the real index of pypi.org.
- Full OAuth 2.0 support (including refresh token issuing flow via UI or CLI)
- Airbyte Java HTTP CDK
- CDK for Async HTTP endpoints (request-poll-wait style endpoints)
- CDK for other protocols
- Don't see a feature you need? Create an issue and let us know how we can help!
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for airbyte_cdk_PHLAIR-0.2.3-py3-none-any.whl