raffle_v1 0.0.4 → 0.0.5

data/lib/database_cleaner-0.7.2/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Ben Mabey
+
+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/lib/database_cleaner-0.7.2/README.textile

@@ -0,0 +1,223 @@
+h1. Database Cleaner
+
+Database Cleaner is a set of strategies for cleaning your database in Ruby.
+The original use case was to ensure a clean state during tests.  Each strategy
+is a small amount of code but is code that is usually needed in any ruby app
+that is testing with a database.
+
+ActiveRecord, DataMapper, Sequel, MongoMapper, Mongoid, and CouchPotato are supported.
+
+Here is an overview of the strategies supported for each library:
+
+|_. ORM        |_.  Truncation  |_.  Transaction  |_.  Deletion    |
+| ActiveRecord | Yes            | **Yes**         | Yes            |
+| DataMapper   | Yes            | **Yes**         | No             |
+| CouchPotato  | **Yes**        | No              | No             |
+| MongoMapper  | **Yes**        | No              | No             |
+| Mongoid      | **Yes**        | No              | No             |
+| Sequel       | **Yes**        | Yes             | No             |
+
+(Default strategy for each library is denoted in bold)
+
+The ActiveRecord @:deletion@ strategy is useful for when the @:truncation@ strategy causes
+locks (as reported by some Oracle DB users).  The @:deletion@ option has been reported to
+be faster than @:truncation@ in some cases as well.  In general, the best approach is to use
+@:transaction@ since it is the fastest.
+
+Database Cleaner also includes a @null@ strategy (that does no cleaning at all) which can be used
+with any ORM library. You can also explicitly use it by setting your strategy to @nil@.
+
+For support or to discuss development please use the "Google Group":http://groups.google.com/group/database_cleaner.
+
+h2. How to use
+
+<pre>
+  require 'database_cleaner'
+  DatabaseCleaner.strategy = :truncation
+
+  # then, whenever you need to clean the DB
+  DatabaseCleaner.clean
+</pre>
+
+With the :truncation strategy you can also pass in options, for example:
+<pre>
+  DatabaseCleaner.strategy = :truncation, {:only => %w[widgets dogs some_other_table]}
+</pre>
+
+<pre>
+  DatabaseCleaner.strategy = :truncation, {:except => %w[widgets]}
+</pre>
+
+(I should point out the truncation strategy will never truncate your schema_migrations table.)
+
+Some strategies require that you call DatabaseCleaner.start before calling clean
+(for example the :transaction one needs to know to open up a transaction). So
+you would have:
+
+<pre>
+  require 'database_cleaner'
+  DatabaseCleaner.strategy = :transaction
+
+  DatabaseCleaner.start # usually this is called in setup of a test
+  dirty_the_db
+  DatabaseCleaner.clean # cleanup of the test
+</pre>
+
+At times you may want to do a single clean with one strategy.  For example, you may want
+to start the process by truncating all the tables, but then use the faster transaction
+strategy the remaining time.  To accomplish this you can say:
+
+<pre>
+  require 'database_cleaner'
+  DatabaseCleaner.clean_with :truncation
+  DatabaseCleaner.strategy = :transaction
+  # then make the DatabaseCleaner.start and DatabaseCleaner.clean calls appropriately
+</pre>
+
+h3. RSpec Example
+
+<pre>
+RSpec.configure do |config|
+
+  config.before(:suite) do
+    DatabaseCleaner.strategy = :transaction
+    DatabaseCleaner.clean_with(:truncation)
+  end
+
+  config.before(:each) do
+    DatabaseCleaner.start
+  end
+
+  config.after(:each) do
+    DatabaseCleaner.clean
+  end
+
+end
+</pre>
+
+h3. Cucumber Example
+
+Add this to your features/support/env.rb file:
+
+<pre>
+begin
+  require 'database_cleaner'
+  require 'database_cleaner/cucumber'
+  DatabaseCleaner.strategy = :truncation
+rescue NameError
+  raise "You need to add database_cleaner to your Gemfile (in the :test group) if you wish to use it."
+end
+</pre>
+
+A good idea is to create the before and after hooks to use the DatabaseCleaner.start and DatabaseCleaner.clean methods.
+
+Inside features/support/hooks.rb:
+
+<pre>
+Before do
+  DatabaseCleaner.start
+end
+
+After do |scenario|
+  DatabaseCleaner.clean
+end
+</pre>
+
+This should cover the basics of tear down between scenarios and keeping your database clean.
+For more examples see the section "Why?"
+
+h2. How to use with multiple ORM's
+
+Sometimes you need to use multiple ORMs in your application. You can use DatabaseCleaner to clean multiple ORMs, and multiple connections for those ORMs.
+
+<pre>
+  #How to specify particular orms
+  DatabaseCleaner[:active_record].strategy = :transaction
+  DatabaseCleaner[:mongo_mapper].strategy = :truncation
+
+  #How to specify particular connections
+  DatabaseCleaner[:active_record,{:connection => :two}]
+</pre>
+
+Usage beyond that remains the same with DatabaseCleaner.start calling any setup on the different configured connections, and DatabaseCleaner.clean executing afterwards.
+
+Configuration options
+
+
+|_. ORM         |_.   How to access               |_.   Notes                                                                |
+| Active Record | DatabaseCleaner[:active_record] | Connection specified as :symbol keys, loaded from config/database.yml    |
+| Data Mapper   | DatabaseCleaner[:data_mapper]   | Connection specified as :symbol keys, loaded via Datamapper repositories |
+| Mongo Mapper  | DatabaseCleaner[:mongo_mapper]  | Multiple connections not yet supported                                   |
+| Mongoid       | DatabaseCleaner[:mongoid]       | Multiple connections not yet supported                                   |
+| Couch Potato  | DatabaseCleaner[:couch_potato]  | Multiple connections not yet supported                                   |
+| Sequel        | DatabaseCleaner[:sequel]        | ?                                                                        |
+
+h2. Why?
+
+One of my motivations for writing this library was to have an easy way to
+turn on what Rails calls "transactional_fixtures" in my non-rails
+ActiveRecord projects.  For example, Cucumber ships with a Rails world that
+will wrap each scenario in a transaction.  This is great, but what if you are
+using ActiveRecord in a non-rails project?  You used to have to copy-and-paste
+the needed code, but with DatabaseCleaner you can now say:
+
+<pre>
+  #env.rb
+  require 'database_cleaner'
+  require 'database_cleaner/cucumber'
+  DatabaseCleaner.strategy = :transaction
+</pre>
+
+Now lets say you are running your features and it requires that another process be
+involved (i.e. Selenium running against your app's server.)  You can simply change
+your strategy type:
+
+<pre>
+  #env.rb
+  require 'database_cleaner'
+  require 'database_cleaner/cucumber'
+  DatabaseCleaner.strategy = :truncation
+</pre>
+
+You can have the best of both worlds and use the best one for the job:
+<pre>
+  #env.rb
+  require 'database_cleaner'
+  require 'database_cleaner/cucumber'
+  DatabaseCleaner.strategy = (ENV['SELENIUM'] == 'true') ? :truncation : :transaction
+</pre>
+
+
+h2. Common Errors
+
+h4. DatabaseCleaner is trying to use the wrong ORM
+
+DatabaseCleaner has an autodetect mechanism where if you do not explicitly define your ORM it will use the first ORM it can detect that is loaded.  Since ActiveRecord is the most common ORM used that is the first one checked for.  Sometimes other libraries (e.g. ActiveAdmin) will load other ORMs (e.g. ActiveRecord) even though you are using a different ORM.  This will result in DatabaseCleaner trying to use the wrong ORM (e.g. ActiveRecord) unless you explicitly define your ORM like so:
+
+<pre>
+  # How to setup your ORM explicitly
+  DatabaseCleaner[:mongoid].strategy = :truncation
+</pre>
+
+h4. STDERR is being flooded when using Postgres
+
+If you are using Postgres and have foreign key constraints, the truncation strategy will cause a lot of extra noise to appear on STDERR (in
+the form of "NOTICE truncate cascades" messages). To silence these warnings set the following log level in your postgresql.conf file:
+
+<pre>
+  client_min_messages = warning
+</pre>
+
+
+h2. Debugging
+
+In rare cases DatabaseCleaner will encounter errors that it will log.  By default it uses STDOUT set to the ERROR level but you can configure this to use whatever Logger you desire.  Here's an example of using the Rails.logger in env.rb:
+
+<pre>
+  DatabaseCleaner.logger = Rails.logger
+</pre>
+
+
+h2. COPYRIGHT
+
+Copyright (c) 2009 Ben Mabey. See LICENSE for details.

data/lib/database_cleaner-0.7.2/Rakefile

@@ -0,0 +1,65 @@
+require "rubygems"
+require "bundler"
+Bundler.setup
+
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    s.name = "database_cleaner"
+    s.summary = %Q{Strategies for cleaning databases.  Can be used to ensure a clean state for testing.}
+    s.email = "ben@benmabey.com"
+    s.homepage = "http://github.com/bmabey/database_cleaner"
+    s.description = "Strategies for cleaning databases.  Can be used to ensure a clean state for testing."
+    s.files = FileList["[A-Z]*.*", "{examples,lib,features,spec}/**/*", "Rakefile", "cucumber.yml"]
+    s.authors = ["Ben Mabey"]
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = 'database_cleaner'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.libs << 'lib' << 'spec'
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |t|
+  t.libs << 'lib' << 'spec'
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.rcov = true
+end
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+rescue LoadError
+  puts "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+end
+
+task :default => [:spec, :features]
+
+
+desc "Cleans the project of any tmp file that should not be included in the gemspec."
+task :clean do
+  ["examples/config/database.yml", "examples/db/activerecord_one.db", "examples/db/activerecord_two.db", "examples/db/datamapper_default.db",
+    "examples/db/datamapper_one.db", "examples/db/datamapper_two.db"].each do |f|
+    FileUtils.rm_f(f)
+  end
+  %w[*.sqlite3 *.log #* *.swp *.swo].each do |pattern|
+    `find . -name "#{pattern}" -delete`
+  end
+end
+
+desc "Cleans the dir and builds the gem"
+task :prep => [:clean, :gemspec, :build]

data/lib/database_cleaner-0.7.2/TODO

@@ -0,0 +1,3 @@
+Could be more Datamapper
+MongoMapper multiple db support
+CouchDB multiple db support

data/lib/database_cleaner-0.7.2/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+:major: 0
+:build: 
+:minor: 7
+:patch: 2

data/lib/database_cleaner-0.7.2/cucumber.yml

@@ -0,0 +1 @@
+default: features

data/lib/database_cleaner-0.7.2/examples/Gemfile

@@ -0,0 +1,49 @@
+source "http://rubygems.org"
+# group :development do
+#   # gem "mysql"
+#   # gem "json_pure", "1.4.3"
+#
+#
+#   # gem "datamapper",        "1.0.0"
+#   # gem "dm-migrations",     "1.0.0"
+#   # gem "dm-sqlite-adapter", "1.0.0"
+#
+#   # mongo requirements
+#     # gem "mongo",     "1.0.1"
+#     # gem "mongo_ext", "0.19.3"
+#     # gem "bson_ext",  "1.0.1"
+# end
+
+group :development do
+  gem "rake"
+  gem "ruby-debug"
+
+  gem "bundler"
+  gem "jeweler"
+
+  gem "json_pure"
+
+  #ORM's
+  gem "activerecord",         "2.3.8"
+  gem "datamapper",           "1.0.0"
+    gem "dm-migrations",      "1.0.0"
+    gem "dm-sqlite-adapter",  "1.0.0"
+  gem "mongoid",              "1.9.1"
+    gem "tzinfo",             "0.3.22"
+  gem "mongo_mapper",         "0.8.2"
+  gem "couch_potato",         "0.3.0"
+  gem "sequel",               "~>3.21.0"
+  #gem "ibm_db"  # I don't want to add this dependency, even as a dev one since it requires DB2 to be installed
+end
+
+group :test do
+  gem "rspec"
+  gem "rspactor"
+  gem "rcov"
+  gem "ZenTest"
+end
+
+group :cucumber do
+  gem "cucumber"
+  gem 'sqlite3-ruby'
+end

data/lib/database_cleaner-0.7.2/examples/Gemfile.lock

@@ -0,0 +1,163 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    ZenTest (4.3.3)
+    activerecord (2.3.8)
+      activesupport (= 2.3.8)
+    activesupport (2.3.8)
+    addressable (2.2.0)
+    bson (1.0.4)
+    builder (2.1.2)
+    columnize (0.3.1)
+    couch_potato (0.3.0)
+      couchrest (>= 0.24)
+      json
+    couchrest (1.0.1)
+      json (>= 1.4.6)
+      mime-types (>= 1.15)
+      rest-client (>= 1.5.1)
+    cucumber (0.8.5)
+      builder (~> 2.1.2)
+      diff-lcs (~> 1.1.2)
+      gherkin (~> 2.1.4)
+      json_pure (~> 1.4.3)
+      term-ansicolor (~> 1.0.4)
+    data_objects (0.10.2)
+      addressable (~> 2.1)
+    datamapper (1.0.0)
+      dm-aggregates (= 1.0.0)
+      dm-constraints (= 1.0.0)
+      dm-core (= 1.0.0)
+      dm-core (= 1.0.0)
+      dm-migrations (= 1.0.0)
+      dm-serializer (= 1.0.0)
+      dm-timestamps (= 1.0.0)
+      dm-transactions (= 1.0.0)
+      dm-types (= 1.0.0)
+      dm-validations (= 1.0.0)
+    diff-lcs (1.1.2)
+    dm-aggregates (1.0.0)
+      dm-core (~> 1.0.0)
+    dm-constraints (1.0.0)
+      dm-core (~> 1.0.0)
+      dm-migrations (~> 1.0.0)
+    dm-core (1.0.0)
+      addressable (~> 2.1)
+      extlib (~> 0.9.15)
+    dm-do-adapter (1.0.0)
+      data_objects (~> 0.10.1)
+      dm-core (~> 1.0.0)
+    dm-migrations (1.0.0)
+      dm-core (~> 1.0.0)
+    dm-serializer (1.0.0)
+      dm-core (~> 1.0.0)
+      fastercsv (~> 1.5.3)
+      json_pure (~> 1.4.3)
+    dm-sqlite-adapter (1.0.0)
+      dm-do-adapter (~> 1.0.0)
+      do_sqlite3 (~> 0.10.2)
+    dm-timestamps (1.0.0)
+      dm-core (~> 1.0.0)
+    dm-transactions (1.0.0)
+      dm-core (~> 1.0.0)
+    dm-types (1.0.0)
+      dm-core (~> 1.0.0)
+      fastercsv (~> 1.5.3)
+      json_pure (~> 1.4.3)
+      stringex (~> 1.1.0)
+      uuidtools (~> 2.1.1)
+    dm-validations (1.0.0)
+      dm-core (~> 1.0.0)
+    do_sqlite3 (0.10.2)
+      data_objects (= 0.10.2)
+    durran-validatable (2.0.1)
+    extlib (0.9.15)
+    fastercsv (1.5.3)
+    ffi (0.6.3)
+      rake (>= 0.8.7)
+    gemcutter (0.6.1)
+    gherkin (2.1.5)
+      trollop (~> 1.16.2)
+    git (1.2.5)
+    growl (1.0.3)
+    jeweler (1.4.0)
+      gemcutter (>= 0.1.0)
+      git (>= 1.2.5)
+      rubyforge (>= 2.0.0)
+    jnunemaker-validatable (1.8.4)
+      activesupport (>= 2.3.4)
+    json (1.4.6)
+    json_pure (1.4.6)
+    libnotify (0.2.0)
+      ffi (>= 0.6.2)
+    linecache (0.43)
+    mime-types (1.16)
+    mongo (1.0.7)
+      bson (>= 1.0.4)
+    mongo_mapper (0.8.2)
+      activesupport (>= 2.3.4)
+      jnunemaker-validatable (~> 1.8.4)
+      plucky (~> 0.3.1)
+    mongoid (1.9.1)
+      activesupport (<= 3.0.0)
+      bson (~> 1.0.1)
+      durran-validatable (>= 2.0.1)
+      mongo (~> 1.0.1)
+      will_paginate (< 2.9)
+    plucky (0.3.4)
+      mongo (~> 1.0.7)
+    rake (0.8.7)
+    rb-inotify (0.8.1)
+      ffi (>= 0.5.0)
+    rcov (0.9.8)
+    rest-client (1.6.0)
+      mime-types (>= 1.16)
+    rspactor (0.7.0.beta.6)
+      bundler (>= 1.0.0.rc.5)
+      growl (>= 1.0.3)
+      libnotify (>= 0.1.3)
+      rb-inotify
+      sys-uname (>= 0.8.4)
+      trollop (>= 1.16.2)
+    rspec (1.3.0)
+    ruby-debug (0.10.3)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.3.0)
+    ruby-debug-base (0.10.3)
+      linecache (>= 0.3)
+    rubyforge (2.0.4)
+      json_pure (>= 1.1.7)
+    sequel (3.21.0)
+    sqlite3-ruby (1.3.1)
+    stringex (1.1.0)
+    sys-uname (0.8.4)
+    term-ansicolor (1.0.5)
+    trollop (1.16.2)
+    tzinfo (0.3.22)
+    uuidtools (2.1.1)
+    will_paginate (2.3.14)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  ZenTest
+  activerecord (= 2.3.8)
+  bundler
+  couch_potato (= 0.3.0)
+  cucumber
+  datamapper (= 1.0.0)
+  dm-migrations (= 1.0.0)
+  dm-sqlite-adapter (= 1.0.0)
+  jeweler
+  json_pure
+  mongo_mapper (= 0.8.2)
+  mongoid (= 1.9.1)
+  rake
+  rcov
+  rspactor
+  rspec
+  ruby-debug
+  sequel (~> 3.21.0)
+  sqlite3-ruby
+  tzinfo (= 0.3.22)