Generate dependency graph(s) for variables in Clojure(Script) namespaces.
Add an alias for morpheus in your deps.edn.
{:aliases
{:morpheus {:extra-deps {thomasa/morpheus {:git/url "https://github.com/benedekfazekas/morpheus.git"
:git/sha "6d7d8ccc1dd58ef2d4d9c781486303cf1082b899"}}
:main-opts ["-m" "thomasa.morpheus.main"]}}}Run it in your project, provide directory to generate output files into -- directory needs to exist, format -- png, svg and dot is supported, latter is default -- and a list of paths to analyse.
Morpheus will generate a two files per project variable. One file with a given var's dependency graph where nodes are other variables in the project or in one of the dependencies of the project. The other file will show the usages of a project variable. Usages graphs are also generated for external vars, eg. vars of the dependencies of the project. For example:
clj -M:morpheus -d graphs -f png src test
Use -r option to generate graphs only for a given var and its dependencies. For example
clj -M:morpheus -d graphs -f png -r 'thomasa.morpheus.core/filename' src test
Use -e option to exclude some vars from the graphs generated by morpheus. For example
clj -M:morpheus -d graphs -f png -e 'clojure.core/.*|:clj-kondo/unknown-namespace/.*' src test
to filter out all clojure core vars and references to java interop calls.
For anything else than a dot file you need to have graphiz installed. Alternatively you can use a viewer online, for example edotor.
If you generate svg format you can leverage the references added to the graph nodes and the edges (arrows) between the nodes. You can navigate to subgraphs in your dependency tree by clicking an edge between two nodes. And toggle between the dependency graph and the usages graph by clicking a node. This means navigation has CHANGED compared to previous versions where clicking a node navigated to the subgraph.
Dependency graph
Usages graph
Uses clj-kondo to analyse namespaces under provided paths.