Skip to content

graflo.connections

Connection configuration and runtime credential resolution.

This package is the single home for how to reach things:

  • :mod:graflo.connections.onto — target-DB config models (DBConfig and per-backend subclasses). Pure pydantic; importable without any DB driver.
  • :mod:graflo.connections.graflo_backend — config for the on-disk GraFlo backend.
  • :mod:graflo.connections.mapping — DBType → config-class mapping.
  • :mod:graflo.connections.sources — runtime source connection models (REST API, Kafka, SPARQL, S3 credentials).
  • :mod:graflo.connections.provider — ConnectionProvider protocol resolving conn_proxy labels to runtime configs (keeps YAML manifests secret-free).

Layering: onto / graflo_backend / mapping / sources sit below graflo.architecture.contract (bindings reference PostgresConfig); provider sits above it (it resolves contract connectors). The façade is lazy so importing one side never drags in the other.