viiite 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (67) hide show
  1. data/CHANGELOG.md +5 -0
  2. data/Gemfile +25 -0
  3. data/Gemfile.lock +55 -0
  4. data/LICENCE.md +22 -0
  5. data/Manifest.txt +15 -0
  6. data/README.md +204 -0
  7. data/Rakefile +23 -0
  8. data/bin/viiite +4 -0
  9. data/examples/bench_iteration.rb +9 -0
  10. data/examples/bench_sort.eps +816 -0
  11. data/examples/bench_sort.rash +100 -0
  12. data/examples/bench_sort.rb +38 -0
  13. data/examples/raw.rash +6 -0
  14. data/lib/viiite/command/graph_style.rash +1 -0
  15. data/lib/viiite/command/help.rb +24 -0
  16. data/lib/viiite/command/plot.rb +88 -0
  17. data/lib/viiite/command/report.rb +47 -0
  18. data/lib/viiite/command/run.rb +23 -0
  19. data/lib/viiite/command/serie_style.rash +1 -0
  20. data/lib/viiite/command.rb +45 -0
  21. data/lib/viiite/formatter/plot.rb +38 -0
  22. data/lib/viiite/formatter.rb +5 -0
  23. data/lib/viiite/loader.rb +3 -0
  24. data/lib/viiite/runner.rb +59 -0
  25. data/lib/viiite/tms.rb +89 -0
  26. data/lib/viiite/version.rb +14 -0
  27. data/lib/viiite/viiite_file.rb +20 -0
  28. data/lib/viiite.rb +56 -0
  29. data/spec/fixtures/bench_iteration.rb +9 -0
  30. data/spec/integration/raw_data.rash +6 -0
  31. data/spec/integration/report/viiite_report_1.cmd +1 -0
  32. data/spec/integration/report/viiite_report_1.stdout +7 -0
  33. data/spec/integration/report/viiite_report_2.cmd +1 -0
  34. data/spec/integration/report/viiite_report_2.stdout +10 -0
  35. data/spec/integration/report/viiite_report_3.cmd +1 -0
  36. data/spec/integration/report/viiite_report_3.stdout +18 -0
  37. data/spec/integration/report/viiite_report_4.cmd +1 -0
  38. data/spec/integration/report/viiite_report_4.stdout +22 -0
  39. data/spec/integration/test_command.rb +33 -0
  40. data/spec/integration/viiite/viiite_help.cmd +1 -0
  41. data/spec/integration/viiite/viiite_help.stdout +25 -0
  42. data/spec/spec_helper.rb +23 -0
  43. data/spec/unit/command/test_run.rb +25 -0
  44. data/spec/unit/formatter/plot/test_to_data.rb +16 -0
  45. data/spec/unit/formatter/plot/test_to_dataset.rb +22 -0
  46. data/spec/unit/formatter/plot/test_to_plot.rb +21 -0
  47. data/spec/unit/test_runner.rb +57 -0
  48. data/spec/unit/test_viiite.rb +12 -0
  49. data/spec/unit/tms/test_coerce.rb +46 -0
  50. data/spec/unit/tms/test_divide.rb +26 -0
  51. data/spec/unit/tms/test_minus.rb +26 -0
  52. data/spec/unit/tms/test_plus.rb +34 -0
  53. data/spec/unit/tms/test_times.rb +26 -0
  54. data/spec/unit/tms/test_to_a.rb +11 -0
  55. data/spec/unit/tms/test_to_ruby_literal.rb +11 -0
  56. data/spec/unit/tms/test_to_s.rb +11 -0
  57. data/tasks/clean.rake +3 -0
  58. data/tasks/debug_mail.rake +78 -0
  59. data/tasks/debug_mail.txt +13 -0
  60. data/tasks/gem.rake +68 -0
  61. data/tasks/integration_test.rake +51 -0
  62. data/tasks/spec_test.rake +79 -0
  63. data/tasks/unit_test.rake +77 -0
  64. data/tasks/yard.rake +51 -0
  65. data/viiite.gemspec +192 -0
  66. data/viiite.noespec +40 -0
  67. metadata +297 -0
data/CHANGELOG.md ADDED
@@ -0,0 +1,5 @@
1
+ # 0.1.0 / 2011-08-20
2
+
3
+ * Enhancements
4
+
5
+ * Birthday!
data/Gemfile ADDED
@@ -0,0 +1,25 @@
1
+ source 'http://rubygems.org'
2
+
3
+ group :test do
4
+ gem "rake", "~> 0.9.2"
5
+ gem "rspec", "~> 2.6.0"
6
+ end
7
+
8
+ group :release do
9
+ gem "rake", "~> 0.9.2"
10
+ gem "rspec", "~> 2.6.0"
11
+ gem "wlang", "~> 0.10.2"
12
+ end
13
+
14
+ group :doc do
15
+ gem "yard", "~> 0.7.2"
16
+ gem "bluecloth", "~> 2.1.0"
17
+ gem "jekyll", "~> 0.11.0"
18
+ end
19
+
20
+ group :runtime do
21
+ gem "alf", "~> 0.10.0"
22
+ gem "quickl", "~> 0.4.0"
23
+ gem "gnuplot", "~> 2.3.6"
24
+ end
25
+
data/Gemfile.lock ADDED
@@ -0,0 +1,55 @@
1
+ GEM
2
+ remote: http://rubygems.org/
3
+ specs:
4
+ albino (1.3.3)
5
+ posix-spawn (>= 0.3.6)
6
+ alf (0.10.0)
7
+ myrrha (~> 1.2.0)
8
+ quickl (~> 0.4.0)
9
+ bluecloth (2.1.0)
10
+ classifier (1.3.3)
11
+ fast-stemmer (>= 1.0.0)
12
+ diff-lcs (1.1.2)
13
+ directory_watcher (1.4.0)
14
+ fast-stemmer (1.0.0)
15
+ gnuplot (2.3.6)
16
+ jekyll (0.11.0)
17
+ albino (>= 1.3.2)
18
+ classifier (>= 1.3.1)
19
+ directory_watcher (>= 1.1.1)
20
+ kramdown (>= 0.13.2)
21
+ liquid (>= 1.9.0)
22
+ maruku (>= 0.5.9)
23
+ kramdown (0.13.3)
24
+ liquid (2.2.2)
25
+ maruku (0.6.0)
26
+ syntax (>= 1.0.0)
27
+ myrrha (1.2.0)
28
+ posix-spawn (0.3.6)
29
+ quickl (0.4.0)
30
+ rake (0.9.2)
31
+ rspec (2.6.0)
32
+ rspec-core (~> 2.6.0)
33
+ rspec-expectations (~> 2.6.0)
34
+ rspec-mocks (~> 2.6.0)
35
+ rspec-core (2.6.4)
36
+ rspec-expectations (2.6.0)
37
+ diff-lcs (~> 1.1.2)
38
+ rspec-mocks (2.6.0)
39
+ syntax (1.0.0)
40
+ wlang (0.10.2)
41
+ yard (0.7.2)
42
+
43
+ PLATFORMS
44
+ ruby
45
+
46
+ DEPENDENCIES
47
+ alf (~> 0.10.0)
48
+ bluecloth (~> 2.1.0)
49
+ gnuplot (~> 2.3.6)
50
+ jekyll (~> 0.11.0)
51
+ quickl (~> 0.4.0)
52
+ rake (~> 0.9.2)
53
+ rspec (~> 2.6.0)
54
+ wlang (~> 0.10.2)
55
+ yard (~> 0.7.2)
data/LICENCE.md ADDED
@@ -0,0 +1,22 @@
1
+ # The MIT Licence
2
+
3
+ Copyright (c) 2011 - Bernard Lambeau
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining
6
+ a copy of this software and associated documentation files (the
7
+ "Software"), to deal in the Software without restriction, including
8
+ without limitation the rights to use, copy, modify, merge, publish,
9
+ distribute, sublicense, and/or sell copies of the Software, and to
10
+ permit persons to whom the Software is furnished to do so, subject to
11
+ the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be
14
+ included in all copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
19
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
20
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
21
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
22
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
data/Manifest.txt ADDED
@@ -0,0 +1,15 @@
1
+ viiite.gemspec
2
+ viiite.noespec
3
+ CHANGELOG.md
4
+ Gemfile
5
+ Gemfile.lock
6
+ bin/**/*
7
+ examples/**/*
8
+ lib/**/*
9
+ LICENCE.md
10
+ Manifest.txt
11
+ Rakefile
12
+ README.md
13
+ spec/**/*
14
+ tasks/**/*
15
+ test/**/*
data/README.md ADDED
@@ -0,0 +1,204 @@
1
+ # Viiite
2
+
3
+ Viiite brings tools to benchmark and analyze the complexity of your algorithms.
4
+ It has been designed as an alternative to Benchmark that let your benchmarks
5
+ evolve smoothly from simple measures to more complex infrastructures.
6
+
7
+ [sudo] gem install viiite
8
+
9
+ Viiite uses [semantic versionning](http://semver.org) and has not yet reached the
10
+ public API required for 1.0.0. The safe way to require viiite for now is as
11
+ follows:
12
+
13
+ gem "viiite", "~> 0.1.0"
14
+
15
+ Learn more on the [github-pages of this project](http://blambeau.github.com/viiite)!
16
+
17
+ ## Links
18
+
19
+ * [Github pages with more documentation](http://blambeau.github.com/viiite)
20
+ * [Source code](http://github.com/blambeau/viiite)
21
+
22
+ ## From simple measures ...
23
+
24
+ ```ruby
25
+ require 'viiite'
26
+ n = 15000
27
+ Viiite.bm do |r|
28
+ r.report(:for) { for i in 1..n; a = "1"; end }
29
+ r.report(:times) { n.times do ; a = "1"; end }
30
+ r.report(:upto) { 1.upto(n) do ; a = "1"; end }
31
+ end
32
+ ```
33
+
34
+ ```terminal
35
+ $ viiite report bench_iteration.rb
36
+ +--------+-----------------------------------------------+
37
+ | :bench | :measure |
38
+ +--------+-----------------------------------------------+
39
+ | :for | 0.010000 0.000000 0.010000 ( 0.010454) |
40
+ | :times | 0.000000 0.000000 0.000000 ( 0.002448) |
41
+ | :upto | 0.000000 0.000000 0.000000 ( 0.002451) |
42
+ +--------+-----------------------------------------------+
43
+ ```
44
+
45
+ ## To more complex ones ...
46
+
47
+ ```ruby
48
+ require 'viiite'
49
+ n = 15000
50
+ Viiite.bm do |r|
51
+ r.variation_point :ruby, Viiite.which_ruby
52
+ r.report(:for) { for i in 1..n; a = "1"; end }
53
+ r.report(:times) { n.times do ; a = "1"; end }
54
+ r.report(:upto) { 1.upto(n) do ; a = "1"; end }
55
+ end
56
+ ```
57
+
58
+ ```terminal
59
+ $ rvm exec viiite run bench_iteration.rb | viiite report --hierarchy --regroup=viiite,ruby
60
+ +--------+--------------------------------------------------------------------+
61
+ | :bench | :measure |
62
+ +--------+--------------------------------------------------------------------+
63
+ | :for | +----------------+-----------------------------------------------+ |
64
+ | | | :ruby | :measure | |
65
+ | | +----------------+-----------------------------------------------+ |
66
+ | | | ruby 1.8.7 | 0.010000 0.000000 0.010000 ( 0.009677) | |
67
+ | | | ruby 1.9.3dev | 0.005000 0.000000 0.005000 ( 0.005175) | |
68
+ | | | jruby 1.6.3 | 0.071000 0.000000 0.071000 ( 0.071000) | |
69
+ | | +----------------+-----------------------------------------------+ |
70
+ | :times | +----------------+-----------------------------------------------+ |
71
+ | | | :ruby | :measure | |
72
+ | | +----------------+-----------------------------------------------+ |
73
+ | | | ruby 1.8.7 | 0.000000 0.000000 0.000000 ( 0.003275) | |
74
+ | | | ruby 1.9.3dev | 0.005000 0.000000 0.005000 ( 0.002634) | |
75
+ | | | jruby 1.6.3 | 0.028000 0.000000 0.028000 ( 0.028000) | |
76
+ | | +----------------+-----------------------------------------------+ |
77
+ | ... | ... |
78
+ ```
79
+
80
+ ## To awesomeness ...
81
+
82
+ ```ruby
83
+ require 'viiite'
84
+ Viiite.bm do |b|
85
+ b.variation_point :ruby, Viiite.which_ruby
86
+ b.range_over([100, 200, 300, 400, 500], :size) do |size|
87
+ b.range_over(1..5, :i) do
88
+ bench_case = Array.random(size)
89
+ b.report(:quicksort) { bench_case.quicksort }
90
+ b.report(:bubblesort){ bench_case.bubblesort }
91
+ end
92
+ end
93
+ end
94
+ ```
95
+
96
+ ```terminal
97
+ $ viiite plot bench_sort.rb -x size -y tms.total --graph=ruby --series=viiite --gnuplot | gnuplot
98
+
99
+ ruby 1.8.7
100
+
101
+ 0.35 ++-------+-------+--------+-------+--------+--------+-------+-------++
102
+ + + + + + + bubblesort **A*** +
103
+ | quicksort ##B###*A
104
+ 0.3 ++ ***++
105
+ | *** |
106
+ 0.25 ++ ** ++
107
+ | *** |
108
+ | *** |
109
+ 0.2 ++ *A* ++
110
+ | **** |
111
+ | **** |
112
+ 0.15 ++ *** ++
113
+ | **** |
114
+ | **A* |
115
+ 0.1 ++ ****** ++
116
+ | ****** |
117
+ 0.05 ++ ****A** ++
118
+ | ******** |
119
+ A**** + + + + + + +########B
120
+ 0 B################B################B#################B########-------++
121
+ 100 150 200 250 300 350 400 450 500
122
+
123
+
124
+ ruby 1.9.3dev
125
+
126
+ 0.1 ++-------+-------+--------+-------+--------+--------+-------+-------*A
127
+ + + + + + + bubblesort **A*** +
128
+ | quicksort **B### |
129
+ | ** |
130
+ 0.08 ++ *** ++
131
+ | *** |
132
+ | *A* |
133
+ | *** |
134
+ 0.06 ++ *** ++
135
+ | *** |
136
+ | *** |
137
+ 0.04 ++ *** ++
138
+ | **A* |
139
+ | **** |
140
+ | **** |
141
+ 0.02 ++ **** ++
142
+ | **A** |
143
+ | ****** |
144
+ + ******+ + + + + + +########B
145
+ 0 A**##############B################B#################B########-------++
146
+ 100 150 200 250 300 350 400 450 500
147
+ ```
148
+
149
+ ```terminal
150
+ $ viiite plot bench_sort.rb -x size -y tms.total --graph=viiite --series=ruby --gnuplot | gnuplot
151
+ bubblesort
152
+
153
+ 0.35 ++-------+-------+--------+-------+--------+--------+-------+-------++
154
+ + + + + + + ruby 1.8.7 **A*** +
155
+ | ruby 1.9.3dev ##B### |
156
+ 0.3 ++ ***++
157
+ | *** |
158
+ 0.25 ++ ** ++
159
+ | *** |
160
+ | *** |
161
+ 0.2 ++ *A* ++
162
+ | **** |
163
+ | **** |
164
+ 0.15 ++ *** ++
165
+ | **** |
166
+ | **A* |
167
+ 0.1 ++ ****** ########B
168
+ | ****** ####B######## |
169
+ 0.05 ++ ****A** ######### ++
170
+ | ******** ########B#### |
171
+ A**** ########B########+ + + + + +
172
+ 0 B########+-------+--------+-------+--------+--------+-------+-------++
173
+ 100 150 200 250 300 350 400 450 500
174
+
175
+
176
+ quicksort
177
+
178
+ 0.012 ++-------+-------+--------+-------+--------+-------+--------+------++
179
+ + + + + + + ruby 1.8.7+**A*** +
180
+ | ruby 1.9.3dev ##B### |
181
+ 0.01 ++ **A
182
+ | ****** |
183
+ | ****** |
184
+ 0.008 ++ A** ++
185
+ | ** |
186
+ | ** |
187
+ | * B
188
+ 0.006 ++ ** ##+
189
+ | ** ## |
190
+ | ** # |
191
+ 0.004 ++ * ## ++
192
+ | ** ## |
193
+ | ** ## |
194
+ 0.002 ++ ##B##############**A######## # ++
195
+ | ###### ****** ###### ## |
196
+ + ######+ + ******+ + + ##+## + +
197
+ 0 A****************A**------+-------+--------+-------B--------+------++
198
+ 100 150 200 250 300 350 400 450 500
199
+
200
+ ```
201
+
202
+ ## On the devel side
203
+
204
+ Fork the project on github ... and so on.
data/Rakefile ADDED
@@ -0,0 +1,23 @@
1
+ begin
2
+ gem "bundler", "~> 1.0"
3
+ require "bundler/setup"
4
+ rescue LoadError => ex
5
+ puts ex.message
6
+ abort "Bundler failed to load, (did you run 'gem install bundler' ?)"
7
+ end
8
+
9
+ # Dynamically load the gem spec
10
+ $gemspec_file = File.expand_path('../viiite.gemspec', __FILE__)
11
+ $gemspec = Kernel.eval(File.read($gemspec_file))
12
+
13
+ # We run tests by default
14
+ task :default => :test
15
+
16
+ #
17
+ # Install all tasks found in tasks folder
18
+ #
19
+ # See .rake files there for complete documentation.
20
+ #
21
+ Dir["tasks/*.rake"].each do |taskfile|
22
+ instance_eval File.read(taskfile), taskfile
23
+ end
data/bin/viiite ADDED
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env ruby
2
+ $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
3
+ require "viiite"
4
+ Viiite::Command.run(ARGV, __FILE__)
data/examples/bench_iteration.rb ADDED
@@ -0,0 +1,9 @@
1
+ require 'viiite'
2
+ n = 15000
3
+ Viiite.bm do |r|
4
+ r.variation_point :ruby, Viiite.which_ruby
5
+ r.report(:for) { for i in 1..n; a = "1"; end }
6
+ r.report(:times) { n.times do ; a = "1"; end }
7
+ r.report(:upto) { 1.upto(n) do ; a = "1"; end }
8
+ end
9
+