metric_fu 4.1.2 → 4.1.3

data/.travis.yml

@@ -1,11 +1,14 @@
 language: ruby
+bundler_args: --without development
+script: bundle exec rspec
+# gemfile:
+#   - gemfiles/Gemfile.ci
+# before_install: some_command
+# env:
+#   - "rack=1.3.4"
 rvm:
   - 2.0.0
   - 1.9.3
   - 1.9.2
   - jruby-19mode # JRuby in 1.9 mode
   - rbx-19mode
-matrix:
-  allow_failures:
-    - rvm: jruby-19mode
-    - rvm: rbx-19mode

data/.yardopts

@@ -0,0 +1,5 @@
+--no-private
+--readme README.md
+lib/metric_fu.rb
+lib/metric_fu_requires.rb
+lib/metric_fu/**/*.rb

data/CONTRIBUTING.md

@@ -1,19 +1,34 @@
 How to contribute:
 
-1. Fork metric_fu on github.
-2. bundle install
-3. Run the tests ('bundle exec rake')
-4. Run metric_fu on itself ('bundle exec metric_fu -r')
-5. Make the changes you want and back them up with tests.
-6. Make sure two important rake tests still run ('bundle exec rake' and 'bundle exec rake metrics:all')
-7. Commit and send me a pull request with details as to what has been changed.
+## Bug reports / Issues
 
-Extra Credit:
+  * Is something broken or not working as expected? Check for an existing issue or [create a new one](https://github.com/metricfu/metric_fu/issues/new)
+  * See [Quick guide to writing good bug reports](https://github.com/metricfu/metric_fu/wiki/Issues:-Quick-guide-to-writing-good-bug-reports)
 
-1. Make sure your changes work in 1.8.7, Ruby Enterprise Edition, and 1.9.3 (Hint use 'rvm' to help install multiple rubies)
-2. Update the documentation here or the rubyforge web page inside the `'home_page'` folder
-3. Update the History and give yourself credit.
+## Code
 
-The more of the above steps you do the easier it will be for me to merge in which will greatly increase you chances of getting your changes accepted.
+1. Clone the repo: `git clone git://github.com/metricfu/metric_fu.git && cd metric_fu`
+2. Install the gem dependencies: `bundle install`
+3. Make the changes you want and back them up with tests.
+  * Run the tests (`bundle exec rake`)
+  * Run metric_fu on itself (`bundle exec rake metrics:all`)
+4. Update the HISTORY.md file with your changes and give yourself credit
+5. Commit and create a pull request with details as to what has been changed and why
+  * Use well-described, small (atomic) commits.
+  * Include links to any relevant github issues.
+  * *Don't* change the VERSION file.
+6. Extra Credit: [Confirm it runs and tests pass on the rubies specified in the travis config](.travis.yml). I will otherwise confirm it runs on these.
 
-Also see [Quick guide to writing good bug reports](https://github.com/metricfu/metric_fu/wiki/Issues:-Quick-guide-to-writing-good-bug-reports)
+How I handle pull requests:
+
+* If the tests pass and the pull request looks good, I will merge it.
+* If the pull request needs to be changed,
+  * you can change it by updating the branch you generated the pull request from
+    * either by adding more commits, or
+    * by force pushing to it
+  * I can make any changes myself and manually merge the code in.
+
+## Documentation
+
+* If relevant, you may update [the metric_fu website](https://github.com/metricfu/metricfu.github.com) in a separate pull request to that repo
+* Update the wiki

data/Gemfile

@@ -1,10 +1,14 @@
 source 'https://rubygems.org'
 
 gem 'rake'
-group :development, :test do
+# alternative graphing gem
+gem "googlecharts"
+group :development do
+
+end
+group :test do
   gem "rspec", '>2'
-  gem "test-construct", ">= 1.2.0"
-  gem "googlecharts"
+  gem 'test-construct'
   if ENV['COVERAGE']
     gem 'simplecov'
     # https://github.com/kina/simplecov-rcov-text

data/HISTORY.md

@@ -1,5 +1,17 @@
 ### Master
 
+### MetricFu 4.1.3 / 2013-05-13
+
+* Features
+  * Tests now pass in JRuby and Rubinius! (Benjamin Fleischer)
+* Fixes
+  * Line numbers now display and link properly in annotated code (Benjamin Fleischer)
+  * No longer remove historical metrics when testing metric_fu
+  * Churn metric handler won't crash when no source control found (Dan Mayer)
+* Misc (Benjamin Fleischer)
+  * Removed StandardTemplate, had no additional value and needed to be maintained
+  * Removed most template references to specific metrics
+
 ### MetricFu 4.1.2 / 2013-04-17
 
 * Fixes

data/README.md

@@ -1,5 +1,22 @@
 # MetricFu [![Gem Version](https://badge.fury.io/rb/metric_fu.png)](http://badge.fury.io/rb/metric_fu) [![Build Status](https://travis-ci.org/metricfu/metric_fu.png?branch=master)](http://travis-ci.org/metricfu/metric_fu) [![Code Climate](https://codeclimate.com/github/metricfu/metric_fu.png)](https://codeclimate.com/github/metricfu/metric_fu) [![Dependency Status](https://gemnasium.com/metricfu/metric_fu.png)](https://gemnasium.com/metricfu/metric_fu)
 
+## Metrics
+
+* [Cane](https://rubygems.org/gems/cane), [Source](http://github.com/square/cane)
+* [Churn](https://rubygems.org/gems/churn), [Source](http://github.com/danmayer/churn)
+* [Flog](https://rubygems.org/gems/flog), [Source](https://github.com/seattlerb/flog)
+* [Flay](https://rubygems.org/gems/flay), [Source](https://github.com/seattlerb/flay)
+* [Reek](https://rubygems.org/gems/reek) [Source](https://github.com/troessner/reek)
+* [Roodi](https://rubygems.org/gems/metric_fu-roodi), [Source](https://github.com/metricfu/roodi)
+* [Saikuro](https://rubygems.org/gems/japgolly-Saikuro), [Source](https://github.com/japgolly/Saikuro)
+* Rails-only
+  * [Rails Best Practices](https://rubygems.org/gems/rails_best_practices), [Source](https://github.com/railsbp/rails_best_practices)
+  * Rails `rake stats` task (see [gem](https://rubygems.org/gems/code_statistics), [Source](https://github.com/danmayer/code_statistics) )
+* Test Coverage
+  * 1.9: [SimpleCov](http://rubygems.org/gems/simplecov) and [SimpleCov-Rcov-Text](http://rubygems.org/gems/simplecov-rcov-text)
+  * 1.8 [Rcov](http://rubygems.org/gems/rcov)
+* Hotspots (a meta-metric of the above)
+
 ## Installation
 
     gem install metric_fu

data/TODO.md

@@ -2,107 +2,86 @@
 
 * Keep HISTORY.md in master up to date
 
-* [Fix jruby/rbx errors on travis](https://travis-ci.org/metricfu/metric_fu)
+Items in each category are in generally order of decreasing priority.
+The categories themselves are not in any priority order.
 
-## Before next release
-
-* Move code that references rcov out of
-
-    lib/reporting/templates/awesome/css/default.css
-    lib/reporting/templates/awesome/index.html.erb
-    lib/reporting/templates/standard/default.css
-    lib/reporting/templates/standard/index.html.erb
-
-* Move code that references flog out of
-
-    lib/configuration.rb
-    lib/metrics/hotspots/analysis/code_issue.rb
-    lib/reporting/templates/awesome/index.html.erb
-    lib/reporting/templates/standard/index.html.erb
-
-* Move code that references flay out of
-
-    lib/metrics/generator.rb
-    lib/metrics/hotspots/analysis/code_issue.rb
-    lib/reporting/templates/awesome/index.html.erb
-    lib/reporting/templates/standard/index.html.erb
-
-* Move code that references churn out of
-
-    lib/metrics/hotspots/analysis/code_issue.rb
-    lib/metrics/hotspots/init.rb
-    lib/reporting/templates/awesome/index.html.erb
-    lib/reporting/templates/standard/index.html.erb
-
-* Move code that references rails_best_practices out of
-
-    lib/metrics/hotspots/analysis/code_issue.rb
-    lib/reporting/templates/awesome/index.html.erb
-    lib/reporting/templates/standard/index.html.erb
-
-
-* Move code that references reek out of
-
-    lib/metrics/hotspots/analysis/code_issue.rb
-    lib/reporting/templates/awesome/index.html.erb
-    lib/reporting/templates/standard/index.html.erb
-
-
-* Move code that references roodi out of
-
-    lib/metrics/hotspots/analysis/code_issue.rb
-    lib/reporting/templates/awesome/index.html.erb
-    lib/reporting/templates/standard/index.html.erb
-
-* Move code that references saikuro out of
-
-    lib/metrics/hotspots/analysis/code_issue.rb
-    lib/reporting/templates/awesome/index.html.erb
-    lib/reporting/templates/standard/index.html.erb
-
-* Move code that references stats out of
-
-lib/reporting/templates/awesome/index.html.erb
-lib/reporting/templates/standard/index.html.erb
-
-* Review how metric_fu uses each tools to generate metrics, e.g. by shelling out commands, rake task, modifying the output, etc.
-
-* Change MetricFu.report.add(metric) to e.g. MetricFu.generate_report(metric) to make clear that this actually runs the tool
-
-* Allow the coverage task to specify the command it runs plus any flags (see bundler/capistrano options)
-
-* Test against a rails app
+Also see [CONTRIBUTING](./CONTRIBUTING.md)
 
 ## Features
 
-* Look into adding
-  * https://github.com/metricfu/code_statistics
-  * brakeman https://github.com/metricfu/brakeman
-  * laser https://github.com/metricfu/laser
+* Make it easier to whitelist metrics when running from the commanline (cli)
+* Be able to specify folders to run against rather than just app and lib
+* Be able to run metric tools from metric_fu without shelling out
+* Allow the coverage task to specify the command it runs plus any flags (see bundler/capistrano options)
 * Add configurable logger to all output streams
-* Color code flog results with scale from: http://jakescruggs.blogspot.com/2008/08/whats-good-flog-score.html
-* Make running metric_fu on metric_fu less embarrassing
 * Load all gems at config time so you fail fast if one is missing
-* Refactor the hotspots code
-
+* Color code flog results with scale from: http://jakescruggs.blogspot.com/2008/08/whats-good-flog-score.html
+* Make the template pages prettier (hold off until [61](https://github.com/metricfu/metric_fu/pull/61) is merged)
+* Be able to generate historical metrics for eg gem releases (tagged with appropriate date)
 
 ## Testing
 
+* Test against a rails app, see [yui-rails](https://github.com/nextmat/yui-rails/tree/master/test/dummy)
 * Determine how to test metric_fu against codebases that are not metric_fu, to ensure it works on most applications
   * This is especially true for rails applications
 * Remove / Modify Devver code from the generators/hotspots_spec and base/hotspot_analzyer_spec
+* Add tests
+* Remove useless tests
+* Remove tests that use StandardTemplate. Will require updating tests yml output, which may not be easy
 
 ## Bugs / Fixes
 
+* See issues
+
 ## Misc
 
+### Improvements
+
+* See TODO items in the code
+* Change  how config works to not metaprogrammatically create so many
+instance variables and accessors
+* Clarify the execution path and what a metric's api should be, (repeat for templates and graphs)
+* Change MetricFu.report.add(metric) to e.g. MetricFu.generate_report(metric) to make clear that this actually runs the tool
+* Clarify hotspot weighting
+* Update the wiki with use cases
+* Review how metric_fu uses each tools to generate metrics, e.g. by shelling out commands, rake task, modifying the output, etc.
+* Understand and explain s-expressions and how they're used (or should be ) in [line_numbers.rb](https://github.com/metricfu/metric_fu/blob/master/lib/metric_fu/data_structures/line_numbers.rb) (via the ruby_parser)
+  * maybe see [reek tree dresser](https://github.com/troessner/reek/blob/master/lib/reek/source/tree_dresser.rb) and [reek code parser](https://github.com/troessner/reek/blob/master/lib/reek/core/code_parser.rb) or
+  * [ripper-tags](https://github.com/tmm1/ripper-tags)
+* Remove dead code
 * Determine if CodeIssue is used, else remove it
 * Remove references to Ruport from the Devver / Caliper code
-* Update or move the homepage http://metric-fu.rubyforge.org/
+* Understand and explain how each metric can be used
+* Improve metric_fu code metrics
+* Refactor the hotspots code
 * Is there any reason not to remove the Manifest.txt?
+* Consider removing need for the core extensions (ActiveSupport)
+
+### Documentation
+
+* Get the rdoc (or yard) published
+* Add more inline documentation
 * See other documentation code for examples to improve ours:
   * https://github.com/charliesome/better_errors/blob/master/CONTRIBUTING.md
   * https://github.com/charliesome/better_errors/blob/master/README.md
+
+### Other
+
+* Look into issues for the tools metric_fu uses
+* Look into other tools that might work well
+* Update contributing or issue guidlines
+* Suggest commit message guidelines
+* [Update the homepage](https://github.com/metricfu/metricfu.github.com)
+
+## Future Thoughts
+
+* Look into how to manage plugins or otherwise load abritrary metrics
+  * [Hoe](https://github.com/seattlerb/hoe/blob/master/lib/hoe.rb#L301)
+  * CLI [Flog](https://github.com/seattlerb/flog/blob/master/lib/flog_cli.rb) Plugins [Flog](https://github.com/seattlerb/flog/blob/master/lib/flog_cli.rb#L34)
+* Look into adding
+  * https://github.com/metricfu/code_statistics [1](https://github.com/cloudability/code_statistics)
+  * brakeman https://github.com/metricfu/brakeman
+  * laser https://github.com/metricfu/laser
 * Other intersting libraries to consider:
   * https://gist.github.com/4562865 for generating Flog on ERB templates by jamesmartin
   * https://github.com/chad/turbulence churn and complexity (flog)
@@ -112,7 +91,23 @@ lib/reporting/templates/standard/index.html.erb
   * https://github.com/metricfu/gauntlet
   * https://github.com/metricfu/repodepot-ruby https://twitter.com/jakescruggs/status/70521977303076865
   * https://github.com/eladmeidar/rails_indexes
-  * https://github.com/trptcolin/consistency_fail 
+  * https://github.com/trptcolin/consistency_fail
   * https://github.com/thoughtbot/appraisal
   * https://github.com/jenkinsci/rubymetrics-plugin
   * https://github.com/holman/hopper
+  * https://github.com/eric/metriks
+
+## Useful Links
+
+### Ruby Guides
+
+* https://github.com/cwgem/RubyGuide
+* https://github.com/bbatsov/rubocop
+* https://github.com/bbatsov/ruby-style-guide
+* https://github.com/bbatsov/rails-style-guide
+* [Learning resources](http://www.benjaminfleischer.com/learning/ruby/tutorials.html) [Source](https://github.com/bf4/learning/tree/gh-pages)
+
+### Perf tools
+
+* https://github.com/tmm1/perftools.rb
+* https://twitter.com/mperham/status/311332913641840641

data/lib/metric_fu.rb

@@ -41,6 +41,7 @@ module MetricFu
     (ENV['CC_BUILD_ARTIFACTS'] || 'tmp/metric_fu')
   end
   def self.configure
+    MetricFu.lib_require { 'core_ext' }
     MetricFu.lib_require { 'configuration' }
     init_files = Dir.glob(File.join(MetricFu.metrics_dir, '**/init.rb')).reject do |file|
       if file =~ /rcov/o
@@ -66,6 +67,13 @@ module MetricFu
     end
     MetricFu.configuration
   end
+  def self.mri_only_metrics
+    if MetricFu.configuration.mri?
+      []
+    else
+      [:cane, :flog, :rails_best_practices]
+    end
+  end
   def self.run_rcov
     load File.join(MetricFu.metrics_dir, 'rcov/init.rb')
   end

data/lib/metric_fu/configuration.rb

@@ -119,11 +119,11 @@ module MetricFu
     end
 
     def jruby?
-      @jruby ||= RedCard.check(:jruby)
+      @jruby ||= !!RedCard.check(:jruby)
     end
 
     def mri?
-      @mri ||= RedCard.check(:ruby)
+      @mri ||= !!RedCard.check(:ruby)
     end
 
     def platform #:nodoc:
@@ -133,8 +133,13 @@ module MetricFu
     end
 
     def self.ruby_strangely_makes_accessors_private?
-      RedCard.check('1.9.2') || jruby?
+       ruby192? || jruby?
     end
+
+    def self.ruby192?
+      @ruby192 ||= !!RedCard.check('1.9.2')
+    end
+
     protected unless ruby_strangely_makes_accessors_private?
 
     def add_promiscuous_instance_variable(name,value)

data/lib/metric_fu/core_ext.rb

@@ -0,0 +1,2 @@
+MetricFu.lib_require { 'core_ext/object' }
+MetricFu.lib_require { 'core_ext/string' }

data/lib/metric_fu/core_ext/inflector/inflections.rb

@@ -0,0 +1,214 @@
+# https://raw.github.com/rails/rails/20768176292cbcb883ab152b4aa9ed8c664771cd/activesupport/lib/active_support/inflector/inflections.rb
+# not https://github.com/rails/rails/blob/e8727d37fc49d5bf9976c3cb5c46badb92cf4ced/activesupport/lib/active_support/inflector/inflections.rb
+MetricFu.lib_require { 'core_ext/inflector/methods' }
+module ActiveSupport
+  module Inflector
+    # A singleton instance of this class is yielded by Inflector.inflections, which can then be used to specify additional
+    # inflection rules. Examples:
+    #
+    #   ActiveSupport::Inflector.inflections do |inflect|
+    #     inflect.plural /^(ox)$/i, '\1\2en'
+    #     inflect.singular /^(ox)en/i, '\1'
+    #
+    #     inflect.irregular 'octopus', 'octopi'
+    #
+    #     inflect.uncountable "equipment"
+    #   end
+    #
+    # New rules are added at the top. So in the example above, the irregular rule for octopus will now be the first of the
+    # pluralization and singularization rules that is runs. This guarantees that your rules run before any of the rules that may
+    # already have been loaded.
+    class Inflections
+      def self.instance
+        @__instance__ ||= new
+      end
+
+      attr_reader :plurals, :singulars, :uncountables, :humans
+
+      def initialize
+        @plurals, @singulars, @uncountables, @humans = [], [], [], []
+      end
+
+      # Specifies a new pluralization rule and its replacement. The rule can either be a string or a regular expression.
+      # The replacement should always be a string that may include references to the matched data from the rule.
+      def plural(rule, replacement)
+        @uncountables.delete(rule) if rule.is_a?(String)
+        @uncountables.delete(replacement)
+        @plurals.insert(0, [rule, replacement])
+      end
+
+      # Specifies a new singularization rule and its replacement. The rule can either be a string or a regular expression.
+      # The replacement should always be a string that may include references to the matched data from the rule.
+      def singular(rule, replacement)
+        @uncountables.delete(rule) if rule.is_a?(String)
+        @uncountables.delete(replacement)
+        @singulars.insert(0, [rule, replacement])
+      end
+
+      # Specifies a new irregular that applies to both pluralization and singularization at the same time. This can only be used
+      # for strings, not regular expressions. You simply pass the irregular in singular and plural form.
+      #
+      # Examples:
+      #   irregular 'octopus', 'octopi'
+      #   irregular 'person', 'people'
+      def irregular(singular, plural)
+        @uncountables.delete(singular)
+        @uncountables.delete(plural)
+        if singular[0,1].upcase == plural[0,1].upcase
+          plural(Regexp.new("(#{singular[0,1]})#{singular[1..-1]}$", "i"), '\1' + plural[1..-1])
+          plural(Regexp.new("(#{plural[0,1]})#{plural[1..-1]}$", "i"), '\1' + plural[1..-1])
+          singular(Regexp.new("(#{plural[0,1]})#{plural[1..-1]}$", "i"), '\1' + singular[1..-1])
+        else
+          plural(Regexp.new("#{singular[0,1].upcase}(?i)#{singular[1..-1]}$"), plural[0,1].upcase + plural[1..-1])
+          plural(Regexp.new("#{singular[0,1].downcase}(?i)#{singular[1..-1]}$"), plural[0,1].downcase + plural[1..-1])
+          plural(Regexp.new("#{plural[0,1].upcase}(?i)#{plural[1..-1]}$"), plural[0,1].upcase + plural[1..-1])
+          plural(Regexp.new("#{plural[0,1].downcase}(?i)#{plural[1..-1]}$"), plural[0,1].downcase + plural[1..-1])
+          singular(Regexp.new("#{plural[0,1].upcase}(?i)#{plural[1..-1]}$"), singular[0,1].upcase + singular[1..-1])
+          singular(Regexp.new("#{plural[0,1].downcase}(?i)#{plural[1..-1]}$"), singular[0,1].downcase + singular[1..-1])
+        end
+      end
+
+      # Add uncountable words that shouldn't be attempted inflected.
+      #
+      # Examples:
+      #   uncountable "money"
+      #   uncountable "money", "information"
+      #   uncountable %w( money information rice )
+      def uncountable(*words)
+        (@uncountables << words).flatten!
+      end
+
+      # Specifies a humanized form of a string by a regular expression rule or by a string mapping.
+      # When using a regular expression based replacement, the normal humanize formatting is called after the replacement.
+      # When a string is used, the human form should be specified as desired (example: 'The name', not 'the_name')
+      #
+      # Examples:
+      #   human /_cnt$/i, '\1_count'
+      #   human "legacy_col_person_name", "Name"
+      def human(rule, replacement)
+        @humans.insert(0, [rule, replacement])
+      end
+
+      # Clears the loaded inflections within a given scope (default is <tt>:all</tt>).
+      # Give the scope as a symbol of the inflection type, the options are: <tt>:plurals</tt>,
+      # <tt>:singulars</tt>, <tt>:uncountables</tt>, <tt>:humans</tt>.
+      #
+      # Examples:
+      #   clear :all
+      #   clear :plurals
+      def clear(scope = :all)
+        case scope
+          when :all
+            @plurals, @singulars, @uncountables = [], [], []
+          else
+            instance_variable_set "@#{scope}", []
+        end
+      end
+    end
+
+    # Yields a singleton instance of Inflector::Inflections so you can specify additional
+    # inflector rules.
+    #
+    # Example:
+    #   ActiveSupport::Inflector.inflections do |inflect|
+    #     inflect.uncountable "rails"
+    #   end
+    def inflections
+      if block_given?
+        yield Inflections.instance
+      else
+        Inflections.instance
+      end
+    end
+
+    # Returns the plural form of the word in the string.
+    #
+    # Examples:
+    #   "post".pluralize             # => "posts"
+    #   "octopus".pluralize          # => "octopi"
+    #   "sheep".pluralize            # => "sheep"
+    #   "words".pluralize            # => "words"
+    #   "CamelOctopus".pluralize     # => "CamelOctopi"
+    def pluralize(word)
+      result = word.to_s.dup
+
+      if word.empty? || inflections.uncountables.include?(result.downcase)
+        result
+      else
+        inflections.plurals.each { |(rule, replacement)| break if result.gsub!(rule, replacement) }
+        result
+      end
+    end
+
+    # The reverse of +pluralize+, returns the singular form of a word in a string.
+    #
+    # Examples:
+    #   "posts".singularize            # => "post"
+    #   "octopi".singularize           # => "octopus"
+    #   "sheep".singularize            # => "sheep"
+    #   "word".singularize             # => "word"
+    #   "CamelOctopi".singularize      # => "CamelOctopus"
+    def singularize(word)
+      result = word.to_s.dup
+
+      if inflections.uncountables.any? { |inflection| result =~ /\b(#{inflection})\Z/i }
+        result
+      else
+        inflections.singulars.each { |(rule, replacement)| break if result.gsub!(rule, replacement) }
+        result
+      end
+    end
+
+    # Capitalizes the first word and turns underscores into spaces and strips a
+    # trailing "_id", if any. Like +titleize+, this is meant for creating pretty output.
+    #
+    # Examples:
+    #   "employee_salary" # => "Employee salary"
+    #   "author_id"       # => "Author"
+    def humanize(lower_case_and_underscored_word)
+      result = lower_case_and_underscored_word.to_s.dup
+
+      inflections.humans.each { |(rule, replacement)| break if result.gsub!(rule, replacement) }
+      result.gsub(/_id$/, "").gsub(/_/, " ").capitalize
+    end
+
+    # Capitalizes all the words and replaces some characters in the string to create
+    # a nicer looking title. +titleize+ is meant for creating pretty output. It is not
+    # used in the Rails internals.
+    #
+    # +titleize+ is also aliased as as +titlecase+.
+    #
+    # Examples:
+    #   "man from the boondocks".titleize # => "Man From The Boondocks"
+    #   "x-men: the last stand".titleize  # => "X Men: The Last Stand"
+    def titleize(word)
+      humanize(underscore(word)).gsub(/\b('?[a-z])/) { $1.capitalize }
+    end
+
+    # Create the name of a table like Rails does for models to table names. This method
+    # uses the +pluralize+ method on the last word in the string.
+    #
+    # Examples
+    #   "RawScaledScorer".tableize # => "raw_scaled_scorers"
+    #   "egg_and_ham".tableize     # => "egg_and_hams"
+    #   "fancyCategory".tableize   # => "fancy_categories"
+    def tableize(class_name)
+      pluralize(underscore(class_name))
+    end
+
+    # Create a class name from a plural table name like Rails does for table names to models.
+    # Note that this returns a string and not a Class. (To convert to an actual class
+    # follow +classify+ with +constantize+.)
+    #
+    # Examples:
+    #   "egg_and_hams".classify # => "EggAndHam"
+    #   "posts".classify        # => "Post"
+    #
+    # Singular names are not handled correctly:
+    #   "business".classify     # => "Busines"
+    def classify(table_name)
+      # strip out any leading schema name
+      camelize(singularize(table_name.to_s.sub(/.*\./, '')))
+    end
+  end
+end