Grape

Grape is a syntax-aware grep-like utility for Clojure code. It allows one to search for code patterns using Clojure structures.

Note: this is quite experimental for now.

Command-Line

java -jar grape.jar [-r|--recursive] <pattern> <file> [<file> ...]

Library

;; Lein/Boot
[bfontaine/grape "0.1.0"]

;; Deps
bfontaine/grape {:mvn/version "0.1.0"}

(require '[grape.core :as g])

(def my-code (slurp "myfile.clj"))

;; Find all occurrences of map called with three arguments
(g/find-codes my-code (g/pattern "(map $ $ $)"))

;; Find all occurrences of (condp = ...)
(g/find-codes my-code (g/pattern "(condp = $&)"))

;; Find all occurrences of `if` with no `else` clause
(g/find-codes my-code (g/pattern "(if $ $)"))

Patterns

A pattern is any valid Clojure expression. It can contain some special symbols that are interpreted as wildcards.

Comments, whitespaces, and discard reader macros (#_) are ignored when matching: [43] doesn't match #_ [43] 42 nor 42 ;; [43] but it matches [ 43 ].

Wildcards

• $: any expression. $ matches 42 and (defn f [] 42). (map $) matches (map inc) but not (map inc [1 2 3]).
• $&: any number of expressions, including zero. (f $&) matches (f), (f 1), (f 1 2), etc. There can be only one $& per sequence of expressions (contiguous $&s are equivalent to one $&).

Wildcards can be combined: #{$ $&} matches a set with at least one element.

License

Copyright © 2019 Baptiste Fontaine

This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which is available at http://www.eclipse.org/legal/epl-2.0.

This Source Code may also be made available under the following Secondary Licenses when the conditions for such availability set forth in the Eclipse Public License, v. 2.0 are satisfied: GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version, with the GNU Classpath Exception which is available at https://www.gnu.org/software/classpath/license.html.