https://github.com/pat/ginger

Run specs/tests multiple times through different gem versions
https://github.com/pat/ginger

Last synced: 14 days ago
JSON representation

Run specs/tests multiple times through different gem versions

• Host: GitHub
• URL: https://github.com/pat/ginger
• Owner: pat
• License: mit
• Created: 2008-10-11T08:23:52.000Z (about 16 years ago)
• Default Branch: master
• Last Pushed: 2010-09-02T14:28:00.000Z (about 14 years ago)
• Last Synced: 2024-10-04T13:14:52.612Z (about 1 month ago)
• Language: Ruby
• Homepage:
• Size: 99.6 KB
• Stars: 22
• Watchers: 4
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.textile

Awesome Lists containing this project

README

        
Ginger is a small gem that allows you to test your projects using multiple versions of gem libraries. The idea is from "Ian White's garlic":http://github.com/ianwhite/garlic/tree - hence the related name of this - but my approach is a bit different, since I don't test my plugins from within a rails application. Maybe they can be merged at some point - I just hacked this up quickly to fit my needs.

To get it all working, you need to do four things. The first is, of course, to install this gem.

sudo gem install ginger --source=http://gemcutter.org


Next, add the following line of code to your @spec_helper.rb@ file (or equivalent):

require 'ginger'


You'll want to put it as high up as possible - in particular, before any @require@ calls to libraries you want to cover multiple versions of.

Step number three is creating the sets of scenarios in a file called @ginger_scenarios.rb@, which should go in the root, spec or test directory of your project. Here's an example, showing off the syntax possibilities.

require 'ginger'


Ginger.configure do |config|

  config.aliases["active_record"] = "activerecord"

  

  ar_1_2_6 = Ginger::Scenario.new

  ar_1_2_6[/^active_?record$/] = "1.15.6"

  

  ar_2_0_2 = Ginger::Scenario.new

  ar_2_0_2[/^active_?record$/] = "2.0.2"

  

  ar_2_1_1 = Ginger::Scenario.new

  ar_2_1_1[/^active_?record$/] = "2.1.1"

  

  config.scenarios << ar_1_2_6 << ar_2_0_2 << ar_2_1_1

end


Above, I've added three different scenarios, for three different versions of ActiveRecord. I also added an alias, as people sometimes use the underscore, and sometimes don't. The gem's name has no underscore though, so the _value_ of the alias matches the gem name (whereas the key would be alternative usage).

You can have multiple gems set in each scenario - and you don't have to use regular expressions, you can just use straight strings.

sphinx_scenario = Ginger::Scenario.new

sphinx_scenario["riddle"] = "0.9.8"

sphinx_scenario["thinking_sphinx"] = "0.9.8"


Don't forget to add them to @config@'s scenarios collection, else they're not saved anywhere.

To better discern different defined scenarios you can create them with a name. The name will be output when the scenario runs as the title. 

sphinx_scenario = Ginger::Scenario.new('Thinking Sphinx 0.9.8')


And finally, you'll want to run the tests or specs for each scenario. This is done using the @ginger@ CLI tool, which parrots whatever parameters you give it onto @rake@. So just do something like:

ginger spec

ginger test

ginger spec:unit


h2. Contributors

* "Adam Meehan":http://duckpunching.com/

* "Darragh Curran":http://peelmeagrape.net/