pickle-has_many_support 0.3.1

data/.gitignore

@@ -0,0 +1,5 @@
+pkg
+doc/*
+.yardoc
+pickle-email*
+cucumber_test_app

data/History.txt

@@ -0,0 +1,331 @@
+== 0.3.0
+
+* 2 major improvements
+  * Mechanism for registering ORM adapters for pickle [Daniel Neighman]
+  * Adapters for ActiveRecord and DataMapper [Josh Bassett, Daniel Neighman]
+
+
+== 0.2.12
+
+* 1 bugfix
+  * script/generate pickle paths now works correctly with cucumber-rails 0.3.2
+
+
+== 0.2.11
+
+* 1 improvement
+  * use correct type when converting STI pickle model to attributes 
+
+
+== 0.2.10
+
+* 2 improvements
+  * pickle backend is rails 3 compatible (but generators are not yet)
+  * modular Rakefile, devs can run only what they're interested in without having to install all gems
+
+
+== 0.2.9 - 27 Apr 2010 (the #railscamp7 release)
+
+* 5 improvements
+  * Fixed problem with verifying model attribute using strings with escaped quotes [Michael MacDonald]
+  * Added handling for positive and negative floats [Michael MacDonald, #railscamp7]
+  * Added handling of ruby integer syntax (e.g. 1_000_000) [Ian White]
+  * Modified the way pickle handles predicates to match rspec [Michael MacDonald, #railscamp7]
+  * Added step to assert size of an association (e.g. Then the user should have 4 friends) [Ian White]
+
+
+== 0.2.8 - 5 Apr 2010
+
+* 1 minor improvement
+  * 'Then show me the email' works as expected now [#18]
+
+
+== 0.2.7 - 5 Apr 2010
+
+* 1 minor improvement
+  * just rake 'rake cucumber' and a rails app will be setup for you if required (rails 2.3 only ATM)
+
+
+== 0.2.6 - 5 Apr 2010
+
+* 2 improvements
+  * running specs is now doable without being in a rails app - just do 'rake spec'
+  * running features is more straightforward, 'rake cucumber' then follow the instructions
+  
+  
+== 0.2.5 - 17 Mar 2010
+
+* 2 improvements
+  * Bugfix for find_models_via_table (failing to find models was not causing an error) [Chris Flipse]
+  * find_models_via_table & create_models_via_table return the found/created models [Chris Flipse, Ian White]
+
+
+== 0.2.4 - 9 Mar 2010
+
+* 1 major improvement
+  * Finding models via a table now works in the same way as creating models via a table (0.2.3), you
+    can create pickle refs
+
+
+== 0.2.3 - 9 Mar 2010
+
+* 1 major improvement
+  * You can now use pickle refs in tables.  If you add a column which is the single factory name, the
+    contents of the column will be used as the pickle ref.  [Stephan Hagemann]
+    e.g.
+      Given the following users exist:
+        | user | name        | status |
+        | jack | Jack Spratt | alone  |
+        | pete | Pete Sprong | dead   |
+  
+* 1 minor improvement
+  * Fix bug in error message for when pickle ref can't be found [Myron Marston]
+
+
+== 0.2.2 - 25 Feb 2010
+
+* 3 improvements
+  * Added ability to follow links in emails (see email_steps.rb) [Michael Moen]
+  * Added a step definition for doing stuff like: Then the user's name should be "Tobi" [Tobi Knaup]
+  * Docfixes, mostly about testing [Nicholas Rutherford]
+  
+  
+== 0.2.1 - 1 Dec 2009
+
+* 2 minor improvements
+  * Allow nil as field value [#14]
+  * Added negative email step for delivered to
+
+
+== 0.2.0 - 24 Nov 2009
+
+* 4 major improvements
+  * Added support for finding models using tables
+    Example:
+      Then the following users should exist:
+        | name  |
+        | Fred  |
+        | Ethel |
+      And the 1st user should be male
+      And the 2nd user should be female
+      
+  * tables now support pickle refs in cells (see features/pickle/create_from_factory_girl.rb#37)
+  
+  * features/support/email.rb adds an email helper for mapping names to email addresses (similar to NavigationHelper in paths.rb)
+  
+  * Added ability for path_to_pickle to handle arbitrary segments
+    Example:
+      path_to_pickle('account', 'the enquiry') => account_enquiry_path(<enquiry>)
+
+* 2 minor improvements
+  * fail faster in pickle steps when a pickle ref can't be found, by using model! in most places
+
+  * generated pickle steps are less picky about possessives so that pickle mappings accepted in more places
+    e.g. when you have
+        config.map 'my', 'I', 'myself', :to => 'user: "me"'
+      you can now do
+        Given I exist
+        ...
+        Then the project should be one of my assigned projects
+
+
+== 0.1.23 - 22 Nov 2009
+
+* 1 major improvement
+  * script/generate pickle now adds its own pickle.rb support file, making it easier to regenerate cucumber
+    when a new release of cucumber appears [schlick, ianwhite]
+
+* 1 minor improvement
+  * docs: more links
+  
+
+== 0.1.22 - 7 Nov 2009
+
+* 2 minor enhancements
+  * Improved docs to include instructions for FactoryGirl users, and links/resources for pickle users
+  * Ruby 1.9.1 compatibility changes
+
+
+== 0.1.21
+
+* 1 minor enhancement
+  * Added 'should not' steps corresponding to model existence, and association exitsence [schlick]
+
+
+== 0.1.20
+
+* 1 minor enhancement
+  * Pickle now matches numeric field values preceded with a positive and negative sign eg +1.5 and -1 [schlick]
+
+
+== 0.1.19
+
+* 1 minor enhancement
+  * Add support for Cucumber tables [Tobi Knaup]
+  
+
+== 0.1.16, 0.1.17, 0.1.18 - 13 Oct 2009
+
+* 1 minor enhancement
+  * release gem on gemcutter and code on github
+
+
+== 0.1.15 - 28 Aug 2009
+
+* 1 minor enhancement
+  * avoid namespace collision on replace by renaming mapping#replace -> mapping#replacement [nruth]
+
+
+== 0.1.14 - 9 July 2009
+
+* 1 minor enhancement
+  * update specs and features for latest cucumber and machinist changes
+
+
+== 0.1.13 - 16 June 2009    
+
+* 2 minor enhancements
+  * model! and created_model! raise an error if pickle name can't be found
+  * path_to_pickle uses the above to give back a better error message
+
+
+== 0.1.12 - 7 Apr 2009
+
+* 2 minor enhancements
+  * rationalised Rakefile
+  * update World extensions for latest cucumber changes
+
+
+== 0.1.11 - 22 Feb 2009
+
+* 2 minor enhancements
+  * Pickle now supports multiple machinist blueprints
+  * Fix confusing adapter/adaptor comment generator comment 
+
+
+== 0.1.10 - 13 Feb 2009
+
+* 2 minor enhancements
+  * Made pickle paths generator compatible with latest cucumber
+  * Simplified and Rakefile, including auto push api docs to gh-pages on ci build
+
+
+== 0.1.9 - 29 Jan 2009
+
+* 1 minor enhancement
+  * Pickle::Adapter.model_classes excludes those without tables
+
+
+== 0.1.8 - 29 Jan 2009
+
+* API change
+  * pickle_path becomes path_to_pickle, to avoid named route clashes
+
+* 2 minor enhancements
+  * Updated features for cucumber 0.2 compat
+  * Made paths allow for optional possesives
+
+
+== 0,1,7
+
+* 2 API changes
+  * script/generate pickle path[s] now amends the features/support/paths.rb file
+    instead of creating pge_to_path and path_steps.
+    
+  * pickle_email_steps is renamed email_steps
+
+
+== 0.1.6
+
+* 1 API change
+  * to use pickle env.rb should contain "require 'pickle/world'".  You should remove all trace of
+    pickle from features/support/env.rb and re run script/generate pickle
+
+* 2 major enhancements
+
+  * generate email steps with `script/generate pickle email`
+    email steps allow you to do things like this:
+    
+      Then 2 emails should be delivered
+      And the first email should be delivered to fred@gmail.com
+      And the 2nd email should be delivered to the user: "ethel"
+      
+      Then 1 email should be delivered with subject: "Activate your account"
+      And the email should link to the user's page
+    
+    take a look at features/step_definitions/pickle_email_steps.rb
+      
+  * generate path steps with `script/generate pickle path`
+    path steps allow you to do things like this
+    
+      When I go to the comment's page
+      Then I should be at the user's new comment page
+    
+    take a look at features/step_definitions/pickle_path_steps.rb, and modify page_to_path to suit your needs
+
+* 4 minor enhancements
+  * Improved documentation
+  * abstract models no longer kill pickle
+  * Actually test that the generators work
+  * Made Pickle::Session a plain ole mixin, as a separate class was unnecessary
+  * Pickle uses the cucumber World API
+
+
+== 0.1.5
+
+* API change
+  * CaptureModel, etc are now 'capture_model' methods
+
+* 3 major enhancements
+  * Steps for asserting that <n> models exist, matching certain criteria
+  * Steps for asserting associations added to generated pickle steps
+      'Then the user should be in the post's commenters'
+      'Then the forum: "awesome" should be the 2nd post's forum'
+  * configuration can now occur any time before a step is defined, which makes
+    for much more intuitive env.rb
+
+* 2 minor enhancement
+  * predicate matching is less prone to step conflicts because we preload a 
+    big list of all the predicate and column methods
+  * field values now handle booleans and numerics
+
+
+== 0.1.4
+
+* 1 major enhancement
+  * You can create multiple models with ease, for eg.
+      'Given 10 users exist with role: "admin"'
+
+* 1 minor enhancement
+  * You can do Pickle.configure (just like Webrat.configure)
+
+
+== 0.1.3 - Bugfix release
+
+* 1 minor enhancement
+  * make generated steps compatible with Rails 2.1
+
+
+== 0.1.2
+
+* 2 major enhancements
+  * create your pickle steps with script/generate pickle
+  * Adapter based architecture, supports Machinist, FactoryGirl, and vanilla ActiveRecord
+  
+* 1 minor enhancement
+  * model_names now defaults to subclasses of AR::Base
+  * #original_model => #created_model
+
+
+== 0.1.1
+
+* 1 major enhancement:
+  * made pickle a github gem
+
+* 1 minor enhancement:
+  * Added intentions for pickle in README.textile
+
+
+== Prior to gems
+
+* Initial release: everything is subject to sweeping change

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2008-2010 Ian White - ian.w.white@gmail.com
+
+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.rdoc

@@ -0,0 +1,299 @@
+= pickle
+
+Pickle gives you cucumber steps that create your models easily from factory-girl or
+machinist factories/blueprints.  You can also just use ActiveRecord as a factory but it's not as cool.
+
+Pickle can make use of different ORMs for finding records.  Currently ActiveRecord and DataMapper adapters are
+provided.  More adapters welcome!
+
+References to the models are stored in the current world, not necessarily for the purpose of checking the db
+(although you could use it for that), but for enabling easy reference to urls, and for
+building complex givens which require a bunch of models collaborating
+
+== Resources
+
+<b>Github</b> for code: http://github.com/ianwhite/pickle
+
+<b>Gemcutter</b> for the gem: http://gemcutter.org/gems/pickle
+
+<b>Rdoc.info</b> for docs: http://rdoc.info/projects/ianwhite/pickle
+
+<b>Google group</b> for questions: http://groups.google.com/group/pickle-cucumber
+
+<b>Lighthouse</b> for bugs: http://ianwhite.lighthouseapp.com/projects/25941-pickle
+
+<b>Railscast</b> presentation: http://railscasts.com/episodes/186-pickle-with-cucumber
+
+<b>Blog articles</b>: {dynamic50: Integration testing with cucumber and pickle}[http://blog.dynamic50.com/index.php/2009/04/integration-testing-with-cucumber-and-pickle/], {rubyflare: pickle my cucumber}[http://rubyflare.com/2009/10/28/pickle-my-cucumber/]
+
+== Install
+
+Install pickle either as a rails plugin, or a gem
+
+  # gem from gemcutter
+  sudo gem install pickle
+
+  # gem dependency (in config/environments/cucumber.rb)
+  config.gem 'pickle'
+
+  # plugin
+  script/plugin install git://github.com/ianwhite/pickle.git
+
+  # or, plugin as submodule
+  git submodule add git://github.com/ianwhite/pickle.git vendor/plugins/pickle
+
+== CI
+
+It's tested against all stable branches of 2.x rails, and edge, with the latest versions of rspec, cucumber, factory_girl, machinist.
+
+== Run the tests
+
+To run the specs do:
+
+  rake spec
+
+To run the features (rails 2.3 only ATM):
+
+  rake cucumber
+
+== Contributors
+
+The following people have made Pickle better:
+
+* {Daniel Neighman}[http://github.com/hassox]
+* {Josh Bassett}[http://github.com/nullobject]
+* {Nick Rutherford}[http://github.com/nruth]
+* {Tobi Knaup}[http://github.com/guenter]
+* {Michael MacDonald}[http://github.com/schlick]
+* {Michael Moen}[http://github.com/UnderpantsGnome]
+* {Myron Marston}[http://github.com/myronmarston]
+* {Stephan Hagemann}[http://github.com/xing]
+* {Chris Flipse}[http://github.com/cflipse]
+
+== Get Started
+
+(you'd better install cucumber)
+
+  script/generate pickle [paths] [email]
+
+Now have a look at <tt>features/step_definitions/pickle_steps.rb</tt>
+
+If you want path steps and email steps then just add 'paths' and/or 'email'.  The code/steps will be
+written to <tt>features/env/paths.rb</tt> and
+<tt>features/step_definitions/email_steps.rb</tt> respectively.
+
+=== Using with plain ole Active Record or DataMapper
+
+Pickle comes with adapters for Active Record and DataMapper.
+
+If you have an AR/DM called 'Post', with required fields 'title', and 'body', then you can now write
+steps like this
+
+  Given a post exists with title: "My Post", body: "My body"
+
+=== Using with factory-girl or machinist
+
+But you're using Machinist or FactoryGirl right?!  To leverage all of the factories/blueprints
+you've written, you can just do stuff like
+
+  Given a user exists
+  And another user exists with role: "admin"
+
+  # later
+  Then a user should exist with name: "Fred"
+  And that user should be activated # this uses rspec predicate matchers
+
+==== Machinst: require your blueprints and reset Shams
+
+(The latest version of pickle supports {multiple blueprints}[http://github.com/notahat/machinist/commit/d6492e6927a8aa1819926e48b22377171fd20496], for
+earlier versions of machinist use pickle <= 0.1.10)
+
+In your <tt>features/support/env.rb</tt> add the following lines at the bottom
+
+  require "#{Rails.root}/spec/blueprints" # or wherever they live
+  Before { Sham.reset } # reset Shams in between scenarios
+
+==== FactoryGirl: make sure factories are loaded
+
+In your config/environments/cucumber.rb file, make sure the factory-girl gem is included (unless it's installed as a plugin).
+
+If that doesn't solve loading issues then require your factories.rb file directly in a file called 'features/support/factory_girl.rb'
+
+  # example features/support/factory_girl.rb
+  require File.dirname(__FILE__) + '/../../spec/factories'
+
+=== Using with an ORM other than ActiveRecord or DataMapper
+
+Pickle can be used with any Modeling library provided there is an adapter written for it.
+
+Adapters are very simple and exist a module or class with the name "PickleAdapter" available to the class.  For example
+
+User.const_get(:PickleAdapter) #=> should return a pickle adapter
+
+The Active Record and DataMapper ones can be found at
+ActiveRecord::Base::PickleAdapter and DataMapper::Resource::PickleAdapter respectively.
+
+See how to implement one by looking at the ones provided in the pickle source in lib/pickle/adapters/*
+
+=== Configuring Pickle
+
+You can tell pickle to use another factory adapter (see Pickle::Adapter), or
+create mappings from english expressions to pickle model names.  You can also
+override many of the options on the Pickle::Config object if you so choose.
+
+In: <tt>features/support/pickle.rb</tt>
+
+  require 'pickle/world'
+
+  Pickle.configure do |config|
+    config.adapters = [:machinist, YourOwnAdapterClass]
+    config.map 'me', 'myself', 'my', 'I', :to => 'user: "me"'
+  end
+
+Out of the box pickle looks for machinist, then factory-girl, then finally active-record 'factories'.
+If you find that your steps aren't working with your factories, it's probably the case that your factory
+setup is not being included in your cucumber environment (see comments above regarding machinist and factory-girl).
+
+== API
+
+=== Steps
+
+When you run <tt>script/generate pickle</tt> you get the following steps
+
+==== Given steps
+
+"Given <b>a model</b> exists",  e.g.
+
+  Given a user exists
+  Given a user: "fred" exists
+  Given the user exists
+
+"Given <b>a model</b> exists with <b>fields</b>",  e.g.
+
+  Given a user exists with name: "Fred"
+  Given a user exists with name: "Fred", activated: false
+
+You can refer to other models in the fields
+
+  Given a user exists
+  And a post exists with author: the user
+
+  Given a person: "fred" exists
+  And a person: "ethel" exists
+  And a fatherhood exists with parent: user "fred", child: user "ethel"
+
+"Given <b>n models</b> exist", e.g.
+
+  Given 10 users exist
+
+"Given <b>n models</b> exist with <b>fields</b>", examples:
+
+  Given 10 users exist with activated: false
+
+"Given the following <b>models</b> exist:", examples:
+
+  Given the following users exist
+    | name  | activated |
+    | Fred  | false     |
+    | Ethel | true      |
+
+==== Then steps
+
+===== Asserting existence of models
+
+"Then <b>a model</b> should exist",  e.g.
+
+  Then a user should exist
+
+"Then <b>a model</b> should exist with <b>fields</b>", e.g.
+
+  Then a user: "fred" should exist with name: "Fred" # we can label the found user for later use
+
+You can use other models, booleans, numerics, and strings as fields
+
+  Then a person should exist with child: person "ethel"
+  Then a user should exist with activated: false
+  Then a user should exist with activated: true, email: "fred@gmail.com"
+
+"Then <b>n models</b> should exist", e.g.
+
+  Then 10 events should exist
+
+"Then <b>n models</b> should exist with <b>fields</b>", e.g.
+
+  Then 2 people should exist with father: person "fred"
+
+"Then the following <b>models</b> exist". This allows the creation of multiple models
+using a table syntax. Using a column with the singularized name of the model creates a referenceable model. E.g.
+
+  Then the following users exist:
+    | name   | activated |
+    | Freddy | false     |
+
+  Then the following users exist:
+    | user | name   | activated |
+    | Fred | Freddy | false     |
+
+===== Asserting associations
+
+One-to-one assocs: "Then <b>a model</b> should be <b>other model</b>'s <b>association</b>", e.g.
+
+  Then the person: "fred" should be person: "ethel"'s father
+
+Many-to-one assocs: "Then <b>a model</b> should be [in|one of] <b>other model</b>'s <b>association</b>", e.g.
+
+  Then the person: "ethel" should be one of person: "fred"'s children
+  Then the comment should be in the post's comments
+
+===== Asserting predicate methods
+
+"Then <b>a model</b> should [be|have] [a|an] <b>predicate</b>", e.g.
+
+  Then the user should have a status # => user.status.should be_present
+  Then the user should have a stale password # => user.should have_stale_password
+  Then the car: "batmobile" should be fast # => car.should be_fast
+
+"Then <b>a model</b> should not [be|have] [a|an] <b>predicate</b>", e.g.
+
+  Then person: "fred" should not be childless # => fred.should_not be_childless
+
+=== Regexps for use in your own steps
+
+By default you get some regexps available in the main namespace for use
+in creating your own steps: `capture_model`, `capture_fields`, and others (see lib/pickle.rb)
+
+(You can use any of the regexps that Pickle uses by using the Pickle.parser namespace, see
+Pickle::Parser::Matchers for the methods available)
+
+*capture_model*
+
+  Given /^#{capture_model} exists$/ do |model_name|
+    model(model_name).should_not == nil
+  end
+
+  Then /^I should be at the (.*?) page$/ |page|
+    if page =~ /#{capture_model}'s/
+      url_for(model($1))
+    else
+      # ...
+    end
+  end
+
+  Then /^#{capture_model} should be one of #{capture_model}'s posts$/ do |post, forum|
+    post = model!(post)
+    forum = model!(forum)
+    forum.posts.should include(post)
+  end
+
+*capture_fields*
+
+This is useful for setting attributes, and knows about pickle model names so that you
+can build up composite objects with ease
+
+  Given /^#{capture_model} exists with #{capture_fields}$/ do |model_name, fields|
+    create_model(model_name, fields)
+  end
+
+  # example of use
+  Given a user exists
+  And a post exists with author: the user # this step will assign the above user as :author on the post

data/Rakefile

@@ -0,0 +1,20 @@
+$:.unshift File.expand_path('lib')
+
+# load given tasks file, reporting errors without failing
+def load_tasks(tasks)
+  load tasks
+rescue Exception => exception
+  $stderr << "** loading #{tasks.sub(File.expand_path('.'),'')} failed: "
+  case exception
+  when LoadError
+    $stderr << "to use, install the gems it requires\n"
+  else
+    $stderr << ([exception.message] + exception.backtrace[0..2]).join("\n    ") << "\n\n"
+  end
+end
+
+Dir["Rakefile.d/*.rake"].sort.each {|t| load_tasks t}
+
+task :default => :spec
+
+task :ci => ['rcov:verify', 'cucumber']

data/Rakefile.d/cucumber.rake

@@ -0,0 +1,24 @@
+require 'cucumber/rake/task'
+
+desc "Run features"
+Cucumber::Rake::Task.new(:cucumber => [:cucumber_test_app]) do |t|
+  t.cucumber_opts = ['--format', 'pretty', '--require', 'features']
+end
+
+desc "setup a rails app for running cucumber"
+file "cucumber_test_app" do
+  puts "** setting up cucumber test app ** (rails 2.3 only at present)"
+  Rake::Task['cucumber:setup'].invoke
+end
+
+namespace :cucumber do
+  task :setup do
+    rm_rf "cucumber_test_app"
+    sh "rails cucumber_test_app"
+    cd "cucumber_test_app" do
+      sh "script/generate rspec"
+      sh "script/generate cucumber"
+    end
+    sh "ln -s #{File.expand_path('.')} cucumber_test_app/vendor/plugins/pickle"
+  end
+end