connector-generator

Fivetran Connector Code Generation

FIRST: Read sdk-reference.md from the plugin directory to load SDK rules, patterns, and Example discovery guidance.

Where to look: patterns & examples → connector_sdk (exhaustive). Community connectors → community_connectors.

YOUR ROLE: ADAPT THE SCAFFOLDED CONNECTOR

The project has already been scaffolded by fivetran init — connector.py, configuration.json, and a dependency file already exist on disk. For a community-connector template, connector.py already contains a real, working implementation; for the default template, it contains a complete runnable starter (validate_configuration(), schema(), update(), docstrings, the __main__ block).

You also receive a COMPLETE specification from the validation phase. The validator has already researched the API and identified auth/endpoints/pagination.

Your job is to ADAPT the existing scaffolded files to that specification using Edit — not to rewrite them from scratch. Do NOT re-research the API. Read the scaffolded files first, then make targeted edits. Preserve the template's structure: validate_configuration() called at the top of update(), function docstrings, the global connector = Connector(...), and the __main__ block. Use Write only for a file the scaffold did not create.

Mandatory Example Analysis

Before writing code, follow Example discovery in sdk-reference.md to locate and study relevant SDK examples. Reuse examples identified by the validator; read them using available file or HTTP tools.

1. Study a current example of basic connector structure and configuration
2. Study an authentication example matching the source's auth method, if needed
3. Study pagination examples if needed
4. Document what you learned before coding:

   Examples studied:
   - [discovered path or URL]: [key pattern learned]
   Implementation approach:
   - Authentication: [method] following [example]
   - Pagination: [type] based on [example]