Spec-Zone.ru › Ruby on Rails 7.1

модуль 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

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

  • discuss.rubyonrails.org/c/rubyonrails-core

Атрибуты

app_class[RW]
application[W]
cache[RW]
logger[RW]

Публичные методы класса

application() Показать исходный код
# File railties/lib/rails.rb, line 43
def application
  @application ||= (app_class.instance if app_class)
end
autoloaders() Показать исходный код
# File railties/lib/rails.rb, line 123
def autoloaders
  application.autoloaders
end
backtrace_cleaner() Показать исходный код
# File railties/lib/rails.rb, line 54
def backtrace_cleaner
  @backtrace_cleaner ||= Rails::BacktraceCleaner.new
end
configuration() Показать исходный код
# File railties/lib/rails.rb, line 50
def configuration
  application.config
end

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

env() Показать исходный код
# File railties/lib/rails.rb, line 72
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
env=(environment) Показать исходный код
# File railties/lib/rails.rb, line 79
def env=(environment)
  @_env = ActiveSupport::EnvironmentInquirer.new(environment)
end

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

Rails.env = "staging" # => "staging"
error() Показать исходный код
# File railties/lib/rails.rb, line 90
def error
  ActiveSupport.error_reporter
end

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

Rails.error.handle(IOError) do
  # ...
end
Rails.error.report(error)
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 103
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 119
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 63
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 как строку.

© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API