Skip to content

Commit

Permalink
Add documentation for packages - 2024-12-22
Browse files Browse the repository at this point in the history
  • Loading branch information
eladkal committed Dec 22, 2024
1 parent 84ffd91 commit 86f8d12
Show file tree
Hide file tree
Showing 10,828 changed files with 6,446,985 additions and 1,817 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: 809a0e20eb9f994d9d8db73b0823ec9f
tags: 645f666f9bcd5a90fca523b33c5a78b7

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
:py:mod:`airflow.providers.airbyte.hooks.airbyte`
=================================================

.. py:module:: airflow.providers.airbyte.hooks.airbyte
Module Contents
---------------

Classes
~~~~~~~

.. autoapisummary::

airflow.providers.airbyte.hooks.airbyte.AirbyteHook




Attributes
~~~~~~~~~~

.. autoapisummary::

airflow.providers.airbyte.hooks.airbyte.T


.. py:data:: T
.. py:class:: AirbyteHook(airbyte_conn_id = 'airbyte_default', api_version = 'v1')
Bases: :py:obj:`airflow.hooks.base.BaseHook`

Hook for Airbyte API.

:param airbyte_conn_id: Optional. The name of the Airflow connection to get
connection information for Airbyte. Defaults to "airbyte_default".
:param api_version: Optional. Airbyte API version. Defaults to "v1".

.. py:attribute:: conn_name_attr
:value: 'airbyte_conn_id'



.. py:attribute:: default_conn_name
:value: 'airbyte_default'



.. py:attribute:: conn_type
:value: 'airbyte'



.. py:attribute:: hook_name
:value: 'Airbyte'



.. py:method:: get_conn_params(conn_id)
.. py:method:: create_api_session()
Create Airbyte API session.


.. py:method:: get_ui_field_behaviour()
:classmethod:

Return custom field behaviour.


.. py:method:: get_job_details(job_id)
Use Http async call to retrieve metadata for a specific job of an Airbyte Sync.

:param job_id: The ID of an Airbyte Sync Job.


.. py:method:: get_job_status(job_id)
Retrieve the status for a specific job of an Airbyte Sync.

:param job_id: The ID of an Airbyte Sync Job.


.. py:method:: wait_for_job(job_id, wait_seconds = 3, timeout = 3600)
Poll a job to check if it finishes.

:param job_id: Required. Id of the Airbyte job
:param wait_seconds: Optional. Number of seconds between checks.
:param timeout: Optional. How many seconds wait for job to be ready.
Used only if ``asynchronous`` is False.


.. py:method:: submit_sync_connection(connection_id)
.. py:method:: cancel_job(job_id)
Cancel the job when task is cancelled.

:param job_id: Required. Id of the Airbyte job


.. py:method:: test_connection()
Tests the Airbyte connection by hitting the health API.



Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
:py:mod:`airflow.providers.airbyte.hooks`
=========================================

.. py:module:: airflow.providers.airbyte.hooks
Submodules
----------
.. toctree::
:titlesonly:
:maxdepth: 1

airbyte/index.rst


Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
:py:mod:`airflow.providers.airbyte`
===================================

.. py:module:: airflow.providers.airbyte
Subpackages
-----------
.. toctree::
:titlesonly:
:maxdepth: 3

hooks/index.rst
operators/index.rst
sensors/index.rst
triggers/index.rst


Package Contents
----------------

.. py:data:: __version__
:value: '5.0.0'



Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
:py:mod:`airflow.providers.airbyte.operators.airbyte`
=====================================================

.. py:module:: airflow.providers.airbyte.operators.airbyte
Module Contents
---------------

Classes
~~~~~~~

.. autoapisummary::

airflow.providers.airbyte.operators.airbyte.AirbyteTriggerSyncOperator




.. py:class:: AirbyteTriggerSyncOperator(connection_id, airbyte_conn_id = 'airbyte_default', asynchronous = False, deferrable = conf.getboolean('operators', 'default_deferrable', fallback=False), api_version = 'v1', wait_seconds = 3, timeout = 3600, **kwargs)
Bases: :py:obj:`airflow.models.BaseOperator`

Submits a job to an Airbyte server to run a integration process between your source and destination.

.. seealso::
For more information on how to use this operator, take a look at the guide:
:ref:`howto/operator:AirbyteTriggerSyncOperator`

:param airbyte_conn_id: Optional. The name of the Airflow connection to get connection
information for Airbyte. Defaults to "airbyte_default".
:param connection_id: Required. The Airbyte ConnectionId UUID between a source and destination.
:param asynchronous: Optional. Flag to get job_id after submitting the job to the Airbyte API.
This is useful for submitting long running jobs and
waiting on them asynchronously using the AirbyteJobSensor. Defaults to False.
:param deferrable: Run operator in the deferrable mode.
:param api_version: Optional. Airbyte API version. Defaults to "v1".
:param wait_seconds: Optional. Number of seconds between checks. Only used when ``asynchronous`` is False.
Defaults to 3 seconds.
:param timeout: Optional. The amount of time, in seconds, to wait for the request to complete.
Only used when ``asynchronous`` is False. Defaults to 3600 seconds (or 1 hour).

.. py:attribute:: template_fields
:type: collections.abc.Sequence[str]
:value: ('connection_id',)



.. py:attribute:: ui_color
:value: '#6C51FD'



.. py:method:: execute(context)
Create Airbyte Job and wait to finish.


.. py:method:: execute_complete(context, event = None)
Invoke this callback when the trigger fires; return immediately.

Relies on trigger to throw an exception, otherwise it assumes execution was
successful.


.. py:method:: on_kill()
Cancel the job if task is cancelled.



Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
:py:mod:`airflow.providers.airbyte.operators`
=============================================

.. py:module:: airflow.providers.airbyte.operators
Submodules
----------
.. toctree::
:titlesonly:
:maxdepth: 1

airbyte/index.rst


Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
:py:mod:`airflow.providers.airbyte.sensors.airbyte`
===================================================

.. py:module:: airflow.providers.airbyte.sensors.airbyte
.. autoapi-nested-parse::

This module contains a Airbyte Job sensor.



Module Contents
---------------

Classes
~~~~~~~

.. autoapisummary::

airflow.providers.airbyte.sensors.airbyte.AirbyteJobSensor




.. py:class:: AirbyteJobSensor(*, airbyte_job_id, deferrable = conf.getboolean('operators', 'default_deferrable', fallback=False), airbyte_conn_id = 'airbyte_default', api_version = 'v1', **kwargs)
Bases: :py:obj:`airflow.sensors.base.BaseSensorOperator`

Check for the state of a previously submitted Airbyte job.

:param airbyte_job_id: Required. Id of the Airbyte job
:param airbyte_conn_id: Optional. The name of the Airflow connection to get
:param deferrable: Run sensor in the deferrable mode.
connection information for Airbyte. Defaults to "airbyte_default".
:param api_version: Optional. Airbyte API version. Defaults to "v1".

.. py:attribute:: template_fields
:type: collections.abc.Sequence[str]
:value: ('airbyte_job_id',)



.. py:attribute:: ui_color
:value: '#6C51FD'



.. py:method:: poke(context)
Override when deriving this class.


.. py:method:: execute(context)
Submit a job which generates a run_id and gets deferred.


.. py:method:: execute_complete(context, event = None)
Invoke this callback when the trigger fires; return immediately.

Relies on trigger to throw an exception, otherwise it assumes execution was
successful.



Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
:py:mod:`airflow.providers.airbyte.sensors`
===========================================

.. py:module:: airflow.providers.airbyte.sensors
Submodules
----------
.. toctree::
:titlesonly:
:maxdepth: 1

airbyte/index.rst


Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
:py:mod:`airflow.providers.airbyte.triggers.airbyte`
====================================================

.. py:module:: airflow.providers.airbyte.triggers.airbyte
Module Contents
---------------

Classes
~~~~~~~

.. autoapisummary::

airflow.providers.airbyte.triggers.airbyte.AirbyteSyncTrigger




.. py:class:: AirbyteSyncTrigger(job_id, conn_id, end_time, poll_interval)
Bases: :py:obj:`airflow.triggers.base.BaseTrigger`

Triggers Airbyte Sync, makes an asynchronous HTTP call to get the status via a job ID.

This trigger is designed to initiate and monitor the status of Airbyte Sync jobs. It
makes use of asynchronous communication to check the progress of a job run over time.

:param conn_id: The connection identifier for connecting to Airbyte.
:param job_id: The ID of an Airbyte Sync job.
:param end_time: Time in seconds to wait for a job run to reach a terminal status. Defaults to 7 days.
:param poll_interval: polling period in seconds to check for the status.

.. py:method:: serialize()
Serialize AirbyteSyncTrigger arguments and classpath.


.. py:method:: run()
:async:

Make async connection to Airbyte, polls for the pipeline run status.


.. py:method:: is_still_running(hook)
:async:

Async function to check whether the job is submitted via async API.

If job is in running state returns True if it is still running else return False



Loading

0 comments on commit 86f8d12

Please sign in to comment.