jjttjj/rewrite-clj

A library that reads and writes Clojure, ClojureScript and EDN from Clojure and ClojureScript in a whitespace and comment preserving way.

Status

Rewrite-clj v1 has been successfully and widely adopted.

See project page for current priorities.

Docs

User Guide
Developer Guide
Design
- Merging rewrite-clj and rewrite-cljs
FAQ

Used In…

Some projects using rewrite-clj v1

ancient-clj 🐥 - Version Metadata Retrieval for Maven Artifacts
antq 🐥 - Point out your outdated dependencies
babashka 📍 - Native, fast starting Clojure interpreter for scripting
carve 🐥 - Carve out the essentials of your Clojure app
classpath 📍 - Classpath/classloader/deps.edn related utilities
clerk 🐥 - Local-First Notebooks for Clojure
cljfmt 🐥 - A tool for formatting Clojure code
cljstyle 🐥 - A tool for formatting Clojure code
clojure-lsp 🐥 - Language Server (LSP) for Clojure
duck-repled 📍 - Transform your REPL interation into Pathom queries
kit 📍 - Lightweight, modular framework for scalable web development in Clojure
kusonga 🐥 - Renaming and moving namespaces in Clojure(script)
refactor-nrepl 🐥 - nREPL middleware to support refactorings in an editor agnostic way
reval 🐥 -reproduceable eval - namespace eval and storage with browser ui
rewrite-edn 🐥 - Utility lib on top of rewrite-clj with common operations to update EDN while preserving whitespace and comments
rich-comment-tests 🐥 - Turns rich comment forms into tests
test-doc-blocks 🐥 - Test AsciiDoc and CommonMark code blocks found in articles and docstrings
umschreiben-clj 🐥 - Rewrite utilities for refactoring clojure files
zprint 🐥 - Executables, uberjar, and library to beautifully format Clojure and Clojurescript source code and s-expressions

Some projects using rewrite-clj v0 and/or rewrite-cljs

depot 🐥 🩹 - Find newer versions of your dependencies in your deps.edn file
confair 📍 - A configuration library for Clojure
gen-fn 📍 - Generate Datomic function literals from regular Clojure namespaces
kibit 🐥 - There’s a function for that!
lein-ancient 🐥 - Check your Projects for outdated Dependencies
mranderson 🐥 - Dependency inlining and shadowing
mutant 🐥 - Mutation testing for Clojure
repl-tooling 📍 - a base package for Clojure’s editor tooling
update-leiningen-dependencies-skill 📍 - Track project.clj dependencies across different projects

Have an update? Let us know!

🐥 canary tested against rewrite-clj v1 lib test suite
🩹 source required minor change to work with rewrite-clj v1
📍 no easy-peasy way to run automated unit tests found for this project

Versioning

Rewrite-clj versioning scheme is: major.minor.release-test-qualifier

major increments when a non alpha release API has been broken - something, as a rule, we’d like to avoid.
minor increments to convey significant new features have been added.
release indicates small changes or bug fixes - starting with v1.1, it is the rewrite-clj release count over the life of rewrite-clj.
test-qualifier is absent for stable releases. Can be alpha, beta, rc1, etc.