core/com.strumenta.kolasu.transformation

Package-level declarations

Types

open class ASTTransformer(val issues: MutableList<Issue> = mutableListOf(), val allowGenericNode: Boolean = true)

Implementation of a tree-to-tree transformation. For each source node type, we can register a transformer that knows how to produce a transformed node. Then, this transformer can read metadata in the transformed node to recursively transform and assign children. If no node transformer is provided for a source node type, a GenericNode is created, and the processing of the subtree stops there.

ChildNodeTransformer

data class ChildNodeTransformer<Source, Target, Child>(val name: String, val get: (Source) -> Any?, val setter: (Target, Child?) -> Unit?)

Information on how to retrieve a child node.

GenericNode

class GenericNode(parent: Node? = null) : Node

A generic AST node. We use it to represent parts of a source tree that we don't know how to translate yet.

Mapped

annotation class Mapped(val path: String = "")

A child of an AST node that is automatically populated from a source tree.

NodeTransformer

class NodeTransformer<Source, Output : Node>(val constructor: (Source, ASTTransformer, NodeTransformer<Source, Output>) -> Output?, val children: MutableMap<String, ChildNodeTransformer<Source, *, *>?> = mutableMapOf(), var finalizer: (Output) -> Unit = {}, var skipChildren: Boolean = false, var childrenSetAtConstruction: Boolean = false)

Transformer that, given a tree node, will instantiate the corresponding transformed node.

ParameterConverter

interface ParameterConverter

Functions

findGenericNode

fun Node.findGenericNode(): GenericNode?

preferredConstructor

inline fun <T : Any> KClass<T>.preferredConstructor(): KFunction<T>