lopata 0.1.11 → 0.1.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d30e71eec70c684f9d576aafa08ddac0a63e1e0615c0127dc31791592ccc833f
-  data.tar.gz: 88f921909bf2e3e7d34c3c6460630d0ae9e87f2ffb4c906916d92f1959df1f59
+  metadata.gz: 2bcc4430dec94673cafa7b78a1ce7a1a9290539fdfc6c74d452db6bdbb36562e
+  data.tar.gz: f2cab1b0033f5d8a44d4bd9beba5b2b6c354b8ec05bd9ea91cf7ee329b1c0626
 SHA512:
-  metadata.gz: e1bd2c858bd6f25e395ff74cad7e1af577a56346a7114ff2baa0cd6818294e148a1b8b91eb9c1219cca7359fa415720c01ffa7dd3c99012963114114aecb9ff3
-  data.tar.gz: 6c8e08f4148a47b69d40d16b5bf6ef3b6450adb5dc2c41ea9d728fe10d1fd9ffb87a2e07894a2576329b74b505050fe7f8d2c14ddf3ed7e52124242a81b7820d
+  metadata.gz: bf4791606e84c616316e54fd191687e9b21ce86d47b627228a66b5b936886a28ffde9b4d5a50a52de72296ed7b957fb3c8eaa54ca5309d637ced84b080e4aa89
+  data.tar.gz: f4634151931554ed5583d04dc807929d56e85072bb0203be6548b94bfda6f7dfaa3eb2387505f7027eed8692c0c16bdaa6892f420ae826654713d268440108ea

data/README.md

@@ -1,26 +1,26 @@
-# Lopata
-
-Functional acceptance testing using Ruby.
-
-## Installation
-
-    gem install lopata
-
-## Usage
-
-Create new lopata project:
-
-    lopata new <project-name>
-
-Setup environment: edit <project-name>/config/environments/qa.yml for setup project for testing.
-
-Write tests: puts tests in <project-name>/scenarios folder. Define shared steps in <project-name>/shared_steps folder.
-
-Run tests:
-
-    cd <project-name>
-    lopata
-
-## Documentation
-
+# Lopata
+
+Functional acceptance testing using Ruby.
+
+## Installation
+
+    gem install lopata
+
+## Usage
+
+Create new lopata project:
+
+    lopata new <project-name>
+
+Setup environment: edit <project-name>/config/environments/qa.yml for setup project for testing.
+
+Write tests: puts tests in <project-name>/scenarios folder. Define shared steps in <project-name>/shared_steps folder.
+
+Run tests:
+
+    cd <project-name>
+    lopata
+
+## Documentation
+
 See [features description](https://github.com/avolochnev/lopata/tree/master/features) for documentation.

data/exe/lopata

@@ -1,11 +1,11 @@
-#!/usr/bin/env ruby
-require 'bundler/setup'
-require 'lopata/runner'
-
-# use default command with arguments if given command is unknown.
-argv = ARGV.dup
-unless Lopata::Runner.all_commands.keys.map(&:to_s).include? argv.first
-  argv.unshift 'test'
-end
-
-Lopata::Runner.start argv
+#!/usr/bin/env ruby
+require 'bundler/setup'
+require 'lopata/runner'
+
+# use default command with arguments if given command is unknown.
+argv = ARGV.dup
+unless Lopata::Runner.all_commands.keys.map(&:to_s).include? argv.first
+  argv.unshift 'test'
+end
+
+Lopata::Runner.start argv

data/lib/lopata.rb

@@ -1,74 +1,100 @@
-require 'lopata/id'
-require 'lopata/configuration'
-require 'lopata/environment'
-require 'lopata/scenario_builder'
-require 'lopata/scenario'
-require 'lopata/step'
-require 'lopata/shared_step'
-
-# Namespace for all Lopata code.
-module Lopata
-  # Define the scenario.
-  # @see Lopata::ScenarioBuilder.define
-  def self.define(*args, &block)
-    Lopata::ScenarioBuilder.define(*args, &block)
-  end
-
-  # Skip scenario definition. Option to temporary ignore scenario
-  def self.xdefine(*args, &block)
-  end
-
-  # Register the shared step
-  #
-  # @example
-  #     Lopata.shared_step 'test user' do
-  #       setup { @user = create(:user) }
-  #     end
-  #
-  # Shared step may be used in scenarios by name:
-  # @example
-  #     Lopata.define 'user' do
-  #       setup 'test user'
-  #
-  #       it 'exists' do
-  #         expect(@user).to_not be_nil
-  #       end
-  #     end
-  # @param name [String] shared step unique name
-  # @param block [Block] shared step action sequence definition
-  def self.shared_step(name, &block)
-    Lopata::SharedStep.register(name, &block)
-  end
-
-  # Yields the global configuration to a block.
-  # @yield [Lopata::Configuration] global configuration
-  #
-  # @example
-  #     Lopata.configure do |config|
-  #       config.before_scenario 'setup test user'
-  #     end
-  # @see Lopata::Configuration
-  def self.configure(&block)
-    yield Lopata.configuration
-  end
-
-  # Returns global configuration object.
-  # @return [Lopata::Configuration]
-  # @see Lopata.configure
-  def self.configuration
-    @configuration ||= Lopata::Configuration.new
-  end
-
-  # @private
-  # Internal container for global non-configuration data.
-  def self.world
-    @world ||= Lopata::World.new
-  end
-
-  # Return global environment object
-  # @return [Lopata::Environment]
-  # @see Lopata::Environment
-  def self.environment
-    Lopata.configuration.environment
-  end
-end
+require 'lopata/id'
+require 'lopata/configuration'
+require 'lopata/environment'
+require 'lopata/scenario_builder'
+require 'lopata/scenario'
+require 'lopata/step'
+require 'lopata/shared_step'
+
+# Namespace for all Lopata code.
+module Lopata
+  # Define the scenario.
+  # @see Lopata::ScenarioBuilder.define
+  def self.define(*args, &block)
+    Lopata::ScenarioBuilder.define(*args, &block)
+  end
+
+  # Skip scenario definition. Option to temporary ignore scenario
+  def self.xdefine(*args, &block)
+  end
+
+  # Register the shared step
+  #
+  # @example
+  #     Lopata.shared_step 'test user' do
+  #       setup { @user = create(:user) }
+  #     end
+  #
+  # Shared step may be used in scenarios by name:
+  # @example
+  #     Lopata.define 'user' do
+  #       setup 'test user'
+  #
+  #       it 'exists' do
+  #         expect(@user).to_not be_nil
+  #       end
+  #     end
+  # @param name [String] shared step unique name
+  # @param block [Block] shared step action sequence definition
+  def self.shared_step(name, &block)
+    Lopata::SharedStep.register(name, &block)
+  end
+
+  # Register the shared step for setup.
+  # 
+  # shared_setup is a shortcat for shared_step 'name' { setup { .. } }. The block will be arrounded into the setup call.
+  #
+  # @example
+  #     Lopata.shared_setup 'test user' do
+  #       @user = create(:user)
+  #     end
+  #
+  # Shared step may be used in scenarios by name:
+  # @example
+  #     Lopata.define 'user' do
+  #       setup 'test user'
+  #
+  #       it 'exists' do
+  #         expect(@user).to_not be_nil
+  #       end
+  #     end
+  # @param name [String] shared step unique name
+  # @param block [Block] shared setup definition
+  def self.shared_setup(name, &block)
+    Lopata::SharedStep.register(name) do
+      setup(&block)
+    end
+  end
+
+  # Yields the global configuration to a block.
+  # @yield [Lopata::Configuration] global configuration
+  #
+  # @example
+  #     Lopata.configure do |config|
+  #       config.before_scenario 'setup test user'
+  #     end
+  # @see Lopata::Configuration
+  def self.configure(&block)
+    yield Lopata.configuration
+  end
+
+  # Returns global configuration object.
+  # @return [Lopata::Configuration]
+  # @see Lopata.configure
+  def self.configuration
+    @configuration ||= Lopata::Configuration.new
+  end
+
+  # @private
+  # Internal container for global non-configuration data.
+  def self.world
+    @world ||= Lopata::World.new
+  end
+
+  # Return global environment object
+  # @return [Lopata::Environment]
+  # @see Lopata::Environment
+  def self.environment
+    Lopata.configuration.environment
+  end
+end

data/lib/lopata/active_record.rb

@@ -1,136 +1,136 @@
-module Lopata
-  # Helpers for ActiveRecord usage in tests.
-  #
-  # Make helpers available in scenarios by
-  #
-  #     require 'lopata/active_record'
-  #
-  # @example
-  #
-  #     # Configure db connection at config/environments/qa.yml like rails:
-  #     # db:
-  #     #   adapter: postgresql
-  #     #   host: your.database.host
-  #     #   username: username
-  #     #   password: password
-  #     #   database: database
-  #     require 'active_record'
-  #     require 'lopata/active_record'
-  #
-  #     class User < ActiveRecord::Base; end
-  #
-  #     Lopata.define 'User creation' do
-  #       setup do
-  #         @user = User.create!(username: 'testuser')
-  #       end
-  #       # Remove user from database after scenario
-  #       cleanup :user
-  #
-  #       it 'works' do
-  #         expect(@user).to_not be_nil
-  #       end
-  #     end
-  #
-  module ActiveRecord
-    # To be included in Lopata::Scenario. The methods may be used in runtime.
-    module Methods
-      # Destroy ActiveRecord objects.
-      #
-      # Does nothing if 'keep' mode is enabled:
-      #
-      #     Lopata.configure do |c|
-      #       c.keep = true
-      #     end
-      #
-      # @param objects [Array<ActiveRecord::Base, Array<ActiveRecord::Base>, nil>] to be destroyed
-      # @see Lopata::Configuration#keep
-      def cleanup(*objects)
-        return if Lopata.configuration.keep
-        objects.flatten.compact.each do |o|
-          begin
-            o.reload.destroy!
-          rescue ::ActiveRecord::RecordNotFound
-            # Already destroyed - skip
-          rescue ::ActiveRecord::InvalidForeignKey
-            # Possible async job created new relationships (e.g. history records). Try again once.
-            o.reload.destroy!
-          end
-        end
-      end
-
-      # Reload ActiveRecord objects
-      #
-      # @example
-      #
-      #     # use in steps
-      #     reload @a, @b
-      #     # instead of
-      #     @a.reload; @b.reload
-      #
-      # @param objects [Array<ActiveRecord::Base, Array<ActiveRecord::Base>, nil>] to be reloaded
-      def reload(*objects)
-        objects.flatten.compact.each(&:reload)
-      end
-
-      # Marks object to be destroyed at the end of scenario
-      #
-      # @param object [ActiveRecord::Base] the object to be destoryed at the end of scenario
-      # @return the given object, so chains can be build
-      def cleanup_later(object)
-        return nil unless object
-        @created_objects ||= []
-        @created_objects << object
-        object
-      end
-
-      # Find ActiveRecord object of given class by params.
-      # Marks the returned object to be destroyed at the end of scenario.
-      #
-      # @example
-      #     action do
-      #       # UI actions creating the user
-      #       @user = find_created(User, username: 'testuser')
-      #     end
-      #     it 'created' do
-      #       expect(@user).to_not be_nil
-      #     end
-      #     # No cleanup needed
-      #     # cleanup :user
-      #
-      # @param cls [Class] active record model class
-      # @param params [Hash] options for record finding
-      # @return [ActiveRecord::Base, nil] the object or nil if not found
-      # @see #cleanup_later called on the hood
-      def find_created(cls, params)
-        cleanup_later cls.where(params).take
-      end
-    end
-
-    # To be included in Lopata::ScenarioBuilder. The methods may be used in build time.
-    module DSL
-      # Mark instance variables to call #destroy at teardown phase of scenario or context running.
-      #
-      # Does nothing if 'keep' mode is enabled.
-      #
-      # @param vars [Array<Symbol, String>] instance variable names to be destroyed on teardown phase.
-      def cleanup(*vars, &block)
-        unless vars.empty?
-          teardown do
-            cleanup vars.map { |v| instance_variable_get "@#{v}" }
-          end
-        end
-        teardown &block if block_given?
-      end
-    end
-  end
-end
-
-Lopata.configure do |c|
-  c.after_scenario { cleanup @created_objects }
-end
-
-params = Lopata.environment['db']
-ActiveRecord::Base.establish_connection(params) if params
-
-Lopata::Scenario.include Lopata::ActiveRecord::Methods
+module Lopata
+  # Helpers for ActiveRecord usage in tests.
+  #
+  # Make helpers available in scenarios by
+  #
+  #     require 'lopata/active_record'
+  #
+  # @example
+  #
+  #     # Configure db connection at config/environments/qa.yml like rails:
+  #     # db:
+  #     #   adapter: postgresql
+  #     #   host: your.database.host
+  #     #   username: username
+  #     #   password: password
+  #     #   database: database
+  #     require 'active_record'
+  #     require 'lopata/active_record'
+  #
+  #     class User < ActiveRecord::Base; end
+  #
+  #     Lopata.define 'User creation' do
+  #       setup do
+  #         @user = User.create!(username: 'testuser')
+  #       end
+  #       # Remove user from database after scenario
+  #       cleanup :user
+  #
+  #       it 'works' do
+  #         expect(@user).to_not be_nil
+  #       end
+  #     end
+  #
+  module ActiveRecord
+    # To be included in Lopata::Scenario. The methods may be used in runtime.
+    module Methods
+      # Destroy ActiveRecord objects.
+      #
+      # Does nothing if 'keep' mode is enabled:
+      #
+      #     Lopata.configure do |c|
+      #       c.keep = true
+      #     end
+      #
+      # @param objects [Array<ActiveRecord::Base, Array<ActiveRecord::Base>, nil>] to be destroyed
+      # @see Lopata::Configuration#keep
+      def cleanup(*objects)
+        return if Lopata.configuration.keep
+        objects.flatten.compact.each do |o|
+          begin
+            o.reload.destroy!
+          rescue ::ActiveRecord::RecordNotFound
+            # Already destroyed - skip
+          rescue ::ActiveRecord::InvalidForeignKey
+            # Possible async job created new relationships (e.g. history records). Try again once.
+            o.reload.destroy!
+          end
+        end
+      end
+
+      # Reload ActiveRecord objects
+      #
+      # @example
+      #
+      #     # use in steps
+      #     reload @a, @b
+      #     # instead of
+      #     @a.reload; @b.reload
+      #
+      # @param objects [Array<ActiveRecord::Base, Array<ActiveRecord::Base>, nil>] to be reloaded
+      def reload(*objects)
+        objects.flatten.compact.each(&:reload)
+      end
+
+      # Marks object to be destroyed at the end of scenario
+      #
+      # @param object [ActiveRecord::Base] the object to be destoryed at the end of scenario
+      # @return the given object, so chains can be build
+      def cleanup_later(object)
+        return nil unless object
+        @created_objects ||= []
+        @created_objects << object
+        object
+      end
+
+      # Find ActiveRecord object of given class by params.
+      # Marks the returned object to be destroyed at the end of scenario.
+      #
+      # @example
+      #     action do
+      #       # UI actions creating the user
+      #       @user = find_created(User, username: 'testuser')
+      #     end
+      #     it 'created' do
+      #       expect(@user).to_not be_nil
+      #     end
+      #     # No cleanup needed
+      #     # cleanup :user
+      #
+      # @param cls [Class] active record model class
+      # @param params [Hash] options for record finding
+      # @return [ActiveRecord::Base, nil] the object or nil if not found
+      # @see #cleanup_later called on the hood
+      def find_created(cls, params)
+        cleanup_later cls.where(params).take
+      end
+    end
+
+    # To be included in Lopata::ScenarioBuilder. The methods may be used in build time.
+    module DSL
+      # Mark instance variables to call #destroy at teardown phase of scenario or context running.
+      #
+      # Does nothing if 'keep' mode is enabled.
+      #
+      # @param vars [Array<Symbol, String>] instance variable names to be destroyed on teardown phase.
+      def cleanup(*vars, &block)
+        unless vars.empty?
+          teardown do
+            cleanup vars.map { |v| instance_variable_get "@#{v}" }
+          end
+        end
+        teardown &block if block_given?
+      end
+    end
+  end
+end
+
+Lopata.configure do |c|
+  c.after_scenario { cleanup @created_objects }
+end
+
+params = Lopata.environment['db']
+ActiveRecord::Base.establish_connection(params) if params
+
+Lopata::Scenario.include Lopata::ActiveRecord::Methods
 Lopata::ScenarioBuilder.include Lopata::ActiveRecord::DSL