Methods
A
B
C
D
E
G
I
J
K
N
R
S
Constants
DATABASES = %w( mysql oracle postgresql sqlite3 frontbase ibm_db sqlserver )
 
JDBC_DATABASES = %w( jdbcmysql jdbcsqlite3 jdbcpostgresql jdbc )
 
Attributes
[RW] rails_template
Class Public methods
add_shared_options_for(name)
# File railties/lib/rails/generators/app_base.rb, line 21
def self.add_shared_options_for(name)
  class_option :builder,            :type => :string, :aliases => "-b",
                                    :desc => "Path to a #{name} builder (can be a filesystem path or URL)"

  class_option :template,           :type => :string, :aliases => "-m",
                                    :desc => "Path to an #{name} template (can be a filesystem path or URL)"

  class_option :skip_gemfile,       :type => :boolean, :default => false,
                                    :desc => "Don't create a Gemfile"

  class_option :skip_bundle,        :type => :boolean, :default => false,
                                    :desc => "Don't run bundle install"

  class_option :skip_git,           :type => :boolean, :aliases => "-G", :default => false,
                                    :desc => "Skip Git ignores and keeps"

  class_option :skip_active_record, :type => :boolean, :aliases => "-O", :default => false,
                                    :desc => "Skip Active Record files"

  class_option :skip_sprockets,     :type => :boolean, :aliases => "-S", :default => false,
                                    :desc => "Skip Sprockets files"

  class_option :database,           :type => :string, :aliases => "-d", :default => "sqlite3",
                                    :desc => "Preconfigure for selected database (options: #{DATABASES.join('/')})"

  class_option :javascript,         :type => :string, :aliases => '-j', :default => 'jquery',
                                    :desc => 'Preconfigure for selected JavaScript library'

  class_option :skip_javascript,    :type => :boolean, :aliases => "-J", :default => false,
                                    :desc => "Skip JavaScript files"

  class_option :dev,                :type => :boolean, :default => false,
                                    :desc => "Setup the #{name} with Gemfile pointing to your Rails checkout"

  class_option :edge,               :type => :boolean, :default => false,
                                    :desc => "Setup the #{name} with Gemfile pointing to Rails repository"

  class_option :skip_test_unit,     :type => :boolean, :aliases => "-T", :default => false,
                                    :desc => "Skip Test::Unit files"

  class_option :help,               :type => :boolean, :aliases => "-h", :group => :rails,
                                    :desc => "Show this help message and quit"

  class_option :old_style_hash,     :type => :boolean, :default => false,
                                    :desc => "Force using old style hash (:foo => 'bar') on Ruby >= 1.9"
end
new(*args)
# File railties/lib/rails/generators/app_base.rb, line 68
def initialize(*args)
  @original_wd = Dir.pwd
  super
  convert_database_option_for_jruby
end
Instance Protected methods
apply_rails_template()
# File railties/lib/rails/generators/app_base.rb, line 108
def apply_rails_template
  apply rails_template if rails_template
rescue Thor::Error, LoadError, Errno::ENOENT => e
  raise Error, "The template [#{rails_template}] could not be loaded. Error: #{e}"
end
assets_gemfile_entry()
# File railties/lib/rails/generators/app_base.rb, line 195
def assets_gemfile_entry
  return if options[:skip_sprockets]

  gemfile = if options.dev? || options.edge?
    <<-GEMFILE
      # Gems used only for assets and not required
      # in production environments by default.
      group :assets do
        gem 'sass-rails',   :git => 'git://github.com/rails/sass-rails.git', :branch => '3-2-stable'
        gem 'coffee-rails', :git => 'git://github.com/rails/coffee-rails.git', :branch => '3-2-stable'

        # See https://github.com/sstephenson/execjs#readme for more supported runtimes
        #{javascript_runtime_gemfile_entry}
        gem 'uglifier', '>= 1.0.3'
      end
    GEMFILE
  else
    <<-GEMFILE
      # Gems used only for assets and not required
      # in production environments by default.
      group :assets do
        gem 'sass-rails',   '~> 3.2.3'
        gem 'coffee-rails', '~> 3.2.1'

        # See https://github.com/sstephenson/execjs#readme for more supported runtimes
        #{javascript_runtime_gemfile_entry}
        gem 'uglifier', '>= 1.0.3'
      end
    GEMFILE
  end

  gemfile.strip_heredoc.gsub(/^[ \t]*$/, '')
end
build(meth, *args)
# File railties/lib/rails/generators/app_base.rb, line 95
def build(meth, *args)
  builder.send(meth, *args) if builder.respond_to?(meth)
end
builder()
# File railties/lib/rails/generators/app_base.rb, line 76
def builder
  @builder ||= begin
    if path = options[:builder]
      if URI(path).is_a?(URI::HTTP)
        contents = open(path, "Accept" => "application/x-thor-template") {|io| io.read }
      else
        contents = open(File.expand_path(path, @original_wd)) {|io| io.read }
      end

      prok = eval("proc { #{contents} }", TOPLEVEL_BINDING, path, 1)
      instance_eval(&prok)
    end

    builder_class = get_builder_class
    builder_class.send(:include, ActionMethods)
    builder_class.new(self)
  end
end
bundle_command(command)
# File railties/lib/rails/generators/app_base.rb, line 241
def bundle_command(command)
  say_status :run, "bundle #{command}"

  # We are going to shell out rather than invoking Bundler::CLI.new(command)
  # because `rails new` loads the Thor gem and on the other hand bundler uses
  # its own vendored Thor, which could be a different version. Running both
  # things in the same process is a recipe for a night with paracetamol.
  #
  # We use backticks and #print here instead of vanilla #system because it
  # is easier to silence stdout in the existing test suite this way. The
  # end-user gets the bundler commands called anyway, so no big deal.
  #
  # Thanks to James Tucker for the Gem tricks involved in this call.
  print %x"#{Gem.ruby}" -rubygems "#{Gem.bin_path('bundler', 'bundle')}" #{command}`
end
comment_if(value)
# File railties/lib/rails/generators/app_base.rb, line 133
def comment_if(value)
  options[value] ? '# ' : ''
end
convert_database_option_for_jruby()
# File railties/lib/rails/generators/app_base.rb, line 176
def convert_database_option_for_jruby
  if defined?(JRUBY_VERSION)
    case options[:database]
    when "oracle"     then options[:database].replace "jdbc"
    when "postgresql" then options[:database].replace "jdbcpostgresql"
    when "mysql"      then options[:database].replace "jdbcmysql"
    when "sqlite3"    then options[:database].replace "jdbcsqlite3"
    end
  end
end
create_root()
# File railties/lib/rails/generators/app_base.rb, line 99
def create_root
  self.destination_root = File.expand_path(app_path, destination_root)
  valid_const?

  empty_directory '.'
  set_default_accessors!
  FileUtils.cd(destination_root) unless options[:pretend]
end
database_gemfile_entry()
# File railties/lib/rails/generators/app_base.rb, line 125
def database_gemfile_entry
  options[:skip_active_record] ? "" : "gem '#{gem_for_database}'\n"
end
empty_directory_with_gitkeep(destination, config = {})
# File railties/lib/rails/generators/app_base.rb, line 261
def empty_directory_with_gitkeep(destination, config = {})
  empty_directory(destination, config)
  git_keep(destination)
end
gem_for_database()
# File railties/lib/rails/generators/app_base.rb, line 160
def gem_for_database
  # %w( mysql oracle postgresql sqlite3 frontbase ibm_db sqlserver jdbcmysql jdbcsqlite3 jdbcpostgresql )
  case options[:database]
  when "oracle"         then "ruby-oci8"
  when "postgresql"     then "pg"
  when "frontbase"      then "ruby-frontbase"
  when "mysql"          then "mysql2"
  when "sqlserver"      then "activerecord-sqlserver-adapter"
  when "jdbcmysql"      then "activerecord-jdbcmysql-adapter"
  when "jdbcsqlite3"    then "activerecord-jdbcsqlite3-adapter"
  when "jdbcpostgresql" then "activerecord-jdbcpostgresql-adapter"
  when "jdbc"           then "activerecord-jdbc-adapter"
  else options[:database]
  end
end
git_keep(destination)
# File railties/lib/rails/generators/app_base.rb, line 266
def git_keep(destination)
  create_file("#{destination}/.gitkeep") unless options[:skip_git]
end
include_all_railties?()
# File railties/lib/rails/generators/app_base.rb, line 129
def include_all_railties?
  !options[:skip_active_record] && !options[:skip_test_unit] && !options[:skip_sprockets]
end
javascript_gemfile_entry()
# File railties/lib/rails/generators/app_base.rb, line 229
def javascript_gemfile_entry
  "gem '#{options[:javascript]}-rails'" unless options[:skip_javascript]
end
javascript_runtime_gemfile_entry()
# File railties/lib/rails/generators/app_base.rb, line 233
def javascript_runtime_gemfile_entry
  if defined?(JRUBY_VERSION)
    "gem 'therubyrhino'\n"
  else
    "# gem 'therubyracer', :platforms => :ruby\n"
  end
end
key_value(key, value)

Returns Ruby 1.9 style key-value pair if current code is running on Ruby 1.9.x. Returns the old-style (with hash rocket) otherwise.

# File railties/lib/rails/generators/app_base.rb, line 272
def key_value(key, value)
  if options[:old_style_hash] || RUBY_VERSION < '1.9'
    ":#{key} => #{value}"
  else
    "#{key}: #{value}"
  end
end
rails_gemfile_entry()
# File railties/lib/rails/generators/app_base.rb, line 137
      def rails_gemfile_entry
        if options.dev?
          "            gem 'rails',     :path => '#{Rails::Generators::RAILS_DEV_PATH}'
            gem 'journey',   :git => 'git://github.com/rails/journey.git', :branch => '1-0-stable'
            gem 'arel',      :git => 'git://github.com/rails/arel.git', :branch => '3-0-stable'
".strip_heredoc
        elsif options.edge?
          "            gem 'rails',     :git => 'git://github.com/rails/rails.git', :branch => '3-2-stable'
            gem 'journey',   :git => 'git://github.com/rails/journey.git', :branch => '1-0-stable'
            gem 'arel',      :git => 'git://github.com/rails/arel.git', :branch => '3-0-stable'
".strip_heredoc
        else
          "            gem 'rails', '#{Rails::VERSION::STRING}'

            # Bundle edge Rails instead:
            # gem 'rails', :git => 'git://github.com/rails/rails.git'
".strip_heredoc
        end
      end
ruby_debugger_gemfile_entry()
# File railties/lib/rails/generators/app_base.rb, line 187
def ruby_debugger_gemfile_entry
  if RUBY_VERSION < "1.9"
    "gem 'ruby-debug'"
  else
    "gem 'debugger'"
  end
end
run_bundle()
# File railties/lib/rails/generators/app_base.rb, line 257
def run_bundle
  bundle_command('install') unless options[:skip_gemfile] || options[:skip_bundle]
end
set_default_accessors!()
# File railties/lib/rails/generators/app_base.rb, line 114
def set_default_accessors!
  self.rails_template = case options[:template]
    when /^https?:\/\//
      options[:template]
    when String
      File.expand_path(options[:template], Dir.pwd)
    else
      options[:template]
  end
end