[7/n][dagster-fivetran] Implement load_fivetran_asset_specs

[maximearmstrong]

Summary & Motivation

This PR implements the load_fivetran_asset_specs function:

from dagster_fivetran import FivetranWorkspace, load_fivetran_asset_specs

import dagster as dg

# Connect to Fivetran using the credentials
fivetran_workspace = FivetranWorkspace(
    account_id=dg.EnvVar("FIVETRAN_ACCOUNT_ID"),
    api_key=dg.EnvVar("FIVETRAN_API_KEY"),
    api_secret=dg.EnvVar("FIVETRAN_API_SECRET"),
)

fivetran_specs = load_fivetran_asset_specs(fivetran_workspace)
defs = dg.Definitions(assets=[*fivetran_specs], resources={"fivetran": fivetran_workspace})

How I Tested These Changes

Additional unit test

Changelog

[dagster-fivetran] The load_fivetran_asset_specs function is added. It can be used with the FivetranWorkspace resource and DagsterFivetranTranslator translator to load your Fivetran connector tables as external assets in Dagster.

[maximearmstrong]

• [11/n][dagster-fivetran] Implement materialization method in FivetranWorkspace #25961 : 3 dependent PRs (#26009 , #26025 , #26181 )
• [dagster-fivetran] Use Fivetran translator instance in load specs fn and state-backed defs #26133
• [10/n][dagster-fivetran] Implement fivetran_assets and build_fivetran_assets_definitions #25944
• [dagster-fivetran] Implement resync_and_poll method in FivetranClient #26062
• [dagster-fivetran] Implement sync_and_poll method in FivetranClient #26061
• [dagster-fivetran] Implement base poll method in FivetranClient #26060
• [dagster-fivetran] Implement base resync method in FivetranClient #26059
• [9/n][dagster-fivetran] Implement base sync methods in FivetranClient #25911
• [8/n][dagster-fivetran] Implement FivetranConnector and FivetranDestination #25889
• [7/n][dagster-fivetran] Implement load_fivetran_asset_specs #25808 👈 (View in Graphite)
• [6/n][dagster-fivetran] Implement FivetranWorkspaceDefsLoader #25807
• [5/n][dagster-fivetran] Implement FivetranWorkspaceData to FivetranConnectorTableProps method #25797
• [4/n][dagster-fivetran] Implement fetch_fivetran_workspace_data #25788
• [3/n][dagster-fivetran] Implement FivetranClient for rework #25756
• [2/n][dagster-fivetran] Update DagsterFivetranTranslator and related classes for rework #25751
• [1/n][dagster-fivetran] Scaffold FivetranWorkspace for rework #25750
• master

This stack of pull requests is managed by Graphite. Learn more about stacking.

[graphite-app]

The docstring's return type description references Tableau content, but this function returns Fivetran assets. The return description should read: List[AssetSpec]: The set of assets representing the Fivetran content in the workspace.

Spotted by Graphite Reviewer

Is this helpful? React 👍 or 👎 to let us know.

[dpeng817]

can we add some examples?

[maximearmstrong]

Sure - I added one in 14f49b7, more to come when I update the docs.