magic-tree

KO | EN

gitlite — search

#javascript #python #react #ai #llm #go #machine-learning #deep-learning #linux #awesome #pytorch #security #mcp #open-source

(★ 18)

whitespace-aware Clojure source code manipulation.

magic-tree Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Magic Tree

> “Leaves turned to soil beneath my feet. Thus it is, trees eat themselves.”
>
> -- _David Mitchell, Cloud Atlas_

Magic Tree parses Clojure code into an AST suitable for powering smart, structural editing environments. Like [rewrite-cljs](https://github.com/rundis/rewrite-cljs), it preserves whitespace and uses zippers as an intermediate data structure. The current form of Magic Tree is just a first step to a bigger vision.

## What can it do?

1. Parse raw Clojure source into an AST (`magic-tree.core/ast`) and corresponding zipper (`magic-tree.core/ast-zip`).
2. Traverse and edit as desired.
3. Emit Clojure (`magic-tree.core/string` or `magic-tree.core/sexp`) with existing whitespace intact.

An example of real-world usage can be found in [Maria](https://github.com/mhuebert/maria), a beginner-friendly ClojureScript REPL.

## Testing

`lein doo phantom test`

## Future

In addition to being 'whitespace-aware', a magic-tree AST should also be 'cursor-aware' and 'selection-aware', and thus encapsulate nearly the full state of an editor. This will simplify the implementation of new editing commands, make testing easier, and allow for more freedoms in the visual representation and manipulation of code. (CodeMirror will be just one of many possible 'views' on an AST, one which happens to use a string representation.)

magic-tree

magic-tree Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

magic-tree

magic-tree Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README