gyst 0.0.2

data/.gitignore

@@ -0,0 +1,8 @@
+Gemfile.lock
+*.gem
+.bundle/
+.yardoc/
+_site/
+doc/
+pkg/
+tmp/

data/Changelog.md

@@ -0,0 +1,6 @@
+## 0.0.2 (May 27, 2011) - Happy Birthday Mom.
+
+Features:
+
+- scripts: rakee, raket
+- patches: gyst/factory_girl

data/Gemfile

@@ -0,0 +1,14 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in gys.gemspec
+gemspec
+
+group :test do
+  gem 'factory_girl' # not in gemspec since use of factory_girl patch is optional
+end
+
+group :blog do
+  gem 'jekyll', '0.10.0' # version for gh_pages
+  gem 'liquid', '2.0.0'  # version for gh_pages (http://support.github.com/discussions/site/3216-github-pages-liquid-template-tags-not-being-parsed)
+  gem 'rdiscount' # I haven't found the gh_pages specific version yet.
+end

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2011 Matthew Scilipoti
+
+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,161 @@
+Grease Your Suite Toolkit (gyst)
+================================
+
+Purpose
+--------
+A suite of helpers to aid in speeding up your tests; including scripts,
+existing libraries, and patches.
+
+Inspired by Nick Gauthier's ["Grease-Your-Suite" presentation(s)][gys_showoff].
+
+Faster tests? Good.
+
+Install
+--------
+This will be released to rubygems.org once we have a little more
+functionality.   
+**NOTE:** in order to use the bash scripts, you must use the `--no-wrapper`
+argument.
+    gem install pkg/gyst-0.0.1.gem --no-wrappers
+
+
+Dependencies
+------------
+
+No runtime dependencies (except for the libraries you choose to patch).
+
+
+Scripts
+--------
+Various helper scripts.
+
+    rakee # runs rake tasks with REE configured for tests
+    raket # hydra helper, runs rake tasks with RAILS_ENV=test and REE configured for tests
+    grease_your_suite.sh # configures REE (different for linux/osx?
+
+
+### rakee
+---
+`rakee` configures REE for testing, then runs the task(s).  It simply executes grease_your_suite.sh before running the rake task.
+
+Usage:
+
+    rakee # runs all tests after configuring REE
+    rakee test:units
+    rakee features
+
+
+### raket
+---
+`raket` is a helper for the [hydra gem](https://github.com/ngauthier/hydra). Hydra requires that `RAILS_ENV=test`.  `raket` sets RAILS_ENV and configures REE for testing, then runs the task(s).
+
+Usage:
+
+    raket hydra
+    raket hydra:specs
+
+
+### grease_your_suite.sh (gys)
+---
+This script configures Ruby Enterprise Edition (REE) for testing,
+as [suggested here][gys_showoff].   
+Usually used as a helper script for rake tasks.
+Also useful for a group of specs.
+
+We recommend you use an alias:
+
+    alias gys=grease_your_suite.sh
+
+Usage:
+
+    gys cucumber
+    gys rspec spec
+    gys rspec -cfs spec/a_sub_dir
+
+
+***API***
+---
+
+### Libraries
+---
+<strong>As of 2011-05, "`require 'gyst'`" is a noop.</strong>   
+You must require the pieces the you want.  We'll turn this on once more pieces are available, otherwise we will probably break things with each release.   
+Patch factory_girl to use :build, break stuff.   
+Add 'db_null', break stuff.   
+Simply by using "require 'gyst'"?  Let's wait.
+
+---
+
+We are using "selective requires" for the libraries and scripts.  Want everything, simply:
+    require 'gyst' # (TODO) enables all the libraries and applies all the patches
+
+You can also just `require` the pieces you want.
+
+#### DbNull
+Yells if you try to access the db
+
+    require 'gyst/db_null' # (TODO)
+
+
+### Patches
+---
+
+#### Factory Girl
+Sets default_strategy to :build. Creating models in the db is slow.
+Don't do it if you don't have to.
+
+
+    require 'gyst/factory_girl' # all factory_girl enhancements (rspec, test_unit, etc)
+    require 'gyst/factory_girl/rspec' # (TODO) just patch for rspec
+    require 'gyst/factory_girl/test_unit' # (TODO) just patch for Test::Unit
+
+
+Tested On
+--------------
+Ruby 1.9.2 (p180)
+
+
+Contribute
+-----------
+Contributions and discussions are welcome.
+Feel free to add sugggestions and bugs to our [issues on github](https://github.com/mattscilipoti/gyst/issues).
+
+* Fork the project.
+* `bundle install`.  Run all tests with `rakee`
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.  Note: the existing tests may fail
+  with pre-1.9 versions of ruby; upgrade to get clean runs.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+*NOTE*: when adding a new shell script
+
+ * add to git index
+ * `rake build`
+ * gem install pkg/gyst-0.0.?.gem --no-wrappers
+
+References
+-----------
+ * https://github.com/ngauthier/Grease-Your-Suite
+ * http://m.onkey.org/make-your-shoulda-tests-faster-with-fast_context
+ * http://37signals.com/svn/posts/2742-the-road-to-faster-tests
+   * http://ola-bini.blogspot.com/2007/12/your-ruby-tests-are-memory-leaks.html
+ * http://makandra.com/notes/950-speed-up-rspec-by-deferring-garbage-collection
+
+
+
+TODO
+-----
+ * Add to rdoc.info
+ * CI at travis
+ * Multi-ruby testing: 
+   * http://rails-bestpractices.com/blog/posts/11-test-your-rubygem-under-different-rubies
+   * https://github.com/tomas-stefano/infinity_test
+
+
+[gys_showoff]: http://grease-your-suite.heroku.com/  "Grease Your Suites"
+
+____
+Copyright (c) 2011 Matthew Scilipoti, released under the MIT license

data/Rakefile

@@ -0,0 +1,30 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.pattern = "test/*_spec.rb"
+end
+
+
+require 'cucumber'
+require 'cucumber/rake/task'
+
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --format pretty"
+end
+
+task :default => [:test, :features]
+
+
+# rake tasks for testing
+task :pass do
+  puts "PASSED"
+end
+
+task :fail do
+  fail "EXPECTED FAILURE"
+end
+

data/bin/grease_your_suite.sh

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+# Note: to generate this without the ruby gems wrapper, 
+#  we used the --no-wrapper arg
+echo "INFO: Configuring REE (re: grease_your_suite)"
+export RUBY_HEAP_MIN_SLOTS=1000000
+export RUBY_HEAP_SLOTS_INCREMENT=1000000
+export RUBY_HEAP_SLOTS_GROWTH_FACTOR=1
+export RUBY_GC_MALLOC_LIMIT=1000000000
+export RUBY_HEAP_FREE_MIN=500000111
+
+time $@
+

data/bin/rakee

@@ -0,0 +1,4 @@
+#!/bin/sh
+
+grease_your_suite.sh rake $@
+

data/bin/raket

@@ -0,0 +1,5 @@
+#!/bin/sh
+## Hydra needs test env.
+echo "Loading test environment..."
+RAILS_ENV=test rakee $*
+

data/features/command_line/grease_your_suite.feature

@@ -0,0 +1,17 @@
+Feature: the grease_your_suite script sets configuration options for REE
+
+  In order to speed up tests, the gys script should
+  assign the environment values
+  to configure GC appropriately for testing
+
+
+  Scenario: the script sets Environment Variables
+    When I run `grease_your_suite.sh`
+    # output includes message and output from `time`
+    Then it should pass with:
+      """
+      INFO: Configuring REE (re: grease_your_suite)
+
+      real	0m0
+      """
+

data/features/command_line/rakee.feature

@@ -0,0 +1,9 @@
+Feature: rakee
+  In order to run testing quickly from rake tasks
+  We want to configure REE
+
+  Scenario: rakee pass
+    When I successfully run `rakee pass`
+    Then the output should contain "Configuring REE"
+    And the output should contain "PASS"
+    And the output should contain "real	0m0"

data/features/command_line/raket.feature

@@ -0,0 +1,11 @@
+Feature: raket
+  In order to run hydra quickly from rake tasks
+  We want to configure REE and set RAILS_ENV
+
+  Scenario: raket pass
+    When I successfully run `raket pass`
+    Then the output should contain "Loading test environment..."
+    And the output should contain "Configuring REE"
+    And the output should contain "PASS"
+    And the output should contain "real	0m0"
+

data/features/patches/factory_girl.feature

@@ -0,0 +1,15 @@
+Feature: factory_girl patch
+
+  @gemset
+  Scenario: friendly loading (no such gem)
+
+    Given I'm using a new gemset
+    And a file named "gyst_factory_girl.rb" with:
+      """
+      require '../../lib/gyst/factory_girl'
+      """
+
+    When I run `ruby gyst_factory_girl.rb`
+    Then the output should contain "Could not find 'factory_girl'"
+
+

data/features/step_definitions/rvm_steps.rb

@@ -0,0 +1,14 @@
+Given /^(?:I'm|I am) using a new gemset$/ do
+  use_clean_gemset(CLEAN_GEMSET)
+end
+
+Given /^(?:I'm|I am) using a new gemset with these gems:$/ do |table|
+  # table is a Cucumber::Ast::Table
+  Given "I am using a new gemset"
+
+  table.rows.each do |row|
+    gem = row.first
+    run_simple("gem install #{gem}", true)
+  end
+end
+

data/features/support/env.rb

@@ -0,0 +1,15 @@
+# require 'ruby-debug'
+require 'aruba/cucumber'
+
+Before do
+  @aruba_timeout_seconds = 3
+end
+
+CLEAN_GEMSET = 'delete_me'
+
+Before('@gemset') do
+  puts "INFO: feature may be slow, please be patient.  Using --no-rdoc in ~/.gemrc helps."
+  run_simple("rvm --force gemset delete #{CLEAN_GEMSET}", true)
+  @aruba_timeout_seconds = 20
+end
+

data/gyst.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "gyst/version"
+
+Gem::Specification.new do |s|
+  s.name        = "gyst"
+  s.version     = Gyst::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Matt Scilipoti"]
+  s.email       = ["matt@scilipoti.name"]
+  s.homepage    = ""
+  s.summary     = %q{A suite of helpers to aid in speeding up your tests.}
+  s.description = %q{A suite of helpers to aid in speeding up your tests; including scripts, existing libraries, and patches.
+  }
+
+  s.rubyforge_project = "gyst"
+
+  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"]
+
+  s.add_development_dependency('aruba')
+  s.add_development_dependency('minitest')
+  s.add_development_dependency('rake')
+end

data/lib/gyst.rb

@@ -0,0 +1 @@
+# require 'gyst/factory_girl'

data/lib/gyst/factory_girl.rb

@@ -0,0 +1,24 @@
+# since use of this "patch" is optional,
+#   we should not add "factory_girl" as a dependency
+begin
+  require 'factory_girl'
+rescue LoadError
+  $stderr.puts <<-EOS
+#{'*'*50}
+  "ERROR: Could not find 'factory_girl'.
+     You should either install it (https://github.com/thoughtbot/factory_girl)
+     or be more specific about which parts of `gyst` you would like to use (see README)."
+#{'*'*50}
+  EOS
+
+  raise
+end
+
+Factory.class_eval do
+  # change default_strategy to build, instead of :create
+  # TODO: patch FactoryGirl to allow setting overall default_strategy
+  def default_strategy #:nodoc:
+    @options[:default_strategy] || :build
+  end
+end
+

data/lib/gyst/version.rb

@@ -0,0 +1,3 @@
+module Gyst
+  VERSION = "0.0.2"
+end

data/test/factory_girl_spec.rb

@@ -0,0 +1,12 @@
+require 'minitest/autorun'
+# require 'minitest/pride' # undefined method `output' for MiniTest::Unit:Class (NoMethodError)
+
+require File.expand_path('../lib/gyst/factory_girl', File.dirname(__FILE__))
+
+
+describe Factory do
+  it "should use :build by default" do
+    subject = Factory.new(:test)
+    subject.default_strategy.must_equal :build
+  end
+end

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification 
+name: gyst
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Matt Scilipoti
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-27 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: aruba
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: minitest
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id003
+description: "A suite of helpers to aid in speeding up your tests; including scripts, existing libraries, and patches.\n  "
+email: 
+- matt@scilipoti.name
+executables: 
+- grease_your_suite.sh
+- rakee
+- raket
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Changelog.md
+- Gemfile
+- MIT-LICENSE
+- README.md
+- Rakefile
+- bin/grease_your_suite.sh
+- bin/rakee
+- bin/raket
+- features/command_line/grease_your_suite.feature
+- features/command_line/rakee.feature
+- features/command_line/raket.feature
+- features/patches/factory_girl.feature
+- features/step_definitions/rvm_steps.rb
+- features/support/env.rb
+- gyst.gemspec
+- lib/gyst.rb
+- lib/gyst/factory_girl.rb
+- lib/gyst/version.rb
+- test/factory_girl_spec.rb
+has_rdoc: true
+homepage: ""
+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: gyst
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: A suite of helpers to aid in speeding up your tests.
+test_files: 
+- features/command_line/grease_your_suite.feature
+- features/command_line/rakee.feature
+- features/command_line/raket.feature
+- features/patches/factory_girl.feature
+- features/step_definitions/rvm_steps.rb
+- features/support/env.rb
+- test/factory_girl_spec.rb