ruby_raider 1.1.4 → 3.0.0

data/lib/generators/template_renderer/partial_resolver.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require_relative 'template_error'
+
+module TemplateRenderer
+  # Resolves partial template paths with context-aware searching
+  #
+  # Resolution strategy:
+  # 1. Try relative to calling template: ./partials/{name}.tt
+  # 2. Fall back to all Generator.source_paths searching for partials/{name}.tt
+  class PartialResolver
+    PARTIAL_EXTENSION = '.tt'
+    PARTIALS_DIR = 'partials'
+
+    def initialize(generator_class)
+      @generator_class = generator_class
+    end
+
+    # Resolve a partial name to its absolute file path
+    #
+    # @param name [String] The partial name (without .tt extension)
+    # @param binding [Binding] The binding context from the caller
+    # @return [String] Absolute path to the partial file
+    # @raise [TemplateNotFoundError] If partial cannot be found
+    def resolve(name, binding)
+      caller_file = caller_file_from_binding(binding)
+      partial_filename = "#{name}#{PARTIAL_EXTENSION}"
+
+      # Try relative to caller first
+      if caller_file
+        relative_path = File.join(File.dirname(caller_file), PARTIALS_DIR, partial_filename)
+        return File.expand_path(relative_path) if File.exist?(relative_path)
+      end
+
+      # Fall back to searching all source paths
+      searched = search_source_paths(partial_filename)
+      return searched[:found] if searched[:found]
+
+      # Not found - raise with helpful error
+      raise TemplateNotFoundError.new(
+        "Partial '#{name}' not found",
+        partial_name: name,
+        searched_paths: search_paths(name, binding)
+      )
+    end
+
+    # Get all paths that were searched (for error messages)
+    def search_paths(name, binding)
+      paths = []
+      partial_filename = "#{name}#{PARTIAL_EXTENSION}"
+
+      # Add relative path if available
+      caller_file = caller_file_from_binding(binding)
+      if caller_file
+        relative_path = File.join(File.dirname(caller_file), PARTIALS_DIR, partial_filename)
+        paths << relative_path
+      end
+
+      # Add all source path possibilities (including subdirectories)
+      source_paths.each do |source_path|
+        paths << File.join(source_path, PARTIALS_DIR, partial_filename)
+
+        # Also include subdirectories (e.g., templates/common/partials/, templates/helpers/partials/)
+        Dir.glob(File.join(source_path, '*', PARTIALS_DIR)).each do |subdir|
+          paths << File.join(subdir, partial_filename)
+        end
+      end
+
+      paths
+    end
+
+    private
+
+    # Extract the calling template file from binding context
+    def caller_file_from_binding(binding)
+      binding.eval('__FILE__')
+    rescue StandardError
+      nil
+    end
+
+    # Search all Generator.source_paths for the partial.
+    # Uses a cached directory index to avoid repeated Dir.glob calls.
+    def search_source_paths(partial_filename)
+      # Check the pre-built index first (fast path)
+      partial_dirs.each do |dir|
+        full_path = File.join(dir, partial_filename)
+        return { found: File.expand_path(full_path), searched: [full_path] } if File.exist?(full_path)
+      end
+
+      { found: nil, searched: [] }
+    end
+
+    # Get all configured source paths from the generator class
+    def source_paths
+      @source_paths ||= @generator_class.source_paths || []
+    end
+
+    # Pre-built index of all directories that could contain partials.
+    # Scanned once via Dir.glob, then reused for every partial lookup.
+    def partial_dirs
+      @partial_dirs ||= source_paths.flat_map do |source_path|
+        dirs = []
+        direct = File.join(source_path, PARTIALS_DIR)
+        dirs << direct if File.directory?(direct)
+        Dir.glob(File.join(source_path, '*', PARTIALS_DIR)).each { |d| dirs << d }
+        dirs
+      end
+    end
+  end
+end

data/lib/generators/template_renderer/template_error.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module TemplateRenderer
+  # Base error class for all template-related errors
+  class TemplateError < StandardError
+    attr_reader :partial_name, :searched_paths, :original_error
+
+    def initialize(message, partial_name: nil, searched_paths: nil, original_error: nil)
+      @partial_name = partial_name
+      @searched_paths = searched_paths || []
+      @original_error = original_error
+      super(message)
+    end
+  end
+
+  # Raised when a partial template cannot be found
+  class TemplateNotFoundError < TemplateError
+    def to_s
+      message_parts = ["Partial '#{@partial_name}' not found."]
+
+      if @searched_paths.any?
+        message_parts << "\nSearched in:"
+        message_parts.concat(@searched_paths.map { |path| "  - #{path}" })
+      end
+
+      message_parts.join("\n")
+    end
+  end
+
+  # Raised when a template has syntax errors or rendering fails
+  class TemplateRenderError < TemplateError
+    def initialize(message, partial_name:, original_error: nil)
+      super(message, partial_name:, original_error:)
+    end
+
+    def to_s
+      message_parts = ["Error rendering partial '#{@partial_name}': #{super()}"]
+
+      if @original_error
+        message_parts << "\nOriginal error: #{@original_error.class}: #{@original_error.message}"
+        if @original_error.backtrace
+          message_parts << "\nBacktrace:"
+          message_parts.concat(@original_error.backtrace.first(5).map { |line| "  #{line}" })
+        end
+      end
+
+      message_parts.join("\n")
+    end
+  end
+end

data/lib/generators/template_renderer.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require_relative 'template_renderer/partial_cache'
+require_relative 'template_renderer/partial_resolver'
+require_relative 'template_renderer/template_error'
+
+# Template rendering module for Ruby Raider generators
+#
+# Provides a clean partial() helper for including ERB templates with:
+# - Automatic caching of compiled ERB objects (10x performance improvement)
+# - Context-aware path resolution (relative to caller, then all source_paths)
+# - Helpful error messages when partials are missing
+# - Flexible whitespace handling (trim_mode, strip options)
+#
+# Usage in templates:
+#   <%= partial('screenshot') %>                    # Default: trim_mode: '-', no strip
+#   <%= partial('screenshot', strip: true) %>       # With .strip!
+#   <%= partial('screenshot', trim: false) %>       # No trim_mode
+#   <%= partial('driver_config', trim_mode: '<>') %> # Custom trim_mode
+#
+# The partial() method automatically has access to all generator instance
+# variables and methods (cucumber?, mobile?, selenium?, etc.) through binding.
+module TemplateRenderer
+  # Render a partial template with caching and smart path resolution
+  #
+  # @param name [String] Partial name without .tt extension (e.g., 'screenshot')
+  # @param options [Hash] Rendering options
+  # @option options [String, nil] :trim_mode ERB trim mode (default: '-')
+  #   - '-'  : Trim lines ending with -%>
+  #   - '<>' : Omit newlines for lines starting with <% and ending with %>
+  #   - nil  : No trimming
+  # @option options [Boolean] :strip Whether to call .strip! on result (default: false)
+  # @option options [Boolean] :trim Whether to use trim_mode (default: true)
+  #
+  # @return [String] Rendered template content
+  #
+  # @example Basic usage
+  #   <%= partial('screenshot') %>
+  #
+  # @example With strip
+  #   <%= partial('screenshot', strip: true) %>
+  #
+  # @example No trim mode
+  #   <%= partial('quit_driver', trim: false) %>
+  #
+  # @raise [TemplateNotFoundError] If partial cannot be found
+  # @raise [TemplateRenderError] If rendering fails
+  def partial(name, options = {})
+    # Default options
+    options = {
+      trim_mode: '-',
+      strip: false,
+      trim: true
+    }.merge(options)
+
+    # Handle trim: false by setting trim_mode to nil
+    options[:trim_mode] = nil if options[:trim] == false
+
+    # Render the partial through the cache
+    result = self.class.template_renderer.render_partial(name, binding, options)
+
+    # Apply strip if requested
+    options[:strip] ? result.strip : result
+  end
+
+  # Module hook for including in classes
+  def self.included(base)
+    base.extend(ClassMethods)
+  end
+
+  # Class methods added to the including class
+  module ClassMethods
+    # Get the shared template renderer instance
+    # Each generator class gets its own cache instance
+    def template_renderer
+      @template_renderer ||= PartialCache.new(self)
+    end
+
+    # Clear the template cache (useful for testing)
+    # Clears cache for this class and all subclasses
+    def clear_template_cache
+      @template_renderer&.clear
+      @template_renderer = nil
+      subclasses.each do |subclass|
+        subclass.clear_template_cache if subclass.respond_to?(:clear_template_cache)
+      end
+    end
+
+    # Get cache statistics (useful for debugging)
+    # Aggregates stats across this class and all subclasses
+    def template_cache_stats
+      own = @template_renderer&.stats || { size: 0, entries: [], memory_estimate: 0 }
+      subclasses.each do |subclass|
+        next unless subclass.respond_to?(:template_cache_stats)
+
+        sub_stats = subclass.instance_variable_get(:@template_renderer)&.stats
+        next unless sub_stats
+
+        own[:size] += sub_stats[:size]
+        own[:entries].concat(sub_stats[:entries])
+        own[:memory_estimate] += sub_stats[:memory_estimate]
+      end
+      own
+    end
+  end
+end

data/lib/generators/templates/common/config.tt

@@ -1,5 +1,5 @@
 <% if mobile? -%>
-<%= ERB.new(File.read(File.expand_path('./partials/mobile_config.tt', __dir__))).result(binding) %>
+<%= partial('mobile_config', trim: false) %>
 <% else -%>
-<%= ERB.new(File.read(File.expand_path('./partials/web_config.tt', __dir__)), trim_mode: '-').result(binding) %>
+<%= partial('web_config') %>
 <% end -%>

data/lib/generators/templates/common/gemfile.tt

@@ -1,38 +1,61 @@
 source 'https://rubygems.org'
 
+ruby '~> <%= ruby_version %>.0'
+
 gem 'activesupport'
 <% if mobile? %>
 gem 'appium_lib'
 gem 'appium_console'
 <% end %>
+<%- if allure_reporter? -%>
 <%- if cucumber? -%>
-gem 'allure-cucumber', '2.23.0'
+gem 'allure-cucumber', '2.28.0'
+<%- elsif minitest? -%>
+gem 'allure-ruby-commons', '2.28.0'
 <%- else -%>
-gem 'allure-rspec', '2.23.0'
-gem 'allure-ruby-commons', '2.23.0'
+gem 'allure-rspec', '2.28.0'
+gem 'allure-ruby-commons', '2.28.0'
+<%- end -%>
+<%- end -%>
+<%- if capybara? -%>
+gem 'capybara'
+gem 'selenium-webdriver'
 <%- end -%>
-<%- if axe? -%>
+<%- if axe_addon? -%>
+<%- if minitest? -%>
+gem 'axe-core-minitest'
+<%- else -%>
 gem 'axe-core-rspec'
+<%- end -%>
 gem 'axe-core-selenium'
 <%- end -%>
-<%- if visual? -%>
-gem 'eyes_selenium', '~> 4.6', '>= 4.6.1'
-gem 'eyes_universal', '~> 3.3', '>= 3.3.1'
+<%- if visual_addon? -%>
+gem 'chunky_png'
 <%- end -%>
-<%- unless visual? -%>
 gem 'parallel_split_test'
 gem 'parallel_tests'
-<%- end -%>
 gem 'rake'
 gem 'reek'
+<%- if rspec? -%>
+gem 'rspec-retry'
+<%- end -%>
+<%- if junit_reporter? && rspec? -%>
+gem 'rspec_junit_formatter'
+<%- end -%>
 gem '<%= framework %>'
 <%- if cucumber? -%>
 gem 'rspec'
 <%- end -%>
+<%- if minitest? -%>
+gem 'minitest-reporters'
+<%- end -%>
 gem 'rubocop'
 <%- if rspec? -%>
 gem 'rubocop-rspec'
 <%- end -%>
+<%- if minitest? -%>
+gem 'rubocop-minitest'
+<%- end -%>
 gem 'ruby_raider', '~> 1.1.0'
 <%- if selenium_based? %>
 gem 'selenium-webdriver'
@@ -40,3 +63,7 @@ gem 'selenium-webdriver'
 <%- if watir? -%>
 gem 'watir'
 <%- end -%>
+<%- if web? -%>
+gem 'debug', '>= 1.0'
+gem 'pry'
+<%- end -%>

data/lib/generators/templates/common/git_ignore.tt

@@ -1 +1,6 @@
-allure-results
+<%- if allure_reporter? -%>
+allure-results
+<%- end -%>
+<%- if rspec? -%>
+spec/examples.txt
+<%- end -%>

data/lib/generators/templates/common/partials/mobile_config.tt

@@ -1 +1,5 @@
-platform: :ios
+platform: :ios
+
+video:
+  enabled: false
+  strategy: auto # auto, appium, or screen

data/lib/generators/templates/common/partials/web_config.tt

@@ -1,11 +1,9 @@
 browser: chrome
-url: 'https://automationteststore.com/'
-
-<%- if selenium_based? -%>
-driver_options:
-  :timeouts:
-    :implicit: 10000 # 10 seconds
-<% end -%>
+url: 'https://raider-test-site.onrender.com/'
+timeout: 10 # seconds — used for implicit waits and max wait time
+viewport:
+  width: 1920
+  height: 1080
 
 browser_arguments:
   chrome:
@@ -15,4 +13,15 @@ browser_arguments:
     - search-engine-choice-country
   firefox:
     - acceptInsecureCerts
-    - no-sandbox
+    - no-sandbox
+
+video:
+  enabled: false
+  strategy: auto # auto, cdp, or screen
+
+debug:
+  enabled: false        # also toggled by DEBUG=true env var
+  console_logs: true    # capture browser console logs on failure
+  action_logging: true  # log driver actions with timestamps
+  network_logging: true # capture HTTP requests on failure (Chrome/Edge only)
+  log_dir: 'debug_logs'

data/lib/generators/templates/common/rakefile.tt

@@ -2,3 +2,39 @@ desc 'Print Ruby Raider version'
 task :raider do
   system 'raider version'
 end
+<%- if rspec? -%>
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+RSpec::Core::RakeTask.new(:smoke) do |t|
+  t.rspec_opts = '--tag smoke'
+end
+RSpec::Core::RakeTask.new(:regression) do |t|
+  t.rspec_opts = '--tag regression'
+end
+
+task default: :spec
+<%- elsif cucumber? -%>
+
+require 'cucumber/rake/task'
+
+Cucumber::Rake::Task.new(:features)
+Cucumber::Rake::Task.new(:smoke) do |t|
+  t.cucumber_opts = '--tags @smoke'
+end
+Cucumber::Rake::Task.new(:regression) do |t|
+  t.cucumber_opts = '--tags @regression'
+end
+
+task default: :features
+<%- elsif minitest? -%>
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.test_files = FileList['test/**/test_*.rb']
+end
+
+task default: :test
+<%- end -%>

data/lib/generators/templates/common/read_me.tt

@@ -4,10 +4,10 @@
 <br />
 <div align="center">
    <a href="https://github.com/RubyRaider/ruby_raider">
-   <img src="https://private-user-images.githubusercontent.com/33221555/391053089-3a1a492f-a70e-45ff-8fd0-5f83cef91f49.svg?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzI4ODUyNTEsIm5iZiI6MTczMjg4NDk1MSwicGF0aCI6Ii8zMzIyMTU1NS8zOTEwNTMwODktM2ExYTQ5MmYtYTcwZS00NWZmLThmZDAtNWY4M2NlZjkxZjQ5LnN2Zz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDExMjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQxMTI5VDEyNTU1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTQ1MDM2ZjAzMmIwMWRmZjdlMjBkMWYxNGFkNTAxYTM0OTEyZjhmNjQ4YmE5NWMwOWE4MTY1Njc5ZjllNTMxYjQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.EnwLs1vZClwzNl1el0SRflyUJrwzno_LhBnnAXMHz7E" alt="Logo" style="width:200px;">
+   <img src="https://www.ruby-raider.com/assets/icon-DYY74ofR.png" alt="Logo" style="width:200px;">
    </a>
    <p align="center">
-      <a href="https://github.com/RubyRaider/ruby_raider#getting-started"><strong>Explore the docs »</strong></a>
+      <a href="https://github.com/RubyRaider/ruby_raider#getting-started"><strong>Explore the docs</strong></a>
       <br />
       <br />
       <a href="https://rubygems.org/gems/ruby_raider">Rubygems</a>
@@ -21,119 +21,71 @@
 
 ## What is Ruby Raider?
 
-Ruby Raider is a generator and scaffolding gem to make UI test automation easier
+Ruby Raider is a generator and scaffolding gem to make UI test automation easier.
 
-### At the moment Ruby Raider supports generating the following frameworks:
+### Supported Frameworks
 
-| Web Testing Framework | Visual Testing Framework          | Mobile Testing Framework           | Accessibility Testing Framework |
-|-----------------------|-----------------------------------|------------------------------------|---------------------------------|
-| Cucumber and Selenium | Cucumber, Applitools and Selenium | Cucumber and Appium for IOS        | Cucumber and Axe for web        |
-| Rspec and Selenium    | Rspec, Applitools and Selenium    | Rspec and Appium for IOS           | Rspec and Axe for web           |
-| Cucumber and Watir    |                                   | Cucumber and Appium for Android    |                                 |
-| Rspec and Watir       |                                   | Rspec and Appium for Android       |                                 |
-|                       |                                   | Cucumber and Appium Cross-platform |                                 |
-|                       |                                   | Rspec and Appium Cross-platform    |                                 |
+| Web Testing Framework | Mobile Testing Framework           |
+|-----------------------|------------------------------------|
+| Cucumber and Selenium | Cucumber and Appium for iOS        |
+| RSpec and Selenium    | RSpec and Appium for iOS           |
+| Cucumber and Watir    | Cucumber and Appium for Android    |
+| RSpec and Watir       | RSpec and Appium for Android       |
+| Cucumber and Capybara | Cucumber and Appium Cross-platform |
+| RSpec and Capybara    | RSpec and Appium Cross-platform    |
+| Minitest and Selenium | Minitest and Appium for iOS        |
+| Minitest and Watir    | Minitest and Appium for Android    |
+| Minitest and Capybara | Minitest and Appium Cross-platform |
 
-***In order to run the Appium tests, download the example [app](https://github.com/saucelabs/my-demo-app-rn).***
-***Remember to use the full path of the app that you download in the capabilities file and start the server using one of
-the commands below:***
+**Optional add-ons for web projects:**
+- **Accessibility testing (axe)**: `--accessibility` flag
+- **Visual regression testing (chunky_png)**: `--visual` flag
+- **Performance auditing (Lighthouse)**: `--performance` flag
 
-```ruby
-raider u start_appium
-appium --base /wd/hub  
-```
-
-***In order to run the visual tests with applitools, you need to create an account and get your api key, you can read
-more [here](https://applitools.com/docs/topics/overview/obtain-api-key.html#:~:text=If%20you%20already%20have%20an,Your%20key%20will%20be%20displayed.)
-.***
+***The web tests run against the [Raider Test Store](https://raider-test-site.onrender.com/).***
 
-***To use the open ai integration you need to set up the OPENAI_ACCESS_TOKEN environment variable and
-you can also set the optional OPENAI_ORGANIZATION_ID if you have an organization***
+***To run Appium tests, download the example [app](https://github.com/RaiderHQ/raider_test_app) and start the server:***
 
-This works in all the platforms (Tested on Mac OS, Linux and Windows).
-
-## Getting started
+```bash
+raider u start_appium
+```
 
-To get the project up and running.
+This works on all platforms (Mac OS, Linux and Windows).
 
-**Just do:**
+## Getting Started
 
-```ruby
+```bash
 gem install ruby_raider
-```
-
-**Then do:**
-
-```ruby
 raider new [name_of_project]
 ```
 
-Then a TUI/CLI will appear where the configuration of which frameworks you want to be generated/scaffolded can be
-selected.
+Or with parameters:
 
-Select the ones you will like to work with.
-
-If you already know which frameworks you want to use, you can do:
-
-```ruby
+```bash
 raider new [name_of_project] -p framework:[framework] automation:[automation_type]
 ```
 
-An example of the command above would be:
+### Commands
 
-```ruby
-raider new test_project -p framework:rspec automation:selenium
 ```
-
-### Ruby raider provides the following list of basic commands
-
-###### Anything between square brackets([...]) is where your imput goes
-
-```ruby
-Commands :
-raider generate # Provides access to all the scaffolding commands
-raider help [COMMAND] # Describe available commands or one specific command
-raider new [PROJECT_NAME] # Creates a new framework based on settings picked
-raider utility # Provides access to all the utility commands 
-raider version # It shows the version of Ruby Raider you are currently using
+raider generate         # Scaffolding commands
+raider utility          # Utility commands
+raider plugin_manager   # Plugin management
+raider new [NAME]       # Create new project
+raider version          # Show version
+raider help [COMMAND]   # Describe commands
 ```
 
-All the basic commands have their corresponding shortcut:
-
-* g for generate
-* n for new
-* u for utility
-* v for version
-
-### Scaffolding Commands
-
-Ruby Raider also supports scaffolding:
-
-* To create a new page object you do: ```raider g page [PAGE_NAME]```
-* To create a new spec you do: ```raider g spec [SPEC_NAME]```
-* To create a new feature you do: ```raider g feature [FEATURE_NAME]```
-* To create a new steps definition you do: ```raider g steps [STEPS_NAME]```
-* To create both a page/spec or a page/feature/steps you do: ```raider g scaffold [SCAFFOLD_NAME]```
+Shortcuts: `g` (generate), `n` (new), `u` (utility), `v` (version), `pm` (plugin_manager)
 
-It's possible to add the option --path or p if you want to specify where to create your features, pages, helpers and
-specs.
+### Scaffolding
 
-If you want to set the default path for the creation of your features, helpers and specs:
-
-```ruby
-raider u path [PATH_NAME] - -feature or f
-raider u path [PATH_NAME] - -spec or s
-raider u path [PATH_NAME] - -helper or h
 ```
-
-If you don't specify an option, path will assume you want to change the default path for pages.
-
-### Appium Server Command
-
-To initialise Appium server run this command:
-
-```ruby
-raider u start_appium
+raider g page [NAME]      # Create page object
+raider g spec [NAME]      # Create RSpec test
+raider g feature [NAME]   # Create Cucumber feature
+raider g steps [NAME]     # Create step definitions
+raider g scaffold [NAME]  # Create page + test + steps
 ```
 
 ### Sponsors

data/lib/generators/templates/common/rspec.tt

@@ -0,0 +1,3 @@
+-I .
+--require helpers/spec_helper
+--format documentation

data/lib/generators/templates/common/ruby_version.tt

@@ -0,0 +1 @@
+<%= ruby_version %>

data/lib/generators/templates/helpers/allure_helper.tt

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-<%=- ERB.new(File.read(File.expand_path('./partials/allure_requirements.tt', __dir__))).result(binding).strip! -%>
-<%- allure = ERB.new(File.read(File.expand_path('./partials/allure_imports.tt', __dir__))).result(binding).strip! -%>
+<%=- partial('allure_requirements', trim: false, strip: true) -%>
+<%- allure = partial('allure_imports', trim: false, strip: true) -%>
 
 
 module AllureHelper
@@ -21,6 +21,17 @@ module AllureHelper
         test_case: true
        )
      end
+
+    def add_video(name, file)
+      return unless file && File.exist?(file)
+
+      Allure.add_attachment(
+        name: "Recording: #{name}",
+        source: File.new(file),
+        type: 'video/mp4',
+        test_case: true
+      )
+    end
   <%- if rspec? -%>
 
     def formatter