Transformation¶

{ #concept-transformation }

Stable ID: CONCEPT-TRANSFORMATION

Purpose¶

Transformation manipulates code using find / filter / manipulate workflows.

MISC¶

Transformation Functionality¶

• The encoding of a file should never be changed
• The meta data of a file or directory is only allowed to change when an actual change happened
• Analysis or a match (with a failing filter) are NOT enough
• Offset-based batch modifications of strings

• Insert and replace operations

  • remove is just replace with ""

• AST-based batch modifications of strings

• Replace (incl. remove), and insert (Prepend, append, and surround - e.g., for matching brackets)

• Batch modification of Translation Unit (Single file of code)

• Prepend, append, surround, replace of specific AST Node
• Find, Filter (possibly multiple), and Replace functionality (whole match is replaced)
  • Replace recursively (so the AST nodes assigned to placeholders are also modified)
• Find (possibly multiple - a.k.a. chained find), Filter (possibly multiple), and modify functionality
  • Multiple operations on a single find
  • Modification of any AST node possible
  • not only contained in the found match, but all via navigation (along parent and ancestor nodes)