Readme — rewrite-clj 1.0.579-alpha

Liking cljdoc? Tell your friends :D

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

Status

Warning: v1 Alpha Release

Migration from rewrite-cljc-playground complete. Rewrite-cljc-playground is where I first merged rewrite-clj v0 and rewrite-cljs.
We are automatically testing against popular libraries. We patch them to use rewrite-clj v1 and then run their test suites. Only a minor failure on zprint v1.1.1 was found due to intentional breaking changes in namespaced maps.
Please review change log for an overview of all v1 changes.
I am very conservative on making any further v0→v1 breaking changes, but am open to breaking changes to any of the new v1 work.

We’ll move out of alpha after folks have had a chance to give rewrite-clj v1 alpha a good shake. Things look solid but I would be very surprised if there are no issues and/or feedback.

See project page for current priorities.

Docs

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

Versioning

Rewrite-clj versioning scheme is: major.minor.patch-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.
patch indicates bug fixes - it is the total number of commits in the repo.
test-qualifier is absent for stable releases. Can be alpha, beta, rc1, etc.