Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

updating documentation

  • Loading branch information...
commit 1a9fcb8e552ad1499f75b94c2021a3d5a4ba5f0d 1 parent 4cf4eff
Jake Scruggs authored April 30, 2009
155  README
... ...
@@ -1,154 +1 @@
1  
-Version 0.9.0
2  
-http://github.com/jscruggs/metric_fu
3  
-
4  
-Metric_fu began its life as a plugin for Rails that generated code metrics reports.  As of version 0.7.0, metric_fu is a gem owing to the excellent work done by Sean Soper.  
5  
-
6  
-Metric_fu is a set of rake tasks that make it easy to generate metrics reports.  It uses Saikuro, Flog, Rcov, and Rails' built-in stats task to create a series of reports.  It's designed to integrate easily with CruiseControl.rb by placing files in the Custom Build Artifacts folder.
7  
-
8  
-****Installation****
9  
-sudo gem install jscruggs-metric_fu -s http://gems.github.com
10  
-
11  
-Then in your Rakefile:
12  
-require 'metric_fu'
13  
-
14  
-If you like to vendor gems, you can unpack metric_fu into vendor/gems and require it like so:
15  
-require 'vendor/gems/jscruggs-metric_fu-0.9.0/lib/metric_fu'
16  
-
17  
-then you don't have to install it on every box you run it on.
18  
-
19  
-Important note:
20  
-You must have Rcov and Flog installed to get coverage and flog reports.  Metric_fu requires both of these gems so they will be installed when you install the metric_fu gem.
21  
-
22  
-
23  
-****Usage****
24  
-
25  
-Out of the box metrics provides these tasks:
26  
-rake metrics:all                  # Generate coverage, cyclomatic complexity, flog, flay, railroad and churn reports
27  
-rake metrics:churn                # Which files change the most
28  
-rake metrics:coverage             # Generate and open coverage report
29  
-rake metrics:coverage:clean       # Delete aggregate coverage data.
30  
-rake metrics:coverage:clobber_do  # Remove rcov products for do
31  
-rake metrics:coverage:do          # RCov task to generate report
32  
-rake metrics:flay                 # Generate code duplication report with flay
33  
-rake metrics:flog:all             # Generate and open flog report
34  
-rake metrics:flog:clean           # Delete aggregate flog data.
35  
-rake metrics:flog:controllers     # Flog code in app/controllers
36  
-rake metrics:flog:custom          # Generate a flog report from specified directories
37  
-rake metrics:flog:helpers         # Flog code in app/helpers
38  
-rake metrics:flog:lib             # Flog code in lib
39  
-rake metrics:flog:models          # Flog code in app/models
40  
-rake metrics:reek                 # A code smell report using Reek
41  
-rake metrics:saikuro              # A cyclomatic complexity report using Saikuro
42  
-
43  
-Rails projects also have the following tasks:
44  
-
45  
-rake metrics:stats                 # A stats report
46  
-
47  
-See below for more detail on the individual tasks.  It's recommended to use CruiseControl.rb to set up a metrics build.  See the CruiseControl.rb online docs for more info on how to set up cc.rb and, once you've got that figured out, change the cruise_config.rb file inside your project to have these lines:
48  
-
49  
-project.rake_task = 'metrics:all_with_migrate'
50  
-project.scheduler.polling_interval = 24.hours
51  
-
52  
-Which will check for updates every 24 hours and run all the metrics rake tasks (migrating your test db first).  The output will be visible from an individual build's detail page.
53  
-
54  
-
55  
-****Notes on configuration****
56  
-
57  
-Metric_fu can be customized to your liking by adding the following to your Rakefile
58  
-
59  
-MetricFu::Configuration.run do |config|
60  
-  #define which metrics you want to use
61  
-  config.metrics          = [:coverage, :flog]
62  
-  config.churn    = { :start_date => lambda{ 3.months.ago } }  
63  
-  config.coverage = { :test_files => ['test/**/test_*.rb'] }
64  
-  config.flog     = { :dirs_to_flog => ['cms/app', 'cms/lib']  }
65  
-  config.flay     = { :dirs_to_flay => ['cms/app', 'cms/lib']  }  
66  
-  config.saikuro  = { "--warn_cyclo" => "3", "--error_cyclo" => "4" }
67  
-end
68  
-
69  
-
70  
-****Notes on metrics:coverage****
71  
-
72  
-When creating a coverage report, metric_fu runs all the tests in the test folder and specs in spec folder using Rcov.
73  
-You can configure the coverage test files pattern:
74  
-  config.coverage[:test_files] = ['test/**/test_*.rb']
75  
-
76  
-The default value is ['test/**/*_test.rb', 'spec/**/*_spec.rb']
77  
-
78  
-You may also configure Rcov options:
79  
-  config.coverage = { :test_files => ['test/**/*_test.rb'],
80  
-                :rcov_opts => ["--exclude /gems/,/Library/"] }
81  
-                
82  
-The default value is  { :test_files => ['test/**/*_test.rb', 'spec/**/*_spec.rb'],
83  
-                        :rcov_opts => ["--sort coverage", "--html", "--rails", "--exclude /gems/,/Library/,spec"] }
84  
-
85  
-
86  
-****Notes on metrics:saikuro****
87  
-
88  
-Saikuro is bundled with metric_fu so you don't have to install it.  Look at the SAIKURO_README (or the internet) for more documentation on Saikuro.  If you wish to change the options Saikuro is run with, then set this constant in your configuration:
89  
-
90  
-  config.saikuro = { "--warn_cyclo" => "3", "--error_cyclo" => "4" }
91  
-
92  
-config.saikuro is a hash that gets merged with the default options hash.  The above example will set the warn_cyclo to 3 and the error_cyclo to 4 (which is way too low -- it's just an example) instructing Saikuro to flag methods with a higher cyclomatic complexity in it's report.
93  
-
94  
-If you want to have Saikuro look at multiple folders you can put something like this in your configuration:
95  
-
96  
-  config.saikuro = {"--input_directory" => '"cms/app | cms/lib"'}
97  
-
98  
-
99  
-****Notes on metrics:flay****
100  
-
101  
-Flay analyzes ruby code for structural similarities. 
102  
-You can configure which directories need to be flayed.
103  
-The defaults are 'lib' for non Rails projects and ['app', 'lib'] for Rails projects.
104  
-
105  
-  config.flay[:dirs_to_flay] = ['cms/app', 'cms/lib']
106  
-
107  
-
108  
-****Notes on metrics:flog****
109  
-
110  
-Flog is another way of measuring complexity (or tortured code as the Flog authors like to put it).  You should check out the awesome, and a little scary, Flog website for more info.
111  
-'rake metrics:flog:custom' allows you to specify a custom set of directories to Flog (in your configuration).
112  
-The defaults are 'lib' for non Rails projects and ['app', 'lib'] for Rails projects.
113  
-
114  
-  config.flog[:dirs_to_flog] = ['cms/app', 'cms/lib']
115  
-
116  
-
117  
-****Notes on metrics:reek****
118  
-
119  
-Reek detects common code smells in ruby code.
120  
-You can configure which directories need to be checked.
121  
-The defaults are 'lib' for non Rails projects and ['app', 'lib'] for Rails projects.
122  
-
123  
-  config.reek[:dirs_to_reek] = ['cms/app', 'cms/lib']
124  
-
125  
-
126  
-****Notes on metrics:roodi****
127  
-
128  
-Roodi parses your Ruby code and warns you about design issues you have based on the checks that is has configured.
129  
-You can configure which directories need to be checked.
130  
-The defaults are 'lib' for non Rails projects and ['app', 'lib'] for Rails projects.
131  
-
132  
-    config.roodi[:dirs_to_roodi] = ['cms/app', 'cms/lib']
133  
-
134  
-****Notes on metrics:stats****
135  
-
136  
-This is just 'rake stats' for Rails put into a file.  On my projects I like to be able to look at CruiseControl and get stats about the app at different points in time.
137  
-
138  
-
139  
-****Notes on metrics:churn****
140  
-
141  
-Files that change a lot in your project may be bad a sign.  This task uses "svn log" to identify those files and put them in a report.  The default is to start counting changes from the beginning of your project, which might be too far back so you can change like so:
142  
-
143  
-  config.churn = { :start_date => lambda{ 3.months.ago } }
144  
-
145  
-The Proc is there because '3.months.ago' only works when after the Rails Environment is loaded (and Rails extends Fixnum) which I didn't want to do every time you run a rake task.
146  
-
147  
-You can also change the minimum churn count like so:
148  
-
149  
-  config.churn = { :minimum_churn_count => 3 }
150  
-
151  
-
152  
-****Thanks****
153  
-
154  
-I'd like to thank the authors of Saikuro, Flog, Rcov, CruiseControl.rb, Flay, Reek, Roodi and Rails for creating such excellent open source products.  Also Andre Arko, Petrik de Heus, Sean Soper, Erik St Martin, Andy Gregorowicz, Bastien, Michael Schubert, Kurtis Seebaldt, Toby Tripp, Paul Gross, and Chirdeep Shetty for their help and advice.
  1
+See http://metric-fu.rubyforge.org/ for documentation, or the HISTORY file for a change log.
206  home_page/index.html
@@ -27,22 +27,18 @@
27 27
             <li>
28 28
                 <h2>Links</h2>
29 29
                 <ul>
30  
-                    <li><a href="http://rubyforge.org/projects/metric-fu/">
31  
-                        Summary
32  
-                        </a>
33  
-                    </li>
34  
-                    <li><a href="http://rubyforge.org/forum/?group_id=6142">
35  
-                        Forums
36  
-                        </a>
37  
-                    </li>
38  
-                    <li><a href="http://rubyforge.org/tracker/?group_id=6142">
39  
-                        Tracker
  30
+                    <li><a href="http://groups.google.com/group/metric_fu">
  31
+                        Google Group
40 32
                         </a>
41 33
                     </li>
42 34
                     <li><a href="http://github.com/jscruggs/metric_fu">
43 35
                         SCM
44 36
                         </a>
45 37
                     </li>
  38
+                    <li><a href="http://jakescruggs.blogspot.com/">
  39
+                        Jake Scruggs' Blog (lead developer)
  40
+                        </a>
  41
+                    </li>
46 42
                 </ul>
47 43
             </li>
48 44
         </ul>
@@ -50,7 +46,7 @@
50 46
     <!-- end #sidebar -->
51 47
     </div>
52 48
 <div id="left">
53  
-            <h1>About metric_fu 0.9.0</h1>
  49
+            <h1>About metric_fu 1.0.0</h1>
54 50
             <div>
55 51
 <p><br/>
56 52
     Metric_fu is a set of rake tasks that make it easy to generate metrics reports.  It uses 
@@ -68,51 +64,15 @@
68 64
     by placing files in the Custom Build Artifacts folder.
69 65
 </p>
70 66
 <br/>
71  
-
72  
-<p><br/>
73  
-    <h2>Output:</h2>
74  
-    <a href="cc.rb.gif">
75  
-        <img width="300" height="200" src="cc.rb.gif"
76  
-                alt="cruise control"/>
77  
-    </a>
78  
-    <a href="churn.gif">
79  
-        <img width="240" height="133" src="churn.gif"
80  
-                alt="churn"/>
81  
-    </a>
82  
-    <a href="flog.gif">
83  
-        <img width="322" height="110" src="flog.gif"
84  
-                alt="flog"/>
85  
-    </a>
86  
-    <a href="cyclomatic.gif">
87  
-        <img width="225" height="102" src="cyclomatic.gif"
88  
-                alt="cyclomatic"/>
89  
-    </a>
90  
-    <br/>
91  
-    <a href="flay.gif">
92  
-        <img width="326" height="115" src="flay.gif"
93  
-                alt="flay"/>
94  
-    </a>
95  
-    <br/>
96  
-    <a href="rcov.gif">
97  
-        <img width="322" height="100" src="rcov.gif"
98  
-                alt="rcov"/>
99  
-    </a>
100  
-    <a href="stats.gif">
101  
-        <img width="322" height="100" src="stats.gif"
102  
-                alt="stats"/>
103  
-    </a>  
104  
-    <a href="roodi.gif">
105  
-        <img width="322" height="122" src="roodi.gif"
106  
-                alt="Roodi"/>
107  
-    </a>
108  
-    <a href="reek.gif">
109  
-        <img width="395" height="140" src="reek.gif"
110  
-                alt="Reek"/>
111  
-    </a>
112  
-</p>  
  67
+<p>
  68
+  The big new feature in metric_fu 1.0.0 is yaml serialization of the metrics.  Running metric_fu now generates, in addition to html reports, a report.yml file.  You can consume this file to mash up metrics, track them, or whatever you desire.  Many thanks go to <a href="http://github.com/gmcinnes">Grant McInnes</a> for his work on this feature.
  69
+</p>
113 70
 <h2>Installation:</h2>
114  
-<p>First do this:</p>
115  
-<pre>sudo gem install jscruggs-metric_fu -s http://gems.github.com/</pre>
  71
+<p>If you haven't added github to your gem sources do this:</p>
  72
+<pre>sudo gem sources -a http://gems.github.com</pre>
  73
+<br/>
  74
+<p>Now install the gem:</p>
  75
+<pre>sudo gem install jscruggs-metric_fu</pre>
116 76
 <br/>
117 77
 <p>Then in your Rakefile:</p>
118 78
 <br/>
@@ -122,25 +82,24 @@
122 82
 If you like to vendor gems, you can unpack metric_fu into vendor/gems and require it like so:
123 83
 </p>
124 84
 <br/>
125  
-<pre>require(File.join(RAILS_ROOT, 'vendor', 'gems', 'jscruggs-metric_fu-0.9.0', 'lib', 'metric_fu'))</pre>
  85
+<pre>require(File.join(RAILS_ROOT, 'vendor', 'gems', 'jscruggs-metric_fu-1.0.0', 'lib', 'metric_fu'))</pre>
126 86
 <br/>
127 87
 <p>Then you don't have to install it on every box you run it on.</p>
128 88
 <br/>
129 89
 <p>Later versions of Rails like to manage your gems for you, so you can put this in your environment.rb file:</p>
130 90
 <br/>
131  
-<pre>config.gem 'jscruggs-metric_fu', :version => '0.9.0', :lib => 'metric_fu', :source => 'http://gems.github.com'</pre>
  91
+<pre>config.gem 'jscruggs-metric_fu', :version => '1.0.0', :lib => 'metric_fu', :source => 'http://gems.github.com'</pre>
132 92
 <br/>
133  
-<p>And then issue these commands:</p>
  93
+<p>And then issue this command:</p>
134 94
 <br/>
135 95
 <pre>
136 96
   $ rake gems:install
137  
-  $ rake gems:unpack
138 97
 </pre>
139 98
 <br/>
140  
-<p>That way Rails won't yell at you everytime you run a Rake task:</p>
  99
+<p>That way Rails won't yell at you every time you run a Rake task:</p>
141 100
 <br/>
142 101
 <pre>
143  
-  config.gem: Unpacked gem jscruggs-metric_fu-0.9.0 in vendor/gems has no specification file. Run 'rake gems:refresh_specs' to fix this.
  102
+  config.gem: Unpacked gem jscruggs-metric_fu-1.0.0 in vendor/gems has no specification file. Run 'rake gems:refresh_specs' to fix this.
144 103
 </pre>
145 104
 <br/>
146 105
 <p>
@@ -149,49 +108,51 @@
149 108
 
150 109
 <p><br/>
151 110
     <h2>Usage:</h2>
152  
-    Out of the box metric_fu provides these tasks:
  111
+    Out of the box metric_fu provides this tasks:
153 112
     <ul>
154  
-      <li>rake metrics:all               # Generate coverage, cyclomatic complexity, flog, flay, railroad, reek, roodi, stats... </li>
155  
-      <li>rake metrics:all_with_migrate  # Generate metrics after migrating (for continuous integration)                         </li>
156  
-      <li>rake metrics:churn             # Which files change the most                                                           </li>
157  
-      <li>rake metrics:flay              # Generate code duplication report with flay                                            </li>
158  
-      <li>rake metrics:flog:all          # Generate and open flog report                                                         </li>
159  
-      <li>rake metrics:flog:clean        # Delete aggregate flog data.                                                           </li>
160  
-      <li>rake metrics:flog:controllers  # Flog code in app/controllers                                                          </li>
161  
-      <li>rake metrics:flog:custom       # Generate a flog report from specified directories                                     </li>
162  
-      <li>rake metrics:flog:helpers      # Flog code in app/helpers                                                              </li>
163  
-      <li>rake metrics:flog:lib          # Flog code in lib                                                                      </li>
164  
-      <li>rake metrics:flog:models       # Flog code in app/models                                                               </li>
165  
-      <li>rake metrics:reek              # A code smell report using Reek                                                        </li>
166  
-      <li>rake metrics:roodi             # A Ruby coding standards report using Roodi                                            </li>
167  
-      <li>rake metrics:saikuro           # A cyclomatic complexity report using Saikuro                                          </li>
168  
-      <li>rake metrics:stats             # A stats report                                                                        </li>
  113
+      <li>rake metrics:all # Generate coverage, cyclomatic complexity, flog, flay, railroad, reek, roodi, stats... </li>
169 114
     </ul>                
170 115
     <br/>
171  
-    See below for more detail on the individual tasks.  I recommend using CruiseControl.rb to set up a metrics build.  See the CruiseControl.rb online docs for more info on how to set up cc.rb and, once you've got that figured out, change the cruise_config.rb file inside your project to have these lines:
  116
+    I recommend using CruiseControl.rb to set up a metrics build.  See the CruiseControl.rb online docs for more info on how to set up cc.rb and, once you've got that figured out, change the cruise_config.rb file inside your project to have these lines:
172 117
 <br/><br/>
173  
-    <pre>project.rake_task = 'metrics:all_with_migrate'</pre>
  118
+    <pre>project.rake_task = 'metrics:all'</pre>
174 119
     <pre>project.scheduler.polling_interval = 24.hours</pre>
175 120
 <br/>
176  
-    Which will check for updates every 24 hours and run all the metric_fu rake tasks (migrating your test db first).  The output will be visible from an individual build's detail page.  Like so:
  121
+    Which will check for updates every 24 hours and run all the metric_fu rake tasks (migrating your test db first).  The output will be visible from an individual build's detail page.
177 122
 </p>
178 123
 <br/>
179  
-<a href="cc.rb.gif">
180  
-    <img width="300" height="200" src="cc.rb.gif"
181  
-            alt="cruise control"/>
182  
-</a>
183  
-<p><br/>
184  
-    <h2>General notes on configuration:</h2>
185  
-    <p>Metric_fu can be customized to your liking by adding the following to your Rakefile:</p>
  124
+
  125
+    <h2>Configuration:</h2>
  126
+    <p>You need to run the Configuration in your rakefile in order for metric_fu to work.  If you just want to accept the defaults do this:</p>
  127
+    <pre>
  128
+    MetricFu::Configuration.run {}
  129
+    </pre>
  130
+    <p>Metric_fu can be customized to your liking by altering the defaults in your Rakefile:</p>
186 131
     <pre>
187  
-    MetricFu::Configuration.run do |config|
188  
-      #define which metrics you want to use
189  
-      config.metrics          = [:coverage, :flog]
190  
-      config.churn    = { :start_date => lambda{ 3.months.ago } }  
191  
-      config.coverage = { :test_files => ['test/**/test_*.rb'] }
192  
-      config.flog     = { :dirs_to_flog => ['cms/app', 'cms/lib']  }
193  
-      config.flay     = { :dirs_to_flay => ['cms/app', 'cms/lib']  }  
194  
-      config.saikuro  = { "--warn_cyclo" => "3", "--error_cyclo" => "4" }
  132
+      MetricFu::Configuration.run do |config|
  133
+        #define which metrics you want to use
  134
+        config.metrics  = [:churn, :saikuro, :stats, :flog, :flay, :reek, :roodi, :rcov]
  135
+        config.flay     = { :dirs_to_flay => ['app', 'lib']  } 
  136
+        config.flog     = { :dirs_to_flog => ['app', 'lib']  }
  137
+        config.reek     = { :dirs_to_reek => ['app', 'lib']  }
  138
+        config.roodi    = { :dirs_to_roodi => ['app', 'lib'] }
  139
+        config.saikuro  = { :output_directory => 'scratch_directory/saikuro', 
  140
+                            :input_directory => ['app', 'lib'],
  141
+                            :cyclo => "",
  142
+                            :filter_cyclo => "0",
  143
+                            :warn_cyclo => "5",
  144
+                            :error_cyclo => "7",
  145
+                            :formater => "text"} #this needs to be set to "text"
  146
+        config.churn    = { :start_date => "1 year ago", :minimum_churn_count => 10}
  147
+        config.rcov     = { :test_files => ['test/**/*_test.rb', 
  148
+                                            'spec/**/*_spec.rb'],
  149
+                            :rcov_opts => ["--sort coverage", 
  150
+                                           "--no-html", 
  151
+                                           "--text-coverage",
  152
+                                           "--no-color",
  153
+                                           "--profile",
  154
+                                           "--rails",
  155
+                                           "--exclude /gems/,/Library/,spec"]}
195 156
     end
196 157
     </pre>
197 158
 </p>
@@ -202,92 +163,49 @@
202 163
 </p>
203 164
 <p><br/>
204 165
     <h2>Notes on metrics:saikuro</h2>
205  
-    Saikuro is bundled with metric_fu so you don't have to install it.  Look at the SAIKURO_README (or the internet) for more documentation on Saikuro.  If you wish to change the options Saikuro is run with, then set it like so in your Rakefile:
  166
+    Saikuro is bundled with metric_fu so you don't have to install it.  Look at the SAIKURO_README (or the internet) for more documentation on Saikuro.
206 167
 <br/><br/>
207  
-<pre>
208  
-    config.saikuro = { "--warn_cyclo" => "3", "--error_cyclo" => "4" }
209  
-</pre>
210  
-<br/>
211  
-    MetricFu::SAIKURO_OPTIONS is a hash that gets merged with the default options hash.  The above example will set the warn_cyclo to 3 and the error_cyclo to 4 (which is way too low -- it's just an example) instructing Saikuro to flag methods with a higher cyclomatic complexity in it's report.
212  
-    <br/>
213  
-    <br/>
214  
-    If you want to have Saikuro look at multiple folders you can put something like this in you rakefile:
215  
-    <br/>
216  
-    <br/>
217  
-<pre>
218  
-    config.saikuro = {"--input_directory" => '"cms/app | cms/lib"'}
219  
-</pre>
220 168
 </p>
221 169
 <p><br/>
222 170
     <h2>Notes on metrics:flay</h2>
223 171
     Flay analyzes ruby code for structural similarities. 
224 172
     You can configure which directories need to be flayed.
225 173
     The defaults are 'lib' for non Rails projects and ['app', 'lib'] for Rails projects.
226  
-    You can customize the directories analyzed like so: 
227 174
 </p>
228  
-<pre>
229  
-    config.flay[:dirs_to_flay] = ['cms/app', 'cms/lib']
230  
-</pre>
231 175
 
232 176
 <p><br/>
233 177
     <h2>Notes on metrics:flog</h2>
234 178
     Flog is another way of measuring complexity (or tortured code as the Flog authors like to put it).  You should check out the awesome, and a little scary, <a href="http://ruby.sadi.st/Flog.html">Flog website</a> for more info.
235 179
 </p>
236  
-<p>
237  
-    <br/>
238  
-    'rake metrics:flog:custom' allows you to specify a custom set of directories to Flog (in your rakefile) like so:
239  
-    <br/>
240  
-    <br/>
241  
-<pre>
242  
-    config.flog[:dirs_to_flog] = ['cms/app', 'cms/lib'] 
243  
-</pre>
244  
-</p>
245 180
 <p><br/>
246 181
     <h2>Notes on metrics:reek</h2>
247 182
     Reek detects common code smells in ruby code.
248 183
     You can configure which directories need to be checked.
249 184
     The defaults are 'lib' for non Rails projects and ['app', 'lib'] for Rails projects.
250  
-    You can customize the directories analyzed like so:
251 185
 </p>
252  
-<pre>
253  
-    config.reek[:dirs_to_reek] = ['cms/app', 'cms/lib']] 
254  
-</pre>
  186
+
255 187
 <p><br/>
256 188
     <h2>Notes on metrics:roodi</h2>
257 189
     Roodi parses your Ruby code and warns you about design issues you have based on the checks that is has configured.
258 190
     You can configure which directories need to be checked.
259 191
     The defaults are 'lib' for non Rails projects and ['app', 'lib'] for Rails projects.
260  
-    You can customize the directories analyzed like so:
261 192
 </p>
262  
-<pre>
263  
-    config.roodi[:dirs_to_roodi] = ['cms/app', 'cms/lib']
264  
-</pre>
265 193
 <p><br/>
266 194
     <h2>Notes on metrics:stats</h2>
267 195
     This is just 'rake stats' put into a file.  On my projects I like to be able to look at CruiseControl and get stats about the app at different points in time.
268 196
 </p>
269 197
 <p><br/>
270 198
     <h2>Notes on metrics:churn</h2>
271  
-    Files that change a lot in your project may be bad a sign.  This task uses svn or git's log to identify those files and put them in a report.  The default is to start counting changes from the beginning of your project, which might be too far back so you can change like so:
272  
-<br/><br/>
273  
-<pre>
274  
-    config.churn = { :start_date => lambda{ 3.months.ago } }
275  
-</pre>
  199
+    Files that change a lot in your project may be bad a sign.  This task uses svn or git's log to identify those files and put them in a report.
276 200
 <br/>
277  
-    The Proc is there because '3.months.ago' only works after the Rails Environment is loaded (and Rails extends Fixnum) which I didn't want to do every time you run a rake task.
278  
-<br/>
279  
-<br/>
280  
-    You can also change the minimum churn count like so:
281  
-<br/>
282  
-<br/>
283  
-<pre>
284  
-    config.churn = { :minimum_churn_count => 3 } 
285  
-</pre> 
286 201
 <br/>
287 202
 </p>
288 203
 <br/>
289 204
 <p>Metric_fu began its life as a plugin for Rails that generated code metrics reports.  As of version 0.7.0, metric_fu is a gem (owing to the excellent work done by Sean Soper) and is hosted on GitHub at <a href="http://github.com/jscruggs/metric_fu">http://github.com/jscruggs/metric_fu</a>. </p>
290 205
 <p><br/>   
  206
+    <h2>Questions?</h2>
  207
+    <p>Use the Google Group: <a href="http://groups.google.com/group/metric_fu">http://groups.google.com/group/metric_fu</a></p>
  208
+    <br/>
291 209
     <h2>Thanks</h2>
292 210
     I'd like to thank the authors of Saikuro, Subversion, Flog, Rcov, CruiseControl.rb, and Rails for creating such excellent open source products.  Also many thanks go to 
293 211
     <a href="http://arko.net/">Andre Arko</a>, 

0 notes on commit 1a9fcb8

Please sign in to comment.
Something went wrong with that request. Please try again.