# Foodcoop-specific configuration. # # This is loaded from +config/app_config.yml+, which contains a root # key for each environment (plus an optional +defaults+ key). When using # the multicoops feature (+multicoops+ is set to +true+ for the environment), # each foodcoop has its own key. # # In addition to the configuration file, values can be overridden in the database # using {RailsSettings::CachedSettings} as +foodcoop..**+. # # Some values may not be set in the database (e.g. the database connection to # sharedlists, or +default_scope+), these are defined as children of the # +protected+ key. The default contains a sensible list, but you can modify # that. Here's an almost minimal example: # # default: # default_scope: f # host: order.foodstuff.test # hostname for urls in emails # # name: Fairy Foodstuff # the name of our foodcoop # contact: # # ... # email: fairy@foodstuff.test # general contact email address # # price_markup: 6 # foodcoop margin # # protected: # shared_lists: false # allow database connection override # use_messages: true # foodcoops can't disable the use of messages # class FoodsoftConfig # @!attribute scope # Returns the current foodcoop scope for the multicoops feature, otherwise # the value of the foodcoop configuration key +default_scope+ is used. # @return [String] The current foodcoop scope. mattr_accessor :scope # @!attribute config # Returns a {ActiveSupport::HashWithIndifferentAccess Hash} with the current # scope's configuration from the configuration file. Note that this does not # include values that were changed in the database. # @return [ActiveSupport::HashWithIndifferentAccess] Current configuration from configuration file. mattr_accessor :config # Configuration file location. # Taken from environment variable +FOODSOFT_APP_CONFIG+, # or else +config/app_config.yml+. APP_CONFIG_FILE = ENV['FOODSOFT_APP_CONFIG'] || 'config/app_config.yml' # Rails.logger isn't ready yet - and we don't want to litter rspec invocation with this msg puts "-> Loading app configuration from #{APP_CONFIG_FILE}" unless defined? RSpec # Loaded configuration APP_CONFIG = ActiveSupport::HashWithIndifferentAccess.new( YAML.load(File.read(File.expand_path(APP_CONFIG_FILE, Rails.root))) ) class << self def init # Gather program-default configuration self.default_config = get_default_config # Load initial config from development or production set_config Rails.env # Overwrite scope to have a better namescope than 'production' self.scope = config[:default_scope] or raise "No default_scope is set" # Set defaults for backward-compatibility set_missing end # Set config and database connection for specific foodcoop. # # Only needed in multi coop mode. # @param foodcoop [String, Symbol] Foodcoop to select. def select_foodcoop(foodcoop) set_config foodcoop setup_database end # Return configuration value for the currently selected foodcoop. # # First tries to read configuration from the database (cached), # then from the configuration files. # # FoodsoftConfig[:name] # => 'FC Test' # # To avoid errors when the database is not yet setup (when loading # the initial database schema), cached settings are only being read # when the settings table exists. # # @param key [String, Symbol] # @return [Object] Value of the key. def [](key) if RailsSettings::CachedSettings.table_exists? and allowed_key?(key) value = RailsSettings::CachedSettings["foodcoop.#{self.scope}.#{key}"] value = config[key] if value.nil? value else config[key] end end # Store configuration in the database. # # If value is equal to what's defined in the configuration file, remove key from the database. # @param key [String, Symbol] Key # @param value [Object] Value # @return [Boolean] Whether storing succeeded (fails when key is not allowed to be set in database). def []=(key, value) return false unless allowed_key?(key) # try to figure out type ... value = case value when 'true' then true when 'false' then false when /^[-+0-9]+$/ then value.to_i when /^[-+0-9.]+([eE][-+0-9]+)?$/ then value.to_f when '' then nil else value end # then update database if config[key] == value or (config[key].nil? and value == false) # delete (ok if it was already deleted) begin RailsSettings::CachedSettings.destroy "foodcoop.#{self.scope}.#{key}" rescue RailsSettings::Settings::SettingNotFound end else # or store RailsSettings::CachedSettings["foodcoop.#{self.scope}.#{key}"] = value end return true end # @return [Array] Configuration keys that are set (either in +app_config.yml+ or database). def keys keys = RailsSettings::CachedSettings.get_all("foodcoop.#{self.scope}.").try(:keys) || [] keys.map! {|k| k.gsub /^foodcoop\.#{self.scope}\./, ''} keys += config.keys keys.map(&:to_s).uniq end # Loop through each foodcoop and executes the given block after setup config and database def each_coop if config[:multi_coop_install] APP_CONFIG.keys.reject { |coop| coop =~ /^(default|development|test|production)$/ }.each do |coop| select_foodcoop coop yield coop end else yield config[:default_scope] end end # @return [Boolean] Whether this key may be set in the database def allowed_key?(key) # fast check for keys without nesting return !self.config[:protected][key] # @todo allow to check nested keys as well end # @return [Hash] Full configuration. def to_hash Hash[keys.map {|k| [k, self[k]]} ] end protected # @!attribute default_config # Returns the program-default foodcoop configuration. # # Plugins (engines in Rails terms) can easily add to the default # configuration by defining a method +default_foodsoft_config+ in # their engine and modify the {Hash} passed. # # When modifying this, please make sure to use default values that # match old behaviour. For example, when the wiki was made optional # and turned into a plugin, the configuration item +use_wiki+ was # introduced with a default value of +true+ (set in the wiki plugin): # # module FoodsoftWiki # class Engine < ::Rails::Engine # def default_foodsoft_config(cfg) # cfg[:use_wiki] = true # keep backward compatibility # end # end # end # # @return [Hash] Default configuration values mattr_accessor :default_config # Reload original configuration file, e.g. in between tests. # @param filename [String] Override configuration file def reload!(filename = APP_CONFIG_FILE) APP_CONFIG.clear.merge! YAML.load(File.read(File.expand_path(filename, Rails.root))) init end private def set_config(foodcoop) raise "No config for this environment (#{foodcoop}) available!" if APP_CONFIG[foodcoop].nil? self.config = APP_CONFIG[foodcoop] self.scope = foodcoop set_missing end def setup_database database_config = ActiveRecord::Base.configurations[Rails.env] database_config = database_config.merge(config[:database]) if config[:database].present? ActiveRecord::Base.establish_connection(database_config) end # Completes foodcoop configuration with program defaults. # @see #foodsoft_config def set_missing config.replace(default_config.deep_merge(config)) end # Returns program-default configuration. # When new options are introduced, put backward-compatible defaults here, so that # configuration files that haven't been updated, still work as they did. This also # makes sure that the configuration editor picks up the defaults. # @return [Hash] Program-default foodcoop configuration. # @see #default_config # @see #set_missing def get_default_config cfg = { use_nick: true, use_apple_points: true, # English is the default language, and this makes it show up as default. default_locale: 'en', foodsoft_url: 'https://github.com/foodcoops/foodsoft', # The following keys cannot, by default, be set by foodcoops themselves. protected: { multi_coop_install: true, default_scope: true, notification: true, shared_lists: true, protected: true, database: true } } # allow engines to easily add to this engines = Rails::Engine::Railties.engines.select { |e| e.respond_to?(:default_foodsoft_config) } engines.each { |e| e.default_foodsoft_config(cfg) } cfg end end end