leaderboard_factory 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format nested

data/.rvmrc

@@ -0,0 +1 @@
+rvm --create 1.9.3@leaderboard_factory_gem

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# CHANGELOG
+
+## leaderboard_factory 0.0.1 (2012-08-03)
+
+* initial extraction from project.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Matt Wilson
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,81 @@
+# LeaderboardFactory
+
+Helpful tools for defining a bunch of leaderboards associated with your objects. Builds on the [leaderboard](https://github.com/agoragames/leaderboard) gem.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'leaderboard_factory'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install leaderboard_factory
+
+You'll need to tell it how to find Redis. Configure this on the module:
+
+```ruby
+LeaderboardFactory.redis = Redis.new
+# or
+LeaderboardFactory.configure do |c|
+  c.redis = Redis.new(db: 15)
+end
+```
+
+## Usage
+
+Let's start with an example:
+
+```ruby
+class Player
+  include LeaderboardFactory
+
+  attr_accessor :id
+
+  leaderboard 'game_duration', :id
+  leaderboard 'maps_by_wins', :id
+  collection_leaderboard 'best_finishes', { reverse: true }
+end
+```
+
+What we've done here is define two leaderboards that are scoped to a player's ID, and one that applies to the entire collection of players. This latter one also ranks things in reverse order--there are two optional parameters to both methods, both hashes, and both are simply passed along to the leaderboard gem. The first is the leaderboard options, the second any specific redis options--if you need to pass along something specific for, say, a leaderboard in a different Redis instance. Check out the [leaderboard](https://github.com/agoragames/leaderboard) gem documentation for more details.
+
+Let's look at how to use these.
+
+```ruby
+p = Player.new
+p.id = 1234
+
+p.game_duration # => <Leaderboard @leaderboard_name="game-duration-1234">
+game_id = 1234
+game_duration = 2345
+p.rank_game_duration game_id, game_duration # => ["OK"]
+p.game_duration.all_members # => [...]
+
+Player.best_finishes # => <Leaderboard @leaderboard_name="best-finishes">
+Player.rank_best_finishes p.id, 3, { player_name: "Bob" } # => ["OK", true]
+Player.best_finishes.all_members(with_member_data: true) # etc etc
+```
+
+As you can see, we have a handy accessor that returns our leaderboard, and we even have a handy shortcut to add (*rank* in leaderboard parlance) new items to the board.
+
+You can examine the options for any defined leaderboard via `Player.leaderboard_specs`.
+
+There is a nascent and evolving set of helpers that you can access via `Player.leaderboards`--check out the helpers.rb file for more details there. These helpers will probably change.
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## Copyright
+
+Copyright (c) 2012 Matt Wilson. See LICENSE for further details.

data/Rakefile

@@ -0,0 +1,12 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rspec_opts = ['--backtrace']
+  # spec.ruby_opts = ['-w']
+end
+
+task default: :spec

data/leaderboard_factory.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require 'leaderboard_factory/version'
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Matt Wilson"]
+  gem.email         = ["mwilson@majorleaguegaming.com"]
+  gem.description   = %q{Helps you define and work with a bunch of leaderboards, from, e.g. an ActiveModel object}
+  gem.summary       = %q{Helps you define and work with a bunch of leaderboards, from, e.g. an ActiveModel object}
+  gem.homepage      = "https://github.com/agoragames/leaderboard_factory"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "leaderboard_factory"
+  gem.require_paths = ["lib"]
+  gem.version       = LeaderboardFactory::VERSION
+
+  gem.add_dependency('leaderboard')
+  gem.add_dependency('active_support')
+  gem.add_development_dependency('rake')
+  gem.add_development_dependency('rspec')
+end

data/lib/leaderboard_factory/configuration.rb

@@ -0,0 +1,13 @@
+module LeaderboardFactory
+  module Configuration
+    # Redis instance
+    attr_accessor :redis
+
+    # yield self for block-style config
+    #
+    # LeaderboardFactory.configure { |c| c.redis = Redis.new(db: 15) }
+    def configure
+      yield self
+    end
+  end
+end

data/lib/leaderboard_factory/helper_proxy.rb

@@ -0,0 +1,21 @@
+require 'leaderboard_factory/helpers'
+
+module LeaderboardFactory
+  class HelperProxy
+    include LeaderboardFactory::Helpers
+
+    attr_accessor :context
+
+    def initialize context
+      self.context = context
+    end
+
+  end
+
+  module HelperProxyMethods
+    # Returns a contextualized helper instance so that one can use the helpers.
+    def leaderboards
+      HelperProxy.new(self)
+    end
+  end
+end

data/lib/leaderboard_factory/helpers.rb

@@ -0,0 +1,85 @@
+module LeaderboardFactory
+  # This system is in the most flux. These are some helpers that I found very, ahem, *helpful*.
+  # I'm just not sure I'm sold on the API, and I know that there will be more.
+  module Helpers
+    def board_name name, key = nil
+      name = name.gsub('_', '-')
+      name += "-#{context.send(key)}" if key
+      name
+    end
+
+    # Takes the top item off of the pivot and optionally passes the result through a callable mapper.
+    #
+    # @param leaderboard [Symbol] the name of the leaderboard
+    # @param options [Hash] +:mapper+ is the only unique option, other per +#pivot+
+    #
+    # Example
+    #
+    #    leaderboards.top(:personal_bests) # => [16.0, ['Event ID 1', 'Event ID 3']]
+    #    leaderboards.top(:personal_bests, mapper: Proc.new do |score, bests|
+    #      { high_score: score.to_i, tied: bests.size, best_events: bests }
+    #    end) # => { high_score: 16, tied: 2, best_events: ['Event ID 1', 'Event ID 3'] }
+    def top leaderboard, options = {}
+      result = pivot(leaderboard, options).first
+      if options[:mapper]
+        options[:mapper].call(*result)
+      else
+        result
+      end
+    end
+
+    # Take the leaderboard and pivot the data by the score.
+    # By default it will group the members by their score.
+    #
+    # @param leaderboard [Symbol] the name of the leaderboard you want to pivot
+    # @param options [Hash] (optional) tweak the output
+    #
+    # Available options
+    #
+    #   +:member_data+ whether or not to include member data
+    #   +:score+ a callable object that will transform the score
+    #   +:pluck+ the name of a +member_data+ attribute. If you don't want all of the data.
+    #
+    # Examples
+    #
+    #    leaderboards.pivot(:personal_bests) # => { 16.0 => ['Event ID 1', 'Event ID 3'], 14.2 => ['Event ID 2'] }
+    #    leaderboards.pivot(:personal_bests, member_data: true)
+    #       # => { 16.0 => [{ 'event_name' => 'My Event Name', 'timestamp' => '12323425' },
+    #                       { 'event_name' => 'My Third Attempt', 'timestamp' => '12323488' } ], ...
+    #    leaderboards.pivot(:personal_bests, member_data: true, pluck: 'event_name')
+    #       # => { 16.0 => ['My Event Name', 'My Third Attempt'], 14.2 => ['Followup'] }
+    #    leaderboards.pivot(:personal_bests, score: Proc.new { |s| s.to_i })
+    #       # => { 16 => ['Event ID 1', 'Event ID 3'], 14 => ['Event ID 2'] }
+    def pivot leaderboard, options
+      lb_options = {}
+      if options[:member_data]
+        lb_options.merge!(with_member_data: true)
+      end
+      context.send(leaderboard).all_members(lb_options).inject({}) do |buf, member|
+        key = options[:score] ? options[:score].call(member[:score]) : member[:score]
+        buf[key] ||= []
+        item = if options[:pluck]
+          member[:member_data][options[:pluck]]
+        elsif options[:member_data]
+          member[:member_data]
+        else
+          member[:member]
+        end
+        buf[key] << item
+        buf
+      end
+    end
+
+    # returns the given leaderboard
+    #
+    # @param leaderboard [Symbol] the name of the leaderboard you want
+    #
+    # Example
+    #
+    #    leaderboards.get(:personal_bests) # => Leaderboard
+    def get leaderboard
+      context.send(leaderboard)
+    end
+
+  end
+end

data/lib/leaderboard_factory/version.rb

@@ -0,0 +1,3 @@
+module LeaderboardFactory
+  VERSION = "0.0.1"
+end

data/lib/leaderboard_factory.rb

@@ -0,0 +1,113 @@
+require 'leaderboard'
+require 'leaderboard_factory/configuration'
+require 'leaderboard_factory/helper_proxy'
+require 'leaderboard_factory/version'
+require 'active_support/inflector'
+require 'active_support/concern'
+require 'active_support/core_ext/class/attribute'
+
+module LeaderboardFactory
+  extend Configuration
+  extend ActiveSupport::Concern
+
+  included do
+    class_attribute :leaderboard_specs
+    self.leaderboard_specs = {
+      instance: {},
+      collection: {}
+    }
+
+    include HelperProxyMethods
+    extend HelperProxyMethods
+  end
+
+  module ClassMethods
+    # Defines a new leaderboard that will be scoped to some unique property on the object instance.
+    # Use this if you want to, say, track a specific player's personal bests, or some other
+    #   stat that is specific to the individual.
+    # This method defines an accessor that will return the leaderboard, as well as a shorthand
+    #   method for ranking a new item in the leaderboard
+    #
+    # @param board [String] the name of the leaderboard
+    # @param scope_key [String/Symbol] the name of an attribute on the instance that will scope the leaderboard.
+    # @param options [Hash] optional; these are passed along to the leaderboard object
+    # @param redis_options [Hash] optional; these are also passed along to the leaderboard object
+    #
+    # Example
+    #
+    #    class Player < ActiveRecord::Base
+    #      include LeaderboardFactory
+    #      leaderboard 'maps_by_wins', :id
+    #    end
+    #
+    #    p = Player.new(id: 77)
+    #    p.maps_by_wins # => the player's personal maps leaderboard
+    #    p.rank_map_by_wins map.name, 33, { map_id: 42 } # => ["OK", true]
+    def leaderboard board, scope_key, options = {}, redis_options = {}
+      self.leaderboard_specs[:instance][board] = {
+        key: scope_key,
+        options: options,
+        redis_options: redis_options
+      }
+
+      define_methods board, :instance
+    end
+
+    # As +leaderboard+, but on the class rather than the instance.
+    # it does not take a +scope_key+ parameter, but all other functionality is the same.
+    #
+    # @param board [String] the name of the leaderboard
+    # @param scope_key [String/Symbol] the name of an attribute on the instance that will scope the leaderboard.
+    # @param options [Hash] optional; these are passed along to the leaderboard object
+    # @param redis_options [Hash] optional; these are also passed along to the leaderboard object
+    #
+    # Example
+    #
+    #    class Player < ActiveRecord::Base
+    #      include LeaderboardFactory
+    #      collection_leaderboard 'strength_of_schedule'
+    #    end
+    #
+    #    Player.strength_of_schedule # => the leaderboard object
+    #    Player.rank_strength_of_schedule 232, 66.3, { player_name: 'Bob' } # => ["OK", true]
+    def collection_leaderboard board, options = {}, redis_options = {}
+      self.leaderboard_specs[:collection][board] = {
+        options: options,
+        redis_options: redis_options
+      }
+
+      define_methods board, :collection, 'self.'
+    end
+
+    # Method what actually does the defining.
+    def define_methods board, type = :instance, prefix = ''
+      singluar_object, *remainder_of_name = board.split("_")
+      singluar_object = singluar_object.singularize
+      accessor_method_name = ([singluar_object] + remainder_of_name).join("_")
+
+      class_eval <<-METHODS, __FILE__, __LINE__
+        def #{prefix}#{board}
+          return @#{board} if @#{board}
+          options               = leaderboard_specs[:#{type}]['#{board}'][:options]
+          redis_options         = leaderboard_specs[:#{type}]['#{board}'][:redis_options]
+          redis_key             = leaderboard_specs[:#{type}]['#{board}'][:key]
+
+          redis_options.merge!({
+            redis_connection: LeaderboardFactory.redis
+          })
+
+          @#{board} = Leaderboard.new( leaderboards.board_name('#{board}', redis_key),
+                                       Leaderboard::DEFAULT_OPTIONS.merge(options),
+                                       redis_options )
+        end
+
+        def #{prefix}rank_#{accessor_method_name} object, rank, member_data = nil
+          #{board}.rank_member object, rank, member_data
+        end
+      METHODS
+    end
+  end
+
+  # instance methods would go here...
+
+end

data/spec/helper_proxy_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+module LeaderboardFactory
+  describe HelperProxy do
+    it "takes on parameter to initialize, the context" do
+      foo = mock
+      proxy = HelperProxy.new(foo)
+      proxy.context.should === foo
+    end
+    it "includes the actual helpers" do
+      HelperProxy.included_modules.should include(LeaderboardFactory::Helpers)
+    end
+  end
+end

data/spec/helpers_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+module LeaderboardFactory
+  describe Helpers do
+    let(:kontext) {
+      mock
+    }
+    let(:proxy) {
+      LeaderboardFactory::HelperProxy.new(kontext)
+    }
+
+    describe "#board_name" do
+      it "returns a good name for the leaderboard" do
+        proxy.board_name('garlics_by_weight').should == 'garlics-by-weight'
+      end
+      it "takes an optional second parameter which will be used to uniqify the name" do
+        kontext.should_receive(:id).and_return(1234)
+        proxy.board_name('personal_best_garlics', :id).should == 'personal-best-garlics-1234'
+      end
+    end
+  end
+end

data/spec/leaderboard_factory_spec.rb

@@ -0,0 +1,129 @@
+require 'spec_helper'
+
+describe LeaderboardFactory do
+  let(:test_harness) {
+    Class.new do
+      attr_accessor :id
+      include LeaderboardFactory
+    end
+  }
+
+  it "isn't borked" do
+    test_harness.included_modules.should include(LeaderboardFactory)
+  end
+
+  context 'configuration' do
+    it 'has a redis accessor' do
+      LeaderboardFactory.should respond_to(:redis)
+    end
+    it "uses the redis that is configured" do
+      LeaderboardFactory.redis.client.db.should == 15
+    end
+  end
+
+  describe ".leaderboard" do
+    it "defines a connection to a leaderboard object" do
+      test_harness.should respond_to(:leaderboard)
+      test_harness.class_eval do
+        leaderboard 'fu_manchu', :id
+      end
+      test_harness.leaderboard_specs[:instance]['fu_manchu'].should include({
+        key: :id,
+        options: {}
+      })
+    end
+    it "creates a factory method that returns said leaderboard" do
+      test_harness.class_eval do
+        leaderboard 'fu_manchu', :id
+      end
+      instance = test_harness.new
+
+      instance.fu_manchu.should be_a_kind_of(Leaderboard)
+    end
+    it "uses the second parameter to namespace the leaderboard" do
+      test_harness.class_eval do
+        leaderboard 'fu_manchu', :id
+      end
+      instance = test_harness.new
+      instance.id = 'haha'
+      leaderboard = instance.fu_manchu
+      leaderboard.leaderboard_name.should == 'fu-manchu-haha'
+    end
+    it "doesn't leak the abstraction" do
+      klass = Class.new do
+        attr_accessor :id
+        include LeaderboardFactory
+        leaderboard 'garlic', :id
+      end
+
+      klass.new.leaderboard_specs[:instance].keys.should include('garlic')
+      test_harness.new.leaderboard_specs[:instance].should be_empty
+    end
+    it "is connected to the configured redis instance" do
+      test_harness.class_eval do
+        leaderboard 'fu_manchu', :id
+      end
+      redis = test_harness.new.fu_manchu.instance_variable_get(:@redis_connection)
+      redis.should === LeaderboardFactory.redis
+    end
+    it "adds a convience accessor based on the singularized object name, e.g. maps_by_wins => rank_map_by_wins" do
+      test_harness.class_eval do
+        leaderboard 'maps_by_wins', :id
+      end
+      instance = test_harness.new
+
+      instance.should respond_to(:rank_map_by_wins)
+      instance.rank_map_by_wins 'map', 3
+      instance.maps_by_wins.all_members.should include({:member=>"map", :rank=>1, :score=>3.0})
+    end
+    describe "this convience accessor" do
+      it "accepts an optional third parameter, which is member data" do
+        test_harness.class_eval do
+        leaderboard 'maps_by_wins', :id
+      end
+      instance = test_harness.new
+
+      instance.rank_map_by_wins 'map', 3, { event_name: 'framulator 5000' }
+      instance.maps_by_wins.all_members(with_member_data: true).should include({
+        member: "map",
+        rank: 1,
+        score: 3.0,
+        member_data: {"event_name"=>"framulator 5000"}
+      })
+      end
+    end
+    it "can be overriden in the class" do
+      klass = Class.new do
+        attr_accessor :id
+        include LeaderboardFactory
+        leaderboard 'garlics_by_weight', :id
+
+        def rank_garlic_by_weight
+          "HA! HA!"
+        end
+      end
+
+      klass.new.rank_garlic_by_weight.should == "HA! HA!"
+    end
+  end
+
+  describe ".collection_leaderboard" do
+    it "defines a connection to a leaderboard object" do
+      test_harness.should respond_to(:collection_leaderboard)
+      test_harness.class_eval do
+        collection_leaderboard 'greatest_of_all_time'
+      end
+      test_harness.leaderboard_specs[:collection]['greatest_of_all_time'].should include({
+        options: {}
+      })
+    end
+    it "creates a factory method that returns said leaderboard" do
+      test_harness.class_eval do
+        collection_leaderboard 'greatest_of_all_time'
+      end
+
+      test_harness.greatest_of_all_time.should be_a_kind_of(Leaderboard)
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+require 'rspec'
+require 'leaderboard_factory'
+LeaderboardFactory.redis = Redis.new(db: 15)
+
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification
+name: leaderboard_factory
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Matt Wilson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: leaderboard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: active_support
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Helps you define and work with a bunch of leaderboards, from, e.g. an
+  ActiveModel object
+email:
+- mwilson@majorleaguegaming.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- leaderboard_factory.gemspec
+- lib/leaderboard_factory.rb
+- lib/leaderboard_factory/configuration.rb
+- lib/leaderboard_factory/helper_proxy.rb
+- lib/leaderboard_factory/helpers.rb
+- lib/leaderboard_factory/version.rb
+- spec/helper_proxy_spec.rb
+- spec/helpers_spec.rb
+- spec/leaderboard_factory_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/agoragames/leaderboard_factory
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Helps you define and work with a bunch of leaderboards, from, e.g. an ActiveModel
+  object
+test_files:
+- spec/helper_proxy_spec.rb
+- spec/helpers_spec.rb
+- spec/leaderboard_factory_spec.rb
+- spec/spec_helper.rb