generator-spec 0.3.3

data/wiki/rails_view_helpers.textile

@@ -0,0 +1,167 @@
+The Rails 3 spec helpers can be used to setup the temporary Rails 3 app used for the specs. 
+Use the `create` methods to setup an application layout of expected files expected/required by the generator to test it.
+
+The `remove` methods can be used to cleanup before or after a test run, f.ex using the RSpec `before(:each)` and `after(:each)` blocks.  
+
+h3. View helpers
+
+* create_view name, content
+* create_view name, &block
+* remove_view name
+* remove_views *names
+
+h3. Model helpers
+
+* create_model name, content
+* create_model name, &block
+* remove_model name
+* remove_models *names
+
+h3. Controller helpers
+
+* create_controller name, content
+* create_controller name, &block
+* remove_controller name
+* remove_controller *names
+
+h3. Mailer helpers
+
+* create_mailer name, content
+* create_mailer name, &block
+* remove_mailer name
+* remove_mailers *names
+
+h3. Helper helpers
+
+* create_helper name, content
+* create_helper name, &block
+* remove_helper name
+* remove_helpers *names
+
+--
+
+The RSpec 2 generator matchers are used to match on file content that are the result of running the generator under test. 
+These matchers can be used to test if the resulting file contains content/ruby code as expected (or specified).  
+
+* generate_file name, type:Symbol, &block
+* generate_dir name, type:Symbol, &block
+* generate_migration name, &block
+
+* have_class name, &block
+* have_module name, &block
+* have_method name, &block, type:Symbol (:class)
+* include_module name, &block
+* inherit_from name, &block
+
+*generate_file* can take any of the symbols below as a type argument and perform matchings on 
+that file in the appropriate location in the Rails 3 app.
+
+* :model, :controller, :view, :helper, :observer, :migration
+* :javascript, :stylesheet, :initializer, :locale
+
+h3. Example use of matchers
+
+<pre>
+g.should generate_file name, :model do |content|
+  content.should have_class name do |klass|
+    klass.should include_module 'Canable::Ables'
+  end
+end
+</pre>
+
+h2. Migration file
+
+There are a bunch of ways to match the layout of a generated migration file as the following demonstrates.
+
+* Matchers
+* Helper methods
+
+h3. Matchers
+
+Example use
+<pre>
+g.should have_migration(:create_users) do |content|
+  content.should have_up do |up|
+    up.should create_table(:users) do |table|
+      table.should add_column(:name, :string)
+    end
+  end
+end 
+</pre>
+
+Migration file matcher
+
+* have_migration name, &block
+
+Up and Down method matchers
+
+* have_up, &block
+* have_down, &block
+
+Table matchers
+
+* have_create_table name, &block
+* have_change_table name, &block
+* have_drop_table name
+* have_rename_table name, new_name
+
+Column matchers
+
+* have_remove_column name
+* have_add_column name, type='string'
+* have_change_column name, type='string'
+* have_add_tbl_column tbl_name, name, type='string'
+
+Table column matchers
+
+* have_change_tbl_column tbl_name, name, type='string'
+* have_rename_tbl_column tbl_name, new_name
+* have_remove_tbl_column tbl_name, name
+
+h3. Helper methods
+
+Example use
+<pre>
+g.migration :create_users do |content|
+  file_content.up do |up|
+    up.creates_table :users do |table|
+      table.adds_column :name, :string
+    end
+  end
+end 
+</pre>
+
+
+Check named migration file exists and yields content of file
+* migration file_name, &block
+
+Checks class method 'up' exists and yields content of method
+* up &block
+
+Checks class method 'down' exists and yields content of method
+* down &block
+
+Check specific block exists and yields content of block 
+
+* creates_table name, &block
+* changes_table name, &block
+
+Test specific migration statements exist within table block
+
+* drops_table name
+* renames_table name
+* removes_column name
+* adds_column name, type='string'
+* changes_column name, type='string'
+
+Test that migration statements exist that apply to a specific table
+
+* adds_tbl_column tbl_name, name, type='string'
+* changes_tbl_column tbl_name, name, type='string'
+* renames_tbl_column tbl_name, new_name
+* removes_tbl_column tbl_name, name
+
+Check Index statements
+
+* adds_tbl_index tbl_name, name
+* removes_tbl_index tbl_name, name

metadata

@@ -0,0 +1,205 @@
+--- !ruby/object:Gem::Specification 
+name: generator-spec
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 3
+  - 3
+  version: 0.3.3
+platform: ruby
+authors: 
+- Kristian Mandrup
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-04 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 0
+        - beta19
+        version: 2.0.0.beta19
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 0
+        - beta
+        - 19
+        version: 2.0.0.beta.19
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 8
+        - 7
+        version: 0.8.7
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rails
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 0
+        - 0
+        - rc
+        version: 3.0.0.rc
+  type: :runtime
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: test-unit
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 9
+        version: 2.0.9
+  type: :runtime
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: require_all
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 1
+        - 0
+        version: 1.1.0
+  type: :runtime
+  version_requirements: *id006
+description: RSpec 2 library to assist in writing generator specs
+email: kmandrup@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- generator-spec.gemspec
+- lib/generators/demo/demo_generator.rb
+- lib/rspec_for_generators.rb
+- lib/rspec_for_generators/fixtures/routes.rb
+- lib/rspec_for_generators/generator_spec_helper.rb
+- lib/rspec_for_generators/main.rb
+- lib/rspec_for_generators/matchers/content/have_block.rb
+- lib/rspec_for_generators/matchers/content/have_call.rb
+- lib/rspec_for_generators/matchers/content/have_class.rb
+- lib/rspec_for_generators/matchers/content/have_method.rb
+- lib/rspec_for_generators/matchers/content/have_module.rb
+- lib/rspec_for_generators/matchers/content/include_module.rb
+- lib/rspec_for_generators/matchers/content/inherit_from.rb
+- lib/rspec_for_generators/matchers/file/generate_directory.rb
+- lib/rspec_for_generators/matchers/file/generate_file.rb
+- lib/rspec_for_generators/matchers/file/generate_migration.rb
+- lib/rspec_for_generators/matchers/helpers/content.rb
+- lib/rspec_for_generators/matchers/helpers/file.rb
+- lib/rspec_for_generators/matchers/helpers/migration.rb
+- lib/rspec_for_generators/matchers/migration/have_column.rb
+- lib/rspec_for_generators/matchers/migration/have_index.rb
+- lib/rspec_for_generators/matchers/migration/have_migration.rb
+- lib/rspec_for_generators/matchers/migration/have_table.rb
+- lib/rspec_for_generators/matchers/migration/have_tbl_column.rb
+- lib/rspec_for_generators/matchers/migration/have_up_down.rb
+- lib/rspec_for_generators/rails_helpers/all.rb
+- lib/rspec_for_generators/rails_helpers/rails_app.rb
+- lib/rspec_for_generators/rails_helpers/rails_controller.rb
+- lib/rspec_for_generators/rails_helpers/rails_helper.rb
+- lib/rspec_for_generators/rails_helpers/rails_mailer.rb
+- lib/rspec_for_generators/rails_helpers/rails_model.rb
+- lib/rspec_for_generators/rails_helpers/rails_orm.rb
+- lib/rspec_for_generators/rails_helpers/rails_view.rb
+- lib/rspec_for_generators/rails_spec_helper.rb
+- lib/rspec_for_generators/rspec_test_case.rb
+- rspec_for_generators.gemspec
+- spec/rspec_for_generators/rspec_for_generators_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- wiki/Custom Rails 3 Generators.textile
+- wiki/rails_view_helpers.textile
+has_rdoc: true
+homepage: http://github.com/kristianmandrup/rspec_for_generators
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: RSpec 2 library for writing generator specs
+test_files: 
+- spec/rspec_for_generators/rspec_for_generators_spec.rb
+- spec/spec_helper.rb