backyard 0.0.1

data/.gitignore

@@ -0,0 +1,6 @@
+pkg/*
+*.gem
+
+.bundle
+.rvmrc
+.yardoc/

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in backyard.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,46 @@
+PATH
+  remote: .
+  specs:
+    backyard (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activerecord (2.3.10)
+      activesupport (= 2.3.10)
+    activesupport (2.3.10)
+    builder (3.0.0)
+    cucumber (0.10.0)
+      builder (>= 2.1.2)
+      diff-lcs (~> 1.1.2)
+      gherkin (~> 2.3.2)
+      json (~> 1.4.6)
+      term-ansicolor (~> 1.0.5)
+    diff-lcs (1.1.2)
+    factory_girl (1.3.2)
+    gherkin (2.3.3)
+      json (~> 1.4.6)
+    json (1.4.6)
+    rspec (2.4.0)
+      rspec-core (~> 2.4.0)
+      rspec-expectations (~> 2.4.0)
+      rspec-mocks (~> 2.4.0)
+    rspec-core (2.4.0)
+    rspec-expectations (2.4.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.4.0)
+    sqlite3 (1.3.3)
+    term-ansicolor (1.0.5)
+    yard (0.6.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activerecord
+  backyard!
+  cucumber
+  factory_girl
+  rspec
+  sqlite3
+  yard

data/History.txt

@@ -0,0 +1,16 @@
+== In Git
+
+=== New Features
+
+=== Bugfixes
+
+== 0.0.1 (24.01.2011)
+
+=== New Features
+* define the attributes, which name your model [Yves Senn]
+* define the name of your model with a block [Yves Senn]
+* basic API for storing, accessing and building named models [Yves Senn]
+* factory_girl support [Yves Senn]
+
+=== Bugfixes
+* reload models before the return [Yves Senn]

data/README.md

@@ -0,0 +1,97 @@
+# Backyard
+
+this project is in a 'work in progress' state. The object creation currently only works with factory_girl.
+
+## Installation
+
+in your Gemfile:
+
+    gem 'backyard'
+
+to configure backyard, you need to create a backyard.rb file in your features/support directory:
+    require 'backyard/cucumber'
+
+    Backyard.configure do
+      # application specific configuration
+      name_attribute :username, :for => :user
+      name_attribute :title, :for => [:post, :comment]
+    end
+
+## Usage
+
+Backyard provides a simple dsl to name the models in your cucumber scenarios.
+
+    put_model(:post, 'How to use Backyard') # create and store a new Post model named 'How to use Backyard'
+    put_model(:post, 'I am published', {:published => true}) # you can pass additional options for the factory
+
+    my_comment = Comment.first
+    put_model(my_comment, 'My Comment') # you can also store existing models
+
+Backyard keeps track of your saved models and you can access them from all the step definitions:
+
+    get_model(:post, 'How to use Backyard') # returns the stored post instance
+
+If you want to write step definitions, which do not care if the model you are referencing exists then you can use the `model´ method. It will check if the model with the given name exists and if not, it will create a new model for you.
+
+    model(:user, 'Tester') # this will return the user called 'Tester' if one has been crated, otherwise it will create a new model for you
+    model(:user, 'Gardener', {:approved => true})  # you can also pass additional attributes for the factories
+
+## Examples
+
+The best way, to get an idea of backyard in action, is to peek inside the [cucumber features](https://github.com/senny/backyard/tree/master/features).
+
+## Configuration
+
+Backyard needs to know how to name your models correctly. You can define the rules using the `Backyard.configure` method:
+
+    Backyard.configure do
+      name_attribute :title, :for => :article
+    end
+
+    # Examples
+    put_model(:article, 'Getting Started with Rails') # this creates an Article instance with the titel: 'Getting Started with Rails'
+    model(:article, 'Getting Started with Rails') # returns the article created above
+    model(:article, 'Upgrading to Rails 3') # since no article with the given name has been created it will create one.
+
+There are situations when the name of your model is not as simple as setting an attribute. In these circumstances you can register a block to set the name of your model accordingly:
+
+    Backyard.configure do
+      name_for :owner do |name|
+        { :user => model(:user, name, {:username => name}) }
+      end
+    end
+
+If all users in your system are named with the username attribute you could use the following configuration:
+
+    Backyard.configure do
+      name_attribute :username, :for => :user
+
+      name_for :owner do |name|
+        { :user => model(:user, name) }
+      end
+    end
+
+    # Examples
+    put_model(:user, 'John') # creates a User with username: 'John'
+    put_model(:owner, 'Jane') # creates a Owner with an associated User, which has the username: 'Jane'
+
+This will still create Owner models with an associated user, where the username is set to the name of the created Owner model. This configuration has the advantage, that the username is also beeing set if you just create a User model.
+
+## Community
+
+### Got a question?
+
+Just send me a message and I'll try to get to you as soon as possible.
+
+### Found a bug?
+
+Please register a new issue.
+
+### Fixed something?
+
+1. Fork backyard
+2. Create a topic branch - `git checkout -b my_branch`
+3. Make your changes and update the History.txt file
+4. Push to your branch - `git push origin my_branch`
+5. Send me a pull-request for your topic branch
+6. That's it!

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/backyard.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "backyard/version"
+
+Gem::Specification.new do |s|
+  s.name        = "backyard"
+  s.version     = Backyard::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Yves Senn"]
+  s.email       = ["yves.senn@gmail.com"]
+  s.homepage    = "http://rubygems.org/gems/backyard"
+  s.summary     = %q{manage the models in your cucumbers with ease}
+  s.description = %q{backyard allows you to name the models in your cucumber scenarios.}
+
+  s.rubyforge_project = "backyard"
+
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "cucumber"
+  s.add_development_dependency "factory_girl"
+  s.add_development_dependency "activerecord"
+  s.add_development_dependency "sqlite3"
+  s.add_development_dependency "yard"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/cucumber.yml

@@ -0,0 +1,8 @@
+<%
+rerun = File.file?('rerun.txt') ? IO.read('rerun.txt') : ""
+rerun_opts = rerun.to_s.strip.empty? ? "--format progress features" : "--format pretty #{rerun}"
+std_opts = "--format progress features --strict --tags ~@wip"
+%>
+default: <%= std_opts %>
+wip: --tags @wip:3 --wip features
+rerun: <%= rerun_opts %> --format rerun --out rerun.txt --strict --tags ~@wip

data/features/backyard_with_factory_girl.feature

@@ -0,0 +1,65 @@
+Feature: backyard should work with FactoryGirl
+
+  Background:
+    Given I use the factory_girl adapter for backyard
+
+  Scenario: store and retrieve an object
+    When I store the user "John" in the backyard
+    Then the backyard should have 1 stored users
+    And the backyard should have a stored user named "John"
+
+  Scenario: store multiple objects
+    When I store the following users in the backyard:
+      | Name   |
+      | John   |
+      | Jane   |
+      | Jackob |
+    Then the backyard should have 3 stored users
+    And the backyard should have a stored user named "John"
+    And the backyard should have a stored user named "Jane"
+    And the backyard should have a stored user named "Jackob"
+
+  Scenario: store associated models
+    When I store the following accounts in the backyard:
+      | Description    | Owner |
+      | Taxes          | John  |
+      | John's Savings | John  |
+      | Jane's Savings | Jane  |
+    Then the backyard should have 2 stored users
+    And the backyard should have 3 stored accounts
+    And the account "Taxes" should be owned by "John"
+    And the account "John's Savings" should be owned by "John"
+    And the account "Jane's Savings" should be owned by "Jane"
+
+  Scenario: use the backyard name as model attribute
+    Given I have the following backyard configuration:
+    """
+    Backyard.configure do
+      name_attribute :description, :for => :account
+    end
+    """
+    When I store the account "Holidays" in the backyard
+    Then the account "Holidays" should have the description "Holidays"
+
+  Scenario: advanced configuration for model names
+    Given I have the following backyard configuration:
+    """
+    Backyard.configure do
+      name_for :user do |name|
+        {:username => name,
+        :email => "#{name.downcase.gsub(/\s/, '.')}@gmail.com"}
+      end
+    end
+    """
+    When I store the user "John Doe" in the backyard
+    Then the user "John Doe" should have the username "John Doe"
+    And the user "John Doe" should have the email "john.doe@gmail.com"
+
+  Scenario: the backyard is empty by default
+    Then the backyard should have 0 stored users
+    Then the backyard should have 0 stored accounts
+
+  Scenario: the backyard always returns updated models
+    When I store the user "John" in the backyard
+    And I set "John"'s username to "John the man" using a sql query
+    Then the user "John" should have the username "John the man"

data/features/step_definitions/backyard_account_steps.rb

@@ -0,0 +1,20 @@
+When /I store the following accounts in the backyard:/ do |accounts_table|
+  accounts_table.hashes.each do |row|
+    attributes = {}
+
+    if row['Owner'].present?
+      model(:user, row['Owner'])
+      attributes[:owner] = model(:user, row['Owner'])
+    end
+
+    put_model(:account, row['Description'], attributes)
+  end
+end
+
+Then /^the account "([^"]*)" should be owned by "([^"]*)"$/ do |account_name, owner_name|
+  get_model(:account, account_name).owner.should == get_model(:user, owner_name)
+end
+
+Then /^the account "([^"]*)" should have the description "([^"]*)"$/ do |account_name, description|
+  get_model(:account, account_name).description.should == description
+end

data/features/step_definitions/backyard_steps.rb

@@ -0,0 +1,25 @@
+def backyard_model
+  '(user|account)s?'
+end
+
+Given /^I use the factory_girl adapter for backyard$/ do
+  require 'factory_girl'
+  Factory.find_definitions
+  Backyard.config.use_adapter :factory_girl
+end
+
+Given /^I have the following backyard configuration:$/ do |string|
+  eval(string)
+end
+
+When /^I store the #{backyard_model} "([^"]*)" in the backyard$/ do |model_type, model_name|
+  put_model(model_type, model_name)
+end
+
+Then /^the backyard should have (\d+) stored #{backyard_model}$/ do |amount, model_type|
+  get_models(model_type).should have(amount.to_i).item
+end
+
+Then /^the backyard should have a stored #{backyard_model} named "([^"]*)"$/ do |model_type, model_name|
+  get_model(model_type, model_name).should_not be_nil
+end

data/features/step_definitions/backyard_user_steps.rb

@@ -0,0 +1,16 @@
+When /^I store the following users in the backyard:$/ do |users_table|
+  users_table.hashes.each do |row|
+    attributes = {}
+    put_model(:user, row['Name'], attributes)
+  end
+end
+
+When /^I set "([^"]*)"'s username to "([^"]*)" using a sql query$/ do |user_name, new_username|
+  user = model(:user, user_name)
+  User.connection.execute("UPDATE users SET username = '#{new_username}' WHERE id = #{user.id}")
+end
+
+Then /^the user "([^"]*)" should have the (username|email) "([^"]*)"$/ do |user_name, attribute, value|
+  user = get_model(:user, user_name)
+  user.send(attribute).should == value
+end

data/features/support/backyard.rb

@@ -0,0 +1 @@
+require 'backyard/cucumber'

data/features/support/env.rb

@@ -0,0 +1,13 @@
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../lib')
+require 'backyard'
+
+require 'rspec/expectations'

data/lib/backyard/adapter/factory_girl.rb

@@ -0,0 +1,13 @@
+class Backyard::Adapter::FactoryGirl < Backyard::Adapter
+
+  def class_for_type(model_type)
+    factory = ::Factory.factories[model_type.to_sym]
+    raise ArgumentError, "no factory for: #{model_type}\ngot: #{::Factory.factories.keys}" unless factory
+    factory.build_class
+  end
+
+  def create(model_type, attributes)
+    Factory(model_type, attributes)
+  end
+
+end

data/lib/backyard/adapter.rb

@@ -0,0 +1,17 @@
+module Backyard
+  class Adapter
+
+    def class_for_type(model_type)
+      model_type.to_s.split('_').map!{ |w| w.capitalize }.join
+    end
+
+    def generate_model_name(model_type)
+      "#{model_type.to_s.capitalize} #{Time.now.to_f}"
+    end
+
+    def create(model_type, attributes)
+      raise NotImplementedError
+    end
+
+  end
+end

data/lib/backyard/configuration.rb

@@ -0,0 +1,51 @@
+module Backyard
+  class Configuration
+
+    def initialize
+      @model_configuration ||= {}
+    end
+
+    def name_attribute(attribute, options = {})
+      raise "missing the :for options" unless options.has_key?(:for)
+      [*options[:for]].each do |model_type|
+        model = adapter_instance.class_for_type(model_type)
+        config_for(model).name_attributes << attribute
+      end
+    end
+
+    def name_for(*model_types, &block)
+      model_types.each do |model_type|
+        klass = adapter_instance.class_for_type(model_type)
+        config_for(klass).name_blocks << block
+      end
+    end
+
+    def use_adapter(adapter)
+      @adapter = adapter
+    end
+
+    def config_for(model_type)
+      @model_configuration[model_type] ||= Model.new
+    end
+
+    def adapter_instance
+      return @adapter_instance if @adapter_instance
+      @adapter ||= :factory_girl
+      require File.join('backyard', 'adapter', "#{@adapter}")
+      adapter_class = @adapter.to_s.split('_').map!{ |w| w.capitalize }.join
+      @adapter_instance = eval "Backyard::Adapter::#{adapter_class}.new"
+    end
+
+    class Model
+      attr_writer :name_attributes, :name_blocks
+      def name_attributes
+        @name_attributes ||= []
+      end
+
+      def name_blocks
+        @name_blocks ||= []
+      end
+    end
+
+  end
+end

data/lib/backyard/cucumber.rb

@@ -0,0 +1,3 @@
+require 'backyard'
+
+World(Backyard::Session)

data/lib/backyard/model_store.rb

@@ -0,0 +1,24 @@
+module Backyard
+  class ModelStore
+
+    def initialize
+      @store ||= {}
+    end
+
+    def put(name, object)
+      @store[object.class] ||= {}
+      @store[object.class][name] = object
+    end
+
+    def get(klass, name)
+      models = @store[klass]
+      unless models.nil?
+        models[name]
+      end
+    end
+
+    def get_collection(klass)
+      @store[klass] || []
+    end
+  end # END ModelStore
+end # END Backyard

data/lib/backyard/session.rb

@@ -0,0 +1,110 @@
+module Backyard
+  module Session
+
+    # Put a model in the backyard.
+    #
+    # @overload put_model(type, name, attributes)
+    #   creates an instance from type 'type' and saved it under the
+    #   passed name. The attributes are forwarded to the object creation
+    #   @param [Symbol] type the type of object that should get created
+    #   @param [String] name the name for the newly created object
+    #   @param [Hash] attributes additional parameters for the object creation
+    # @overload put_model(object, name)
+    #   stores the given object under 'name'
+    #   @param [Object] object the object to store
+    #   @param [String] name the name for the object
+    # @return [Object] the object, which was stored
+    def put_model(model_type, name = nil, attributes = {})
+      model_name = name.nil? ? adapter.generate_model_name(model_type) : name
+      obj = if model_type.is_a?(String) || model_type.is_a?(Symbol)
+              klass = class_for_type(model_type)
+              attributes = apply_model_config(klass, model_name).merge(attributes)
+              adapter.create(model_type, attributes)
+            else
+              model_type
+            end
+      model_store.put(model_name, obj)
+    end
+
+    # Retrieve a stored object from the backyard.
+    #
+    # @param [Symbol] type the type of the object to retrieve
+    # @param [String] name the name of the object to retrieve
+    # @return [Object, nil] the object with the given type and name
+    def get_model(model_type, name)
+      klass = class_for_type(model_type)
+      result = model_store.get(klass, name)
+      reload_model(result)
+    end
+
+    # Check if a model is stored in the backyard.
+    #
+    # @param [Symbol] type the type of the object
+    # @param [String] name the name of the object
+    # @return [true, false]
+    def model_exists?(model_type, name)
+      get_model(model_type, name) != nil
+    end
+
+    # This method is used when you don't care if you get an existing
+    # instance or if a new one is beeing created.
+    #
+    # @see #get_model
+    # @see #put_model
+    #
+    # @param [Symbol] model_type the type of the object
+    # @param [String] name the name of the object
+    # @return [Object] an object with the given type and name
+    def model(model_type, name, attributes = {})
+      if model_exists?(model_type, name)
+        get_model(model_type, name)
+      else
+        put_model(model_type, name, attributes)
+      end
+    end
+
+    # Retrieve all objects for a given type.
+    #
+    # @param [Symbol] type the type of the objects to retrieve
+    # @return [Array<Object>] an array of objects of the given type
+    def get_models(model_type)
+      model_store.get_collection class_for_type(model_type)
+    end
+
+    def model_store
+      @store ||= ModelStore.new
+    end
+
+    protected
+
+    def adapter
+      @adapter ||= Backyard.config.adapter_instance
+    end
+
+    def reload_model(model)
+      if model.respond_to?(:reload)
+        model.reload
+      else
+        model
+      end
+    end
+
+    def class_for_type(model_type)
+      klass = if model_type.kind_of?(Class)
+                model_type
+              else
+                adapter.class_for_type(model_type)
+              end
+    end
+
+    def apply_model_config(klass, model_name)
+      model_config = Backyard.config.config_for(klass)
+      name_attributes = model_config.name_attributes.map { |attribute| [attribute, model_name]}
+      block_attributes = model_config.name_blocks.inject({}) do |attrs, block|
+        attrs.merge(instance_exec model_name, &block)
+      end
+      Hash[name_attributes].merge(block_attributes)
+    end
+
+  end
+end

data/lib/backyard/version.rb

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

data/lib/backyard.rb

@@ -0,0 +1,16 @@
+require 'backyard/configuration'
+require 'backyard/adapter'
+require 'backyard/model_store'
+require 'backyard/session'
+
+module Backyard
+  def self.configure(&block)
+    @config = Backyard::Configuration.new
+    @config.instance_eval(&block)
+  end
+
+  def self.config
+    @config ||= Backyard::Configuration.new
+    @config
+  end
+end

data/spec/backyard/adapter/factory_girl_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe Backyard::Adapter::FactoryGirl do
+
+  describe "#create" do
+    it "should delegate to factory_girl" do
+      subject.should_receive(:Factory).with(:entry, {:name => '123 Entry'})
+      subject.create :entry, {:name => '123 Entry'}
+    end
+  end
+
+  describe "#class_for_type" do
+    it "should work with a factory where the class is specified as text" do
+      subject.class_for_type(:my_string_factory).should == String
+    end
+
+    it "should work with a factory where the class is specified as an Object" do
+      subject.class_for_type(:my_hash_factory).should == Hash
+    end
+
+    it "should work with a factory where the class is guessed" do
+      subject.class_for_type(:array).should == Array
+    end
+
+    context "when no factory is defined" do
+      it "should raise an ArgumentError" do
+        lambda do
+          subject.class_for_type(:i_am_not_a_valid_factory)
+        end.should raise_error(ArgumentError)
+      end
+    end
+  end
+
+end

data/spec/backyard/adapter_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe Backyard::Adapter do
+
+  describe "#class_for_type" do
+    it "should transform the type into a CamelCase Class" do
+      subject.class_for_type(:user_session).should == 'UserSession'
+    end
+  end
+
+  describe "#create" do
+    it "should raise a NotImplementedError" do
+      lambda do
+        subject.create(:post, {})
+      end.should raise_error(NotImplementedError)
+    end
+  end
+
+  describe "#generate_model_name" do
+    it "should use the capitalized name as starting point" do
+      subject.generate_model_name(:user).should be_start_with('User ')
+    end
+
+    it "should always generate a unique name" do
+      (1..10).map { subject.generate_model_name(:article) }.uniq.should have(10).items
+    end
+  end
+
+end

data/spec/backyard/configuration_spec.rb

@@ -0,0 +1,60 @@
+require 'spec_helper'
+
+describe Backyard::Configuration do
+
+  subject { Backyard::Configuration.new }
+
+  describe "#name_attribute" do
+    context "with single for key" do
+      it "should store the specified attribtues" do
+        subject.name_attribute :username, :for => :string
+        subject.config_for(String).name_attributes.should == [:username]
+      end
+    end
+
+    context "for multiple models" do
+      it "should store the specified attribtues" do
+        subject.name_attribute :title, :for => [:string, :array, :hash]
+        subject.config_for(Hash).name_attributes.should == [:title]
+        subject.config_for(Array).name_attributes.should == [:title]
+        subject.config_for(String).name_attributes.should == [:title]
+      end
+    end
+  end
+
+  describe "#name_for" do
+
+    context "with a single model" do
+      it "should store the block in the model config" do
+        my_block = lambda {|name| }
+        subject.name_for :array, &my_block
+        subject.config_for(Array).name_blocks.should include(my_block)
+      end
+    end
+
+    context "for multiple models" do
+      it "should store the block in the model config" do
+        my_block = lambda {|name| }
+        subject.name_for :array, :hash, &my_block
+        subject.config_for(Array).name_blocks.should include(my_block)
+        subject.config_for(Hash).name_blocks.should include(my_block)
+      end
+    end
+  end
+
+  describe "#use_adapter" do
+    it "should set the specified adapter" do
+      subject.use_adapter :factory_girl
+      subject.adapter_instance.should be_kind_of(Backyard::Adapter::FactoryGirl)
+    end
+  end
+
+  describe "#adapter_instance" do
+    describe "default: " do
+      it "should return the factory girl adapter" do
+        subject.adapter_instance.should be_kind_of(Backyard::Adapter::FactoryGirl)
+      end
+    end
+  end
+
+end

data/spec/backyard/model_store_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+describe Backyard::ModelStore do
+
+  subject { Backyard::ModelStore.new }
+
+  it "should store models" do
+    subject.put "John", [:i, :am, :john]
+    subject.get(Array, "John").should == [:i, :am, :john]
+  end
+
+  it "should store models with different types and the same name" do
+    subject.put "Jane", "This is Jane"
+    subject.put ["Jane"], %w(this is jane)
+    subject.get(String, 'Jane').should == "This is Jane"
+  end
+
+  describe "#get_collection" do
+    context "without models" do
+      it "should return an emtpy array" do
+        subject.get_collection(Hash).should == []
+      end
+    end
+
+    context "with models" do
+      before do
+        subject.put "John", "I am John"
+        subject.put "Jane", "I am Jane"
+      end
+
+      it "should return 2 items" do
+        subject.get_collection(String).should have(2).items
+      end
+
+
+      it "should return the models" do
+        subject.get_collection(String).should == {
+          'John' =>'I am John',
+          'Jane' => 'I am Jane'
+        }
+      end
+    end
+  end
+
+end

data/spec/backyard/session_spec.rb

@@ -0,0 +1,114 @@
+require 'spec_helper'
+
+describe Backyard::Session do
+
+  let(:model_store) { mock }
+  let(:adapter) { mock }
+
+  subject do
+    sessionClass = Class.new do
+      include Backyard::Session
+    end
+    session = sessionClass.new
+    session.stub(:adapter => adapter)
+    session.stub(:model_store => model_store)
+    session
+  end
+
+  describe "#get_model" do
+
+    it "should delegate to the model_store" do
+      adapter.should_receive(:class_for_type).with(:user).and_return(Struct)
+      model_store.should_receive(:get).with(Struct, 'Jeremy').and_return('I am Jeremy')
+      subject.get_model(:user, 'Jeremy').should == 'I am Jeremy'
+    end
+
+    context "with a reloadable model" do
+      it "should return the reloaded model" do
+        object = Array.new
+        object.should_receive(:reload).and_return(['I', 'am', 'reloaded'])
+
+        adapter.should_receive(:class_for_type).with(:array).and_return(Array)
+        model_store.should_receive(:get).with(Array, 'Reloadable Array').and_return(object)
+
+        subject.get_model(:array, 'Reloadable Array').should == ['I', 'am', 'reloaded']
+      end
+    end
+
+  end
+
+  describe "#get_models" do
+
+    it "should delegate to the model_store" do
+      adapter.should_receive(:class_for_type).with(:array).and_return(Array)
+      model_store.should_receive(:get_collection).with(Array).and_return([[1], [2]])
+      subject.get_models(:array).should == [[1], [2]]
+    end
+  end
+
+  describe "#put_model" do
+    context "with a name" do
+      context "with an attributes Hash" do
+        it "should delegate to the model_store" do
+          adapter.should_receive(:create).with(:post, {}).and_return('The Post')
+          adapter.should_receive(:class_for_type).with(:post).and_return(String)
+
+          model_store.should_receive(:put).with('First Post!', 'The Post')
+          subject.put_model(:post, 'First Post!')
+        end
+      end
+    end
+
+    context "without a name" do
+      it "should generate a name" do
+        adapter.should_receive(:create).with(:note, {}).and_return('The Note')
+        adapter.should_receive(:class_for_type).with(:note).and_return(String)
+        adapter.should_receive(:generate_model_name).with(:note).and_return { 'Note 123' }
+        model_store.should_receive(:put).with('Note 123', 'The Note')
+
+        subject.put_model(:note)
+      end
+    end
+
+    context "with an object" do
+      it "should store the object under the given name" do
+        model_store.should_receive(:put).with('Johnny', {:me => 'Johhny'})
+        subject.put_model({:me => 'Johhny'}, 'Johnny')
+      end
+    end
+  end
+
+  describe "#model_exists?" do
+    context "the model is present" do
+      it "should return true" do
+        subject.should_receive(:get_model).with(:user, 'James').and_return('This is James')
+        subject.model_exists?(:user, 'James').should be_true
+      end
+    end
+
+    context "the model does not exist" do
+      it "should return false" do
+        subject.should_receive(:get_model).with(:user, 'James').and_return(nil)
+        subject.model_exists?(:user, 'James').should be_false
+      end
+    end
+  end
+
+  describe "#model" do
+    context "the model with the given name exists" do
+      it "should return the existing model" do
+        subject.should_receive(:get_model).with(:note, 'welcome').twice.and_return('Hallo')
+        subject.model(:note, 'welcome').should == 'Hallo'
+      end
+    end
+
+    context "no model exists for the given name" do
+      it "should create a new model" do
+        subject.should_receive(:get_model).with(:note, 'see you').and_return(nil)
+        subject.should_receive(:put_model).with(:note, 'see you', {}).and_return('The Note')
+        subject.model(:note, 'see you').should == 'The Note'
+      end
+    end
+  end
+
+end

data/spec/backyard_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe Backyard do
+
+  describe ".configure" do
+    it "should eval the configuration block in the Backyard::Configuration scope" do
+      scope = nil
+      Backyard.configure do
+        scope = self
+      end
+      scope.should be_kind_of(Backyard::Configuration)
+    end
+  end
+
+  describe ".config" do
+    it "should return a Backyard::Configuration" do
+      Backyard.configure {}
+      Backyard.config.should be_kind_of(Backyard::Configuration)
+    end
+  end
+
+end

data/spec/factories.rb

@@ -0,0 +1,15 @@
+Factory.define :string do |f| end
+Factory.define :array do |f| end
+Factory.define :hash do |f| end
+Factory.define :my_string_factory, :class => 'String' do |f| end
+Factory.define :my_hash_factory, :class => Hash do |f| end
+
+require File.join(File.dirname(__FILE__), 'models')
+
+Factory.define :user do |f|
+  f.username 'John Doe'
+end
+
+Factory.define :account do |f|
+  f.description '<missing>'
+end

data/spec/models/account.rb

@@ -0,0 +1,3 @@
+class Account < ActiveRecord::Base
+  belongs_to :owner, :class_name => 'User'
+end

data/spec/models/user.rb

@@ -0,0 +1,3 @@
+class User < ActiveRecord::Base
+  has_many :accounts, :foreign_key => 'owner_id'
+end

data/spec/models.rb

@@ -0,0 +1,21 @@
+require 'active_record'
+
+ActiveRecord::Base.establish_connection(:adapter => "sqlite3",
+                                        :database  => ":memory:")
+orig_stdout = $stdout
+$stdout = File.new('/dev/null', 'w')
+ActiveRecord::Schema.define do
+  create_table :users do |t|
+    t.string :username
+    t.string :email
+  end
+
+  create_table :accounts do |t|
+    t.string :description
+    t.integer :owner_id
+  end
+end
+$stdout = orig_stdout
+
+require File.join(File.dirname(__FILE__), 'models', 'user')
+require File.join(File.dirname(__FILE__), 'models', 'account')

data/spec/spec_helper.rb

@@ -0,0 +1,21 @@
+require File.join(File.dirname(__FILE__), '..', 'lib', 'backyard')
+require 'factory_girl'
+require 'backyard/adapter/factory_girl'
+
+Factory.find_definitions
+
+RSpec.configure do |config|
+  # == Mock Framework
+  #
+  # If you prefer to use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+  config.mock_with :rspec
+
+  # If you're not using ActiveRecord, or you'd prefer not to run each of your
+  # examples within a transaction, comment the following line or assign false
+  # instead of true.
+  # config.use_transactional_fixtures = true
+end

metadata

@@ -0,0 +1,190 @@
+--- !ruby/object:Gem::Specification 
+name: backyard
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Yves Senn
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-24 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: factory_girl
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: sqlite3
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id006
+description: backyard allows you to name the models in your cucumber scenarios.
+email: 
+- yves.senn@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- History.txt
+- README.md
+- Rakefile
+- backyard.gemspec
+- cucumber.yml
+- features/backyard_with_factory_girl.feature
+- features/step_definitions/backyard_account_steps.rb
+- features/step_definitions/backyard_steps.rb
+- features/step_definitions/backyard_user_steps.rb
+- features/support/backyard.rb
+- features/support/env.rb
+- lib/backyard.rb
+- lib/backyard/adapter.rb
+- lib/backyard/adapter/factory_girl.rb
+- lib/backyard/configuration.rb
+- lib/backyard/cucumber.rb
+- lib/backyard/model_store.rb
+- lib/backyard/session.rb
+- lib/backyard/version.rb
+- spec/backyard/adapter/factory_girl_spec.rb
+- spec/backyard/adapter_spec.rb
+- spec/backyard/configuration_spec.rb
+- spec/backyard/model_store_spec.rb
+- spec/backyard/session_spec.rb
+- spec/backyard_spec.rb
+- spec/factories.rb
+- spec/models.rb
+- spec/models/account.rb
+- spec/models/user.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://rubygems.org/gems/backyard
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: backyard
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: manage the models in your cucumbers with ease
+test_files: 
+- features/backyard_with_factory_girl.feature
+- features/step_definitions/backyard_account_steps.rb
+- features/step_definitions/backyard_steps.rb
+- features/step_definitions/backyard_user_steps.rb
+- features/support/backyard.rb
+- features/support/env.rb
+- spec/backyard/adapter/factory_girl_spec.rb
+- spec/backyard/adapter_spec.rb
+- spec/backyard/configuration_spec.rb
+- spec/backyard/model_store_spec.rb
+- spec/backyard/session_spec.rb
+- spec/backyard_spec.rb
+- spec/factories.rb
+- spec/models.rb
+- spec/models/account.rb
+- spec/models/user.rb
+- spec/spec_helper.rb