Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
---- What is this? ---- Antro is a profiler for ant build scripts. It allows to view a complete trace of the build annotated with timing information and to view by-line statistics for the build scripts involved. ---- Usage ---- To profile a build script, one has to 1) run ant with antro attached as a listener; this will produce a report 2) run antro GUI and open the report 3) stare at the report until the bottlenecks become clear 1) Do something like this: ant -listener ru.jkff.antro.ProfileListener -lib ~/antro/antro.jar build.xml The report will be written to the current directory, unless overridden with -Dantro.dir=/where/to/write/the/report. 2) Just run antro.jar with java -jar antro.jar or double-click antro.jar (in Windows). 3) The GUI is rather obvious to use: it has a trace view, a bar view and a line view. The trace view is a trace of the whole build, annotated with how much time each task/target/subbuild took. Builds/subbuilds look like [my-project] Targets look like #compile-and-jar Tasks look like <javac> The bar view shows an overview of the selected trace node. Each bar corresponds to a trace node and can be hovered, clicked or double-clicked. When hovered, a tooltip appears. When clicked, the node is highlighted in the bar view and also highlighted are usages of the same source line in the bar view. When double-clicked, the double-clicked node becomes root for the bar view and is selected in the tree. The line view speaks for itself. Keys: (inspired by IntelliJ IDEA (tm)) - F4 in trace: Select corresponding source line in the line view - Ctrl-Shift-F7 in trace or line view: highlight usages of the corresponding line in the trace ---- History ---- 02 Oct 2008 - version 0.52 Accepted patch: format filenames as Windows-friendly ISO8601 - thanks, my anonymous friend! By-line statistics for recursive tasks is now correct Todo section added below 04 Apr 2008 - version 0.51 Fixed bug with handling of -Dantro.dir=.. (it was not handled at all) (not long before that) - initial release ---- Todo ---- In order of decreasing priority - Show time statistics by leaf tasks, sorted by time percent (like, javac took 80% of the time) - Show a vertical scrollbar in the bar view - Support displaying the min/max/first call stacks for a line on a double-click on the corresponding column (the info is present in the json report, it is just not shown) - Support F3/Shift-F3 keys for 'cycle between usages'