Merge 17a5569 into 8ba1525

lib/howitzer/capybara_helpers.rb

@@ -60,7 +60,7 @@ def duration(time_in_numeric)
 
     # Updates a job status on the job cloud
     # @note SauceLabs is currently supported only
-    # @param json_data [String] (for example, {passed: true})
+    # @param json_data [Hash] for example, (passed: true)
 
     def update_cloud_job_status(json_data = {})
       case Howitzer.driver.to_sym

lib/howitzer/email.rb

@@ -52,7 +52,7 @@ def self.adapter=(adapter_name)
     end
 
     # Searches a mail by a recepient
-    # @param recepient [String] recepient's email address
+    # @param recipient [String] recepient's email address
     # @param params [Hash] placeholders with appropriate values
     # @raise [NoEmailSubjectError] when a subject is not specified for the email class
     # @return [Email] an instance of the email message

lib/howitzer/mail_adapters/abstract.rb

@@ -17,8 +17,8 @@ class Abstract
       attr_reader :message
 
       # Finds an email in mailbox
-      # @param recipient [String] an email
-      # @param subject [String]
+      # @param _recipient [String] an email
+      # @param _subject [String]
 
       def self.find(_recipient, _subject)
         raise NotImplementedError

lib/howitzer/web/page.rb

@@ -71,7 +71,7 @@ def self.current_page
       end
 
       # Waits until a web page is opened
-      # @param time_out [Integer] time in seconds a required web page to be loaded
+      # @param timeout [Integer] time in seconds a required web page to be loaded
       # @return [Boolean]
       # @raise [IncorrectPageError] when timeout expired and the page is not displayed
 

lib/howitzer/web/page_dsl.rb

@@ -8,6 +8,7 @@ class PageScope
 
         def initialize(page_klass, &block)
           self.page_klass = page_klass
+          self.outer_context = eval('self', block.binding) if block.present?
           instance_eval(&block)
         end
 
@@ -20,10 +21,16 @@ def is_expected # rubocop:disable Style/PredicateName
           expect(page_klass.given)
         end
 
-        # Proxies all methods to page instance except methods with be_ and have_ prefixes
+        # Proxies all methods to a page instance.
+        #
+        # @note There are some exceptions:
+        #   * Methods with `be_` and `have_` prefixes are excluded
+        #   * `out` method extracts an instance variable from an original context if starts from @.
+        #    Otherwise it executes a method from an original context
 
         def method_missing(name, *args, &block)
           return super if name =~ /\A(?:be|have)_/
+          return eval_in_out_context(*args, &block) if name == :out
           page_klass.given.send(name, *args, &block)
         end
 
@@ -36,7 +43,18 @@ def respond_to_missing?(name, include_private = false)
 
         private
 
-        attr_accessor :page_klass
+        def eval_in_out_context(*args, &block)
+          return nil if args.size.zero?
+          name = args.shift
+          return get_outer_instance_variable(name) if name.to_s.start_with?('@')
+          outer_context.send(name, *args, &block)
+        end
+
+        def get_outer_instance_variable(name)
+          outer_context.instance_variable_get(name)
+        end
+
+        attr_accessor :page_klass, :outer_context
       end
 
       def self.included(base)
@@ -47,12 +65,22 @@ module ClassMethods
         # Allows to execute page methods in context of the page.
         # @note It additionally checks the page is really displayed
         #   on each method call, otherwise it raises error
-        # @example
+        # @example Standard case
         #   LoginPage.open
         #   LoginPage.on do
         #     fill_form(name: 'John', email: 'jkarpensky@gmail.com')
         #     submit_form
         #   end
+        # @example More complex case with outer context
+        #   @name = 'John'
+        #   def email(domain = 'gmail.com')
+        #     "jkarpensky@#{domain}"
+        #   end
+        #   LoginPage.open
+        #   LoginPage.on do
+        #     fill_form(name: out(:@name), email: out(:email, 'yahoo.com'))
+        #     submit_form
+        #   end
 
         def on(&block)
           PageScope.new(self, &block)

spec/unit/lib/web/page_dsl_spec.rb

@@ -42,6 +42,28 @@
       it { expect(subject.class).to eq(RSpec::Matchers::BuiltIn::Has) }
     end
 
+    context 'when out' do
+      let(:outer_context) do
+        Class.new do
+          def initialize(klass)
+            @klass = klass
+            @a = 5
+          end
+
+          def scope
+            @klass.new(nil) { 1 }
+          end
+
+          def secret
+            '***'
+          end
+        end
+      end
+      let(:scope) { outer_context.new(described_class).scope }
+      it { expect(scope.out(:@a)).to eq(5) }
+      it { expect(scope.out(:secret)).to eq('***') }
+    end
+
     context 'when starts other prefix' do
       let(:scope) { described_class.new(page) { 1 } }
       subject { scope.foo(1, 2, 3) }