Module: Rails

Extended by:
ActiveSupport::Autoload
Defined in:
lib/rails.rb,
lib/rails/info.rb,
lib/rails/rack.rb,
lib/rails/paths.rb,
lib/rails/engine.rb,
lib/rails/railtie.rb,
lib/rails/version.rb,
lib/rails/api/task.rb,
lib/rails/app_loader.rb,
lib/rails/generators.rb,
lib/rails/application.rb,
lib/rails/console/app.rb,
lib/rails/dev_caching.rb,
lib/rails/gem_version.rb,
lib/rails/rack/logger.rb,
lib/rails/configuration.rb,
lib/rails/initializable.rb,
lib/rails/commands/server.rb,
lib/rails/console/helpers.rb,
lib/rails/engine/railties.rb,
lib/rails/generators/base.rb,
lib/rails/commands/console.rb,
lib/rails/test_unit/runner.rb,
lib/rails/backtrace_cleaner.rb,
lib/rails/test_unit/railtie.rb,
lib/rails/commands/dbconsole.rb,
lib/rails/generators/actions.rb,
lib/rails/test_unit/reporter.rb,
lib/rails/commands/rake_proxy.rb,
lib/rails/generators/app_base.rb,
lib/rails/application/finisher.rb,
lib/rails/commands/application.rb,
lib/rails/engine/configuration.rb,
lib/rails/generators/migration.rb,
lib/rails/generators/test_case.rb,
lib/rails/railtie/configurable.rb,
lib/rails/application/bootstrap.rb,
lib/rails/engine/commands_tasks.rb,
lib/rails/generators/named_base.rb,
lib/rails/railtie/configuration.rb,
lib/rails/commands/commands_tasks.rb,
lib/rails/commands/console_helper.rb,
lib/rails/generators/active_model.rb,
lib/rails/generators/model_helpers.rb,
lib/rails/test_unit/line_filtering.rb,
lib/rails/application/configuration.rb,
lib/rails/application/routes_reloader.rb,
lib/rails/generators/resource_helpers.rb,
lib/rails/generators/testing/behaviour.rb,
lib/rails/generators/testing/assertions.rb,
lib/rails/generators/generated_attribute.rb,
lib/rails/generators/rails/app/app_generator.rb,
lib/rails/generators/actions/create_migration.rb,
lib/rails/application/default_middleware_stack.rb,
lib/rails/generators/rails/task/task_generator.rb,
lib/rails/generators/testing/setup_and_teardown.rb,
lib/rails/generators/rails/model/model_generator.rb,
lib/rails/generators/rails/assets/assets_generator.rb,
lib/rails/generators/rails/helper/helper_generator.rb,
lib/rails/generators/rails/plugin/plugin_generator.rb,
lib/rails/generators/rails/resource/resource_generator.rb,
lib/rails/generators/rails/scaffold/scaffold_generator.rb,
lib/rails/generators/rails/generator/generator_generator.rb,
lib/rails/generators/rails/migration/migration_generator.rb,
lib/rails/generators/rails/controller/controller_generator.rb,
lib/rails/generators/rails/resource_route/resource_route_generator.rb,
lib/rails/generators/rails/integration_test/integration_test_generator.rb,
lib/rails/generators/rails/scaffold_controller/scaffold_controller_generator.rb

Defined Under Namespace

Modules: API, ActionMethods, AppLoader, Configuration, ConsoleHelper, ConsoleMethods, DevCaching, Generators, Info, Initializable, LineFiltering, Paths, Rack, RakeProxy, TestUnit, VERSION Classes: AppBuilder, Application, ApplicationController, BacktraceCleaner, CommandsTasks, Console, DBConsole, Engine, InfoController, MailersController, PluginBuilder, Railtie, Server, TestUnitRailtie, TestUnitReporter, WelcomeController

Class Attribute Summary collapse

Class Method Summary collapse

Class Attribute Details

.app_classObject

Returns the value of attribute app_class


36
37
38
# File 'lib/rails.rb', line 36

def app_class
  @app_class
end

.applicationObject


37
38
39
# File 'lib/rails.rb', line 37

def application
  @application ||= (app_class.instance if app_class)
end

.cacheObject

Returns the value of attribute cache


36
37
38
# File 'lib/rails.rb', line 36

def cache
  @cache
end

.loggerObject

Returns the value of attribute logger


36
37
38
# File 'lib/rails.rb', line 36

def logger
  @logger
end

Class Method Details

.backtrace_cleanerObject


48
49
50
51
52
53
54
# File 'lib/rails.rb', line 48

def backtrace_cleaner
  @backtrace_cleaner ||= begin
    # Relies on Active Support, so we have to lazy load to postpone definition until AS has been loaded
    require 'rails/backtrace_cleaner'
    Rails::BacktraceCleaner.new
  end
end

.configurationObject

The Configuration instance used to configure the Rails environment


44
45
46
# File 'lib/rails.rb', line 44

def configuration
  application.config
end

.envObject

Returns the current Rails environment.

Rails.env # => "development"
Rails.env.development? # => true
Rails.env.production? # => false

70
71
72
# File 'lib/rails.rb', line 70

def env
  @_env ||= ActiveSupport::StringInquirer.new(ENV["RAILS_ENV"].presence || ENV["RACK_ENV"].presence || "development")
end

.env=(environment) ⇒ Object

Sets the Rails environment.

Rails.env = "staging" # => "staging"

77
78
79
# File 'lib/rails.rb', line 77

def env=(environment)
  @_env = ActiveSupport::StringInquirer.new(environment)
end

.gem_versionObject

Returns the version of the currently loaded Rails as a Gem::Version


3
4
5
# File 'lib/rails/gem_version.rb', line 3

def self.gem_version
  Gem::Version.new VERSION::STRING
end

.groups(*groups) ⇒ Object

Returns all rails groups for loading based on:

  • The Rails environment;

  • The environment variable RAILS_GROUPS;

  • The optional envs given as argument and the hash with group dependencies;

    groups assets: [:development, :test]

    # Returns # => [:default, :development, :assets] for Rails.env == “development” # => [:default, :production] for Rails.env == “production”


92
93
94
95
96
97
98
99
100
101
# File 'lib/rails.rb', line 92

def groups(*groups)
  hash = groups.extract_options!
  env = Rails.env
  groups.unshift(:default, env)
  groups.concat ENV["RAILS_GROUPS"].to_s.split(",")
  groups.concat hash.map { |k, v| k if v.map(&:to_s).include?(env) }
  groups.compact!
  groups.uniq!
  groups
end

.public_pathObject

Returns a Pathname object of the public folder of the current rails project, otherwise it returns nil if there is no project:

Rails.public_path
  # => #<Pathname:/Users/someuser/some/path/project/public>

108
109
110
# File 'lib/rails.rb', line 108

def public_path
  application && Pathname.new(application.paths["public"].first)
end

.rootObject

Returns a Pathname object of the current rails project, otherwise it returns nil if there is no project:

Rails.root
  # => #<Pathname:/Users/someuser/some/path/project>

61
62
63
# File 'lib/rails.rb', line 61

def root
  application && application.config.root
end

.versionObject

Returns the version of the currently loaded Rails as a string.


5
6
7
# File 'lib/rails/version.rb', line 5

def self.version
  VERSION::STRING
end