Liking cljdoc? Tell your friends :D

'Arrowic

O frabjous day! Callooh! Callay! Yet another tiny, incomplete clojure wrapper around a Java library!

In this case, the simplest directed graph viewer possible for those situation where you are in the process of interrogating some data and would like to how it looks as boxes and arrows.

I love graphviz as much as the next former-AT&T Research employee, but it's also rather nice to be able to generate an interactive graph layout from within emacs (or whatever your REPL of choice), tinker with it by hand, then export it to SVG.

The default graph style looks like this. There is also a rather large collection of styling options that are currently undocumented. See the arrowic.style namespace to get some idea of how to use styles.

If you’re building a Swing application (hopefully using seesaw), you can create a Swing component to display your graph using the as-swing-component function.

Usage

[arrowic "0.1.1-SNAPSHOT"]

A new empty graph is created using create-graph. The graph thus created can then be mutated in place inside of a with-graph form using insert-vertex! and insert-edge!.

(use '[arrowic.core])

;; grab some words from the UNIX dictionary
(def words
  (into [] (clojure.string/split-lines (slurp "/usr/share/dict/words"))))

;; make a random graph full of words
(defn random-graph []
  (with-graph (create-graph)
    (let [vertices (repeatedly 10 #(insert-vertex! (rand-nth words)))]
      (doseq [edge-label (repeatedly 20 #(rand-nth words))]
        (insert-edge! (rand-nth vertices) 
                      (rand-nth vertices)
                      :label edge-label)))))

(def graph (random-graph))

(def viewer (create-viewer graph))

(def another-graph (random-graph))

;; can change the currently viewed graph this way:
(view viewer another-graph)

;; export a graph to SVG
(spit "example.svg" (as-svg another-graph))

License

Copyright © 2017 Jack Rusher

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.

Edit on GitHub

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close