ExAST.Query (ExAST v0.7.0)

SQL-like query API for AST search.

This module builds on ExAST.Selector with names that read like query predicates:

import ExAST.Query

from("def _ do ... end")
|> where(contains("Repo.transaction(_)"))
|> where(not contains("IO.inspect(_)"))

The resulting query can be passed to ExAST.search/3 or ExAST.Patcher.find_all/3 anywhere a selector is accepted.

Summary

Types

t()

Functions

all(predicates)

Matches when all nested predicates match.

any(predicates)

Matches when any nested predicate matches.

contains(pattern)

Matches when the selected node contains a descendant matching pattern.

find(query, pattern)

Finds matching descendants of the current selection.

find_child(query, pattern)

Finds matching direct children of the current selection.

first()

Matches the first semantic child in its parent.

follows(pattern)

Matches when a previous sibling matches pattern.

from(pattern)

Starts a query from one pattern or a list of alternative patterns.

has_child(pattern)

Matches when the selected node has a direct child matching pattern.

immediately_follows(pattern)

Matches when the immediately previous sibling matches pattern.

immediately_precedes(pattern)

Matches when the immediately following sibling matches pattern.

inside(pattern)

Matches when the selected node is inside an ancestor matching pattern.

last()

Matches the last semantic child in its parent.

nth(index)

Matches the nth semantic child in its parent, using 1-based indexing.

parent(pattern)

Matches when the selected node has a direct parent matching pattern.

precedes(pattern)

Matches when a following sibling matches pattern.

where(query, expr)

Adds a predicate filter without changing the selected node.