Contents

# Generator Spec

Test Rails generators with RSpec using the standard Rails::Generators::TestCase assertion methods.

# Usage

Gemfile:

```ruby
group :test do
  gem "generator_spec"
end
```

Spec:

```ruby
# spec/lib/generators/test/test_generator_spec.rb
    
require "generator_spec/test_case"

describe TestGenerator do
  include GeneratorSpec::TestCase
  destination File.expand_path("../../tmp", __FILE__)
  arguments %w(something)

  before(:all) do
    prepare_destination
    run_generator
  end

  it "creates a test initializer" do
    assert_file "config/initializers/test.rb", "# Initializer"
  end
end
```
    
An RSpec file matching DSL is also provided, taken with permission from [beard](https://github.com/carlhuda/beard/blob/master/spec/support/matcher.rb) by [carlhuda](https://github.com/carlhuda).

```ruby
describe TestGenerator, "using custom matcher" do
  include GeneratorSpec::TestCase
  destination File.expand_path("../../tmp", __FILE__)
  
  before do
    prepare_destination
    run_generator
  end

  specify do
    destination_root.should have_structure {
      no_file "test.rb"
      directory "config" do
        directory "initializers" do
          file "test.rb" do
            contains "# Initializer"
          end
        end
      end
      directory "db" do
        directory "migrate" do
          file "123_create_tests.rb"
          migration "create_tests" do
            contains "class TestMigration"
          end
        end
      end
    }
  end
end
```

Version data entries

4 entries across 4 versions & 2 rubygems

Version	Path
generator_spec-0.9.0	README.md
sunrise-cms-0.5.0.rc1	vendor/bundle/ruby/1.9.1/gems/generator_spec-0.8.7/README.md
generator_spec-0.8.7	README.md
generator_spec-0.8.6	README.md