The asdf-viz Reference Manual

Table of Contents

Next: , Previous: , Up: (dir)   [Contents][Index]

The asdf-viz Reference Manual

This is the asdf-viz Reference Manual, version 0.1, generated automatically by Declt version 2.4 "Will Decker" on Wed Jun 20 10:46:56 2018 GMT+0.


Next: , Previous: , Up: Top   [Contents][Index]

1 Introduction


* ASDF-VIZ

This is a set of command line utilities for visualizing various object hierarchies of a lisp system.
They are roswell-compatible command-line utilities distributed by quicklisp.
Command installation is done by =ros install asdf-viz=.


*NEWS Oct 20, 2017* We added another utility =call-graph-viz= which can visualize the call graph of a function.

*NEWS Nov 6, 2017* We added another utility =class-viz= which visualizes the class inheritances.

*NEWS Nov 25, 2017* We have a license flag -l / --licence for =asdf-viz=.

** asdf-viz -- visualizing the library dependencies of asdf systems.

+ Simple usage: =$ asdf-viz [output.png] [system-name]...=
+ Complex usage: =$ asdf-viz [[-e|--exclude SYSTEM]...] [-l|--license] PNG-PATH [SYSTEM...]=

Sample output of =asdf-viz -l asdf-viz.png asdf-viz= :

[[./asdf-viz.png]]

** call-graph-viz -- visualizing the call graph

#+begin_src 
Usage: call-graph-viz [options...] png-path

source options
  -s / --system SYSTEM : Quickload the system in the beginning. (specified multiple times, accumulates)
  -l / --load FILE     : Load the FILE before the visualization.(specified multiple times, accumulates)
  -r / --ros FILE      : Load a .ros script before the visualization. (specified multiple times, accumulates)
                         This avoids the problem of shebangs in roswell scripts.

filter options
  -p / --package PKG   : Limit the symbols to the package.      (specified multiple times, accumulates)
                         Package names are automatically upcased.
  -f / --function FN   : Specify the root nodes..               (specified multiple times, accumulates)
  -i / --include-outside-calls : Specifies if the leaf node can contain symbols outside the specified packages.

Examples:

call-graph-viz -s alexandria -p alexandria -f alexandria:symbolicate symbolicate.png
call-graph-viz -s alexandria -f alexandria:symbolicate symbolicate.png
 -- Visualize the call graph of alexandria:symbolicate .
    The second example has the same meaning, where -p option is inferred from the symbol package.

call-graph-viz -i -s alexandria -f alexandria:symbolicate symbolicate2.png
 -- Visualize the call graph of alexandria:symbolicate . Leaf nodes include symbols outside alexandria.

call-graph-viz -s alexandria -p alexandria alexandria.png
 -- Visualize the call graph of all external fbound symbols in alexandria
#+end_src

Example outputs:

[[./symbolicate.png]]

[[./symbolicate2.png]]

[[./alexandria.png]]

** class-viz -- visualizing the class hierarchy

#+begin_src 
Usage: class-viz [-s|--system system]* [png-path] [class names...]
Example: class-viz asdf.png asdf:component
Example: class-viz -s plump plump.png plump:node
#+end_src

Example outputs:

[[./asdf.png]]

[[./plump.png]]

** Dependencies

[[https://github.com/snmsts/roswell/][roswell]] and graphviz.

** Installation

+ =ros install asdf-viz=
+ set up PATH to include =.roswell/bin/= 

** Author

+ Masataro Asai (guicho2.71828@gmail.com)

* Copyright

Copyright (c) 2015 Masataro Asai (guicho2.71828@gmail.com)

* License

Licensed under the LLGPL License.



Next: , Previous: , Up: Top   [Contents][Index]

2 Systems

The main system appears first, followed by any subsystem dependency.


Previous: , Up: Systems   [Contents][Index]

2.1 asdf-viz

Author

Masataro Asai

Contact

guicho2.71828@gmail.com

License

LLGPL

Description

Visualizes the dependencies between asdf systems / Visualize the function call graph.

Version

0.1

Dependencies
Source

asdf-viz.asd (file)

Component

src (module)


Next: , Previous: , Up: Top   [Contents][Index]

3 Modules

Modules are listed depth-first from the system components tree.


Previous: , Up: Modules   [Contents][Index]

3.1 asdf-viz/src

Parent

asdf-viz (system)

Location

src/

Components

Next: , Previous: , Up: Top   [Contents][Index]

4 Files

Files are sorted by type and then listed depth-first from the systems components trees.


Previous: , Up: Files   [Contents][Index]

4.1 Lisp


Next: , Previous: , Up: Lisp files   [Contents][Index]

4.1.1 asdf-viz.asd

Location

asdf-viz.asd

Systems

asdf-viz (system)


Next: , Previous: , Up: Lisp files   [Contents][Index]

4.1.2 asdf-viz/src/asdf.lisp

Parent

src (module)

Location

src/asdf.lisp

Packages

asdf-viz

Exported Definitions

visualize-asdf-hierarchy (function)

Internal Definitions

Next: , Previous: , Up: Lisp files   [Contents][Index]

4.1.3 asdf-viz/src/call-graph.lisp

Parent

src (module)

Location

src/call-graph.lisp

Packages

asdf-viz.call-graph

Exported Definitions

visualize-callgraph (function)

Internal Definitions

Previous: , Up: Lisp files   [Contents][Index]

4.1.4 asdf-viz/src/class-hierarchy.lisp

Parent

src (module)

Location

src/class-hierarchy.lisp

Packages

asdf-viz.class-hierarchy

Exported Definitions

visualize-class-hierarchy (function)


Next: , Previous: , Up: Top   [Contents][Index]

5 Packages

Packages are listed by definition order.


Next: , Previous: , Up: Packages   [Contents][Index]

5.1 asdf-viz

Source

asdf.lisp (file)

Use List
Exported Definitions

visualize-asdf-hierarchy (function)

Internal Definitions

Next: , Previous: , Up: Packages   [Contents][Index]

5.2 asdf-viz.call-graph

Source

call-graph.lisp (file)

Use List
Exported Definitions

visualize-callgraph (function)

Internal Definitions

Previous: , Up: Packages   [Contents][Index]

5.3 asdf-viz.class-hierarchy

Source

class-hierarchy.lisp (file)

Use List
Exported Definitions

visualize-class-hierarchy (function)


Next: , Previous: , Up: Top   [Contents][Index]

6 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.


Next: , Previous: , Up: Definitions   [Contents][Index]

6.1 Exported definitions


Previous: , Up: Exported definitions   [Contents][Index]

6.1.1 Functions

Function: visualize-asdf-hierarchy TARGET-PNG &optional SEED-SYSTEMS MODE
Package

asdf-viz

Source

asdf.lisp (file)

Function: visualize-callgraph TARGET-PNG PKG-DESIGNATORS &key SEEDS INCLUDE-OUTSIDE-CALLS
Package

asdf-viz.call-graph

Source

call-graph.lisp (file)

Function: visualize-class-hierarchy TARGET-PNG &optional BASE-CLASSES
Package

asdf-viz.class-hierarchy

Source

class-hierarchy.lisp (file)


Previous: , Up: Definitions   [Contents][Index]

6.2 Internal definitions


Next: , Previous: , Up: Internal definitions   [Contents][Index]

6.2.1 Special variables

Special Variable: *excluded*
Package

asdf-viz

Source

asdf.lisp (file)

Special Variable: *license*
Package

asdf-viz

Source

asdf.lisp (file)


Next: , Previous: , Up: Internal definitions   [Contents][Index]

6.2.2 Functions

Function: belongs-to-packages PACKAGES FNAME
Package

asdf-viz.call-graph

Source

call-graph.lisp (file)

Function: callees SYMBOL
Package

asdf-viz.call-graph

Source

call-graph.lisp (file)

Function: dependency-name DEPENDENCY-DEF
Package

asdf-viz

Source

asdf.lisp (file)


Previous: , Up: Internal definitions   [Contents][Index]

6.2.3 Classes

Class: call-graph ()
Package

asdf-viz.call-graph

Source

call-graph.lisp (file)

Direct superclasses

standard-object (class)

Direct methods
  • graph-object-points-to (method)
  • graph-object-node (method)
  • graph-object-points-to (method)
  • graph-object-node (method)
  • graph-object-points-to (method)
  • graph-object-node (method)
Direct slots
Slot: packages

list of packages to limit the visualization of the call graph

Initargs

:packages

Slot: include-outside-calls

If the leaf node contains symbols outside PACKAGES

Initargs

:include-outside-calls


Previous: , Up: Top   [Contents][Index]

Appendix A Indexes


Next: , Previous: , Up: Indexes   [Contents][Index]

A.1 Concepts

Jump to:   A   F   L   M  
Index Entry  Section

A
asdf-viz.asd: The asdf-viz<dot>asd file
asdf-viz/src: The asdf-viz/src module
asdf-viz/src/asdf.lisp: The asdf-viz/src/asdf<dot>lisp file
asdf-viz/src/call-graph.lisp: The asdf-viz/src/call-graph<dot>lisp file
asdf-viz/src/class-hierarchy.lisp: The asdf-viz/src/class-hierarchy<dot>lisp file

F
File, Lisp, asdf-viz.asd: The asdf-viz<dot>asd file
File, Lisp, asdf-viz/src/asdf.lisp: The asdf-viz/src/asdf<dot>lisp file
File, Lisp, asdf-viz/src/call-graph.lisp: The asdf-viz/src/call-graph<dot>lisp file
File, Lisp, asdf-viz/src/class-hierarchy.lisp: The asdf-viz/src/class-hierarchy<dot>lisp file

L
Lisp File, asdf-viz.asd: The asdf-viz<dot>asd file
Lisp File, asdf-viz/src/asdf.lisp: The asdf-viz/src/asdf<dot>lisp file
Lisp File, asdf-viz/src/call-graph.lisp: The asdf-viz/src/call-graph<dot>lisp file
Lisp File, asdf-viz/src/class-hierarchy.lisp: The asdf-viz/src/class-hierarchy<dot>lisp file

M
Module, asdf-viz/src: The asdf-viz/src module

Jump to:   A   F   L   M  

Next: , Previous: , Up: Indexes   [Contents][Index]

A.2 Functions

Jump to:   B   C   D   F   V  
Index Entry  Section

B
belongs-to-packages: Internal functions

C
callees: Internal functions

D
dependency-name: Internal functions

F
Function, belongs-to-packages: Internal functions
Function, callees: Internal functions
Function, dependency-name: Internal functions
Function, visualize-asdf-hierarchy: Exported functions
Function, visualize-callgraph: Exported functions
Function, visualize-class-hierarchy: Exported functions

V
visualize-asdf-hierarchy: Exported functions
visualize-callgraph: Exported functions
visualize-class-hierarchy: Exported functions

Jump to:   B   C   D   F   V  

Next: , Previous: , Up: Indexes   [Contents][Index]

A.3 Variables

Jump to:   *  
I   P   S  
Index Entry  Section

*
*excluded*: Internal special variables
*license*: Internal special variables

I
include-outside-calls: Internal classes

P
packages: Internal classes

S
Slot, include-outside-calls: Internal classes
Slot, packages: Internal classes
Special Variable, *excluded*: Internal special variables
Special Variable, *license*: Internal special variables

Jump to:   *  
I   P   S  

Previous: , Up: Indexes   [Contents][Index]

A.4 Data types

Jump to:   A   C   P   S  
Index Entry  Section

A
asdf-viz: The asdf-viz system
asdf-viz: The asdf-viz package
asdf-viz.call-graph: The asdf-viz<dot>call-graph package
asdf-viz.class-hierarchy: The asdf-viz<dot>class-hierarchy package

C
call-graph: Internal classes
Class, call-graph: Internal classes

P
Package, asdf-viz: The asdf-viz package
Package, asdf-viz.call-graph: The asdf-viz<dot>call-graph package
Package, asdf-viz.class-hierarchy: The asdf-viz<dot>class-hierarchy package

S
System, asdf-viz: The asdf-viz system

Jump to:   A   C   P   S