Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Tools for writing macros.

Releases and Dependency Information

Latest stable release: 0.1.5

CLI/deps.edn dependency information:

org.clojure/tools.macro {:mvn/version "0.1.5"}

Leiningen dependency information:

[org.clojure/tools.macro "0.1.5"]

Maven dependency information:


Example Usages

macrolet: local macro definitions


(macrolet [(foo [form] `(~form ~form))]
  (foo x))

expands to (x x)

symbol-macrolet: local symbol macro definitions


(symbol-macrolet [def foo]
  (def def def))

expands to (def def foo)

defsymbolmacro, with-symbol-macros: global symbol macro definitions


(defsymbolmacro sum-2-3 (plus 2 3))
  (+ 1 sum-2-3))

expands to (+ 1 (plus 2 3))


like clojure.core/macroexpand-1, but handles symbol macros


like clojure.core/macroexpand, but handles symbol macros


full recursive macro expansion


For writing def-like macros. Handles optional docstrings and attribute maps for a name to be defined in a list of macro arguments.

Developer Information

Change Log

  • Release 0.1.5 on 2013.09.12
    • Fix macroexpansion of methods in deftype* and reify*
    • Allow only non-qualified symbols in macrolet and symbol-macrolet
    • Fix bug that caused overlooking local macro definitions
  • Release 0.1.4 on 2013.09.07
    • Fix compatibility issue for Clojure 1.3/1.4
  • Release 0.1.2 on 2012.02.18
    • Protect symbols bound by let and letfn against macroexpansion from an outer scope
  • Release 0.1.1 on 2011.05.26
    • Added name-with-attributes
  • Release 0.1.0 on 2011.05.04
    • Version imported from old contrib

Copyright and License

Copyright (c) 2011-2023 Rich Hickey. All rights reserved. The use and distribution terms for this software are covered by the Eclipse Public License 1.0 ( which can be found in the file epl-v10.html at the root of this distribution. By using this software in any fashion, you are agreeing to be bound bythe terms of this license. You must not remove this notice, or any other, from this software.