saki 0.1.1 → 0.1.2

data/README.markdown

@@ -41,6 +41,10 @@ The only assumption is that you are using factories instead of fixtures.  You al
 
     with_existing :user, :state => "happy" do...
 
+`with_signed_in` is similar to `with_existing` but after creating the object it passes it into a `sign_in` method:
+
+    with_signed_in :admin do...
+
 `on_visiting` preferably uses some dynamic functions for establishing a path: `new_X_path`, `Xs_path`, `edit_X_path`, `X_path` and `new_X_path`.  In these cases, substitute X for the resource name (e.g. `new_user_path`).  
 
 Note that for examples like `edit_user_path`, it behaves with a slight difference from the rails route helpers, because it assumes that there already exists an instance variable named `@user`.  Since the `edit_user_path` call occurs when there is no `@user`, we can't mention it explicitly.
@@ -49,9 +53,9 @@ For cases where the resource is nested, these path helpers have a :parent => par
 
     on_visiting auctions_path(:parent => :user) do ...
 
-`on_visiting` also takes a path as a string, or a lambda that executes within a before block to set up the path.  It also takes a symbol which is the name of a method name.  This is useful when the code is dependent on an instance variable for path creation.
+`on_visiting` also takes a path as a string, or a proc that executes within a before block to set up the path.  It also takes a symbol which is the name of a method name.  This is useful when the code is dependent on an instance variable for path creation.
 
-    path_for_user = lambda { user_path(@user) }
+    path_for_user = proc { user_path(@user) }
 
     on_visiting path_for_user do ...
 
@@ -65,10 +69,10 @@ or you can do
 
 `on_following_link_to` works the same as on_visiting, but it first validates that the link exists, and then follows it.
 
-`where` is a function taking as a parameter a lambda to execute in the before block.
+`where` is a function taking as a parameter a proc to execute in the before block.
 
     def self.creating_a_user
-        lambda {
+        proc {
             @user = Factory.build @user
             fill_in "user[email]", :with => @user.email
             click_button "Create"
@@ -118,6 +122,14 @@ You can generate new acceptance tests with `rails generate saki:spec SPEC_NAME`.
         end
     end
 
+## Saki as your default integration testing library
+
+If you want to use Saki for generating integration tests for your scaffolding, simply add to your development.rb file
+
+    require "generators/saki/integration_generator"
+
+Then, provided that your integration library is set to :rspec, Saki will create integration tests for your scaffolding for complete test coverage.  Note that these cases are left simple for now, but can be built up upon feedback.  Also you might need to implement additional functions depending on your use case.
+
 ## Why no specs/tests for Saki, oh test guy?
 
 They'll get there :).  Saki is extracted from some spec helpers I used in moving from Cucumber to Steak.  Once I realized they also work as helpers for vanilla RSpec acceptance testing I made them a separate gem.
@@ -130,6 +142,10 @@ I haven't pimped that up yet, but will at some point.  Personally I'm a "green-d
 
 The motivation behind my migration from Cucumber and to Saki, are described in blog posts [Encumbered by Cucumber](http://ludicast.com/articles/1), [Introducing Saki](http://ludicast.com/articles/2).
 
+## Ruby 1.9.2
+
+To work with Ruby 1.9.2 the `where` function takes procs but not lambdas.
+
 ## Thanks
 
 The generators are stolen directly from Steak with some adjustments.

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.1.2

data/lib/generators/saki/integration_generator.rb

@@ -0,0 +1,19 @@
+require 'generators/rspec/integration/integration_generator'
+
+module Rspec
+  module Generators
+    class IntegrationGenerator < Base
+      argument :attributes, :type => :array, :default => [], :banner => "field:type field:type"
+
+      source_paths << File.join(File.dirname(__FILE__), 'templates')
+
+      def create_integration_file
+        template 'full_integration_spec.rb',
+                 File.join('spec/acceptance', class_path, "#{table_name}_spec.rb")
+      end
+      def resource_name
+        file_name.tableize.singularize
+      end
+    end
+  end
+end

data/lib/generators/saki/templates/full_integration_spec.rb

@@ -0,0 +1,35 @@
+require File.dirname(__FILE__) + '/acceptance_helper'
+
+integrate "<%= resource_name %> resource" do
+
+  def fill_in_<%= resource_name %>_details<%-
+      attributes.each do |attribute|
+    %>
+    fill_in "<%= resource_name %>[<%= attribute.name %>]", :with => @<%= resource_name %>.<%= attribute.name %><%-
+      end
+    %>
+  end 
+
+  def has_<%= resource_name %>_details<%-
+      attributes.each do |attribute|
+    %>
+    page.should have_content(@<%= resource_name %>.<%= attribute.name %>)<%-
+      end
+    %>
+  end
+
+  on_visiting new_<%= resource_name %>_path do
+    it { lets_me_create_the(:<%= resource_name %>) }
+    it { shows_failure_on_invalid_create }
+  end
+
+  with_existing :<%= resource_name %> do
+    it { shows_in_list(:<%= resource_name %>) }
+
+    on_visiting edit_<%= resource_name %>_path do
+      it { lets_me_edit_the(:<%= resource_name %>) }
+      it { shows_failure_on_invalid_update_of(:<%= resource_name %>) }
+    end
+  end
+
+end

data/lib/saki.rb

@@ -1,8 +1,104 @@
 require 'rspec/core'
 
 module Saki
+  module RestfulPathwayHelpers
+    def shows_in_list(resource, attrs = nil)
+      visit "/#{resource.to_s.pluralize}"
+      resource_instance = eval "@#{resource}"
+      if attrs
+        attrs.each do |attr|
+          page.should have_content(resource_instance.send(attr))
+        end
+      elsif respond_to?("displays_#{resource}")
+        send "displays_#{resource}"
+      else
+        page.should have_content(resource_instance.name)
+      end
+      has_index_link_list(resource_instance)
+    end
+
+    def has_index_link_list(item, opts = {})
+      has_link_for item, opts
+      has_link_for_editing item, opts
+      has_link_for_deleting item, opts
+      has_link_for_creating item.class.to_s.tableize.singularize, opts
+    end
+
+    def has_show_link_list(item, opts = {})
+      has_link_for_editing item, opts
+      has_link_for_deleting item, opts
+      has_link_for_indexing item.class.to_s.tableize.singularize, opts
+    end
+
+    def shows_failure_on_invalid_update_of(model)
+      if respond_to?("invalidate_#{model}_form")
+        send("invalidate_#{model}_form")
+      else
+        fill_in "#{model}[name]", :with => ""
+      end
+      click_button "Update"
+      page.should have_xpath("//input[@type='submit' and starts-with(@value, 'Update')]")
+      page.should have_content("error")
+    end
+
+    def shows_failure_on_invalid_create
+      click_button "Create"
+      page.should have_xpath("//input[@type='submit' and starts-with(@value, 'Create')]")
+      page.should have_content("error")
+    end
+
+    def lets_me_edit_the(item_name)
+      eval %{
+    @#{item_name} = factory_build item_name
+    fill_in_#{item_name}_details
+    click_button "Update"
+    refetch(item_name)
+    has_#{item_name}_details
+    }
+    end
+
+    def create(item_name)
+      eval %{
+    @#{item_name} = factory_build :#{item_name}
+    if respond_to? :before_#{item_name}_create
+      before_#{item_name}_create
+    end
+    fill_in_#{item_name}_details
+    click_button "Create"
+    }
+    end
+
+    def refetch
+
+
+    def lets_me_create_the(item_name)
+      eval %{
+      create(:#{item_name})
+      refetch(item_name)
+      if respond_to? :after_#{item_name}_create
+        after_#{item_name}_create
+      end
+      has_#{item_name}_details
+      has_show_link_list(@#{item_name})
+    }
+    end
+
+    def refetch(item_name)
+      eval "@#{item_name} = respond_to?(:refetch_#{item_name}_func) ? refetch_#{item_name}_func : @#{item_name}.class.where(:name => @#{item_name}.name).first"
+    end
+
+    def factory_build(name, hash = {})
+      Factory.build name, hash
+    end
+
+    def factory(name, hash = {})
+      Factory name, hash
+    end
+
+  end
+
   module GeneralHelpers
-    extend ActiveSupport::Concern    
+    extend ActiveSupport::Concern
     def default_factory(name, opts = {})
       Factory name, opts
     end
@@ -17,12 +113,22 @@ module Saki
         end
       end
 
+      def with_signed_in resource, opts={}, &block
+        context "with signed in #{resource}" do
+          before do
+            instance_variable_set "@#{resource}", default_factory(resource, opts)
+            eval "sign_in @#{resource}"
+          end
+          module_eval &block
+        end
+      end
+
       def where(executable, *opts, &block)
         context "anonymous closure" do
           before { instance_eval &executable }
           module_eval &block
         end
-      end      
+      end
     end
 
   end
@@ -78,7 +184,7 @@ module Saki
     def has_link_for_indexing(model_type, opts = {})
       href = add_opts "/#{model_type.to_s.tableize}", opts
       has_link href
-    end  
+    end
 
     def should_be_on(page_name)
       current_path = URI.parse(current_url).path
@@ -195,4 +301,5 @@ module RSpec::Core::ObjectExtensions
 end
 
 RSpec.configuration.include Saki::GeneralHelpers
-RSpec.configuration.include Saki::AcceptanceHelpers, :type => :acceptance
+RSpec.configuration.include Saki::AcceptanceHelpers, :type => :acceptance
+RSpec.configuration.include Saki::RestfulPathwayHelpers, :type => :acceptance

data/saki.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{saki}
-  s.version = "0.1.1"
+  s.version = "0.1.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Nate Kidwell"]
-  s.date = %q{2010-09-19}
+  s.date = %q{2010-10-15}
   s.description = %q{Cucumber scenarios are long and confusing sometimes.  Release yourself from the tyranny of client-centered specing!}
   s.email = %q{nate@ludicast.com}
   s.extra_rdoc_files = [
@@ -24,9 +24,11 @@ Gem::Specification.new do |s|
      "Rakefile",
      "VERSION",
      "lib/generators/saki/install_generator.rb",
+     "lib/generators/saki/integration_generator.rb",
      "lib/generators/saki/spec_generator.rb",
      "lib/generators/saki/templates/acceptance_helper.rb",
      "lib/generators/saki/templates/acceptance_spec.rb",
+     "lib/generators/saki/templates/full_integration_spec.rb",
      "lib/generators/saki/templates/helpers.rb",
      "lib/saki.rb",
      "saki.gemspec",

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 1
-  version: 0.1.1
+  - 2
+  version: 0.1.2
 platform: ruby
 authors: 
 - Nate Kidwell
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-19 00:00:00 -04:00
+date: 2010-10-15 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -47,9 +47,11 @@ files:
 - Rakefile
 - VERSION
 - lib/generators/saki/install_generator.rb
+- lib/generators/saki/integration_generator.rb
 - lib/generators/saki/spec_generator.rb
 - lib/generators/saki/templates/acceptance_helper.rb
 - lib/generators/saki/templates/acceptance_spec.rb
+- lib/generators/saki/templates/full_integration_spec.rb
 - lib/generators/saki/templates/helpers.rb
 - lib/saki.rb
 - saki.gemspec