caching_matcher 0.1.0

data/History.txt

@@ -0,0 +1,3 @@
+== 0.1.0 / 2010-09-07
+
+* First release as gem

data/README.txt

@@ -0,0 +1,75 @@
+caching_matcher
+    by Wolfram Arnold; Mighyverse.com; WTA Consulting, Inc.
+    http://github.com/mightyverse/caching_matcher
+
+== DESCRIPTION:
+
+An rspec custom matcher to assert Rails action and fragment caching.
+
+== FEATURES/PROBLEMS:
+
+* Assert fragment caching with custom keys
+* Assert action caching by URL
+* Works only with memcached backend
+* There are unresolved issues with the :format URL parameter (.xml, .json, ...)
+
+== SYNOPSIS:
+
+In test.rb turn on caching and set cache_store to memcache:
+
+config.action_controller.perform_caching             = true
+config.cache_store = :mem_cache_store
+
+
+In spec_helper.rb, add into the config block:
+
+config.include(CachingMatcher)
+config.before { ActionController::Base.cache_store.clear }
+
+
+In RSpec Controller Tests:
+
+lambda {
+   get :index
+}.should be_cached(controller, :action => 'index')
+
+lambda {
+    get :edit, :id => 5
+}.should_not be_cached(controller, :action => 'edit', :id => 5)
+
+lambda {
+    delete :destroy, :id => 5
+}.should expire(controller, :action => 'index')
+
+should_not expire is also available.
+
+== REQUIREMENTS:
+
+* memcached backend
+
+== INSTALL:
+
+* gem install caching_matcher
+
+== LICENSE:
+
+Copyright (c) 2009-2010 Wolfram Arnold; Mightyverse, Inc.; WTA Consulting, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,22 @@
+
+begin
+  require 'bones'
+rescue LoadError
+  abort '### Please install the "bones" gem ###'
+end
+
+task :default => 'test:run'
+task 'gem:release' => 'test:run'
+
+Bones {
+  name  'caching_matcher'
+  authors  'Wolfram Arnold'
+  email    'wolfram@rubyfocus.biz'
+  url      'http://github.com/mightyverse/caching_matcher'
+  ignore_file  '.gitignore'
+  depend_on 'rails', :version => '2.3.8', :development => true
+  depend_on 'activesupport', :version => '2.3.8', :development => true
+  depend_on 'actionpack', :version => '2.3.8', :development => true
+  depend_on 'rspec', :version => '>=1.3.0', :development => true
+  depend_on 'rspec-rails', :version => '>=1.3.2', :development => true
+}

data/bin/caching_matcher

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib caching_matcher]))
+
+# Put your code here
+

data/caching_matcher.gemspec

@@ -0,0 +1,51 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{caching_matcher}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Wolfram Arnold"]
+  s.date = %q{2010-09-07}
+  s.default_executable = %q{caching_matcher}
+  s.description = %q{An rspec custom matcher to assert Rails action and fragment caching.}
+  s.email = %q{wolfram@rubyfocus.biz}
+  s.executables = ["caching_matcher"]
+  s.extra_rdoc_files = ["History.txt", "README.txt", "bin/caching_matcher", "version.txt"]
+  s.files = ["History.txt", "README.txt", "Rakefile", "bin/caching_matcher", "lib/caching_matcher.rb", "lib/caching_matcher/caching_matcher.rb", "spec/controllers/caching_matcher_spec.rb", "spec/mock_app/app/controllers/application_controller.rb", "spec/mock_app/app/controllers/items_controller.rb", "spec/mock_app/config/boot.rb", "spec/mock_app/config/environment.rb", "spec/mock_app/config/environments/test.rb", "spec/mock_app/config/initializers/cookie_verification_secret.rb", "spec/mock_app/config/initializers/mime_types.rb", "spec/mock_app/config/initializers/new_rails_defaults.rb", "spec/mock_app/config/initializers/session_store.rb", "spec/mock_app/config/locales/en.yml", "spec/mock_app/config/routes.rb", "spec/mock_app/log/test.log", "spec/spec_helper.rb", "test/test_caching_matcher.rb", "version.txt"]
+  s.homepage = %q{http://github.com/mightyverse/caching_matcher}
+  s.rdoc_options = ["--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{caching_matcher}
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{An rspec custom matcher to assert Rails action and fragment caching}
+  s.test_files = ["test/test_caching_matcher.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rails>, [">= 2.3.8"])
+      s.add_development_dependency(%q<activesupport>, [">= 2.3.8"])
+      s.add_development_dependency(%q<actionpack>, [">= 2.3.8"])
+      s.add_development_dependency(%q<rspec>, [">= 1.3.0"])
+      s.add_development_dependency(%q<rspec-rails>, [">= 1.3.2"])
+      s.add_development_dependency(%q<bones>, [">= 3.4.7"])
+    else
+      s.add_dependency(%q<rails>, [">= 2.3.8"])
+      s.add_dependency(%q<activesupport>, [">= 2.3.8"])
+      s.add_dependency(%q<actionpack>, [">= 2.3.8"])
+      s.add_dependency(%q<rspec>, [">= 1.3.0"])
+      s.add_dependency(%q<rspec-rails>, [">= 1.3.2"])
+      s.add_dependency(%q<bones>, [">= 3.4.7"])
+    end
+  else
+    s.add_dependency(%q<rails>, [">= 2.3.8"])
+    s.add_dependency(%q<activesupport>, [">= 2.3.8"])
+    s.add_dependency(%q<actionpack>, [">= 2.3.8"])
+    s.add_dependency(%q<rspec>, [">= 1.3.0"])
+    s.add_dependency(%q<rspec-rails>, [">= 1.3.2"])
+    s.add_dependency(%q<bones>, [">= 3.4.7"])
+  end
+end

data/lib/caching_matcher/caching_matcher.rb

@@ -0,0 +1,99 @@
+module CachingMatcher
+
+  class MatcherBase
+    # first argument: controller
+    # second arg: either a path string or hash of url options
+    def initialize(controller, path_arg)
+      @controller = controller
+      compute_cache_key(path_arg)
+    end
+
+    attr_reader :cache_key
+
+    private
+
+    def compute_cache_key(path_arg)
+      case path_arg
+        when String
+          path = path_arg
+        when Hash
+          url_options = path_arg.merge(:controller => @controller.class.to_s.underscore.split(/_controller/).first)
+          path = ActionController::Caching::Actions::ActionCachePath.path_for(@controller, url_options, true)
+        else
+          raise "Argument to be_cached and be_expired must be controller, followed by a path as string or URL hash"
+      end
+      @cache_key = @controller.fragment_cache_key(path)
+    end
+
+    protected
+
+    def run_match(event_proc)
+      @before = ActionController::Base.cache_store.exist?(@cache_key)
+      event_proc.call
+      @after = ActionController::Base.cache_store.exist?(@cache_key)
+    end
+  end
+
+  def prime_cache(controller, url_options)
+    mb = MatcherBase.new(controller, url_options)
+    ActionController::Base.cache_store.write(mb.cache_key, "Some data")
+  end
+
+  def clear_cache(controller, url_options)
+    mb = MatcherBase.new(controller, url_options)
+    ActionController::Base.cache_store.delete(mb.cache_key)
+  end
+
+  class BeCachedMatcher < MatcherBase
+
+    def matches?(event_proc)
+      run_match(event_proc)
+      !@before && @after
+    end
+
+    def failure_message_for_should
+      if @before
+        "Key: #{@cache_key} was cached before operation. Did you forget to call ActionController::Base.cache_store.clear in the before block?"
+      elsif !@after
+        "Key: #{@cache_key} was not cached after operation but should have been."
+      end
+    end
+
+    def failure_message_for_should_not
+      if @after
+        "Key: #{@cache_key} was cached after operation but should not have been."
+      end
+    end
+  end
+
+  def be_cached(controller,url_options)
+    BeCachedMatcher.new(controller,url_options)
+  end
+
+  class BeExpiredMatcher < MatcherBase
+    def matches?(event_proc)
+      run_match(event_proc)
+      @before && !@after
+    end
+    def failure_message_for_should
+      if !@before
+        "Key: #{@cache_key} was not cached before operation but should have been.  Did you forget to prime the cache?"
+      elsif @after
+        "Key: #{@cache_key} was cached after operation but should not have been."
+      end
+    end
+
+    def failure_message_for_should_not
+      if @before
+        "Key: #{@cache_key} was cached before operation but should not have been.  Did you forget to clear the cache in a before block?"
+      elsif !@after
+        "Key: #{@cache_key} was not cached after operation but should have been."
+      end
+    end
+  end
+
+  def be_expired(controller,url_options)
+    BeExpiredMatcher.new(controller,url_options)
+  end
+
+end

data/lib/caching_matcher.rb

@@ -0,0 +1,65 @@
+
+module CachingMatcher
+
+  # :stopdoc:
+  LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
+  PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
+  # :startdoc:
+
+  # Returns the version string for the library.
+  #
+  def self.version
+    @version ||= File.read(path('version.txt')).strip
+  end
+
+  # Returns the library path for the module. If any arguments are given,
+  # they will be joined to the end of the libray path using
+  # <tt>File.join</tt>.
+  #
+  def self.libpath( *args, &block )
+    rv =  args.empty? ? LIBPATH : ::File.join(LIBPATH, args.flatten)
+    if block
+      begin
+        $LOAD_PATH.unshift LIBPATH
+        rv = block.call
+      ensure
+        $LOAD_PATH.shift
+      end
+    end
+    return rv
+  end
+
+  # Returns the lpath for the module. If any arguments are given,
+  # they will be joined to the end of the path using
+  # <tt>File.join</tt>.
+  #
+  def self.path( *args, &block )
+    rv = args.empty? ? PATH : ::File.join(PATH, args.flatten)
+    if block
+      begin
+        $LOAD_PATH.unshift PATH
+        rv = block.call
+      ensure
+        $LOAD_PATH.shift
+      end
+    end
+    return rv
+  end
+
+  # Utility method used to require all files ending in .rb that lie in the
+  # directory below this file that has the same name as the filename passed
+  # in. Optionally, a specific _directory_ name can be passed in such that
+  # the _filename_ does not have to be equivalent to the directory.
+  #
+  def self.require_all_libs_relative_to( fname, dir = nil )
+    dir ||= ::File.basename(fname, '.*')
+    search_me = ::File.expand_path(
+        ::File.join(::File.dirname(fname), dir, '**', '*.rb'))
+
+    Dir.glob(search_me).sort.each {|rb| require rb}
+  end
+
+end  # module CachingMatcher
+
+CachingMatcher.require_all_libs_relative_to(__FILE__)
+

data/spec/controllers/caching_matcher_spec.rb

@@ -0,0 +1,64 @@
+require File.join(File.dirname(__FILE__), %w[.. spec_helper])
+
+describe CachingMatcher do
+  controller_name :items
+
+  context "Caching Assertions" do
+    it 'reports cached' do
+      lambda {
+        get :index
+      }.should be_cached(controller, :action => 'index')
+    end
+
+    it 'reports uncached' do
+      lambda {
+        get :edit, :id => 5
+      }.should_not be_cached(controller, :action => 'edit', :id => 5)
+    end
+  end
+
+  context "Expiry Assertions" do
+    it 'reports expired' do
+      prime_cache(controller, :action => 'index')
+      lambda {
+        delete :destroy, :id => 5
+      }.should be_expired(controller, :action => 'index')
+    end
+
+    it 'reports unexpired' do
+      prime_cache(controller, :action => 'index')
+      lambda {
+        delete :edit, :id => 5
+      }.should_not be_expired(controller, :action => 'index')
+    end
+  end
+
+  context "Helpers" do
+    it 'can prime the cache programmatically with url hash' do
+      lambda {
+        prime_cache(controller, :action => 'index')
+      }.should be_cached(controller, :action => 'index')
+    end
+
+    it 'can prime the cache programmatically with path' do
+      lambda {
+        prime_cache(controller, 'hello_world')
+      }.should be_cached(controller, 'hello_world')
+    end
+
+    it 'can clear the cache programmatically with url hash' do
+      prime_cache(controller, :action => 'index')
+      lambda {
+        clear_cache(controller, :action => 'index')
+      }.should be_expired(controller, :action => 'index')
+    end
+
+    it 'can clear the cache programmatically with path' do
+      prime_cache(controller, 'hello_world')
+      lambda {
+        clear_cache(controller, 'hello_world')
+      }.should be_expired(controller, 'hello_world')
+    end
+  end
+end
+

data/spec/mock_app/app/controllers/application_controller.rb

@@ -0,0 +1,2 @@
+class ApplicationController < ActionController::Base
+end

data/spec/mock_app/app/controllers/items_controller.rb

@@ -0,0 +1,17 @@
+class ItemsController < ApplicationController
+
+  caches_action :index
+
+  def index
+    render :text => "Index"
+  end
+
+  def edit
+    render :text => "Edit"
+  end
+
+  def destroy
+    expire_action url_for(:action => 'index')
+    render :text => "Destroy"
+  end
+end

data/spec/mock_app/config/boot.rb

@@ -0,0 +1,110 @@
+# Don't change this file!
+# Configure your app in config/environment.rb and config/environments/*.rb
+
+RAILS_ROOT = "#{File.dirname(__FILE__)}/.." unless defined?(RAILS_ROOT)
+
+module Rails
+  class << self
+    def boot!
+      unless booted?
+        preinitialize
+        pick_boot.run
+      end
+    end
+
+    def booted?
+      defined? Rails::Initializer
+    end
+
+    def pick_boot
+      (vendor_rails? ? VendorBoot : GemBoot).new
+    end
+
+    def vendor_rails?
+      File.exist?("#{RAILS_ROOT}/vendor/rails")
+    end
+
+    def preinitialize
+      load(preinitializer_path) if File.exist?(preinitializer_path)
+    end
+
+    def preinitializer_path
+      "#{RAILS_ROOT}/config/preinitializer.rb"
+    end
+  end
+
+  class Boot
+    def run
+      load_initializer
+      Rails::Initializer.run(:set_load_path)
+    end
+  end
+
+  class VendorBoot < Boot
+    def load_initializer
+      require "#{RAILS_ROOT}/vendor/rails/railties/lib/initializer"
+      Rails::Initializer.run(:install_gem_spec_stubs)
+      Rails::GemDependency.add_frozen_gem_path
+    end
+  end
+
+  class GemBoot < Boot
+    def load_initializer
+      self.class.load_rubygems
+      load_rails_gem
+      require 'initializer'
+    end
+
+    def load_rails_gem
+      if version = self.class.gem_version
+        gem 'rails', version
+      else
+        gem 'rails'
+      end
+    rescue Gem::LoadError => load_error
+      $stderr.puts %(Missing the Rails #{version} gem. Please `gem install -v=#{version} rails`, update your RAILS_GEM_VERSION setting in config/environment.rb for the Rails version you do have installed, or comment out RAILS_GEM_VERSION to use the latest version installed.)
+      exit 1
+    end
+
+    class << self
+      def rubygems_version
+        Gem::RubyGemsVersion rescue nil
+      end
+
+      def gem_version
+        if defined? RAILS_GEM_VERSION
+          RAILS_GEM_VERSION
+        elsif ENV.include?('RAILS_GEM_VERSION')
+          ENV['RAILS_GEM_VERSION']
+        else
+          parse_gem_version(read_environment_rb)
+        end
+      end
+
+      def load_rubygems
+        min_version = '1.3.2'
+        require 'rubygems'
+        unless rubygems_version >= min_version
+          $stderr.puts %Q(Rails requires RubyGems >= #{min_version} (you have #{rubygems_version}). Please `gem update --system` and try again.)
+          exit 1
+        end
+
+      rescue LoadError
+        $stderr.puts %Q(Rails requires RubyGems >= #{min_version}. Please install RubyGems and try again: http://rubygems.rubyforge.org)
+        exit 1
+      end
+
+      def parse_gem_version(text)
+        $1 if text =~ /^[^#]*RAILS_GEM_VERSION\s*=\s*["']([!~<>=]*\s*[\d.]+)["']/
+      end
+
+      private
+        def read_environment_rb
+          File.read("#{RAILS_ROOT}/config/environment.rb")
+        end
+    end
+  end
+end
+
+# All that for this:
+Rails.boot!

data/spec/mock_app/config/environment.rb

@@ -0,0 +1,41 @@
+# Be sure to restart your server when you modify this file
+
+# Specifies gem version of Rails to use when vendor/rails is not present
+RAILS_GEM_VERSION = '2.3.8' unless defined? RAILS_GEM_VERSION
+
+# Bootstrap the Rails environment, frameworks, and default configuration
+require File.join(File.dirname(__FILE__), 'boot')
+
+Rails::Initializer.run do |config|
+  # Settings in config/environments/* take precedence over those specified here.
+  # Application configuration should go into files in config/initializers
+  # -- all .rb files in that directory are automatically loaded.
+
+  # Add additional load paths for your own custom dirs
+  # config.load_paths += %W( #{RAILS_ROOT}/extras )
+
+  # Specify gems that this application depends on and have them installed with rake gems:install
+  # config.gem "bj"
+  # config.gem "hpricot", :version => '0.6', :source => "http://code.whytheluckystiff.net"
+  # config.gem "sqlite3-ruby", :lib => "sqlite3"
+  # config.gem "aws-s3", :lib => "aws/s3"
+
+  # Only load the plugins named here, in the order given (default is alphabetical).
+  # :all can be used as a placeholder for all plugins not explicitly named
+  # config.plugins = [ :exception_notification, :ssl_requirement, :all ]
+
+  # Skip frameworks you're not going to use. To use Rails without a database,
+  # you must remove the Active Record framework.
+  config.frameworks -= [ :active_record, :active_resource, :action_mailer ]
+
+  # Activate observers that should always be running
+  # config.active_record.observers = :cacher, :garbage_collector, :forum_observer
+
+  # Set Time.zone default to the specified zone and make Active Record auto-convert to this zone.
+  # Run "rake -D time" for a list of tasks for finding time zone names.
+  config.time_zone = 'UTC'
+
+  # The default locale is :en and all translations from config/locales/*.rb,yml are auto loaded.
+  # config.i18n.load_path += Dir[Rails.root.join('my', 'locales', '*.{rb,yml}')]
+  # config.i18n.default_locale = :de
+end

data/spec/mock_app/config/environments/test.rb

@@ -0,0 +1,32 @@
+# Settings specified here will take precedence over those in config/environment.rb
+
+# The test environment is used exclusively to run your application's
+# test suite.  You never need to work with it otherwise.  Remember that
+# your test database is "scratch space" for the test suite and is wiped
+# and recreated between test runs.  Don't rely on the data there!
+config.cache_classes = true
+
+# Log error messages when you accidentally call methods on nil.
+config.whiny_nils = true
+
+# Show full error reports and disable caching
+config.action_controller.consider_all_requests_local = true
+config.action_controller.perform_caching             = true
+config.action_view.cache_template_loading            = true
+
+# Disable request forgery protection in test environment
+config.action_controller.allow_forgery_protection    = false
+
+# Tell Action Mailer not to deliver emails to the real world.
+# The :test delivery method accumulates sent emails in the
+# ActionMailer::Base.deliveries array.
+config.action_mailer.delivery_method = :test
+
+# Use SQL instead of Active Record's schema dumper when creating the test database.
+# This is necessary if your schema can't be completely dumped by the schema dumper,
+# like if you have constraints or database-specific column types
+# config.active_record.schema_format = :sql
+
+config.gem 'rspec-rails', :version => '>= 1.3.2', :lib => false unless File.directory?(File.join(Rails.root, 'vendor/plugins/rspec-rails'))
+
+config.cache_store = :mem_cache_store

data/spec/mock_app/config/initializers/cookie_verification_secret.rb

@@ -0,0 +1,7 @@
+# Be sure to restart your server when you modify this file.
+
+# Your secret key for verifying the integrity of signed cookies.
+# If you change this key, all old signed cookies will become invalid!
+# Make sure the secret is at least 30 characters and all random, 
+# no regular words or you'll be exposed to dictionary attacks.
+ActionController::Base.cookie_verifier_secret = '97cc4e208746ae1bfd9b85841756b44eebde353bc08ffe28ceb9dbc5ac0f50c251942710072fbafd5944e7efaabeccf83ffdbcb6fae386a79f8f6f3e7c951591';

data/spec/mock_app/config/initializers/mime_types.rb

@@ -0,0 +1,5 @@
+# Be sure to restart your server when you modify this file.
+
+# Add new mime types for use in respond_to blocks:
+# Mime::Type.register "text/richtext", :rtf
+# Mime::Type.register_alias "text/html", :iphone

data/spec/mock_app/config/initializers/new_rails_defaults.rb

@@ -0,0 +1,21 @@
+# Be sure to restart your server when you modify this file.
+
+# These settings change the behavior of Rails 2 apps and will be defaults
+# for Rails 3. You can remove this initializer when Rails 3 is released.
+
+if defined?(ActiveRecord)
+  # Include Active Record class name as root for JSON serialized output.
+  ActiveRecord::Base.include_root_in_json = true
+
+  # Store the full class name (including module namespace) in STI type column.
+  ActiveRecord::Base.store_full_sti_class = true
+end
+
+ActionController::Routing.generate_best_match = false
+
+# Use ISO 8601 format for JSON serialized times and dates.
+ActiveSupport.use_standard_json_time_format = true
+
+# Don't escape HTML entities in JSON, leave that for the #json_escape helper.
+# if you're including raw json in an HTML page.
+ActiveSupport.escape_html_entities_in_json = false

data/spec/mock_app/config/initializers/session_store.rb

@@ -0,0 +1,15 @@
+# Be sure to restart your server when you modify this file.
+
+# Your secret key for verifying cookie session data integrity.
+# If you change this key, all old sessions will become invalid!
+# Make sure the secret is at least 30 characters and all random, 
+# no regular words or you'll be exposed to dictionary attacks.
+ActionController::Base.session = {
+  :key         => '_rails-2.3.8_session',
+  :secret      => 'd284ec0e18b0d49b380996f29145d500b197492931a18c8c9c2d120e322e64511b810f914bb0d332a72d234ce2ad7e4d65c8e7e28a6beadf00113ac40de0626f'
+}
+
+# Use the database for sessions instead of the cookie-based default,
+# which shouldn't be used to store highly confidential information
+# (create the session table with "rake db:sessions:create")
+# ActionController::Base.session_store = :active_record_store

data/spec/mock_app/config/locales/en.yml

@@ -0,0 +1,5 @@
+# Sample localization file for English. Add more files in this directory for other locales.
+# See http://github.com/svenfuchs/rails-i18n/tree/master/rails%2Flocale for starting points.
+
+en:
+  hello: "Hello world"

data/spec/mock_app/config/routes.rb

@@ -0,0 +1,4 @@
+ActionController::Routing::Routes.draw do |map|
+  map.connect ':controller/:action/:id'
+  map.connect ':controller/:action/:id.:format'
+end