howitzer 2.0.3 → 2.3.0

data/generators/root/templates/Gemfile.erb

@@ -1,28 +1,22 @@
 source 'https://rubygems.org'
 
-# Uncomment it if you are going to use 'webkit' driver. QT library should be installed.
-# See https://github.com/thoughtbot/capybara-webkit/wiki/Installing-Qt-and-compiling-capybara-webkit
-#
-# gem 'capybara-webkit'
+ruby '>=2.6.8'
 
-gem 'howitzer'
-# Uncomment it if you are going to use 'poltergeist' driver. PhantomJS should be installed.
-# See https://github.com/jnicklas/capybara#poltergeist
-# gem 'poltergeist', git: 'https://github.com/teampoltergeist/poltergeist.git', branch: :master
-gem 'rest-client'
-gem 'repeater'
-gem 'factory_girl'
 gem 'capybara-screenshot'
-<% if cucumber %>
-gem 'syntax'
-gem 'cucumber', '~>2.0'
-gem 'cuke_sniffer', require: false
-<% elsif rspec %>
-gem 'rspec', '~>3.2'
-<% elsif turnip %>
-gem 'rspec', '~>3.2'
-gem 'turnip'
-<% end %>
-gem 'rubocop'
+<%= "gem 'cucumber', '>=3.0', '<7'\n" if cucumber -%>
+<%= "gem 'cuke_sniffer', require: false\n" if cucumber -%>
+gem 'factory_bot'
+gem 'howitzer'
 gem 'pry'
 gem 'pry-byebug'
+gem 'repeater'
+gem 'rest-client'
+<%= "gem 'rspec', '~>3.2'\n" if rspec || turnip -%>
+gem 'rubocop'
+<%= "gem 'rubocop-rspec'\n" if rspec || turnip -%>
+<%= "gem 'turnip'\n" if turnip -%>
+<%= "gem 'syntax'\n" if cucumber -%>
+
+# Uncomment it if you are going to use 'appium' driver. Appium and Android SDK should be installed.
+# See https://appium.io/docs/en/about-appium/getting-started/
+# gem 'appium_capybara'

data/generators/rspec/rspec_generator.rb

@@ -15,9 +15,9 @@ module Howitzer
     protected
 
     def banner
-      <<-EOS
+      <<-MSG
   * RSpec integration to the framework ...
-      EOS
+      MSG
     end
   end
 end

data/generators/rspec/templates/rspec.rake

@@ -10,43 +10,43 @@ end
 
 RSpec::Core::RakeTask.new(:rspec, 'Run all rspec scenarios') do |t|
   Howitzer.current_rake_task = t.name
-  t.opts = opts.call(t.name)
+  t.rspec_opts = opts.call(t.name)
 end
 
 RSpec::Core::RakeTask.new(:features, 'Run all workable scenarios (without @wip and @bug tags)') do |t|
   Howitzer.current_rake_task = t.name
-  t.opts = "#{opts.call(t.name)} --tag ~wip --tag ~bug"
+  t.rspec_opts = "#{opts.call(t.name)} --tag ~wip --tag ~bug"
 end
 
 namespace :features do
   RSpec::Core::RakeTask.new(:wip, 'Run scenarios in progress (with @wip tag)') do |t|
     Howitzer.current_rake_task = t.name
-    t.opts = "#{opts.call(t.name)} --tag wip"
+    t.rspec_opts = "#{opts.call(t.name)} --tag wip"
   end
 
   RSpec::Core::RakeTask.new(:bug, 'Run scenarios with known bugs (with @bug tag)') do |t|
     Howitzer.current_rake_task = t.name
-    t.opts = "#{opts.call(t.name)} --tag bug"
+    t.rspec_opts = "#{opts.call(t.name)} --tag bug"
   end
 
   RSpec::Core::RakeTask.new(:smoke, 'Run workable smoke scenarios (with @smoke tag)') do |t|
     Howitzer.current_rake_task = t.name
-    t.opts = "#{opts.call(t.name)} --tag smoke --tag ~wip --tag ~bug"
+    t.rspec_opts = "#{opts.call(t.name)} --tag smoke --tag ~wip --tag ~bug"
   end
 
   RSpec::Core::RakeTask.new(:bvt, 'Run workable build verification test scenarios') do |t|
     Howitzer.current_rake_task = t.name
-    t.opts = "#{opts.call(t.name)} --tag ~wip --tag ~bug --tag ~p1 --tag ~p2 --tag ~smoke"
+    t.rspec_opts = "#{opts.call(t.name)} --tag ~wip --tag ~bug --tag ~p1 --tag ~p2 --tag ~smoke"
   end
 
   RSpec::Core::RakeTask.new(:p1, 'Run workable scenarios with normal priority (with @p1 tag)') do |t|
     Howitzer.current_rake_task = t.name
-    t.opts = "#{opts.call(t.name)} --tag p1 --tag ~wip --tag ~bug"
+    t.rspec_opts = "#{opts.call(t.name)} --tag p1 --tag ~wip --tag ~bug"
   end
 
   RSpec::Core::RakeTask.new(:p2, 'Run workable scenarios with low priority (with @p2 tag)') do |t|
     Howitzer.current_rake_task = t.name
-    t.opts = "#{opts.call(t.name)} --tag p2 --tag ~wip --tag ~bug"
+    t.rspec_opts = "#{opts.call(t.name)} --tag p2 --tag ~wip --tag ~bug"
   end
 end
 

data/generators/rspec/templates/spec_helper.rb

@@ -2,7 +2,7 @@ require 'capybara/rspec/features'
 require_relative '../config/boot'
 require_relative '../config/capybara'
 
-Dir['./spec/support/**/*.rb'].each { |f| require f }
+Dir['./spec/support/**/*.rb'].sort.each { |f| require f }
 
 RSpec.configure do |config|
   Howitzer::Log.settings_as_formatted_text
@@ -10,13 +10,14 @@ RSpec.configure do |config|
   Howitzer::Cache.store(:cloud, :start_time, Time.now.utc)
   Howitzer::Cache.store(:cloud, :status, true)
 
-  config.include FactoryGirl::Syntax::Methods
+  config.include FactoryBot::Syntax::Methods
 
   config.disable_monkey_patching!
   config.color = true
   config.wait_timeout = Howitzer.rspec_wait_timeout
+  config.order = Howitzer.test_order.presence || :defined
 
-  config.before(:each) do
+  config.before do
     scenario_name =
       if RSpec.current_example.description.blank?
         RSpec.current_example.metadata[:full_description]
@@ -27,12 +28,12 @@ RSpec.configure do |config|
     @session_start = CapybaraHelpers.duration(Time.now.utc - Howitzer::Cache.extract(:cloud, :start_time))
   end
 
-  config.after(:each) do
+  config.after do
     Howitzer::Cache.clear_all_ns
     if CapybaraHelpers.cloud_driver?
       session_end = CapybaraHelpers.duration(Time.now.utc - Howitzer::Cache.extract(:cloud, :start_time))
       Howitzer::Log.info "CLOUD VIDEO #{@session_start} - #{session_end}" \
-               " URL: #{CapybaraHelpers.cloud_resource_path(:video)}"
+                         " URL: #{CapybaraHelpers.cloud_resource_path(:video)}"
     elsif CapybaraHelpers.ie_browser?
       Howitzer::Log.info 'IE reset session'
       Capybara.current_session.execute_script("void(document.execCommand('ClearAuthenticationCache', false));")

data/generators/tasks/tasks_generator.rb

@@ -10,9 +10,9 @@ module Howitzer
     protected
 
     def banner
-      <<-EOF
+      <<-MSG
   * Base rake task generation ...
-      EOF
+      MSG
     end
   end
 end

data/generators/turnip/templates/spec_helper.rb

@@ -1,7 +1,7 @@
 require_relative '../config/boot'
 require_relative '../config/capybara'
 
-Dir['./spec/support/**/*.rb'].each { |f| require f }
+Dir['./spec/support/**/*.rb'].sort.each { |f| require f }
 
 RSpec.configure do |config|
   Howitzer::Log.settings_as_formatted_text
@@ -9,13 +9,14 @@ RSpec.configure do |config|
   Howitzer::Cache.store(:cloud, :start_time, Time.now.utc)
   Howitzer::Cache.store(:cloud, :status, true)
 
-  config.include FactoryGirl::Syntax::Methods
+  config.include FactoryBot::Syntax::Methods
 
   config.disable_monkey_patching!
   config.color = true
   config.wait_timeout = Howitzer.rspec_wait_timeout
+  config.order = Howitzer.test_order.presence || :defined
 
-  config.before(:each) do
+  config.before do
     scenario_name =
       if RSpec.current_example.description.blank?
         RSpec.current_example.metadata[:full_description]
@@ -26,12 +27,12 @@ RSpec.configure do |config|
     @session_start = CapybaraHelpers.duration(Time.now.utc - Howitzer::Cache.extract(:cloud, :start_time))
   end
 
-  config.after(:each) do
+  config.after do
     Howitzer::Cache.clear_all_ns
     if CapybaraHelpers.cloud_driver?
       session_end = CapybaraHelpers.duration(Time.now.utc - Howitzer::Cache.extract(:cloud, :start_time))
       Howitzer::Log.info "CLOUD VIDEO #{@session_start} - #{session_end}" \
-               " URL: #{CapybaraHelpers.cloud_resource_path(:video)}"
+                         " URL: #{CapybaraHelpers.cloud_resource_path(:video)}"
     elsif CapybaraHelpers.ie_browser?
       Howitzer::Log.info 'IE reset session'
       Capybara.current_session.execute_script("void(document.execCommand('ClearAuthenticationCache', false));")

data/generators/turnip/turnip_generator.rb

@@ -18,9 +18,9 @@ module Howitzer
     protected
 
     def banner
-      <<-EOS
+      <<-MSG
   * Turnip integration to the framework ...
-      EOS
+      MSG
     end
   end
 end

data/generators/web/templates/example_page.rb

@@ -1,7 +1,7 @@
 # This class is example of web page
 class ExamplePage < Howitzer::Web::Page
   path '/'
-  validate :url, %r{\A(?:.*?:\/\/)?[^\/]*\/?\z}
+  validate :url, %r{\A(?:.*?://)?[^/]*/?\z}
 
   section :menu
 

data/generators/web/web_generator.rb

@@ -14,9 +14,9 @@ module Howitzer
     protected
 
     def banner
-      <<-EOS
+      <<-MSG
   * PageOriented pattern structure generation ...
-      EOS
+      MSG
     end
   end
 end

data/lib/howitzer/cache.rb

@@ -4,7 +4,7 @@ module Howitzer
   # Data can be stored in memory using this class
   #
   module Cache
-    SPECIAL_NS_LIST = [:cloud].freeze #:nodoc:
+    SPECIAL_NS_LIST = [:cloud].freeze # :nodoc:
     @data ||= {}
 
     class << self
@@ -12,35 +12,35 @@ module Howitzer
 
       # Saves data into memory. Marking by a namespace and a key
       #
-      # @param ns [String] a namespace
+      # @param namespace [String] a namespace
       # @param key [String] a key that should be uniq within the namespace
       # @param value [Object] everything you want to store in Memory
       # @raise [NoDataError] if the namespace missing
 
-      def store(ns, key, value)
-        check_ns(ns)
-        @data[ns][key] = value
+      def store(namespace, key, value)
+        check_ns(namespace)
+        @data[namespace][key] = value
       end
 
       # Gets data from memory. Can get all namespace or single data value in namespace using key
       #
-      # @param ns [String] a namespace
+      # @param namespace [String] a namespace
       # @param key [String] key that isn't necessary required
       # @return [Object, Hash] all data from the namespace if the key is ommited, otherwise returs
       #   all data for the namespace
       # @raise [NoDataError] if the namespace missing
 
-      def extract(ns, key = nil)
-        check_ns(ns)
-        key ? @data[ns][key] : @data[ns]
+      def extract(namespace, key = nil)
+        check_ns(namespace)
+        key ? @data[namespace][key] : @data[namespace]
       end
 
       # Deletes all data from a namespace
       #
-      # @param ns [String] a namespace
+      # @param namespace [String] a namespace
 
-      def clear_ns(ns)
-        init_ns(ns)
+      def clear_ns(namespace)
+        init_ns(namespace)
       end
 
       # Deletes all namespaces with data
@@ -53,17 +53,18 @@ module Howitzer
 
       private
 
-      def check_ns(ns)
-        raise Howitzer::NoDataError, 'Data storage namespace can not be empty' unless ns
-        init_ns(ns) if ns_absent?(ns)
+      def check_ns(namespace)
+        raise Howitzer::NoDataError, 'Data storage namespace can not be empty' unless namespace
+
+        init_ns(namespace) if ns_absent?(namespace)
       end
 
-      def ns_absent?(ns)
-        !@data.key?(ns)
+      def ns_absent?(namespace)
+        !@data.key?(namespace)
       end
 
-      def init_ns(ns)
-        @data[ns] = {}
+      def init_ns(namespace)
+        @data[namespace] = {}
       end
     end
   end

data/lib/howitzer/capybara_helpers.rb

@@ -1,16 +1,52 @@
 require 'rest-client'
 require 'howitzer/exceptions'
 
+# There is an issue with supporting Ruby 3 by Selenium Webdriver 3.x version
+# https://github.com/SeleniumHQ/selenium/issues/9001
+# Migration to Selenium Webdriver 4 is planned when it will be released without alfa, beta stages.
+if Gem::Requirement.new('>=3').satisfied_by?(Gem::Version.new(RUBY_VERSION)) ||
+   Gem::Requirement.new(['>=3', '<4']).satisfied_by?(Gem::Version.new(Selenium::WebDriver::VERSION))
+  module Selenium
+    module WebDriver
+      module Remote
+        class Bridge # rubocop:disable Style/Documentation
+          class << self
+            alias original_handshake handshake
+
+            def handshake(opts = {})
+              original_handshake(**opts)
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
 module Howitzer
   # This module holds capybara helpers methods
   module CapybaraHelpers
-    CHECK_YOUR_SETTINGS_MSG = 'Please check your settings'.freeze #:nodoc:
+    CHECK_YOUR_SETTINGS_MSG = 'Please check your settings'.freeze # :nodoc:
+    HOWITZER_KNOWN_BROWSERS = [ # :nodoc:
+      CLOUD_BROWSERS = [
+        SAUCE = :sauce,
+        TESTINGBOT = :testingbot,
+        BROWSERSTACK = :browserstack,
+        CROSSBROWSERTESTING = :crossbrowsertesting
+      ].freeze,
+      LOCAL_BROWSERS = [
+        HEADLESS_CHROME = :headless_chrome,
+        HEADLESS_FIREFOX = :headless_firefox,
+        SELENIUM = :selenium,
+        SELENIUM_GRID = :selenium_grid
+      ].freeze
+    ].freeze
 
     # @return [Boolean] true if current driver related with SauceLab,
     #   Testingbot or Browserstack cloud service
 
     def cloud_driver?
-      %i[sauce testingbot browserstack].include?(Howitzer.driver.to_sym)
+      CLOUD_BROWSERS.include?(Howitzer.driver.to_sym)
     end
 
     # @return [Boolean] whether or not current browser is
@@ -64,7 +100,7 @@ module Howitzer
 
     def update_cloud_job_status(json_data = {})
       case Howitzer.driver.to_sym
-      when :sauce then update_sauce_job_status(json_data)
+      when SAUCE then update_sauce_job_status(json_data)
       else
         '[NOT IMPLEMENTED]'
       end
@@ -102,7 +138,8 @@ module Howitzer
 
     def cloud_driver(app, caps, url)
       http_client = ::Selenium::WebDriver::Remote::Http::Default.new
-      http_client.timeout = Howitzer.cloud_http_idle_timeout
+      http_client.read_timeout = Howitzer.cloud_http_idle_timeout
+      http_client.open_timeout = Howitzer.cloud_http_idle_timeout
 
       options = {
         url: url,
@@ -110,7 +147,7 @@ module Howitzer
         http_client: http_client,
         browser: :remote
       }
-      driver = Capybara::Selenium::Driver.new(app, options)
+      driver = Capybara::Selenium::Driver.new(app, **options)
       driver.browser.file_detector = remote_file_detector
       driver
     end
@@ -121,7 +158,7 @@ module Howitzer
 
     def cloud_resource_path(kind)
       case Howitzer.driver.to_sym
-      when :sauce then sauce_resource_path(kind)
+      when SAUCE then sauce_resource_path(kind)
       else
         '[NOT IMPLEMENTED]'
       end
@@ -136,24 +173,32 @@ module Howitzer
 
     def cloud_browser?(*browser_aliases)
       unless Howitzer.cloud_browser_name.nil?
-        return browser_aliases.include?(Howitzer.cloud_browser_name.to_s.to_sym)
+        return browser_aliases.include?(Howitzer.cloud_browser_name.to_s.downcase.to_sym)
       end
+
       raise Howitzer::CloudBrowserNotSpecifiedError, CHECK_YOUR_SETTINGS_MSG
     end
 
     def selenium_browser?(*browser_aliases)
-      unless Howitzer.selenium_browser.nil?
-        return browser_aliases.include?(Howitzer.selenium_browser.to_s.to_sym)
-      end
+      return browser_aliases.include?(Howitzer.selenium_browser.to_s.to_sym) unless Howitzer.selenium_browser.nil?
+
       raise Howitzer::SelBrowserNotSpecifiedError, CHECK_YOUR_SETTINGS_MSG
     end
 
     def selenium_driver?
-      Howitzer.driver.to_sym == :selenium
+      Howitzer.driver.to_sym == SELENIUM
+    end
+
+    def headless_chrome_driver?
+      Howitzer.driver.to_sym == HEADLESS_CHROME
+    end
+
+    def headless_firefox_driver?
+      Howitzer.driver.to_sym == HEADLESS_FIREFOX
     end
 
     def selenium_grid_driver?
-      Howitzer.driver.to_sym == :selenium_grid
+      Howitzer.driver.to_sym == SELENIUM_GRID
     end
 
     def prefix_name
@@ -174,7 +219,7 @@ module Howitzer
     end
 
     def update_sauce_job_status(json_data = {})
-      host = "http://#{Howitzer.cloud_auth_login}:#{Howitzer.cloud_auth_pass}@saucelabs.com"
+      host = "https://#{Howitzer.cloud_auth_login}:#{Howitzer.cloud_auth_pass}@saucelabs.com"
       path = "/rest/v1/#{Howitzer.cloud_auth_login}/jobs/#{session_id}"
       url = "#{host}#{path}"
       ::RestClient.put url, json_data.to_json, content_type: :json, accept: :json

data/lib/howitzer/email.rb

@@ -12,6 +12,7 @@ module Howitzer
 
     def self.adapter
       return @adapter if @adapter
+
       self.adapter = Howitzer.mail_adapter.to_sym
       @adapter
     end
@@ -78,8 +79,8 @@ module Howitzer
     def self.find_by_recipient(recipient, params = {})
       if defined?(subject_value).nil? || subject_value.nil?
         raise Howitzer::NoEmailSubjectError, "Please specify email subject. For example:\n" \
-                                    "class SomeEmail < Howitzer::Email\n" \
-                                    "  subject ‘some subject text’\nend"
+                                             "class SomeEmail < Howitzer::Email\n" \
+                                             "  subject ‘some subject text’\nend"
       end
       new(adapter.find(recipient, expand_subject(params), wait: wait_time_value))
     end

data/lib/howitzer/exceptions.rb

@@ -1,23 +1,24 @@
 # This module holds all custom howitzer exceptions
 module Howitzer
-  CommunicationError = Class.new(StandardError) #:nodoc:
-  ParseError = Class.new(StandardError) #:nodoc:
-  InvalidApiKeyError = Class.new(StandardError) #:nodoc:
-  BadElementParamsError = Class.new(StandardError) #:nodoc:
-  NoValidationError = Class.new(StandardError) #:nodoc:
-  UnknownValidationError = Class.new(StandardError) #:nodoc:
-  EmailNotFoundError = Class.new(StandardError) #:nodoc:
-  NoAttachmentsError = Class.new(StandardError) #:nodoc:
-  DriverNotSpecifiedError = Class.new(StandardError) #:nodoc:
-  UnknownDriverError = Class.new(StandardError) #:nodoc:
-  CloudBrowserNotSpecifiedError = Class.new(StandardError) #:nodoc:
-  SelBrowserNotSpecifiedError = Class.new(StandardError) #:nodoc:
-  UnknownBrowserError = Class.new(StandardError) #:nodoc:
-  IncorrectPageError = Class.new(StandardError) #:nodoc:
-  AmbiguousPageMatchingError = Class.new(StandardError) #:nodoc:
-  NoMailAdapterError = Class.new(StandardError) #:nodoc:
-  NoPathForPageError = Class.new(StandardError) #:nodoc:
-  NoEmailSubjectError = Class.new(StandardError) #:nodoc:
-  NoDataError = Class.new(StandardError) #:nodoc:
-  UndefinedElementError = Class.new(StandardError) #:nodoc:
+  CommunicationError = Class.new(StandardError) # :nodoc:
+  ParseError = Class.new(StandardError) # :nodoc:
+  InvalidApiKeyError = Class.new(StandardError) # :nodoc:
+  BadElementParamsError = Class.new(StandardError) # :nodoc:
+  NoValidationError = Class.new(StandardError) # :nodoc:
+  UnknownValidationError = Class.new(StandardError) # :nodoc:
+  EmailNotFoundError = Class.new(StandardError) # :nodoc:
+  NoAttachmentsError = Class.new(StandardError) # :nodoc:
+  DriverNotSpecifiedError = Class.new(StandardError) # :nodoc:
+  UnknownDriverError = Class.new(StandardError) # :nodoc:
+  CloudBrowserNotSpecifiedError = Class.new(StandardError) # :nodoc:
+  SelBrowserNotSpecifiedError = Class.new(StandardError) # :nodoc:
+  UnknownBrowserError = Class.new(StandardError) # :nodoc:
+  IncorrectPageError = Class.new(StandardError) # :nodoc:
+  AmbiguousPageMatchingError = Class.new(StandardError) # :nodoc:
+  NoMailAdapterError = Class.new(StandardError) # :nodoc:
+  NoPathForPageError = Class.new(StandardError) # :nodoc:
+  NoEmailSubjectError = Class.new(StandardError) # :nodoc:
+  NoDataError = Class.new(StandardError) # :nodoc:
+  UndefinedElementError = Class.new(StandardError) # :nodoc:
+  UndefinedSexySettingError = Class.new(StandardError) # :nodoc:
 end

data/lib/howitzer/gmail_api/client.rb

@@ -0,0 +1,31 @@
+module Howitzer
+  module GmailApi
+    # A GmailApi::Client object is used to communicate with the Gmail API.
+    class Client
+      def self.load_gmail_gem!
+        require 'gmail'
+      rescue LoadError
+        raise LoadError, "Unable to load `gmail` library, please add following code to your Gemfile:\n\ngem 'gmail'"
+      end
+      load_gmail_gem!
+
+      def initialize
+        self.client = Gmail.connect(Howitzer.gmail_login, Howitzer.gmail_password)
+      end
+
+      # Finds message according to given parameters
+      #
+      # @param recipient [String] this is recipient mail address for message filtering
+      # @param subject [String] this is subject of the message to filter particular message
+      # @return [Gmail::Message] gmail message object
+
+      def find_message(recipient, subject)
+        client.inbox.emails(to: recipient, subject: subject).last
+      end
+
+      private
+
+      attr_accessor :client
+    end
+  end
+end

data/lib/howitzer/gmail_api.rb

@@ -0,0 +1,7 @@
+module Howitzer
+  # This module holds simple implementation of gmail api client
+  module GmailApi
+  end
+end
+
+require 'howitzer/gmail_api/client'

data/lib/howitzer/log.rb

@@ -80,13 +80,13 @@ module Howitzer
       Logger['ruby_log'].trace = true
     end
 
-    #:nocov:
+    # :nocov:
     def log_without_formatting
       self.base_formatter = blank_formatter
       yield
       self.base_formatter = default_formatter
     end
-    #:nocov:
+    # :nocov:
 
     def console_log
       StdoutOutputter.new(:console).tap { |o| o.only_at(INFO, DEBUG, WARN) }
@@ -96,13 +96,13 @@ module Howitzer
       StderrOutputter.new(:error, 'level' => ERROR)
     end
 
-    #:nocov:
+    # :nocov:
     def blank_formatter
       PatternFormatter.new(pattern: '%m')
     end
-    #:nocov:
+    # :nocov:
 
-    #:nocov:
+    # :nocov:
     def default_formatter
       params = if Howitzer.hide_datetime_from_log
                  { pattern: '[%l] %m' }
@@ -111,7 +111,7 @@ module Howitzer
                end
       PatternFormatter.new(params)
     end
-    #:nocov:
+    # :nocov:
 
     def base_formatter=(formatter)
       @logger.outputters.each { |outputter| outputter.formatter = formatter }