модуль Rails

Railties — объединение `Engine` с Rails

Railties отвечает за объединение всех фреймворков. В целом он:

управляет процессом загрузки приложения Rails;
управляет интерфейсом командной строки rails;
и предоставляет ядро генераторов Rails.

Загрузка

Последнюю версию Railties можно установить с помощью RubyGems:

gem install railties

Исходный код можно загрузить в составе проекта Rails на GitHub

github.com/rails/rails/tree/main/railties

Лицензия

Railties распространяется по лицензии MIT:

opensource.org/licenses/MIT

Поддержка

Документация API доступна по адресу

api.rubyonrails.org

Сообщения об ошибках в проекте Ruby on Rails можно отправлять здесь:

github.com/rails/rails/issues

Предложения по новым функциям следует обсуждать на форуме rubyonrails-core здесь:

discuss.rubyonrails.org/c/rubyonrails-core

Атрибуты

Открытые методы класса

application () Показать исходный код

# File railties/lib/rails.rb, line 44
def application
  @application ||= (app_class.instance if app_class)
end

autoloaders () Показать исходный код

# File railties/lib/rails.rb, line 133
def autoloaders
  application.autoloaders
end

backtrace_cleaner () Показать исходный код

# File railties/lib/rails.rb, line 55
def backtrace_cleaner
  @backtrace_cleaner ||= Rails::BacktraceCleaner.new
end

configuration () Показать исходный код

# File railties/lib/rails.rb, line 51
def configuration
  application.config
end

Экземпляр Configuration, используемый для настройки среды Rails

env () Показать исходный код

# File railties/lib/rails.rb, line 74
def env
  @_env ||= ActiveSupport::EnvironmentInquirer.new(ENV["RAILS_ENV"].presence || ENV["RACK_ENV"].presence || "development")
end

Возвращает текущую среду Rails.

Rails.env # => "development"
Rails.env.development? # => true
Rails.env.production? # => false
Rails.env.local? # => true              true for "development" and "test", false for anything else

env= (environment) Показать исходный код

# File railties/lib/rails.rb, line 81
def env=(environment)
  @_env = ActiveSupport::EnvironmentInquirer.new(environment)
end

Устанавливает среду Rails.

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

error () Показать исходный код

# File railties/lib/rails.rb, line 92
def error
  ActiveSupport.error_reporter
end

Возвращает ActiveSupport::ErrorReporter текущего проекта Rails; если проекта нет, возвращает nil.

Rails.error.handle(IOError) do
  # ...
end
Rails.error.report(error)

event () Показать исходный код

# File railties/lib/rails.rb, line 100
def event
  ActiveSupport.event_reporter
end

Возвращает ActiveSupport::EventReporter текущего проекта Rails; если проекта нет, возвращает nil.

Rails.event.notify("my_event", { message: "Hello, world!" })

gem_version () Показать исходный код

# File railties/lib/rails/gem_version.rb, line 5
def self.gem_version
  Gem::Version.new VERSION::STRING
end

Возвращает текущую загруженную версию Rails в виде Gem::Version.

groups (*groups) Показать исходный код

# File railties/lib/rails.rb, line 113
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

Возвращает все группы Rails для загрузки на основе:

среды Rails;
переменной среды RAILS_GROUPS;
необязательных сред, переданных в качестве аргумента, и хеша с зависимостями групп;

Rails.groups assets: [:development, :test]
# => [:default, "development", :assets] for Rails.env == "development"
# => [:default, "production"]           for Rails.env == "production"

public_path () Показать исходный код

# File railties/lib/rails.rb, line 129
def public_path
  application && Pathname.new(application.paths["public"].first)
end

Возвращает объект Pathname, соответствующий папке public текущего проекта Rails; если проекта нет, возвращает nil:

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

root () Показать исходный код

# File railties/lib/rails.rb, line 64
def root
  application && application.config.root
end

Возвращает объект Pathname, соответствующий текущему проекту Rails; если проекта нет, возвращает nil:

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

version () Показать исходный код

# File railties/lib/rails/version.rb, line 7
def self.version
  VERSION::STRING
end

Возвращает текущую загруженную версию Rails в виде строки.

модуль Rails

Railties — объединение Engine с Rails

Загрузка

Лицензия

Поддержка

Railties — объединение `Engine` с Rails