Main Connector Interface

The primary interface for the Airbyte source connector, providing entry points and connector lifecycle management. This module contains the main classes and functions needed to run the Google Directory connector as an Airbyte source.

Capabilities

Source Connector Class

The main connector class that extends Airbyte's BaseSource to provide Google Directory-specific functionality.

class SourceGoogleDirectory(BaseSource):
    """
    Main connector class for Google Directory integration.
    
    This class extends the Airbyte CDK BaseSource and configures
    the connector to use the Google Directory Client.
    """
    client_class = Client

Entry Point Function

The main entry point for running the connector from command line or programmatically.

def run():
    """
    Main entry point function that launches the connector.
    
    Creates a SourceGoogleDirectory instance and launches it using
    the Airbyte CDK entrypoint with command-line arguments.
    """

Usage Examples

Basic Connector Usage

from source_google_directory import SourceGoogleDirectory

# Create connector instance
source = SourceGoogleDirectory()

# The connector can be used with Airbyte's launch function
from airbyte_cdk.entrypoint import launch
import sys

launch(source, sys.argv[1:])

Command-Line Entry Point

from source_google_directory.run import run

# Run connector with command-line arguments
run()

This will process command-line arguments and execute the appropriate connector operations (spec, check, discover, read).

Direct Import Usage

# Direct import of the main class
from source_google_directory import SourceGoogleDirectory

# This import works because __all__ = ["SourceGoogleDirectory"] in __init__.py
source = SourceGoogleDirectory()

Integration with Airbyte Framework

The connector integrates with the Airbyte framework through:

• BaseSource inheritance: Provides standard Airbyte source interface
• Client class configuration: Uses the Google Directory-specific Client
• Airbyte CDK launch: Standard Airbyte connector lifecycle management
• Command-line interface: Standard Airbyte connector command structure

The connector responds to standard Airbyte commands:

• spec: Returns connection specification
• check: Validates connection configuration
• discover: Returns available streams (users, groups, group_members)
• read: Extracts data from Google Directory API