trendi18n 0.9.1

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) 2009 Łukasz Piestrzeniewicz
+
+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/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 [name of plugin creator]
+
+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/README.rdoc

@@ -0,0 +1,19 @@
+= Introduction
+
+Trendi18n is database backend for Rails' i18n.  Trendi18n offers some administration functionality, which offers:
+
+* paginated list of translations in database (with locale and translation status conditions)
+* autoassigned status for translations:
+	* new
+	* unfinished (for translation with many plural forms only)
+	* finished
+* add new translate
+* edit existing translate
+* remove existing translate
+* looking for translations in database (with locale and translation status conditions)
+
+Real-time updating store_translations
+
+= Copyright
+
+Copyright © 2009 Łukasz Piestrzeniewicz. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,54 @@
+RAILS_ROOT = "spec/test_application"
+
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rubygems'
+require 'tasks/rails'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+      gemspec.name = "trendi18n"
+      gemspec.summary = "Database backend for i18n"
+      gemspec.description = "Database backend for i18n (localization files are still supported). This is beta version so give me your feedback"
+      gemspec.email = "p.misiurek@gmail.com"
+      gemspec.authors = ["Piotr Misiurek", "Piotr Marciniak", "Łukasz Piestrzeniewicz"]
+      files = FileList["[A-Z]*", "{generators,lib,spec,app,rails}/**/*"]
+      files.exclude "spec/test_application/coverage/*"
+      files.exclude "spec/test_application/tmp/*"
+      files.exclude "spec/test_application/nbproject/*"
+      files.exclude "spec/test_application/log/*"
+      files.exclude "spec/test_applcation/test/*"
+      files.exclude "spec/test_application/db/*sqlite3"
+      gemspec.files = files.to_a
+      gemspec.homepage = "http://github.com/bragi/trendi18n"
+      gemspec.add_dependency("rails", ">= 2.3.5")
+  end
+   rescue LoadError
+      puts "Jeweler not available"
+end
+
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the trendi18n plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the trendi18n plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Trendi18n'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end 
+
+
+

data/VERSION

@@ -0,0 +1 @@
+0.9.1

data/app/models/translation.rb

@@ -0,0 +1,125 @@
+class Translation < ActiveRecord::Base
+  before_validation :set_state
+  before_validation :set_defaults
+  after_save :reload_backend
+
+
+  named_scope :untranslated, :conditions => {:state => %w(new unfinished)}
+  named_scope :translated, :conditions => {:state => "finished"}
+  named_scope :localization, lambda {|*args| args.first ? {:conditions => {:locale => args.first}} : nil }
+
+  validates_presence_of :key
+  validates_length_of :locale, :within => 2..6
+  validates_uniqueness_of :key, :scope => %w(locale scope)
+
+  @@locales = []
+
+   # return locales if their exists and translations are up-to-date. In other case assign are locales values from db to locales and return this value
+  def self.get_locales
+    @@locales
+  end
+
+  def self.set_locales
+    @@locales = self.all(:select => "DISTINCT(locale)", :order => "locale ASC").map { |obj| obj.locale  }
+  end
+
+  # This method is running after save translation into db and it is reloading I18n backend (trendi18n)
+  def reload_backend
+    I18n.backend.reload!
+    Translation.set_locales
+  end
+
+  # auto-magic finder using string normalized key to find translation. The first value in scope is the locale, the last is the key and all between are scopes
+  def self.find_by_string_normalized_key(key)
+    scope = I18n.send(:normalize_translation_keys, I18n.locale, key, nil).map(&:to_s)
+    self.first(:conditions => {:key => scope.last, :locale => scope.first, :scope => scope[1..-2].empty? ? nil : scope[1..-2].join(".") }) || raise(ActiveRecord::RecordNotFound, "Could not find translation with key #{key}")
+  end
+
+  # Assign state of translation
+    # - if there is no count in the key, set new if there is not translation and set finished when translation exists
+    # - if there is count in the key, then:
+    #   * if translation has all plural forms, assign finished
+    #   * if translation has some plural forms, then assign unfinished
+    #   * if translation does not have plural forms, then assign new
+  def set_state
+    self.state = self.with_count? ? self.has_all_plural_forms? ? "finished" : self.has_some_plural_forms? ? "unfinished" : "new" : self.translation.blank? ? "new" : "finished"
+  end
+
+  # assign default values to translation
+  def set_defaults
+    self.locale = I18n.locale.to_s if self.locale.blank? # if translation does not have locale, set I18n default
+    self.default = key unless self.default # set key to default if it is not exists
+    self.scope = nil if self.scope.blank? #set nil to scope if it is blank (empty string)
+    self.translation = nil if self.translation.blank? # set nil to translation if it is blank (empty string)
+  end
+
+  # time of the last db update
+  def self.base_updated_at
+    self.exists?(["updated_at > created_at"]) ? self.first(:order => "updated_at DESC", :conditions => "updated_at > created_at").updated_at : Time.at(0)
+  end
+
+   # time of the db read on current db update
+  def self.read_base
+    @base_read_at = Time.zone.now if @base_read_at.nil?
+  end
+
+  def self.clear_base_read_at
+    @base_read_at = nil
+  end
+
+   # db is up-to-date when it wasn't read or read time is larger then update time
+  def self.up_to_date?
+    @base_read_at.nil? || @base_read_at.to_i > self.base_updated_at.to_i
+  end
+
+  # don't be nil if there is "{{count}}" in key
+  def with_count?
+    /\{\{count\}\}/.match(self.key)
+  end
+
+  # true if translation has all plural forms
+  def has_all_plural_forms?
+    !self.zero.blank? && !self.one.blank? && !self.many.blank?
+  end
+
+  # get correct pluralization form (using count)
+  def pluralize(count)
+    if count
+      case count
+      when 0 then self.zero
+      when 1 then self.one
+      else self.many
+        end || self.default
+    else
+      self.translation || self.default
+    end
+  end
+
+  # true if translation has some plural forms
+  def has_some_plural_forms?
+    !self.zero.blank? || !self.one.blank? || !self.many.blank?
+  end
+
+  # look up for translation and return it, if exists, or create if not
+  def self.lookup(locale, key, default = nil, scope = nil)
+    self.read_base
+    scope = I18n.send(:normalize_translation_keys, locale, key, scope)
+    locale = scope.delete_at(0).to_s
+    key = scope.delete_at(scope.size - 1).to_s
+    scope = scope.empty? ? nil : scope.join(".")
+    if self.exists?(:locale => locale, :scope => scope, :key => key)
+      translation = self.first(:conditions => {:locale => locale, :scope => scope, :key => key})
+    else
+      translation = self.new(:key => key, :default => default.nil? ? key : default, :locale => locale, :scope => scope)
+      translation.save
+    end
+    translation
+  end
+
+  # return hash ready to by stored as translation
+  def to_translation_hash
+   path = self.scope.nil? ? [self.key] : self.scope.split(".") << self.key
+   return path.reverse.inject(self) {|before, step| { step => before}}
+  end
+
+end

data/generators/trendi18n/templates/migrations/create_translations.rb

@@ -0,0 +1,22 @@
+class CreateTranslations < ActiveRecord::Migration
+  def self.up
+    create_table ActiveRecord::Base.pluralize_table_names ? :translations : :translation do |t|
+      t.string :locale, :null => false, :limit => 6
+      t.string :key, :null => false
+      t.string :scope
+      t.text :default, :null => false
+      t.text :translation
+      t.text :zero
+      t.text :one
+      t.text :many
+      t.text :few
+      t.string :state, :null => false
+      t.timestamps
+    end
+    add_index :translations, [:locale, :key, :scope], :unique => true
+  end
+
+  def self.down
+    drop_table ActiveRecord::Base.pluralize_table_names ? :translations : :translation
+  end
+end

data/generators/trendi18n/trendi18n_generator.rb

@@ -0,0 +1,8 @@
+class Trendi18nGenerator < Rails::Generator::Base
+
+  def manifest
+    record do |m|
+      m.installer
+    end
+  end
+end

data/lib/commands.rb

@@ -0,0 +1,39 @@
+require "rails_generator"
+require "rails_generator/commands"
+
+module Trendi18n
+  module Generator
+    module Commands
+
+      module Create
+
+        def installer
+            puts "Creating migration file..."
+            migration_template(File.join("migrations", "create_translations.rb"), File.join("db", "migrate"),
+              :migration_file_name => ActiveRecord::Base.pluralize_table_names ? "create_translations" : "create_translation")
+            puts "Inserting migration into db..."
+            version = File.get_migration_version_from_file_name(ActiveRecord::Base.pluralize_table_names ? /create_translations\.rb$/ : /create_translation\.rb$/)
+            system "rake db:migrate:up VERSION=#{version}"
+        end
+
+      end
+
+      module Destroy
+
+         def installer
+            puts "Removing migration from db..."
+            version = File.get_migration_version_from_file_name(ActiveRecord::Base.pluralize_table_names ? /create_translations\.rb$/ : /create_translation\.rb$/)
+            system "rake db:migrate:down VERSION=#{version}"
+            puts "Removing migration file..."
+            migration_template(File.join("migrations", "create_translations.rb"), File.join("db", "migrate"),
+              :migration_file_name => ActiveRecord::Base.pluralize_table_names ? "create_translations" : "create_translation")
+        end
+
+      end
+
+    end
+  end
+end
+
+ Rails::Generator::Commands::Create.send :include, Trendi18n::Generator::Commands::Create
+ Rails::Generator::Commands::Destroy.send :include, Trendi18n::Generator::Commands::Destroy

data/lib/file.rb

@@ -0,0 +1,8 @@
+class File
+
+   # get migration version from filename matching to regexp
+  def self.get_migration_version_from_file_name(migration_name_regexp)
+    Dir[File.join("db", "migrate", "*.rb")].each { |file| return File.basename(file).split("_")[0].to_i if migration_name_regexp.match(File.basename(file)) }
+  end
+
+end

data/lib/trendi18n.rb

@@ -0,0 +1,78 @@
+
+module Trendi18n
+  module Backend
+
+    class Trendi18n < I18n::Backend::Simple
+      delegate :up_to_date?, :to => Translation # delgate up_to_date? method to Translation model
+
+      # return available locales, based on informaton form Translation model
+      def available_locales
+        Translation.get_locales
+      end
+
+      # translate key in locale using options
+      def translate(locale, key, options = {})
+        raise InvalidLocale.new(locale) if locale.nil?
+
+        #if key is an array then as a result run yourself for all subkey in key
+        return key.map { |subkey| translate(locale, subkey, options)} if key.is_a?(Array)
+
+        # read count, scope and default from options
+        count, scope, default = options.values_at(:count, :scope, :default)
+        options.delete(:default) #delete default from option
+
+        # read values of scope and default options and delete them form options
+        values = options.reject {|name, value| [:scope, :default].include?(name)}
+
+        if key.is_a?(Symbol) # if key is a Symbol
+          begin
+            return nested.translate(locale, key, options) # use nested translete
+          rescue
+            I18n::MissingTranslationData # if its exists
+          end
+        end
+
+        entry = lookup(locale, key, default, scope) # lookup for translation
+        entry = entry.pluralize(count) # run pluralization for translation
+        entry = interpolate(locale, entry, values) # run interpolation for translation
+      end
+
+
+      def reload!
+        super # run standard I18n::Backend::Simple reload! method
+        Translation.clear_base_read_at # and clear information about time of last translation's base read
+      end
+
+      protected
+
+      def init_translations
+        # only set @initialized. Translations will be caching in real-time
+        @initialized = true
+        Translation.set_locales
+      end
+
+      # look up for translation. When find cache it and return
+      def lookup(locale, key, default, scope)
+        # cache and return translation. Translation can be find by:
+        # - standard I18n::Backend::Simple.lookup method. If its failed, then:
+        # - Translation model lookup method
+        cache_translation(translation = Translation.lookup(locale, key, default, scope)) unless translation = super(locale, key, scope)
+        translation
+
+     end
+
+      private
+
+      # assign new instance of I18n::Backend::Simple for @nested if its not exists
+      def nested
+        @nested ||= I18n::Backend::Simple.new
+      end
+
+      # add translation to stored
+      def cache_translation(translation)
+        store_translations(translation.locale, translation.to_translation_hash)
+      end
+
+    end
+  end
+end

data/rails/init.rb

@@ -0,0 +1,5 @@
+require 'trendi18n'
+require "commands"
+require 'file'
+
+I18n.backend = Trendi18n::Backend::Trendi18n.new

data/spec/test_application/README

@@ -0,0 +1,243 @@
+== Welcome to Rails
+
+Rails is a web-application framework that includes everything needed to create 
+database-backed web applications according to the Model-View-Control pattern. 
+
+This pattern splits the view (also called the presentation) into "dumb" templates
+that are primarily responsible for inserting pre-built data in between HTML tags.
+The model contains the "smart" domain objects (such as Account, Product, Person,
+Post) that holds all the business logic and knows how to persist themselves to
+a database. The controller handles the incoming requests (such as Save New Account,
+Update Product, Show Post) by manipulating the model and directing data to the view.
+
+In Rails, the model is handled by what's called an object-relational mapping
+layer entitled Active Record. This layer allows you to present the data from
+database rows as objects and embellish these data objects with business logic
+methods. You can read more about Active Record in
+link:files/vendor/rails/activerecord/README.html.
+
+The controller and view are handled by the Action Pack, which handles both
+layers by its two parts: Action View and Action Controller. These two layers
+are bundled in a single package due to their heavy interdependence. This is
+unlike the relationship between the Active Record and Action Pack that is much
+more separate. Each of these packages can be used independently outside of
+Rails.  You can read more about Action Pack in
+link:files/vendor/rails/actionpack/README.html.
+
+
+== Getting Started
+
+1. At the command prompt, start a new Rails application using the <tt>rails</tt> command
+   and your application name. Ex: rails myapp
+2. Change directory into myapp and start the web server: <tt>script/server</tt> (run with --help for options)
+3. Go to http://localhost:3000/ and get "Welcome aboard: You're riding the Rails!"
+4. Follow the guidelines to start developing your application
+
+
+== Web Servers
+
+By default, Rails will try to use Mongrel if it's are installed when started with script/server, otherwise Rails will use WEBrick, the webserver that ships with Ruby. But you can also use Rails
+with a variety of other web servers.
+
+Mongrel is a Ruby-based webserver with a C component (which requires compilation) that is
+suitable for development and deployment of Rails applications. If you have Ruby Gems installed,
+getting up and running with mongrel is as easy as: <tt>gem install mongrel</tt>.
+More info at: http://mongrel.rubyforge.org
+
+Say other Ruby web servers like Thin and Ebb or regular web servers like Apache or LiteSpeed or
+Lighttpd or IIS. The Ruby web servers are run through Rack and the latter can either be setup to use
+FCGI or proxy to a pack of Mongrels/Thin/Ebb servers.
+
+== Apache .htaccess example for FCGI/CGI
+
+# General Apache options
+AddHandler fastcgi-script .fcgi
+AddHandler cgi-script .cgi
+Options +FollowSymLinks +ExecCGI
+
+# If you don't want Rails to look in certain directories,
+# use the following rewrite rules so that Apache won't rewrite certain requests
+# 
+# Example:
+#   RewriteCond %{REQUEST_URI} ^/notrails.*
+#   RewriteRule .* - [L]
+
+# Redirect all requests not available on the filesystem to Rails
+# By default the cgi dispatcher is used which is very slow
+# 
+# For better performance replace the dispatcher with the fastcgi one
+#
+# Example:
+#   RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]
+RewriteEngine On
+
+# If your Rails application is accessed via an Alias directive,
+# then you MUST also set the RewriteBase in this htaccess file.
+#
+# Example:
+#   Alias /myrailsapp /path/to/myrailsapp/public
+#   RewriteBase /myrailsapp
+
+RewriteRule ^$ index.html [QSA]
+RewriteRule ^([^.]+)$ $1.html [QSA]
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteRule ^(.*)$ dispatch.cgi [QSA,L]
+
+# In case Rails experiences terminal errors
+# Instead of displaying this message you can supply a file here which will be rendered instead
+# 
+# Example:
+#   ErrorDocument 500 /500.html
+
+ErrorDocument 500 "<h2>Application error</h2>Rails application failed to start properly"
+
+
+== Debugging Rails
+
+Sometimes your application goes wrong.  Fortunately there are a lot of tools that
+will help you debug it and get it back on the rails.
+
+First area to check is the application log files.  Have "tail -f" commands running
+on the server.log and development.log. Rails will automatically display debugging
+and runtime information to these files. Debugging info will also be shown in the
+browser on requests from 127.0.0.1.
+
+You can also log your own messages directly into the log file from your code using
+the Ruby logger class from inside your controllers. Example:
+
+  class WeblogController < ActionController::Base
+    def destroy
+      @weblog = Weblog.find(params[:id])
+      @weblog.destroy
+      logger.info("#{Time.now} Destroyed Weblog ID ##{@weblog.id}!")
+    end
+  end
+
+The result will be a message in your log file along the lines of:
+
+  Mon Oct 08 14:22:29 +1000 2007 Destroyed Weblog ID #1
+
+More information on how to use the logger is at http://www.ruby-doc.org/core/
+
+Also, Ruby documentation can be found at http://www.ruby-lang.org/ including:
+
+* The Learning Ruby (Pickaxe) Book: http://www.ruby-doc.org/docs/ProgrammingRuby/
+* Learn to Program: http://pine.fm/LearnToProgram/  (a beginners guide)
+
+These two online (and free) books will bring you up to speed on the Ruby language
+and also on programming in general.
+
+
+== Debugger
+
+Debugger support is available through the debugger command when you start your Mongrel or
+Webrick server with --debugger. This means that you can break out of execution at any point
+in the code, investigate and change the model, AND then resume execution! 
+You need to install ruby-debug to run the server in debugging mode. With gems, use 'gem install ruby-debug'
+Example:
+
+  class WeblogController < ActionController::Base
+    def index
+      @posts = Post.find(:all)
+      debugger
+    end
+  end
+
+So the controller will accept the action, run the first line, then present you
+with a IRB prompt in the server window. Here you can do things like:
+
+  >> @posts.inspect
+  => "[#<Post:0x14a6be8 @attributes={\"title\"=>nil, \"body\"=>nil, \"id\"=>\"1\"}>,
+       #<Post:0x14a6620 @attributes={\"title\"=>\"Rails you know!\", \"body\"=>\"Only ten..\", \"id\"=>\"2\"}>]"
+  >> @posts.first.title = "hello from a debugger"
+  => "hello from a debugger"
+
+...and even better is that you can examine how your runtime objects actually work:
+
+  >> f = @posts.first
+  => #<Post:0x13630c4 @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>
+  >> f.
+  Display all 152 possibilities? (y or n)
+
+Finally, when you're ready to resume execution, you enter "cont"
+
+
+== Console
+
+You can interact with the domain model by starting the console through <tt>script/console</tt>.
+Here you'll have all parts of the application configured, just like it is when the
+application is running. You can inspect domain models, change values, and save to the
+database. Starting the script without arguments will launch it in the development environment.
+Passing an argument will specify a different environment, like <tt>script/console production</tt>.
+
+To reload your controllers and models after launching the console run <tt>reload!</tt>
+
+== dbconsole
+
+You can go to the command line of your database directly through <tt>script/dbconsole</tt>.
+You would be connected to the database with the credentials defined in database.yml.
+Starting the script without arguments will connect you to the development database. Passing an
+argument will connect you to a different database, like <tt>script/dbconsole production</tt>.
+Currently works for mysql, postgresql and sqlite.
+
+== Description of Contents
+
+app
+  Holds all the code that's specific to this particular application.
+
+app/controllers
+  Holds controllers that should be named like weblogs_controller.rb for
+  automated URL mapping. All controllers should descend from ApplicationController
+  which itself descends from ActionController::Base.
+
+app/models
+  Holds models that should be named like post.rb.
+  Most models will descend from ActiveRecord::Base.
+
+app/views
+  Holds the template files for the view that should be named like
+  weblogs/index.html.erb for the WeblogsController#index action. All views use eRuby
+  syntax.
+
+app/views/layouts
+  Holds the template files for layouts to be used with views. This models the common
+  header/footer method of wrapping views. In your views, define a layout using the
+  <tt>layout :default</tt> and create a file named default.html.erb. Inside default.html.erb,
+  call <% yield %> to render the view using this layout.
+
+app/helpers
+  Holds view helpers that should be named like weblogs_helper.rb. These are generated
+  for you automatically when using script/generate for controllers. Helpers can be used to
+  wrap functionality for your views into methods.
+
+config
+  Configuration files for the Rails environment, the routing map, the database, and other dependencies.
+
+db
+  Contains the database schema in schema.rb.  db/migrate contains all
+  the sequence of Migrations for your schema.
+
+doc
+  This directory is where your application documentation will be stored when generated
+  using <tt>rake doc:app</tt>
+
+lib
+  Application specific libraries. Basically, any kind of custom code that doesn't
+  belong under controllers, models, or helpers. This directory is in the load path.
+
+public
+  The directory available for the web server. Contains subdirectories for images, stylesheets,
+  and javascripts. Also contains the dispatchers and the default HTML files. This should be
+  set as the DOCUMENT_ROOT of your web server.
+
+script
+  Helper scripts for automation and generation.
+
+test
+  Unit and functional tests along with fixtures. When using the script/generate scripts, template
+  test files will be generated for you and placed in this directory.
+
+vendor
+  External libraries that the application depends on. Also includes the plugins subdirectory.
+  If the app has frozen rails, those gems also go here, under vendor/rails/.
+  This directory is in the load path.

data/spec/test_application/Rakefile

@@ -0,0 +1,10 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require(File.join(File.dirname(__FILE__), 'config', 'boot'))
+
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+require 'tasks/rails'

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

@@ -0,0 +1,10 @@
+# Filters added to this controller apply to all controllers in the application.
+# Likewise, all the methods added will be available for all controllers.
+
+class ApplicationController < ActionController::Base
+  helper :all # include all helpers, all the time
+  protect_from_forgery # See ActionController::RequestForgeryProtection for details
+
+  # Scrub sensitive parameters from your log
+  # filter_parameter_logging :password
+end