Skip to main content

Crate qql_plan

Crate qql_plan 

Source
Expand description

Transport-neutral planning: AST → PlannedOperation.

Architecture:

  • plan::plan is the sole statement → IR entry point.
  • plan::to_rest_route is an optional REST projection (proxies / offline compile).
  • Embeddings are owned by qql-embed, not this crate.

Re-exports§

pub use batch::BatchGrouper;
pub use plan::BatchFamily;
pub use plan::BatchKey;
pub use plan::BatchOpts;
pub use plan::PlannedOperation;
pub use plan::RestProjectionError;
pub use plan::batch_item_error;
pub use plan::build_query_batch;
pub use plan::build_update_batch;
pub use plan::ensure_no_unbound_params;
pub use plan::into_query_batch;
pub use plan::into_update_batch;
pub use plan::parse_and_plan;
pub use plan::plan;
pub use plan::plan_template;
pub use plan::statement_batch_key;
pub use plan::statement_wait;
pub use plan::to_rest_route;
pub use plan::try_route;
pub use plan::verify_batch_cardinality;
pub use routing::CompiledStatement;
pub use routing::compile_statement;
pub use semantic::PlanFacetValue;
pub use semantic::PlanGroupId;
pub use semantic::PlanPointId;
pub use semantic::PlanPointVectors;
pub use semantic::PlanQueryInput;
pub use semantic::PlanShardKey;
pub use semantic::PlanVectorStruct;
pub use semantic::PlanVectorValue;
pub use types::*;

Modules§

batch
Batch grouping, extraction, and validation for multi-statement execution. Batch grouping, extraction, and validation for multi-statement execution.
ddl
DDL lowering: collection, index, and shard-key statements into plan requests. DDL lowering: collection/index/shard/quota statements to plan requests.
filter
Filter lowering into OpenAPI-shaped Filter condition structures.
mutation
Mutation lowering: upsert, delete, and payload/vector updates into wire bodies.
plan
Canonical fallible planner: AST → PlannedOperation.
query
Query lowering: QUERY statements into /points/query request bodies.
routing
Optional REST route projection and the offline compile_statement entry point.
semantic
Typed semantic primitives for the plan layer.
types
Wire and plan-IR request types shared by the REST projection and gRPC conversion.

Enums§

FormulaDefault
One DEFAULTS (name = …) binding value.
PlanDecayKind
Decay curve family of a PlanFormula::Decay node.
PlanFormula
Transport-neutral formula expression tree (QUERY FORMULA <expr>).

Functions§

value_error_text
Render a scalar AST value exactly as the old serde_json pipeline did, for error messages that pin value text ("1.5", "true", "9223372036854775808"). Non-scalars fall back to AST debug shape; only human-facing message text ever flows through here, never the wire.