awetestlib 0.0.2-x86-mingw32

data/.gitignore

@@ -0,0 +1,70 @@
+sinatra.pid
+shamisen-*.gem
+vendor/cache/*
+
+# gVim tmp files
+*~
+# rcov generated
+coverage
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# bundler
+.bundle
+Gemfile.lock
+
+# jeweler generated
+pkg
+
+# for windows
+Thumb.db
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore:
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+.DS_Store
+tmp/*
+.rvmrc
+
+# For TextMate
+#*.tmproj
+#tmtags
+
+# For emacs:
+#*~
+#\#*
+#.\#*
+
+# For vim:
+*.sw[onp]
+
+# For redcar:
+#.redcar
+
+# For rubinius:
+#*.rbc
+
+config/win2008.txt
+
+__MACOSX/
+short_passing_test/
+dump.rdb
+.idea
+config/settings.yml
+PROJECT_NAME
+*.log

data/awetestlib.gemspec

@@ -0,0 +1,57 @@
+# -*- encoding: utf-8 -*-
+puts "#{$0}"
+require "lib/version"
+
+#hack for debugging
+`wellsproxy`
+#end hack
+
+Gem::Specification.new do |s|
+
+  s.name = "awetestlib"
+  s.version = Awetestlib::VERSION
+  s.date = Awetestlib::VERSION_DATE
+  s.platform = Gem::Platform::RUBY
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Anthony Woo", "Patrick Neve"]
+  s.email = %q{patrick@3qilabs.com}
+  s.summary = %q{Awetest DSL for automated testing of browser-based applications.}
+  s.homepage = %q{http://3qilabs.com}
+  s.description = %q{Awetest DSL for automated testing of browser-based applications.}
+
+  # possible dependencies (from shamisen gemfile)
+  #s.add_dependency('i18n')
+
+  # windows specific
+  #s.add_dependency('watir', '1.8.1')
+  #s.add_dependency('commonwatir', '1.8.1')
+  #s.add_dependency('firewatir', '1.8.1')
+  #s.add_dependency('watirloo')
+  #s.add_dependency('win32-process')
+  #s.add_dependency('win32screenshot')
+
+  # all platforms?
+  begin
+    #s.add_dependency('ffi', '= 1.0.9')
+    s.add_dependency('activesupport', '~> 3.0.0')
+    s.add_dependency('watir-webdriver')
+    s.add_dependency('andand')
+    s.add_dependency('spreadsheet', '0.6.8')
+    s.add_dependency('google-spreadsheet-ruby', '0.1.6')
+    s.add_dependency('roo', '1.10.1')
+    #s.add_dependency('selenium-client')   # for running selenium scripts
+    s.add_dependency('selenium-webdriver')
+  rescue
+    puts "#{$!}"
+  end
+
+  s.require_paths = ["lib","ext"]
+  s.files = `git ls-files`.split("\n")
+  s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+
+  #This line tells rubygems to look for an extension to install
+  s.extensions << 'ext/mkrf_conf.rb'
+
+end
+

data/awetestlib.windows.gemspec

@@ -0,0 +1,41 @@
+# -*- encoding: utf-8 -*-
+require "lib/version"
+
+Gem::Specification.new do |s|
+
+  s.name = %q{awetestlib}
+  s.version = Awetestlib::VERSION
+  s.date = Awetestlib::VERSION_DATE
+  s.platform = Gem::Platform::CURRENT
+
+  #s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Anthony Woo", "Patrick Neve"]
+  s.email = %q{patrick@3qilabs.com}
+  s.summary = %q{Awetest DSL for automated testing of browser-based applications.}
+  s.homepage = %q{http://3qilabs.com}
+  s.description = %q{Awetest DSL for automated testing of browser-based applications.}
+
+  s.add_dependency('watir-webdriver')
+  s.add_dependency('watir', '1.8.1')
+  s.add_dependency('commonwatir', '1.8.1')
+  s.add_dependency('firewatir', '1.8.1')
+  s.add_dependency('activesupport', '~> 3.0.0')
+  s.add_dependency('i18n')
+  s.add_dependency('andand')
+  s.add_dependency('watirloo')
+  s.add_dependency('win32-process')
+  s.add_dependency('win32screenshot')
+  s.add_dependency('spreadsheet', '0.6.8')
+  s.add_dependency('google-spreadsheet-ruby', '0.1.6')
+  s.add_dependency('roo', '1.10.1')
+  s.add_dependency('selenium-webdriver')
+  s.add_dependency('pry')
+  s.add_dependency('rdoc', '~> 3.11')
+
+
+  s.require_paths = ["lib"]
+  s.files = `git ls-files`.split("\n")
+  s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+
+end
+

data/awetestlib_notes.txt

@@ -0,0 +1,4 @@
+= does not include patch for IE 7.0 or earlier modal dialog window title ('Web Page Dialog' vs. 'Webpage Dialog')
+  See 'http://github.com/radamanthus/watir'
+= user must download chromedriver.exe and put somewhere in PATH  ( ruby\bin works  )
+

data/awetestlib_osx.gemspec

@@ -0,0 +1,43 @@
+# -*- encoding: utf-8 -*-
+require "lib/version"
+
+Gem::Specification.new do |s|
+
+  s.name = %q{awetestlib}
+  s.version = Awetestlib::VERSION
+  s.date = Awetestlib::VERSION_DATE
+  s.platform = Gem::Platform::RUBY
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Anthony Woo", "Patrick Neve"]
+  s.email = %q{patrick@3qilabs.com}
+  s.summary = %q{Awetest DSL for automated testing of browser-based applications.}
+  s.homepage = %q{http://3qilabs.com}
+  s.description = %q{Awetest DSL for automated testing of browser-based applications.}
+
+  s.add_dependency('watir-webdriver')
+  #s.add_dependency('watir', '1.8.1')
+  #s.add_dependency('commonwatir', '1.8.1')
+  #s.add_dependency('firewatir', '1.8.1')
+  s.add_dependency('activesupport', '~> 3.0.0')
+  s.add_dependency('andand')
+  #s.add_dependency('watirloo')
+  #s.add_dependency('win32-process')
+  #s.add_dependency('win32screenshot')
+  s.add_dependency('spreadsheet', '0.6.8')
+  s.add_dependency('google-spreadsheet-ruby', '0.1.6')
+  s.add_dependency('roo', '1.10.1')
+  s.add_dependency('multipart-post', '1.1.4')
+  s.add_dependency('selenium-webdriver')
+  s.add_dependency('nokogiri')
+
+
+  s.require_paths = ["lib"]   #,"ext"]
+  s.files = `git ls-files`.split("\n")
+  s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+
+  #This line tells rubygems to look for an extension to install
+  #s.extensions = ["ext\\mkrf_conf.rb"]
+
+end
+

data/bin/awetestlib

@@ -0,0 +1,67 @@
+$: << "./lib"
+require 'optparse'
+require 'awetestlib'
+
+options = { }
+OptionParser.new do |opts|
+  opts.banner = "Usage: awetestlib <script_file> [options]"
+
+  opts.on("-m RUN_MODE", "--run_mode RUN_MODE", "Specify the run mode: local, local_zip, remote_zip") do |run_mode|
+    options[:run_mode] = run_mode
+  end
+  opts.on("-r ROOT_PATH", "--root_path ROOT_PATH", "Specify the root path") do |root_path|
+    options[:root_path] = root_path
+  end
+  opts.on("-l LIBRARY", "--library LIBRARY", "Specify a library to be loaded") do |library|
+    options[:library] = library.to_s
+  end
+  opts.on("-x EXCEL_FILE", "--excel EXCEL_FILE", "Specify an excel file containing variables to be loaded") do |xls_path|
+    options[:xls_path] = xls_path
+  end
+  opts.on("-b BROWSER", "--browser BROWSER", "Specify a browser (IE, FF, S, C)") do |browser|
+    options[:browser] = browser
+  end
+  opts.on("-v VERSION", "--version VERSION", "Specify a browser version") do |v|
+    options[:version] = v
+  end
+  opts.on("-e", "--environment_url ENVIRONMENT_URL", "Specify the environment URL") do |environment_url|
+    options[:environment_url] = environment_url
+  end
+  opts.on("-f", "--environment_node_name ENVIRONMENT_NODENAME", "Specify the environment node name") do |node_name|
+    options[:environment_nodename] = node_name
+  end
+  opts.on("-n", "--environment_name ENVIRONMENT_NAME", "Specify the environment name") do |environment_name|
+    options[:environment_name] = environment_name
+  end
+  opts.on("-u SELENIUM_REMOTE_URL", "--selenium_remote_url SELENIUM_REMOTE_URL", "Specify the device's remote url and port") do |remote_url|
+    options[:remote_url] = remote_url
+  end
+  opts.on("-s SCREENCAP_PATH", "--screencap-path SCREENCAP_PATH", "Specify the path where screenshots will be saved") do |screencap_path|
+    options[:screencap_path] = screencap_path
+  end
+  opts.on("-d", "--debug", "Run debugger on first script failure") do
+    options[:debug_on_fail] = true
+  end
+  # add persistent logging for awetestlib. pmn 05jun2012
+  opts.on("-o", "--output_to_log", "Write to log file") do
+    options[:output_to_log] = true
+  end
+  opts.on("", "--log_path_subdir LOG_PATH_SUBDIR", "Specify log path relative to root_path.") do |log_path_subdir|
+    options[:log_path_subdir] = log_path_subdir
+  end
+  opts.on("", "--report_all_test_refs REPORT_ALL_TEST_REFS", "Include list of all error/test case reference ids actually validated.") do
+    options[:report_all_test_refs] = true
+  end
+
+end.parse!
+
+options[:environment] ||= {}
+options[:environment]["name"] = options[:environment_name]
+options[:environment]["url"] = options[:environment_url]
+options[:environment]["nodename"] = options[:environment_nodename]
+options[:script_type] = 'AwetestLegacy'
+options[:script_file] = ARGV[0]
+
+IS_WIN_2008 = File.exists?("config/win2008.txt")
+
+Awetestlib::Runner.new(options).start

data/create_zoho_account1.rb

@@ -0,0 +1,66 @@
+module CreateZohoAccount1
+
+  def run_test(browser)
+    create_account_scenario_1(browser)
+    create_account_scenario_2(browser)
+  end
+
+  def create_account_scenario_1(browser)
+    create_account(browser)
+    create_blank_new_account(browser)
+    export_accounts(browser)
+    import_accounts(browser)
+    signout(browser)
+  end
+
+  def create_account_scenario_2(browser)
+    create_blank_new_account(browser)
+    reports(browser)
+    clone_account(browser)
+    pagination(browser)
+    verify_accounts(browser)
+    search_accounts(browser)
+    signout(browser)
+  end
+
+  def create_account(browser)
+    mark_testlevel('Create New Account', 1)
+    sleep_for(3)
+    click_text(browser, 'New Account')
+    wait_until_ready(browser, :name, /Account Name/)
+    set_textfield_by_name(browser, /Account Name/, "Test Account #1")
+    set_textfield_by_name(browser, /Phone/, "415-333-2311")
+
+    test_account_lookup(browser) #In Project Util
+    browser = attach_browser_by_url(browser, /ShowHomePage/)
+    select_option_by_name_and_option_text(browser, /Account Type/, "Analyst")
+    select_option_by_name_and_option_text(browser, /Industry/, "ASP")
+    set_textfield_by_name(browser, /Billing Street/, "201 Main St")
+    set_textfield_by_name(browser, /Billing City/, "San Francisco")
+    set_textfield_by_name(browser, /Billing State/, "CA")
+    set_textfield_by_name(browser, /Billing Code/, "94102")
+    set_textfield_by_name(browser, /Billing Country/, "USA")
+    #browser.cell(:text, 'Billing to Shipping').click
+    click(browser, :cell, :text, 'Billing to Shipping')
+    click_button_by_value(browser, 'Save')
+
+    wait_until_by_text(browser, 'Test Account #1')
+    validate_text(browser, "Test Account #1")
+    validate_text(browser, "random")
+  end
+
+  def test_account_lookup(browser)
+    mark_testlevel('Account Lookup', 1)
+    click(browser, :image, :title, 'Account Name Lookup')
+    sleep_for(5)
+    popup = attach_browser_by_url(browser, /Parent Account/)
+    set_textfield_by_name(popup, 'fldValue', 'test account #00')
+    click_button_by_value(popup, 'Go')
+    click(popup, :link, :text, 'Test Account #007')
+    # TODO: This next line is currently required for Firefox and Chrome to return to original browser window      browser = attach_browser_by_url(browser, /ShowHomePage/)
+    browser = attach_browser_by_url(browser, /ShowHomePage/)
+    validate_textfield_value_by_name(browser, /Parent Account/, 'Test Account #007')
+  end
+
+
+end

data/create_zoho_account2.rb

@@ -0,0 +1,70 @@
+module CreateZohoAccount2
+
+  def run_test(browser)
+    create_account_scenario_1(browser)
+    create_account_scenario_2(browser)
+  end
+
+  def create_account_scenario_1(browser)
+    mark_testlevel("#{__method__.to_s.titleize}", 1)
+    create_account(browser)
+    create_blank_new_account(browser)
+    export_accounts(browser)
+    import_accounts(browser)
+    signout(browser)
+  end
+
+  def create_account_scenario_2(browser)
+    mark_testlevel("#{__method__.to_s.titleize}", 1)
+    create_blank_new_account(browser)
+    reports(browser)
+    clone_account(browser)
+    pagination(browser)
+    verify_accounts(browser)
+    search_accounts(browser)
+    signout(browser)
+  end
+
+  def create_account(browser)
+    mark_testlevel("#{__method__.to_s.titleize}", 1)
+    sleep_for(3)
+    click_text(browser, 'New Account')
+    wait_until_ready(browser, :name, /Account Name/)
+    set_textfield_by_name(browser, /Account Name/, @var['account_name'], "*** cza007 ***")
+    set_textfield_by_name(browser, /Phone/, @var['account_phone'], "*** cza007 ***")
+
+    test_account_lookup(browser)
+    browser = attach_browser_by_url(browser, /ShowHomePage/)
+
+    select_option_by_name_and_option_text(browser, /Account Type/, @var['account_type'], "*** cza003a ***")
+    select_option_by_name_and_option_text(browser, /Industry/, @var['account_industry'], "*** cza003b ***")
+    set_textfield_by_name(browser, /Billing Street/, @var['account_billing_street'], "*** cza003c ***")
+    set_textfield_by_name(browser, /Billing City/, @var['account_billing_city'], "*** cza003d ***")
+    set_textfield_by_name(browser, /Billing State/, @var['account_billing_state'], "*** cza003e ***")
+    set_textfield_by_name(browser, /Billing Code/, @var['account_billing_zipcode'], "*** cza003f ***")
+    set_textfield_by_name(browser, /Billing Country/, @var['account_country'], "*** cza003g ***")
+
+    #browser.cell(:text, 'Billing to Shipping').click
+    click(browser, :cell, :text, 'Billing to Shipping', "*** cza004 ***")
+    click_button_by_value(browser, 'Save')
+
+    wait_until_by_text(browser, @var['account_name'])
+    validate_text(browser, @var['account_name'], "*** cza005 ***")
+    validate_text(browser, "random", "*** cza006 ***")
+  end
+
+  def test_account_lookup(browser)
+    mark_testlevel("#{__method__.to_s.titleize}", 1)
+    click(browser, :image, :title, 'Account Name Lookup')
+    #sleep_for(5)
+    popup = attach_browser_by_url(browser, /Parent Account/, "*** cza001 ***")
+    if popup
+      set_textfield_by_name(popup, 'fldValue', @var['parent_account_pattern'])
+      click_button_by_value(popup, 'Go')
+      click(popup, :link, :text, @var['parent_account'])
+      # TODO: This next line is currently required for Firefox and Chrome to return to original browser window      browser = attach_browser_by_url(browser, /ShowHomePage/)
+      validate_textfield_value_by_name(browser, /Parent Account/, @var['parent_account'], "*** cza002 ***")
+    end
+  end
+
+end

data/demo.rb

@@ -0,0 +1,86 @@
+module Demo
+  def run
+    browser = open_browser
+    login(browser)
+    test_zoho(browser)
+  end
+
+  def test_account_lookup(browser)
+    mark_testlevel('Account Lookup', 1)
+    browser.image(:title, 'Account Name Lookup').click
+    sleep_for(5)
+    popup = attach_browser_by_url(browser, /Parent/)
+    # TODO: This should be transparent:
+    if @browserAbbrev == "FF"
+      popup = browser
+    end
+    set_textfield_by_name(popup, 'fldValue', 'test')
+    click_button_by_value(popup, 'Go')
+    popup.link(:text, /Test Account/).click
+    #browser = attach_browser_by_url(browser, /ShowHomePage/)
+    #validate_textfield_value_by_name(browser, /Parent Account/, 'Test Account #007')
+  end
+
+  def login(browser)
+    mark_testlevel('Zoho Login', 2)
+    user     = "joeklienwatir@gmail.com" #@zohologin.cell(2,2)
+    password = "watir001"                #@zohologin.cell(2,3)
+    go_to_url(browser, "https://accounts.zoho.com/login?serviceurl=https://www.zoho.com/&hide_signup=true&css=https://www.zoho.com/css/login.css")
+    #browser.goto("https://accounts.zoho.com/login?serviceurl=https://www.zoho.com/&hide_signup=true&css=https://www.zoho.com/css/login.css")
+    set_textfield_by_name(browser, 'lid', user)
+    set_textfield_by_name(browser, 'pwd', password)
+    click_button_by_value(browser, 'Sign In')
+    go_to_url(browser, url = 'https://crm.zoho.com/crm/ShowHomePage.do')
+    validate_text(browser, 'Welcome joeklienwatir at Software')
+    #click_text(browser, 'Old Version')
+
+  end
+
+  def navigate_to_crm(browser)
+    mark_testlevel('Navigate to CRM', 1)
+    click_text(browser, 'CRM')
+  end
+
+  def test_zoho(browser)
+    #get_variables("#{@myRoot}/zoho_variables.xls")
+    navigate_to_crm(browser) #In Project Util
+    create_account(browser)
+    #create_blank_new_account(browser)
+    #export_accounts(browser)
+    #import_accounts(browser)
+    #signout(browser)
+  end
+
+  def create_account(browser)
+    mark_testlevel('Create New Account', 3)
+    sleep_for(3)
+    click_link(browser, 'Accounts')
+    sleep_for(3)
+    click_button_by_value(browser, 'New Account')
+    sleep_for(5)
+    # Watir::Waiter::wait_until { browser.text_field(:name, /Account Name/).exist? }
+                                 # Watir::Waiter::wait_until { browser.text_field(:name, /Account Name/).visible? }
+    set_textfield_by_name(browser, /Account Name/, "Test Account #1")
+    set_textfield_by_name(browser, /Phone/, "415-333-2311")
+
+    test_account_lookup(browser) #In Project Util
+    browser = attach_browser_by_url(browser, /ShowHomePage/)
+    select_option_by_name_and_option_text(browser, /Account Type/, "Analyst")
+    select_option_by_name_and_option_text(browser, /Industry/, "ASP")
+    set_textfield_by_name(browser, /Billing Street/, "201 Main St")
+    set_textfield_by_name(browser, /Billing City/, "San Francisco")
+    set_textfield_by_name(browser, /Billing State/, "CA")
+    set_textfield_by_name(browser, /Billing Code/, "94102")
+    set_textfield_by_name(browser, /Billing Country/, "USA")
+                                 #browser.cell(:text, 'Billing to Shipping').click
+    click_button_by_id(browser, 'copyAddress')
+    sleep_for(5)
+    click_button_by_value(browser, 'Save')
+
+    sleep_for(8)
+                                 #wait_until_by_text(browser, 'Test Account #1')
+    validate_text(browser, "Test Account #1")
+    validate_text(browser, "random")
+  end
+
+end

data/ext/mkrf_conf.rb

@@ -0,0 +1,27 @@
+require 'rubygems/dependency_installer.rb'
+using_windows = !!((RUBY_PLATFORM =~ /(win|w)(32|64)$/) || (RUBY_PLATFORM=~ /mswin|mingw/))
+#using_jruby = defined?(JRUBY_VERSION)
+using_osx = RUBY_PLATFORM =~ /darwin/
+installer = Gem::DependencyInstaller.new
+begin
+  puts "#{RUBY_PLATFORM}"
+  if using_windows
+    installer.install "watirloo", ">=0"
+    installer.install "win32-process", ">=0"
+    installer.install "win32-screenshot", ">=0"
+    installer.install "commonwatir", "=1.8.1"
+    installer.install "watir", "=1.8.1"
+    installer.install "firewatir", "=1.8.1"
+  elsif using_osx
+    installer.install "rb_appscript", ">=0"
+    installer.install "safariwatir", ">=0"
+  end
+
+rescue
+  puts "#{$!}"
+  exit(1)
+end
+
+f = File.open(File.join(File.dirname(__FILE__), "Rakefile"), "w")
+f.write("task :default\n")
+f.close

data/google_search1.rb

@@ -0,0 +1,16 @@
+module GoogleSearch1
+
+  def run
+    mark_testlevel("Awetestlib example: Google Search 1", 1)
+    browser = open_browser
+    go_to_url(browser, 'www.google.com')
+    sleep_for(3)
+    click_text(browser, 'News')
+    set_textfield_by_id(browser, 'gbqfq', '3qilabs')
+    #click(browser, :button, :id, 'gbqfb')
+    validate_text(browser, '3qilabs')
+    validate_text(browser, 'Stories')
+    logout(browser)
+  end
+
+end

data/google_search2.rb

@@ -0,0 +1,19 @@
+module GoogleSearch2
+
+  def run
+    mark_testlevel("Awetestlib example: Google Search 2", 9)
+    browser = open_browser
+    go_to_url(browser, 'www.google.com')
+    sleep_for(3)
+    run_test(browser)
+  end
+
+  def run_test(browser)
+    mark_testlevel("Search for 3qilabs in News", 8)
+    click_text(browser, 'News')
+    set_textfield_by_id(browser, 'gbqfq', '3qilabs')
+    validate_text(browser, '3qilabs', '*** gs2 001 ***')
+    validate_text(browser, 'Stories', '*** gs2 002 ***')
+  end
+
+end

data/lib/awetestlib.rb

@@ -0,0 +1,39 @@
+require 'yaml'
+require 'active_support/core_ext/hash'
+
+module Awetestlib
+  ::USING_WINDOWS = !!((RUBY_PLATFORM =~ /(win|w)(32|64)$/) || (RUBY_PLATFORM=~ /mswin|mingw/))
+  ::USING_OSX     = RUBY_PLATFORM =~ /darwin/
+
+  BROWSER_MAP = {
+      'FF' => 'Firefox',
+      'IE' => 'Internet Explorer',
+      'S'  => 'Safari',
+      'MS' => 'Mobile Safari',
+      'C'  => 'Chrome'
+  }
+
+  BROWSER_ALTERNATES = {
+      'OSX'     => { 'IE' => 'S' },
+      'Windows' => { 'S' => 'IE' }
+  }
+
+  if USING_WINDOWS
+    #require 'win32ole' <-- We'll load this later in Shamisen::AwetestLegacy::Runner. It has to be loaded after watir, see https://www.pivotaltracker.com/story/show/19249981
+    require 'win32/screenshot'
+  end
+  #require 'active_support/inflector'
+  #require 'active_support/core_ext/object'
+  #require 'active_support/core_ext/hash'
+
+  require 'andand'
+  require 'regression/runner'
+
+
+  if USING_OSX
+    require 'appscript'
+  end
+
+  require 'roo'
+
+end

data/lib/patches/README

@@ -0,0 +1,2 @@
+We put here small monkey patches to the gems we use.
+This is the easier path when we sometimes just need to override or add a few methods in a gem; we don't really need to fork it.