Skip to content

Settings are loaded before setup block executed #244

Open

Description

@supremebeing7

Version 2.0.0

I'm trying to use the use_env setting, but was noticing the override wasn't working. On closer inspection, it appears as if all of my settings are loaded prior to the Config.setup block being executed. I verified this by checking it in the initializer:

Config.setup do |config|
  config.const_name = 'Settings'
  config.use_env = true
  config.env_prefix = 'SETTINGS'
  config.env_separator = '__'
  config.env_converter = :downcase
  config.env_parse_values = true
end

puts ENV['SETTINGS__FOO']
# => baz

puts Settings.foo
# => bar

Settings.reload!

puts Settings.foo
# => baz

Has anyone else experienced this? I don't think it's due to any special setup for my particular app, but will try to spin up an example app to test.

Activity

  1. supremebeing7 commented on Jul 25, 2019

    @supremebeing7
    ContributorAuthor

    Reproduced this in an example app https://github.com/supremebeing7/example_config
    That one is on rails 6.0.0.rc1, the other app I experienced this is on rails 5.2.3.

  2. supremebeing7 commented on Jul 25, 2019

    @supremebeing7
    ContributorAuthor

    Worth mentioning also that the const_name override doesn't appear to work either, presumably for the same reason. The problem there is that it still won't work after Settings.reload! since that only reloads the settings and does not redefine any constants.

  3. supremebeing7 commented on Jul 25, 2019

    @supremebeing7
    ContributorAuthor

    OK, I think there's two issues here:

    1. I renamed the initializer to 01_config.rb, but in the railtie it's loading the specific config.rb file"
              initializer = ::Rails.root.join('config', 'initializers', 'config.rb')
              require initializer if File.exist?(initializer)
    1. I did the above rename because when I tried to access the Settings const in the config initializer, it complained of uninitialized constant Settings (NameError). (Related to Settings const name is not available right after Config.setup #187)

    Once I noticed the railtie from [1] above, then [2] makes sense, since the Config.setup method gets called as part of Config.load_and_set_settings after the initializer is already required.

    I'm not sure the best solution here...

    I do think some additional documentation around this would be helpful.

    However, I'm also wondering if maybe the config/initializers/config.rb should live just in config/config.rb? It seems very unintuitive to me to load/require an initializer in a railtie like that, though I admit I'm not super familiar with how similar projects load their settings. But I also think it is surprising not to allow using the settings constant defined in an initializer, as I assume once the initializer runs that Settings constant is defined. If the Config.setup block was not in an initializer but in config/config.rb, and we required it from there in the railtie, I think that would make more sense, and I could then add an initializer to do any manipulation to the settings (like adding sources at runtime, in the case of #187).

    @pkuczynski What do you think? I'm happy to work on this, just unsure what solution makes the most sense. Also open to other ideas than the ones I laid out.

  4. pkuczynski commented on Aug 6, 2019

    @pkuczynski
    Member

    Yeah, the whole point of the initializer is to define configuration options for the Config before the instance is created. The reason it's done this way was, that you don't need an initializer at all if you follow default setup, as Config is plugging into the rails automatically here: https://github.com/railsconfig/config/blob/master/lib/config.rb#L81

    Also see my comment in #187

    Question is: why would you like to access Settings in initializer? Is there a real need for it?

    Maybe we should update documentation. PR welcome :)

  5. added this to the 2.0.1 milestone on Aug 6, 2019
  6. supremebeing7 commented on Aug 7, 2019

    @supremebeing7
    ContributorAuthor

    Thanks for the clarification @pkuczynski.

    you don't need an initializer at all if you follow default setup, as Config is plugging into the rails automatically

    Makes sense! I think the default setup is great and wouldn't want to change how this works.

    Question is: why would you like to access Settings in initializer? Is there a real need for it?

    In my specific case, it was due to migrating from a different configuration gem where we had assigned config values to a constant APP_CONFIG. So, to avoid a messy migration path, in my initializer I just did APP_CONFIG = Settings.

    I'll be the first to admit that's probably not a common use case. A perhaps more common use case might be the add_source approach taken in #187. However, I still think it's odd to have an initializer get loaded like that. In my mind, initializers are run in the order they're placed in the initializers directory, so to have the Config.setup block in config/initializers/config.rb loaded before any of the initializers was very surprising.

    With the caveat that I'm not too familiar with how other projects like this are structured, to me it would make more sense to move the setup block to config/config.rb and load that in the railtie. Then there is no question of initializer load order.

    Obviously this would have to wait for the next minor version at least since it's a breaking change, though we could implement both approaches now and show a deprecation warning for the initializer approach to help ease the transition.

    I'm happy to work on this if that all seems reasonable. However if we think that's excessive or unnecessary and we just want to add more documentation around this, I can certainly do that instead.

  7. pkuczynski commented on Aug 7, 2019

    @pkuczynski
    Member

    As I mentioned the other day, I am mainly working on Node.js stack these days, so can't really say how modern app layout is done nowadays.

    Adding some more explanation to the Rails section of the documentation makes perfect sense if you could do that? Should be enough for now, as nobody else complained.

    @rdubya @pyromaniac what do you think about changing the behavior? I am personally not sure if that's worth the hassle...

  8. rdubya commented on Aug 8, 2019

    @rdubya
    Contributor

    It does seem like it would make sense to move it out of the initializers directory. We reference Settings in other initializers but not in the config initializer.

  9. pkuczynski commented on Aug 12, 2019

    @pkuczynski
    Member

    Then sure, we can work on this and release as 2.1. @supremebeing7 if you wanna take it over, go ahead.

  10. modified the milestones: 2.1.0, 2.2.0, 2.3.0 on Jan 3, 2020
  11. 6 remaining items

  12. pkuczynski commented on Mar 26, 2020

    @pkuczynski
    Member

    That's a shame, but I totally understand. Will keep this open and ping you in some time :)

  13. pkuczynski commented on Dec 8, 2020

    @pkuczynski
    Member

    @supremebeing7 how do you look with time now? :)

  14. supremebeing7 commented on Dec 8, 2020

    @supremebeing7
    ContributorAuthor

    @pkuczynski Still unavailable to work on this. FWIW: This is very low priority for me - after the initial setup, this issue has not come up again. So, unless someone else wants to pick this up, I'd be fine with closing it.

  15. removed their assignment
    on Dec 8, 2020
  16. pkuczynski commented on Dec 8, 2020

    @pkuczynski
    Member

    Got it! @cjlarose do you wanna have a look or shall we close it?

  17. cjlarose commented on Dec 8, 2020

    @cjlarose
    Member

    I can take a look.

  18. self-assigned this
    on Dec 8, 2020
  19. Wildanar06 commented on Dec 10, 2021

    @Wildanar06

    Itu memalukan, tapi aku benar-benar mengerti. Akan membuat ini tetap terbuka dan melakukan ping kepada Anda dalam beberapa waktu :)

    good job sir

  20. modified the milestones: 4.0.0, 4.0.1 on Jun 1, 2022
  21. modified the milestones: 4.1.0, Next on Dec 18, 2023
  22. cjlarose commented on Mar 6, 2024

    @cjlarose
    Member

    Taking another look at this recently since #352 is related. This issue brings up a couple of distinct, though related, points

    • In the default configuration for a Rails project, config/initializers/config.rb is executed twice on boot (once by the Railtie and once again when Rails loads all initializers).
    • In the default configuration for a Rails project, the Settings constant is not available in config/initializers/config.rb, though it is available in other initializers Settings const name is not available right after Config.setup #187
    • If the user goes with a different name for the initializer in a Rails project (such as 01_config.rb), things get especially weird, since while Settings is available in that initializer, it is populated by the call to load_and_set_settings as performed by the Railtie (and does not account for the user's own settings assuming they're calling Config.setup in the initializer).

    I think the solution is still the same: let's move configuration for the config gem to config/config.rb (really, anywhere outsides of initializers). This is a breaking change, but I think it's probably worth it and the migration should be pretty easy for most users.

  23. modified the milestones: 5.6.0, Next on Jul 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions