tree-sitter-clojure

A tree-sitter grammar for Clojure and ClojureScript, packaged with WebAssembly support for portable use without requiring a C compiler.

This is a fork of sogaiu/tree-sitter-clojure that adds WASM builds, multi-language bindings (Node.js, Rust, Go, Python, C, Swift), and CI/CD workflows.

Installation

npm install @yogthos/tree-sitter-clojure

Usage with web-tree-sitter (WASM)

const { Parser, Language } = require("web-tree-sitter");

await Parser.init();
const parser = new Parser();
const clojure = await Language.load(
  require.resolve("@yogthos/tree-sitter-clojure/tree-sitter-clojure.wasm")
);
parser.setLanguage(clojure);

const tree = parser.parse("(defn hello [name] (println name))");
console.log(tree.rootNode.toString());

What the Repository Provides

This repository provides some files used to create various artifacts (e.g. dynamic libraries, WebAssembly modules) used for handling Clojure and ClojureScript source code via tree-sitter.

Please see the what and why document for detailed information.

Potential Changes

Changes may occur because:

1. There may be unanticipated important use cases we may want to account for
2. The grammar depends on tree-sitter which remains in flux (and is still pre 1.0)
3. It's possible we missed something or got something wrong about Clojure and we might want to remedy that

Note that previously tagged versions may work fine depending on the use case. See the changelog for details.

Other Documents

There are some documents in the doc directory covering topics such as:

• Scope
• Limits
• Testing
• Uses

Acknowledgments

This project is based on the original tree-sitter-clojure grammar by sogaiu. All credit for the grammar design and comprehensive test corpus goes to the original project.

Please see the credits for additional acknowledgments.