This directory contains code and data to visualize the contents of Go binaries.
Apply tools in order (Python 3 required):
-
go tool nm -size <binary file> | c++filt
and redirect to some file, e.g.symtab.txt
(provided with the Go toolchain.)
-
python3 tab2pydic.py
on the previously generated file, redirect to e.g.out.py
-
python3 simplify.py
on the previously generated file, redirect todata.js
specifically -
python3 -m http.server
-
open browser on https://localhost:8000/treemap_v3.html
For example:
docker run -v $GOPATH/bin/:/go/bin -p 8000:8000 odedp/go-binsize-viz -b /go/bin/dep
(Use -b
to target the Go executable.)
-
python3 -m http.server
-
open browser on https://localhost:8000/cockroach_sizes.html
This repo uses D3 visualization code inspired from / modifying the following sources:
-
Jacques Jahnichen's zoomable treemap at https://bl.ocks.org/JacquesJahnichen/42afd0cde7cbf72ecb81
-
ported to D3 v4 by Guglielmo Celata at https://bl.ocks.org/guglielmo/16d880a6615da7f502116220cb551498
The Python bits (and thus the Docker embedding) are licensed under the Affero GPL3. This requires derived software to also use AGPL3, and prevents network usage without distribution of source code.
The D3 / Javascript bits in app3.js
(see previous section) are currently
UNLICENSED. They cannot be reused in derived work or other applications
without direct permission from the original author.
The files in the js
subdirectory are imported from the D3.js project
(https://d3js.org/) and are licensed under the terms of the 3-Clause
BSD license.