Query DSL

Namespace: dftracer::utils::utilities::common::query

source

struct AndNode

left and right.

Public Members

QueryNodePtr left

QueryNodePtr right

source

struct ArrayNode

An array of literal values (used by in/not-in).

Public Members

std::vector<LiteralNode> elements

source

struct CompareNode

field op value (e.g., cat == “POSIX”).

Public Members

FieldNode field

CompareOp op

LiteralNode value

source

struct FieldNode

A field reference (e.g., “cat”, “args.level”).

Public Members

std::string path

Dotted path into JSON.

source

struct InNode

field in [values] (e.g., cat in [“POSIX”, “STDIO”]).

Public Members

FieldNode field

ArrayNode values

source

struct LiteralNode

A literal value node.

Public Members

LiteralValue value

source

struct NotInNode

field not in [values].

Public Members

FieldNode field

ArrayNode values

source

struct NotNode

not operand.

Public Members

QueryNodePtr operand

source

struct OrNode

left or right.

Public Members

QueryNodePtr left

QueryNodePtr right

source

class Query

Owns a parsed query AST and provides evaluation.

Public Functions

Query(const Query &other)

Query &operator=(const Query &other)

Query(Query&&) = default

Query &operator=(Query&&) = default

bool evaluate(const json::JsonValue &event) const

Evaluate against a JSON event. Missing fields → false.

bool evaluate(const ValueMap &fields) const

Evaluate against a typed key-value map. Missing fields → false.

inline const QueryNode &root() const

Access the root AST node.

inline const std::string &source() const

Original query source string.

std::string to_string() const

Serialize AST back to query DSL string.

inline const dftracer::utils::StringViewSet &fields() const

Fields referenced by this query, precomputed at construction.

inline bool references(std::string_view field) const

Public Static Functions

static dftracer::utils::expected<Query, QueryError> from_string(std::string_view input)

Parse a query DSL string. Returns error on invalid syntax.

source

struct QueryError

Structured parse error with source location.

Public Functions

std::string format() const

Format as multi-line error message with source and indicator.

Public Members

std::string message

Error description.

std::size_t column

Column position (0-indexed).

std::string source

Original query string.

std::string indicator

Caret/tilde indicator line.

source

struct QueryNode

Sum type for all query AST nodes.

Public Functions

template<typename T>
inline explicit QueryNode(T &&val)

Public Members

QueryNodeVariant data

source

class QueryParseError : public dftracer::utils::DFTUtilsException

Exception wrapping a QueryError.

Public Functions

explicit QueryParseError(QueryError err)

inline const QueryError &error() const

source

struct Token

Public Members

TokenKind kind

std::string_view text

std::size_t column

Free Functions

source

dftracer::utils::StringViewSet dftracer::utils::utilities::common::query::collect_fields(const QueryNode &node)

Collect all field names referenced in a query AST.

source

const char *dftracer::utils::utilities::common::query::compare_op_str(CompareOp op)

Human-readable string for a CompareOp (e.g., “==”, “!=”).

source

bool dftracer::utils::utilities::common::query::evaluate(const QueryNode &node, const JsonValue &event)

Missing fields and type mismatches evaluate to false.

source

bool dftracer::utils::utilities::common::query::evaluate(const QueryNode &node, const ValueMap &fields)

Evaluate against a typed key-value map. Missing fields evaluate to false.

source

template<typename T>
QueryNodePtr dftracer::utils::utilities::common::query::make_node(T &&val)

Create a heap-allocated QueryNode.

source

dftracer::utils::expected<QueryNodePtr, QueryError> dftracer::utils::utilities::common::query::parse(std::string_view input)

Tokenize and parse a query string into an AST.

source

Query dftracer::utils::utilities::common::query::parse_or_throw(std::string_view input)

Parse a query string, throwing QueryParseError on failure.

source

dftracer::utils::expected<QueryNodePtr, QueryError> dftracer::utils::utilities::common::query::parse_tokens(const std::vector<Token> &tokens, std::string_view source)

Parse a pre-tokenized stream into an AST.

source

std::string dftracer::utils::utilities::common::query::to_string(const QueryNode &node)

Serialize an AST back to query DSL string.

source

dftracer::utils::expected<std::vector<Token>, QueryError> dftracer::utils::utilities::common::query::tokenize(std::string_view input)

Tokenize a query string. Keywords are case-insensitive.

source

std::optional<Query> dftracer::utils::utilities::common::query::try_parse(std::string_view input)

Parse a query string into std::optional (nullopt on failure).