Skip to content

graflo.hq

High-level orchestration modules for graflo.

This package provides high-level orchestration classes that coordinate multiple components for graph database operations.

The façade is lazy (PEP 562): importing graflo.hq is cheap; orchestration classes (and their DB/data-source dependencies) load on first attribute access.

Modules:

Name Description
anchor

Resolve a traversal anchor to the identity it names (:mod:~graflo.architecture.schema.anchor).

auto_join

Auto-JOIN generation for edge resources.

bulk

Bulk load: cast and stage a whole input, fold it by identity, write it once.

cast_pool

Worker-process casting for the ingestion hot path.

caster

Data casting and ingestion system for graph databases.

concurrency_gate

Decide how many batches of one data source may be in flight concurrently.

container_write

Write a graph container to a database by identity upsert, without a resource.

db_writer

Database writer for pushing graph data to the target database.

discovery

What a connection offers to read, before any model exists.

doc_error_sink

Pluggable sinks for persisting per-document cast failures.

document_caster

Stateless document-to-graph casting (no I/O).

endpoint_resolve

Resolve edge endpoints declared by a secondary identity.

graph_engine

Graph engine for orchestrating schema inference, connector creation, and ingestion.

identify

Which entity a set of property values identifies, by the key contract alone.

ingestion_parameters

Ingestion parameters and per-document cast-failure models for the caster.

lookup

Which existing vertices a short text may name.

rdf_inferencer

RDF / OWL ontology inference manager.

rdf_landing

Land RDF facts on a manifest: read each class a resource handles from a file.

registry_builder

Build a :class:DataSourceRegistry from :class:Bindings and schema models.

resource_mapper

Resource mapper for creating Bindings from different data sources.

sampler

Connector-driven resource sampling.

sanitizer

Sanitization entry point for schema and ingestion contracts.

sql_inferencer

PostgreSQL schema inference and resource mapping (high level).

sync

Record sync: replace what changed owner records wrote in a loaded target.

write_prepare

What a batch becomes before a backend sees it, without a connection.

Attributes

__all__ = ['CastBatchResult', 'Caster', 'ContainerWriteReport', 'DBWriter', 'DiscoveredResource', 'Discovery', 'DocCastFailure', 'DocErrorBudgetExceeded', 'DocErrorSink', 'GraphEngine', 'IngestionParams', 'JsonlGzDocErrorSink', 'RegistryBuilder', 'ResourceMapper', 'SQLInferenceManager', 'Sanitizer', 'discover', 'failure_sinks_from_ingestion_params', 'write_container'] module-attribute

Functions:

__dir__()

Source code in graflo/hq/__init__.py
def __dir__() -> list[str]:
    return sorted(__all__)

__getattr__(name)

Source code in graflo/hq/__init__.py
def __getattr__(name: str) -> Any:
    if name in _EXPORTS:
        import importlib

        value = getattr(importlib.import_module(_EXPORTS[name]), name)
        globals()[name] = value
        return value
    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")