CODEWITHSUNDEEP
ruby-on-railsautoloadruby-on-rails-5
Tobias
Tobias

Reputation: 4653

Load lib files in production

I've upgraded one of my apps from Rails 4.2.6 to Rails 5.0.0. The Upgrade Guide says, that the Autoload feature is now disabled in production by default.

Now I always get an error on my production server since I load all lib files with autoload in the application.rb file.

module MyApp
    class Application < Rails::Application
        config.autoload_paths += %W( lib/ )
    end
end

For now, I've set the config.enable_dependency_loading to true but I wonder if there is a better solution to this. There must be a reason that Autoloading is disabled in production by default.

Upvotes: 155

Views: 108317

Answers (13)

Marian13
Marian13

Reputation: 9238

config.autoload_lib (Rails 7.1+)

Starting from Rails 7.1, there is a new configuration method, config.autoload_lib(ignore:).

It significantly simplifies the loading of the lib folder.

# config/application.rb
config.autoload_lib(ignore: ["assets", "tasks", "generators"])

Sources:

Upvotes: 2

Tashows
Tashows

Reputation: 559

The only thing that worked for me is adding the nested lib path in eager load paths AND adding a require_dependency in a config.to_prepare block.

# application.rb
...
config.to_prepare do
  require_dependency("#{Rails.root}/lib/spree/core/product_filters.rb")
end

config.eager_load_paths << Rails.root.join('lib').join('spree').join('core')
...

Upvotes: 1

Michał Zalewski
Michał Zalewski

Reputation: 3368

I just used config.eager_load_paths instead of config.autoload_paths like mention akostadinov on github comment: https://github.com/rails/rails/issues/13142#issuecomment-275492070

# config/application.rb
...
# config.autoload_paths << Rails.root.join('lib')
config.eager_load_paths << Rails.root.join('lib')

It works on development and production environment.

Thanks Johan for suggestion to replace #{Rails.root}/lib with Rails.root.join('lib')!

Upvotes: 119

eprothro
eprothro

Reputation: 1117

I agree that some dependencies belong in lib and some may belong in app/lib.

I prefer to load all files I've chosen to put in lib for all environments, hence I do this in config/application.rb immediately after requiring the bundle but before opening the MyApplicationName module.

# load all ruby files in lib
Dir[File.expand_path('../../lib/**/*.rb', __FILE__)].each { |file| require file }

This doesn't depend on Rails.root (which isn't defined yet), and doesn't depend on eager loading (which may be off for an environment).

Upvotes: 2

Jitendra Rathor
Jitendra Rathor

Reputation: 686

Just change config.autoload_paths to config.eager_load_paths in config/application.rb file. Because in rails 5 autoloading is disabled for production environment by default. For more details please follow the link.

 #config.autoload_paths << "#{Rails.root}/lib"
  config.eager_load_paths << Rails.root.join('lib')

It works for both environment development and production.

Upvotes: 10

localhostdotdev
localhostdotdev

Reputation: 1895

to summarize Lev's answer: mv lib app was enough to have all my lib code autoloaded / auto-reloaded.

(rails 6.0.0beta3 but should work fine on rails 5.x too)

Upvotes: -8

pocheptsov
pocheptsov

Reputation: 1956

In some sense, here is a unified approach in Rails 5 to centralize eager and autoload configuration, in the same time it adds required autoload path whenever eager load is configured otherwise it won't be able to work correctly:

# config/application.rb
...
config.paths.add Rails.root.join('lib').to_s, eager_load: true

# as an example of autoload only config
config.paths.add Rails.root.join('domainpack').to_s, autoload: true
...

Upvotes: 5

srghma
srghma

Reputation: 5323

This allows to have lib autoreload, and works in production environment too.

P.S. I have changed my answer, now it adds to both eager- an autoload paths, regardless of environment, to allow work in custom environments too (like stage)

# config/initializers/load_lib.rb
...
config.eager_load_paths << Rails.root.join('lib')
config.autoload_paths << Rails.root.join('lib')
...

Upvotes: 13

Laurie
Laurie

Reputation: 162

Moving the lib folder to app helped solve a problem, my Twitter api would not run in production. I had "uninitialized constant TwitterApi" and my Twitter API was in my lib folder. I had config.autoload_paths += Dir["#{Rails.root}/app/lib"] in my application.rb but it didn't work before moving the folder.

This did the trick

Upvotes: 0

Lev Lukomskyi
Lev Lukomskyi

Reputation: 6667

My list of changes after moving to Rails 5:

  1. Place lib dir into app because all code inside app is autoloaded in dev and eager loaded in prod and most importantly is autoreloaded in development so you don't have to restart server each time you make changes.
  2. Remove any require statements pointing to your own classes inside lib because they all are autoloaded anyway if their file/dir naming are correct, and if you leave require statements it can break autoreloading. More info here
  3. Set config.eager_load = true in all environments to see code loading problems eagerly in dev.
  4. Use Rails.application.eager_load! before playing with threads to avoid "circular dependency" errors.

  5. If you have any ruby/rails extensions then leave that code inside old lib directory and load them manually from initializer. This will ensure that extensions are loaded before your further logic that can depend on it:

    # config/initializers/extensions.rb
Dir["#{Rails.root}/lib/ruby_ext/*.rb"].each { |file| require file }
Dir["#{Rails.root}/lib/rails_ext/*.rb"].each { |file| require file }

Upvotes: 178

Abdullah Barrak
Abdullah Barrak

Reputation: 151

For anyone struggled with this like me, it's not enough to just place a directory under app/. Yes, you'll get autoloading but not necessary reloading, which requires namespacing conventions to be fulfilled.

Also, using initializer for loading old root-level lib will prevent reloading feature during development.

Upvotes: 2

Tobias
Tobias

Reputation: 4653

Autoloading is disabled in the production environment because of thread safety. Thank you to @Зелёный for the link.

I solved this problem by storing the lib files in a lib folder in my app directory as recommended on Github. Every folder in the app folder gets loaded by Rails automatically.

Upvotes: 40

Roman Kiselenko
Roman Kiselenko

Reputation: 44360

There must be a reason that Autoloading is disabled in production by default.

Here is a long discussion about this issue. https://github.com/rails/rails/issues/13142

Upvotes: 24

Related Questions