123456789_123456789_123456789_123456789_123456789_

Class: Rails::Engine::Configuration

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Subclasses:
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
Instance Chain:
Inherits: Rails::Railtie::Configuration
Defined in: railties/lib/rails/engine/configuration.rb

Class Method Summary

Instance Attribute Summary

Instance Method Summary

::Rails::Railtie::Configuration - Inherited

#after_initialize

Last configurable block to run.

#app_generators

This allows you to modify application's generators from Railties.

#app_middleware

This allows you to modify the application's middlewares from Engines.

#before_configuration

First configurable block to run.

#before_eager_load

Third configurable block to run.

#before_initialize

Second configurable block to run.

#eager_load_namespaces

All namespaces that are eager loaded.

#respond_to?,
#to_prepare

Defines generic callbacks to run before #after_initialize.

#to_prepare_blocks

::Array of callbacks defined by #to_prepare.

#watchable_dirs

Add directories that should be watched for change.

#watchable_files

Add files that should be watched for change.

Constructor Details

.new(root = nil) ⇒ Configuration

[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 9

def initialize(root=nil)
  super()
  @root = root
  @generators = app_generators.dup
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Rails::Railtie::Configuration

Instance Attribute Details

#autoload_once_paths (rw)

[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 82

def autoload_once_paths
  @autoload_once_paths ||= paths.autoload_once
end

#autoload_once_paths=(value) (rw)

[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 7

attr_writer :middleware, :eager_load_paths, :autoload_once_paths, :autoload_paths

#autoload_paths (rw)

[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 86

def autoload_paths
  @autoload_paths ||= paths.autoload_paths
end

#autoload_paths=(value) (rw)

[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 7

attr_writer :middleware, :eager_load_paths, :autoload_once_paths, :autoload_paths

#eager_load_paths (rw)

[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 78

def eager_load_paths
  @eager_load_paths ||= paths.eager_load
end

#eager_load_paths=(value) (rw)

[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 7

attr_writer :middleware, :eager_load_paths, :autoload_once_paths, :autoload_paths

#middleware (rw)

Returns the middleware stack for the engine.

[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 16

def middleware
  @middleware ||= Rails::Configuration::MiddlewareStackProxy.new
end

#middleware=(value) (rw)

[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 7

attr_writer :middleware, :eager_load_paths, :autoload_once_paths, :autoload_paths

#root (rw)

[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 6

attr_reader :root

#root=(value) (rw)

[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 74

def root=(value)
  @root = paths.path = Pathname.new(value).expand_path
end

Instance Method Details

#generators {|@generators| ... }

Holds generators configuration:

config.generators do |g|
  g.orm             :data_mapper, migration: true
  g.template_engine :haml
  g.test_framework  :rspec
end

If you want to disable color in console, do:

config.generators.colorize_logging = false

Yields:

  • (@generators)
[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 32

def generators
  @generators ||= Rails::Configuration::Generators.new
  yield(@generators) if block_given?
  @generators
end

#paths

[ GitHub ]

  
# File 'railties/lib/rails/engine/configuration.rb', line 38

def paths
  @paths ||= begin
    paths = Rails::Paths::Root.new(@root)

    paths.add "app",                 eager_load: true, glob: "*"
    paths.add "app/assets",          glob: "*"
    paths.add "app/controllers",     eager_load: true
    paths.add "app/helpers",         eager_load: true
    paths.add "app/models",          eager_load: true
    paths.add "app/mailers",         eager_load: true
    paths.add "app/views"

    paths.add "app/controllers/concerns", eager_load: true
    paths.add "app/models/concerns",      eager_load: true

    paths.add "lib",                 load_path: true
    paths.add "lib/assets",          glob: "*"
    paths.add "lib/tasks",           glob: "**/*.rake"

    paths.add "config"
    paths.add "config/environments", glob: "#{Rails.env}.rb"
    paths.add "config/initializers", glob: "**/*.rb"
    paths.add "config/locales",      glob: "*.{rb,yml}"
    paths.add "config/routes.rb"

    paths.add "db"
    paths.add "db/migrate"
    paths.add "db/seeds.rb"

    paths.add "vendor",              load_path: true
    paths.add "vendor/assets",       glob: "*"

    paths
  end
end