gopkg.in/src-d/hercules.v10 (go): Package hercules contains the functions which are needed to gather various statistics from a Git repository.  The analysis is expressed in a form of the tree: there are nodes - "pipeline items" - which require some other nodes to be executed prior to selves and in turn provide the data for dependent nodes. There are several service items which do not produce any useful statistics but rather provide the requirements for other items. The top-level items include:  - BurndownAnalysis - line burndown statistics for project, files and developers.  - CouplesAnalysis - coupling statistics for files and developers.  - ShotnessAnalysis - structural hotness and couples, by any Babelfish UAST XPath (functions by default).  The typical API usage is to initialize the Pipeline class:  Then add the required analysis:  This call will add all the needed intermediate pipeline items. Then link and execute the analysis tree:  Finally extract the result:  The actual usage example is cmd/hercules/root.go - the command line tool's code.  You can provide additional options via `facts` on initialization. For example, to provide your own logger, enable people-tracking, and set a custom tick size:  Hercules depends heavily on https://github.com/src-d/go-git and leverages the diff algorithm through https://github.com/sergi/go-diff.  Besides, BurndownAnalysis involves File and RBTree. These are low level data structures which enable incremental blaming. File carries an instance of RBTree and the current line burndown state. RBTree implements the red-black balanced binary tree and is based on https://github.com/yasushi-saito/rbtree.  Coupling stats are supposed to be further processed rather than observed directly. labours.py uses Swivel embeddings and visualises them in Tensorflow Projector.  Shotness analysis as well as other UAST-featured items relies on [Babelfish](https://doc.bblf.sh) and requires the server to be running.
Keywords: burndown|git|git-analysis|machine-learning|mining-software-repositories|mloncode|tensorboard-visualizations|tensorflow