-
Notifications
You must be signed in to change notification settings - Fork 1
GBench - The benchmarking module for Groovy
License
gperfutils/gbench
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
OVERVIEW -------- GBench is a benchmarking module for Groovy. It allows you to compare the performance of programs. GBench has two features: Benchmark Builder and Benchmark Transformation. Benchmark Builder allows you to correctly benchmark programs. Groovy is a difficult language to accurately benchmark. Method caching, dynamic optimization and garbage collection by JVM, there are many factors that interfere measurement. You can resolve the issues by using BenchmarkBuilder. See also "Right Groovy Benchmarking" at http://blog.masatonagai.com/2012/03/right-groovy-benchmarking.html for understanding what the "correctly" means. Benchmark Transformation allows you to measure methods’ execution time without additional code. VERSIONING ---------- GBench has different versions for different Groovy versions. [major].[minor].[maintenance]-groovy-[groovy_major].[groovy_minor] For example, the versions of GBench 0.4.3 that supports from Groovy 1.7 to Groovy 2.4 are: 0.4.3-groovy-1.7, 0.4.3-groovy-1.8, 0.4.3-groovy-2.0, 0.4.3-groovy-2.1, 0.4.3-groovy-2.2, 0.4.3-groovy-2.3, 0.4.3-groovy-2.4 DOWNLOADING ----------- Download a distribution from the Maven Central repository using a dependency manager of your choice. Groovy Grape @Grab(group='org.gperfutils', module='gbench', version='[version]') Apache Maven <dependency> <groupId>org.gperfutils</groupId> <artifactId>gbench</artifactId> <version>[version]</version> </dependency> Apache Ivy <dependency org="org.gperfutils" name="gbench" rev="[version]" /> BUILDING -------- Build from source using Ant. Distribution ant dist -Dskip.test=true Binary jar for a specific Groovy version ant binary -Dgroovy.version=[groovy_version] -Dskip.test=true EXAMPLES -------- Compare the performance of StringBuilder and StringBuffer using Benchmark Builder: def r = benchmark { // or new groovyx.gbench.BenchmarkBuilder().run { 'StringBuilder' { def sb = new StringBuilder() sb.append('foo') sb.append('bar') sb.append('baz') sb.toString() } 'StringBuffer' { def sb = new StringBuffer() sb.append('foo') sb.append('bar') sb.append('baz') sb.toString() } } r.prettyPrint() /* stdout: Environment =========== * Groovy: 2.4.0 * JVM: Java HotSpot(TM) 64-Bit Server VM (24.75-b04, Oracle Corporation) * JRE: 1.7.0_75 * Total Memory: 491.5 MB * Maximum Memory: 910.5 MB * OS: Mac OS X (10.10.1, x86_64) Options ======= * Warm Up: Auto (- 60 sec) * CPU Time Measurement: On user system cpu real StringBuilder 115 0 115 117 StringBuffer 132 0 132 133 */ Measure the execution time of a method using Benchmark Transformation: import groovyx.gbench.Benchmark class Task { @Benchmark void run() { // task } } /* stdout: Task void run() user:847000 system:1777000 cpu:2624000 real:4918000 */ LICENSE ------- GBench is licensed under the term of the Apache License, Version 2.0. See the file LICENSE for the full license.
About
GBench - The benchmarking module for Groovy
Resources
License
Stars
Watchers
Forks
Packages 0
No packages published