Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Utilities for macro writers

README.md

clojure.tools.macro

Tools for writing macros.

Releases and Dependency Information

Latest stable release: 0.1.2

Leiningen dependency information:

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

Maven dependency information:

<dependency>
  <groupId>org.clojure</groupId>
  <artifactId>tools.macro</artifactId>
  <version>0.1.2</version>
</dependency>

Example Usages

macrolet: local macro definitions

Example:

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

expands to (x x)

symbol-macrolet: local symbol macro definitions

Example:

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

expands to (def def foo)

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

Example:

(defsymbolmacro sum-2-3 (plus 2 3))
(with-symbol-macros
  (+ 1 sum-2-3))

expands to (+ 1 (plus 2 3))

mexpand-1

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

mexpand

like clojure.core/macroexpand, but handles symbol macros

mexpand-all

full recursive macro expansion

name-with-attributes

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.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 Rich Hickey. All rights reserved. The use and distribution terms for this software are covered by the Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php) 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.

Something went wrong with that request. Please try again.