Skip to main content

A framework for writing Airbyte Connectors.

Project description

Airbyte Python CDK and Low-Code CDK

Airbyte Python CDK is a framework for building Airbyte API Source Connectors. It provides a set of classes and helpers that make it easy to build a connector against an HTTP API (REST, GraphQL, etc), or a generic Python source connector.

Building Connectors with the CDK

If you're looking to build a connector, we highly recommend that you first start with the Connector Builder. It should be enough for 90% connectors out there. For more flexible and complex connectors, use the low-code CDK and SourceDeclarativeManifest.

For more information on building connectors, please see the Connector Development guide on docs.airbyte.com.

Python CDK Overview

Airbyte CDK code is within airbyte_cdk directory. Here's a high level overview of what's inside:

  • airbyte_cdk/connector_builder. Internal wrapper that helps the Connector Builder platform run a declarative manifest (low-code connector). You should not use this code directly. If you need to run a SourceDeclarativeManifest, take a look at source-declarative-manifest connector implementation instead.
  • airbyte_cdk/cli/source_declarative_manifest. This module defines the source-declarative-manifest (aka "SDM") connector execution logic and associated CLI.
  • airbyte_cdk/destinations. Basic Destination connector support! If you're building a Destination connector in Python, try that. Some of our vector DB destinations like destination-pinecone are using that code.
  • airbyte_cdk/models expose airbyte_protocol.models as a part of airbyte_cdk package.
  • airbyte_cdk/sources/concurrent_source is the Concurrent CDK implementation. It supports reading data from streams concurrently per slice / partition, useful for connectors with high throughput and high number of records.
  • airbyte_cdk/sources/declarative is the low-code CDK. It works on top of Airbyte Python CDK, but provides a declarative manifest language to define streams, operations, etc. This makes it easier to build connectors without writing Python code.
  • airbyte_cdk/sources/file_based is the CDK for file-based sources. Examples include S3, Azure, GCS, etc.

Contributing

For instructions on how to contribute, please see our Contributing Guide.

Release Management

Please see the Release Management guide for information on how to perform releases and pre-releases.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

airbyte_cdk-6.33.2.dev0.tar.gz (409.0 kB view details)

Uploaded Source

Built Distribution

airbyte_cdk-6.33.2.dev0-py3-none-any.whl (584.8 kB view details)

Uploaded Python 3

File details

Details for the file airbyte_cdk-6.33.2.dev0.tar.gz.

File metadata

  • Download URL: airbyte_cdk-6.33.2.dev0.tar.gz
  • Upload date:
  • Size: 409.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for airbyte_cdk-6.33.2.dev0.tar.gz
Algorithm Hash digest
SHA256 b53116393d980f8e8d8123477748b3a2722b2d40ae74bc5752d2c83bb0d435b3
MD5 44ce68ce1d9fcd6900d6f36eb9e84d39
BLAKE2b-256 c49541b3b1a8b3bb6764278960e4e3b80f1446cf2bd352232ebbdca4eb7ebfea

See more details on using hashes here.

Provenance

The following attestation bundles were made for airbyte_cdk-6.33.2.dev0.tar.gz:

Publisher: pypi_publish.yml on airbytehq/airbyte-python-cdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file airbyte_cdk-6.33.2.dev0-py3-none-any.whl.

File metadata

File hashes

Hashes for airbyte_cdk-6.33.2.dev0-py3-none-any.whl
Algorithm Hash digest
SHA256 429dfcc80021d41265329bdfee242aaa199aab8615e4ac6e0e830c2f6296b7e1
MD5 365ff102eef08c51390e7842af4c2eb0
BLAKE2b-256 1ed970f882cc7ed89b2e6b305f2e7f223c31683d7316fadc55d6c4890f9a57e7

See more details on using hashes here.

Provenance

The following attestation bundles were made for airbyte_cdk-6.33.2.dev0-py3-none-any.whl:

Publisher: pypi_publish.yml on airbytehq/airbyte-python-cdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page