Reference
Public Modules
Namespaced public API surfaces
- exporter.GoogleSeriesDocstringRenderer
- exporter.NumpySeriesDocstringRenderer
- exporter.PlainSeriesDocstringRenderer
- exporter.RstSeriesDocstringRenderer
- exporter.CodeGenerator
-
Generates Python code from Excel formulas.
- exporter.IdentityTransitCompression
-
Collapse pure identity transit nodes into a projected export graph.
- exporter.FieldDoc
- exporter.SeriesBindingDocstringContext
- exporter.SeriesBindingDocstringContract
- exporter.SeriesFunctionDoc
- exporter.BaseProjectionManifest
-
General, serializable projection manifest for node-collapsing projections.
- exporter.CollapsedGroup
-
Source nodes that folded into one retained computation address.
- exporter.CompositeProjectionManifest
-
Lineage for a sequence of composed projection steps.
- exporter.FormulaRewrite
-
Dependent formula rewrite performed during projection.
- exporter.ProjectedNodeSnapshot
-
Workbook node state captured before projection removes or rewrites it.
- exporter.ProjectionResult
-
Projected graph facade with durable lineage back to the canonical graph.
- exporter.SeriesDocstringRenderCallable
- exporter.SeriesDocstringRenderer
- exporter.SeriesBindingDocstringCallback
- exporter.ProjectionManifest
-
Stable contract a projection manifest exposes to export and composition.
- exporter.ProjectionStep
-
Projection step that builds a
ProjectionResultfrom a graph. - exporter.WebVizLayoutPlugin
- exporter.resolve_series_docstring_renderer()
- exporter.list_series_docstring_callbacks()
- exporter.register_series_docstring_callback()
- exporter.resolve_series_docstring_callback()
-
Look up a registered callback name or return a direct callback object.
- exporter.unregister_series_docstring_callback()
-
Remove a registered callback (for tests and notebook cleanup).
- exporter.to_web_viz_payload()
-
Build a web-visualization payload from a NetworkX DiGraph.
- exporter.apply_projection()
-
Apply one or more projection steps, returning the final projection result.
- exporter.build_forwarding_projection_manifest()
-
Build a
BaseProjectionManifestfrom a graph compressionrecord. - exporter.register_projection_manifest()
-
Register a
from_dictdeserializer for projection manifests ofkind. - exporter.resolve_projection_manifest()
-
Deserialize a manifest by dispatching on its
kindvia the registry. - exporter.unregister_projection_manifest()
-
Remove a registered projection manifest
kind(no-op if absent). - exporter.list_web_viz_layouts()
- exporter.register_web_viz_layout()
- exporter.resolve_web_viz_layout()
-
Look up a registered layout ID or return a direct layout plugin.
- exporter.unregister_web_viz_layout()
-
Remove a registered layout plugin (for tests and notebook cleanup).
- exporter.SeriesDocstringRendererName
- exporter.SeriesDocstringRendererSpec
- exporter.SeriesBindingDocstringCallbackSpec
- exporter.WebVizPayload
- exporter.LAYOUT_FORCEATLAS2
- exporter.LAYOUT_GRAPHVIZ_DOT
- exporter.LAYOUT_GRAPHVIZ_SFDP
- exporter.LAYOUT_MULTIPARTITE
- exporter.LAYOUT_SPRING
- exporter.LAYOUT_STRATIFIED_MULTIPARTITE
- exporter.WebVizLayoutSpec
- grapher.GreaterThanCell
-
Metadata marker: the annotated cell is always greater than another cell.
- grapher.NotEqualCell
-
Metadata marker: the annotated cell is never equal to another cell.
- grapher.RealBetween
-
Real-valued interval constraint for Annotated float types (not enumerable for dynamic refs).
- grapher.RealIntervalDomain
-
Closed real-valued interval metadata; not enumerable for dynamic-ref branching.
- grapher.EdgeProvenance
-
Metadata for a single directed edge, possibly from multiple mechanisms in one formula.
- grapher.DynamicRefConfig
-
Configuration for resolving OFFSET/INDIRECT via constraint-based inference.
- grapher.DynamicRefLimits
-
Tuneable safety limits for dynamic-reference inference.
- grapher.DynamicRefTraceEvent
-
A single trace event emitted during dynamic-ref inference.
- grapher.FromWorkbook
-
Metadata marker: resolve domain from the current cached workbook value.
- grapher.LightweightVizLocalEdges
- grapher.LightweightVizModule
- grapher.LightweightVizModuleEdge
- grapher.LightweightVizNodeColumns
- grapher.LightweightVizPayload
- grapher.LightweightVizStats
- grapher.LocalForceSubgraph
- grapher.CycleReport
-
Result of cycle analysis.
- grapher.DependencyGraph
- grapher.And
-
Logical AND.
- grapher.Compare
-
Comparison: left op right.
- grapher.GuardExpr
-
Base type for conditional dependency guards.
- grapher.Literal
-
A literal value in a condition.
- grapher.Not
-
Logical negation.
- grapher.Or
-
Logical OR.
- grapher.GuardCellRef
-
A cell reference used in a condition.
- grapher.Node
-
Workbook cell in a dependency graph.
- grapher.WorkbookCalcSettings
- grapher.GraphReadView
-
Read-only dependency-graph surface shared by graphs and projected views.
- grapher.CacheValidationPolicy
- grapher.DependencyCause
-
How a dependency edge arises from a formula.
- grapher.DynamicRefError
-
Raised when dynamic reference analysis cannot proceed.
- grapher.CycleError
-
Raised when a cycle prevents computing evaluation order.
- grapher.ValidationResult
- grapher.normalize_blank_range_specs()
-
Normalize a sequence of sheet-qualified range strings.
- grapher.create_dependency_graph()
-
Build a dependency graph starting from target cells.
- grapher.list_dynamic_ref_constraint_candidates()
-
Return sorted leaf cells missing dynamic-ref constraint entries.
- grapher.build_graph_cache_meta()
- grapher.build_graph_cache_meta_portable()
-
Build expected cache metadata without access to the workbook file.
- grapher.save_graph_cache()
- grapher.try_load_graph_cache()
- grapher.infer_dynamic_index_targets()
-
Infer the union of all possible standalone INDEX targets for a formula.
- grapher.infer_dynamic_indirect_targets()
-
Infer the union of all possible INDIRECT targets for a formula.
- grapher.infer_dynamic_offset_targets()
-
Infer the union of all possible OFFSET targets for a formula.
- grapher.trace_dynamic_refs()
-
Activate callback as the dynamic-ref tracer for the enclosed block.
- grapher.select_local_force_subgraph()
- grapher.select_path_induced_subgraph()
-
Return the induced subgraph over nodes lying on directed source->target paths.
- grapher.to_graphviz()
- grapher.to_mermaid()
- grapher.to_networkx()
-
Convert a dependency graph to a NetworkX DiGraph.
- grapher.write_lightweight_viz_data()
- grapher.write_lightweight_viz_html()
- grapher.write_web_viz_html()
-
Write a web visualization HTML bundle from a web-viz payload.
- grapher.format_cell_key()
-
Format a (sheet, column_letters, row) triple into a canonical address.
- grapher.needs_quoting()
-
Return True if a sheet name must be wrapped in single quotes in a formula.
- grapher.get_calc_settings()
-
Extract calculation settings from xl/workbook.xml.
- grapher.validate_graph()
- grapher.GRAPH_CACHE_SCHEMA_VERSION
- grapher.DynamicRefTraceFn
-
Callback signature for receiving trace events.
- grapher.NodeHook
- grapher.NodeKey
- grapher.format_key
- series_bindings.GoogleSeriesDocstringRenderer
- series_bindings.NumpySeriesDocstringRenderer
- series_bindings.PlainSeriesDocstringRenderer
- series_bindings.RstSeriesDocstringRenderer
- series_bindings.ResolutionIssue
-
Alias for resolution-time validation issues.
- series_bindings.FieldDoc
- series_bindings.SeriesBindingDocstringContext
- series_bindings.SeriesBindingDocstringContract
- series_bindings.SeriesFunctionDoc
- series_bindings.SeriesDocstringRenderCallable
- series_bindings.SeriesDocstringRenderer
- series_bindings.SeriesBindingDocstringCallback
- series_bindings.SeriesBindingsLoadError
-
Raised when binding files cannot be parsed or merged.
- series_bindings.SeriesBindingsSchemaError
-
Raised when a binding manifest fails JSON Schema validation.
- series_bindings.InputSeries
- series_bindings.InputSeriesCell
- series_bindings.LeafResolution
- series_bindings.OutputSeries
- series_bindings.OutputSeriesCell
- series_bindings.ResolutionReport
- series_bindings.SeriesResolution
- series_bindings.ValidationIssue
- series_bindings.ValidationReport
- series_bindings.WorkbookSeriesBindings
-
Top-level workbook binding manifest (post-merge, post-schema validation).
- series_bindings.emit_series_bindings_block()
-
Emit setter and/or output compute functions for a binding manifest.
- series_bindings.bindings_canonical_sha256()
-
SHA-256 hex digest of the canonical binding manifest.
- series_bindings.emit_compute_function()
-
Emit Python source lines for one series binding output compute function.
- series_bindings.emit_computes_block()
-
Emit all series output compute functions for a validated binding manifest.
- series_bindings.generate_computes_module()
-
Generate a standalone module fragment with output compute functions.
- series_bindings.resolve_series_docstring_renderer()
- series_bindings.list_series_docstring_callbacks()
- series_bindings.register_series_docstring_callback()
- series_bindings.resolve_series_docstring_callback()
-
Look up a registered callback name or return a direct callback object.
- series_bindings.unregister_series_docstring_callback()
-
Remove a registered callback (for tests and notebook cleanup).
- series_bindings.derive_input_series()
-
Return one input series per binding series with graph-leaf overlap.
- series_bindings.load_series_bindings()
-
Load a binding sidecar file or directory of shards.
- series_bindings.merge_series_binding_documents()
-
Merge partial manifests (e.g. one per sheet) into one workbook document.
- series_bindings.parse_bindings_file()
-
Parse one binding sidecar file (YAML or JSON) without schema validation.
- series_bindings.has_input_direction()
- series_bindings.has_output_direction()
- series_bindings.merge_series_entries()
-
Merge two series entries with the same id from different shards.
- series_bindings.normalize_bindings_document()
-
Normalize all series entries in a binding manifest.
- series_bindings.normalize_series_entry()
-
Return a copy with legacy aliases normalized for schema validation and codegen.
- series_bindings.derive_output_series()
-
Return one output series per binding entry with output.compute and graph overlap.
- series_bindings.expand_data_range()
-
Expand a binding
data_rangeto canonical sheet-qualified cell addresses. - series_bindings.expand_data_range_for_graph()
-
Expand
data_rangeusing named-range maps (and optional workbook) from a graph. - series_bindings.resolve_series_binding()
-
Resolve each participating cell in a series binding to coordinates and record fields.
- series_bindings.resolve_series_bindings()
-
Resolve all series in a binding manifest for the given direction.
- series_bindings.format_schema_errors()
-
Return human-readable schema error strings (for tests and CLI).
- series_bindings.validate_bindings_document()
-
Validate
documentagainst the series binding JSON Schema. - series_bindings.emit_setter_function()
-
Emit Python source lines for one series binding setter.
- series_bindings.emit_setter_helpers()
-
Emit shared private helpers used by generated
set_*functions. - series_bindings.emit_setters_block()
-
Emit all series setter functions for a validated binding manifest.
- series_bindings.generate_setters_module()
-
Generate a standalone module fragment with setters (requires EvalContext imports).
- series_bindings.validate_series_bindings()
-
Validate binding manifests against an extracted dependency graph.
- series_bindings.is_bind_implemented()
- series_bindings.is_layout_implemented()
- series_bindings.SeriesDocstringRendererName
- series_bindings.SeriesDocstringRendererSpec
- series_bindings.SeriesBindingDocstringCallbackSpec
- series_bindings.Record
- series_bindings.Records
- series_bindings.Scalar
- series_bindings.ValidationLevel
- series_bindings.IMPLEMENTED_BIND_KINDS
- series_bindings.IMPLEMENTED_LAYOUTS
- series_bindings.PLANNED_BIND_KINDS
- series_bindings.PLANNED_LAYOUTS
- series_bindings.SUPPORTED_SCHEMA_VERSIONS
Exporter API
Export and extension APIs under excel_grapher.exporter
- exporter.CodeGenerator
-
Generates Python code from Excel formulas.
- exporter.IdentityTransitCompression
-
Collapse pure identity transit nodes into a projected export graph.
- exporter.ProjectionStep
-
Projection step that builds a
ProjectionResultfrom a graph. - exporter.ProjectionResult
-
Projected graph facade with durable lineage back to the canonical graph.
- exporter.ProjectionManifest
-
Stable contract a projection manifest exposes to export and composition.
- exporter.BaseProjectionManifest
-
General, serializable projection manifest for node-collapsing projections.
- exporter.CompositeProjectionManifest
-
Lineage for a sequence of composed projection steps.
- exporter.ProjectedNodeSnapshot
-
Workbook node state captured before projection removes or rewrites it.
- exporter.FormulaRewrite
-
Dependent formula rewrite performed during projection.
- exporter.CollapsedGroup
-
Source nodes that folded into one retained computation address.
- exporter.apply_projection()
-
Apply one or more projection steps, returning the final projection result.
- exporter.build_forwarding_projection_manifest()
-
Build a
BaseProjectionManifestfrom a graph compressionrecord. - exporter.register_projection_manifest()
-
Register a
from_dictdeserializer for projection manifests ofkind. - exporter.resolve_projection_manifest()
-
Deserialize a manifest by dispatching on its
kindvia the registry. - exporter.unregister_projection_manifest()
-
Remove a registered projection manifest
kind(no-op if absent). - exporter.WebVizPayload
- exporter.to_web_viz_payload()
-
Build a web-visualization payload from a NetworkX DiGraph.
- exporter.LAYOUT_FORCEATLAS2
- exporter.LAYOUT_GRAPHVIZ_DOT
- exporter.LAYOUT_GRAPHVIZ_SFDP
- exporter.LAYOUT_MULTIPARTITE
- exporter.LAYOUT_SPRING
- exporter.LAYOUT_STRATIFIED_MULTIPARTITE
- exporter.WebVizLayoutPlugin
- exporter.WebVizLayoutSpec
- exporter.list_web_viz_layouts()
- exporter.register_web_viz_layout()
- exporter.resolve_web_viz_layout()
-
Look up a registered layout ID or return a direct layout plugin.
- exporter.unregister_web_viz_layout()
-
Remove a registered layout plugin (for tests and notebook cleanup).
- exporter.FieldDoc
- exporter.GoogleSeriesDocstringRenderer
- exporter.NumpySeriesDocstringRenderer
- exporter.PlainSeriesDocstringRenderer
- exporter.RstSeriesDocstringRenderer
- exporter.SeriesDocstringRenderCallable
- exporter.SeriesDocstringRenderer
- exporter.SeriesDocstringRendererName
- exporter.SeriesDocstringRendererSpec
- exporter.SeriesBindingDocstringCallback
- exporter.SeriesBindingDocstringCallbackSpec
- exporter.SeriesBindingDocstringContext
- exporter.SeriesBindingDocstringContract
- exporter.SeriesFunctionDoc
- exporter.list_series_docstring_callbacks()
- exporter.register_series_docstring_callback()
- exporter.resolve_series_docstring_callback()
-
Look up a registered callback name or return a direct callback object.
- exporter.unregister_series_docstring_callback()
-
Remove a registered callback (for tests and notebook cleanup).
- exporter.resolve_series_docstring_renderer()
Grapher Namespaced API
Public grapher APIs available under excel_grapher.grapher
- grapher.DependencyCause
-
How a dependency edge arises from a formula.
- grapher.EdgeProvenance
-
Metadata for a single directed edge, possibly from multiple mechanisms in one formula.
- grapher.LightweightVizLocalEdges
- grapher.LightweightVizModule
- grapher.LightweightVizModuleEdge
- grapher.LightweightVizNodeColumns
- grapher.LightweightVizStats
- grapher.GRAPH_CACHE_SCHEMA_VERSION
- grapher.DynamicRefTraceFn
-
Callback signature for receiving trace events.
- grapher.GraphReadView
-
Read-only dependency-graph surface shared by graphs and projected views.
- grapher.NodeHook
- grapher.NodeKey
- grapher.infer_dynamic_index_targets()
-
Infer the union of all possible standalone INDEX targets for a formula.
- grapher.infer_dynamic_indirect_targets()
-
Infer the union of all possible INDIRECT targets for a formula.
- grapher.infer_dynamic_offset_targets()
-
Infer the union of all possible OFFSET targets for a formula.
Series Bindings API
Series binding manifest and codegen APIs
- series_bindings.InputSeries
- series_bindings.InputSeriesCell
- series_bindings.OutputSeries
- series_bindings.OutputSeriesCell
- series_bindings.Record
- series_bindings.Records
- series_bindings.Scalar
- series_bindings.FieldDoc
- series_bindings.GoogleSeriesDocstringRenderer
- series_bindings.NumpySeriesDocstringRenderer
- series_bindings.PlainSeriesDocstringRenderer
- series_bindings.RstSeriesDocstringRenderer
- series_bindings.SeriesDocstringRenderCallable
- series_bindings.SeriesDocstringRenderer
- series_bindings.SeriesDocstringRendererName
- series_bindings.SeriesDocstringRendererSpec
- series_bindings.SeriesBindingDocstringCallback
- series_bindings.SeriesBindingDocstringCallbackSpec
- series_bindings.SeriesBindingDocstringContext
- series_bindings.SeriesBindingDocstringContract
- series_bindings.SeriesFunctionDoc
- series_bindings.LeafResolution
- series_bindings.ResolutionIssue
-
Alias for resolution-time validation issues.
- series_bindings.ResolutionReport
- series_bindings.SeriesResolution
- series_bindings.ValidationIssue
- series_bindings.ValidationLevel
- series_bindings.ValidationReport
- series_bindings.WorkbookSeriesBindings
-
Top-level workbook binding manifest (post-merge, post-schema validation).
- series_bindings.IMPLEMENTED_BIND_KINDS
- series_bindings.IMPLEMENTED_LAYOUTS
- series_bindings.PLANNED_BIND_KINDS
- series_bindings.PLANNED_LAYOUTS
- series_bindings.SUPPORTED_SCHEMA_VERSIONS
- series_bindings.bindings_canonical_sha256()
-
SHA-256 hex digest of the canonical binding manifest.
- series_bindings.derive_input_series()
-
Return one input series per binding series with graph-leaf overlap.
- series_bindings.derive_output_series()
-
Return one output series per binding entry with output.compute and graph overlap.
- series_bindings.emit_compute_function()
-
Emit Python source lines for one series binding output compute function.
- series_bindings.emit_computes_block()
-
Emit all series output compute functions for a validated binding manifest.
- series_bindings.emit_series_bindings_block()
-
Emit setter and/or output compute functions for a binding manifest.
- series_bindings.emit_setter_function()
-
Emit Python source lines for one series binding setter.
- series_bindings.emit_setter_helpers()
-
Emit shared private helpers used by generated
set_*functions. - series_bindings.emit_setters_block()
-
Emit all series setter functions for a validated binding manifest.
- series_bindings.generate_computes_module()
-
Generate a standalone module fragment with output compute functions.
- series_bindings.generate_setters_module()
-
Generate a standalone module fragment with setters (requires EvalContext imports).
- series_bindings.has_input_direction()
- series_bindings.has_output_direction()
- series_bindings.merge_series_entries()
-
Merge two series entries with the same id from different shards.
- series_bindings.normalize_bindings_document()
-
Normalize all series entries in a binding manifest.
- series_bindings.normalize_series_entry()
-
Return a copy with legacy aliases normalized for schema validation and codegen.
- series_bindings.expand_data_range()
-
Expand a binding
data_rangeto canonical sheet-qualified cell addresses. - series_bindings.expand_data_range_for_graph()
-
Expand
data_rangeusing named-range maps (and optional workbook) from a graph. - series_bindings.format_schema_errors()
-
Return human-readable schema error strings (for tests and CLI).
- series_bindings.list_series_docstring_callbacks()
- series_bindings.load_series_bindings()
-
Load a binding sidecar file or directory of shards.
- series_bindings.merge_series_binding_documents()
-
Merge partial manifests (e.g. one per sheet) into one workbook document.
- series_bindings.parse_bindings_file()
-
Parse one binding sidecar file (YAML or JSON) without schema validation.
- series_bindings.register_series_docstring_callback()
- series_bindings.resolve_series_docstring_callback()
-
Look up a registered callback name or return a direct callback object.
- series_bindings.unregister_series_docstring_callback()
-
Remove a registered callback (for tests and notebook cleanup).
- series_bindings.resolve_series_binding()
-
Resolve each participating cell in a series binding to coordinates and record fields.
- series_bindings.resolve_series_bindings()
-
Resolve all series in a binding manifest for the given direction.
- series_bindings.resolve_series_docstring_renderer()
- series_bindings.validate_bindings_document()
-
Validate
documentagainst the series binding JSON Schema. - series_bindings.validate_series_bindings()
-
Validate binding manifests against an extracted dependency graph.
- series_bindings.is_bind_implemented()
- series_bindings.is_layout_implemented()
Classes
Main classes provided by the package
- CodeGenerator
-
Generates Python code from Excel formulas.
- ParseError
-
Raised when a formula cannot be parsed into an AST.
CodeGenerator Methods
Methods for the CodeGenerator class
- CodeGenerator.__enter__()
- CodeGenerator.__exit__()
- CodeGenerator.derive_input_series()
-
Derive input-series metadata from explicit series bindings.
- CodeGenerator.classify_leaf_nodes()
- CodeGenerator.generate()
-
Generate standalone Python code for target cells.
- CodeGenerator.generate_modules()
-
Generate a multi-module Python package for target cells.
Dataclasses
Dataclass definitions
- And
-
Logical AND.
- Compare
-
Comparison: left op right.
- CycleReport
-
Result of cycle analysis.
- DependencyGraph
- DynamicRefConfig
-
Configuration for resolving OFFSET/INDIRECT via constraint-based inference.
- DynamicRefLimits
-
Tuneable safety limits for dynamic-reference inference.
- DynamicRefTraceEvent
-
A single trace event emitted during dynamic-ref inference.
- ExcelRange
- FormulaEvaluator
- FromWorkbook
-
Metadata marker: resolve domain from the current cached workbook value.
- GreaterThanCell
-
Metadata marker: the annotated cell is always greater than another cell.
- GuardCellRef
-
A cell reference used in a condition.
- GuardExpr
-
Base type for conditional dependency guards.
- LightweightVizPayload
- Literal
-
A literal value in a condition.
- LocalForceSubgraph
- Node
-
Workbook cell in a dependency graph.
- Not
-
Logical negation.
- NotEqualCell
-
Metadata marker: the annotated cell is never equal to another cell.
- Or
-
Logical OR.
- RealBetween
-
Real-valued interval constraint for Annotated float types (not enumerable for dynamic refs).
- RealIntervalDomain
-
Closed real-valued interval metadata; not enumerable for dynamic-ref branching.
- WorkbookCalcSettings
DependencyGraph Methods
Methods for the DependencyGraph class
- DependencyGraph.add_node()
- DependencyGraph.__contains__()
- DependencyGraph.__iter__()
- DependencyGraph.__len__()
- DependencyGraph.keys()
-
Return node keys from
source(or the graph) using the selected order. - DependencyGraph.add_edge()
-
Add edge: from_key depends on to_key (from_key -> to_key).
- DependencyGraph.get_node()
-
Return an immutable
NodeViewsnapshot, orNoneif missing. - DependencyGraph.get_dependencies()
-
Return an immutable snapshot of
key’s dependencies (cells it reads). - DependencyGraph.get_dependents()
-
Return an immutable snapshot of cells that depend on
key. - DependencyGraph.get_edge_attrs()
-
Return a typed snapshot of the attributes on edge
from_key -> to_key. - DependencyGraph.get_edge_guard()
-
Return the guard on edge
from_key -> to_key, orNoneif none. - DependencyGraph.set_node_value()
-
Set a node’s
valuefield durably. RaisesKeyErrorif missing. - DependencyGraph.set_node_metadata()
-
Replace a node’s metadata mapping durably.
- DependencyGraph.register_hook()
- DependencyGraph.leaves()
-
Iterate over keys of leaf nodes (no dependencies).
- DependencyGraph.formula_nodes()
-
Iterate over (key, node) pairs for nodes that contain formulas.
- DependencyGraph.leaf_node_items()
-
Iterate over (key, node) pairs for leaf nodes (no cell dependencies).
- DependencyGraph.formula_keys()
-
Return sorted list of keys for nodes that contain formulas.
- DependencyGraph.leaf_keys()
-
Return sorted list of keys for nodes with no dependency edges (leaves).
- DependencyGraph.target_keys()
-
Return sorted list of keys marked as original build targets.
- DependencyGraph.roots()
- DependencyGraph.cycle_report()
- DependencyGraph.evaluation_order()
-
Return nodes in dependency-first order (leaves before formulas that use them).
- DependencyGraph.compress_identity_transits()
-
Remove identity transit nodes and rewire dependents.
- DependencyGraph.__getstate__()
- DependencyGraph.__setstate__()
Enumerations
Enumeration types
Exceptions
Exception classes
- CycleError
-
Raised when a cycle prevents computing evaluation order.
- DynamicRefError
-
Raised when dynamic reference analysis cannot proceed.
- SeriesBindingsLoadError
-
Raised when binding files cannot be parsed or merged.
- SeriesBindingsSchemaError
-
Raised when a binding manifest fails JSON Schema validation.
Named Tuples
Named tuple definitions
Typed Dicts
TypedDict definitions
Functions
Utility functions
- bindings_canonical_sha256()
-
SHA-256 hex digest of the canonical binding manifest.
- build_graph_cache_meta()
- build_graph_cache_meta_portable()
-
Build expected cache metadata without access to the workbook file.
- create_dependency_graph()
-
Build a dependency graph starting from target cells.
- format_cell_key()
-
Format a (sheet, column_letters, row) triple into a canonical address.
- get_calc_settings()
-
Extract calculation settings from xl/workbook.xml.
- list_dynamic_ref_constraint_candidates()
-
Return sorted leaf cells missing dynamic-ref constraint entries.
- load_series_bindings()
-
Load a binding sidecar file or directory of shards.
- needs_quoting()
-
Return True if a sheet name must be wrapped in single quotes in a formula.
- normalize_blank_range_specs()
-
Normalize a sequence of sheet-qualified range strings.
- resolve_series_bindings()
-
Resolve all series in a binding manifest for the given direction.
- save_graph_cache()
- select_local_force_subgraph()
- select_path_induced_subgraph()
-
Return the induced subgraph over nodes lying on directed source->target paths.
- to_graphviz()
- to_mermaid()
- to_networkx()
-
Convert a dependency graph to a NetworkX DiGraph.
- to_web_viz_payload()
-
Build a web-visualization payload from a NetworkX DiGraph.
- trace_dynamic_refs()
-
Activate callback as the dynamic-ref tracer for the enclosed block.
- try_load_graph_cache()
- validate_graph()
- validate_series_bindings()
-
Validate binding manifests against an extracted dependency graph.
- write_lightweight_viz_data()
- write_lightweight_viz_html()
- write_web_viz_html()
-
Write a web visualization HTML bundle from a web-viz payload.
Constants
Module-level constants and data