How are clojurelisp programs modeled as a diagram

Questions

I ve tried wedging my clojure diagrams into what s available in UML, using class-blocks as the file-level namespaces and dependency links to show relationships, but it s awkward and tends to discourage functional patterns. I ve also tried developing ad-hoc solutions, but I can t discover a solution that works as well as UML with, say, Java (simple directed graphs seem to work in a vague manner, but this the results aren t detailed enough). Furthermore, I m not finding anything on the web about this.

Just to be clear, I m not trying to do anything fancy like code generation; I m just talking about pen-and-paper diagrams mostly for my own benefit. I m assuming I m not the first person to have ever considered this for a lisp language.

What solutions have been proposed? Are there any commonly-used standards? What do you recommend? What tools do you use?

Answers

It depends on what you want to describe in your program.

  Dependencies   

Use class diagrams to model the dependencies between namespaces; in this case, it s more clear if you use packages instead of classes in a diagram.

You can also use class diagrams to model dependencies between actors

  Data flow   

http://en.wikipedia.org/wiki/Communication_diagram http://en.wikipedia.org/wiki/Communication_diagram

Or, in the case of actors, depict each actor as an entity and each message as a method.

In any case, it s not useful to try and describe the algorithm of your program in UML. In my experience, they are better described in comments in the source file.

Source

License : cc by-sa 3.0

http://stackoverflow.com/questions/5158155/how-are-clojure-lisp-programs-modeled-as-a-diagram

Related