graflo.architecture

Architecture façade.

For lighter imports, prefer:

• graflo.architecture.schema — graph schema types
• graflo.architecture.contract — manifest, bindings, resources, transforms
• graflo.architecture.graph_types — runtime containers, contexts, indexes (or submodules)
• graflo.architecture.pipeline.runtime — actors and executor

See docs/guides/importing.md in the package.

The façade is lazy (PEP 562) so that importing any graflo.architecture.X submodule does not eagerly load the rest of the architecture tree.

Modules:

Name	Description
backend	On-disk GraFlo backend I/O primitives.
base	Base model for Graflo configuration classes with YAML support.
contract	Declarative contracts: manifest, bindings, ingestion models, resources, transforms.
evolution	Manifest evolution: apply high-level schema + ingestion transforms to :class:~graflo.architecture.contract.manifest.GraphManifest.
graph_types	Graph runtime types and data structures (extraction, assembly, containers).
onto_sample	Resource sampling contract — pure-JSON samples and their derived profiles.
onto_sql
pipeline	Pipeline runtime (execution). Declarations live in graflo.architecture.contract.
profile	Named conformance profiles over a manifest.
query	DB-agnostic read contract: what an agent may ask of a live graph.
refusal	The base class every merge-time refusal shares.
schema
util	Utility functions for graph architecture operations.

Attributes

__all__ = ['HARD_CAPS', 'APIConnector', 'AggregateQuery', 'Bindings', 'BoundSourceKind', 'Budget', 'BudgetAccounting', 'CapExceededError', 'CoreSchema', 'DatabaseProfile', 'Edge', 'EdgeConfig', 'EdgeConfigDBAware', 'ElisionReport', 'FieldType', 'FileConnector', 'GraFloIndex', 'GraFloOutput', 'GraphManifest', 'GraphMetadata', 'GraphModel', 'GraphQuery', 'Index', 'IngestionModel', 'KafkaConnector', 'NeighborQuery', 'NodeQuery', 'ProfileReport', 'ProfileWaivers', 'ProtoTransform', 'QueryCaps', 'QueryResult', 'RankingWeights', 'Resource', 'ResourceConnector', 'Schema', 'SchemaCard', 'SchemaDBAware', 'SchemaGraph', 'SchemaNeighborhood', 'SchemaPath', 'SparqlConnector', 'SubschemaSelection', 'TableConnector', 'Transform', 'TraverseQuery', 'Vertex', 'VertexConfig', 'VertexConfigDBAware', 'build_card', 'build_subschema', 'check_manifest', 'check_manifest_config', 'select_induced', 'subschema'] module-attribute

Functions:

__dir__()

Source code in graflo/architecture/__init__.py

def __dir__() -> list[str]:
    return sorted(__all__)

__getattr__(name)

Source code in graflo/architecture/__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}")