Skip to content

Commit

Permalink
FIX: fails loud if default setting is not set
Browse files Browse the repository at this point in the history
Noted:
- `push_api_secret_key` is set in initializer. Shimed with ''
- `default_theme_key` is set in seeding. Shimed with ''
  • Loading branch information
erickguan committed Aug 15, 2017
1 parent 506572b commit 1646bc0
Show file tree
Hide file tree
Showing 5 changed files with 56 additions and 2 deletions.
2 changes: 2 additions & 0 deletions config/site_settings.yml
Original file line number Diff line number Diff line change
Expand Up @@ -187,6 +187,7 @@ basic:
client: true
default: true
default_theme_key:
default: ''
hidden: true
relative_date_duration:
client: true
Expand Down Expand Up @@ -1414,6 +1415,7 @@ user_api:
max_api_keys_per_user:
default: 10
push_api_secret_key:
default: ''
hidden: true
min_trust_level_for_user_api_key:
default: 1
Expand Down
6 changes: 4 additions & 2 deletions lib/site_settings/yaml_loader.rb
Original file line number Diff line number Diff line change
Expand Up @@ -13,11 +13,13 @@ def load
# Get default value for the site setting:
value = hash.delete('default')
if value.is_a?(Hash)
raise Discourse::Deprecation, "Site setting per env is no longer supported. Error setting: #{setting_name}"
raise Discourse::Deprecation, "The site setting `#{setting_name}` can no longer be set based on Rails environment. See also `config/environments/<env>.rb`."
elsif value.nil?
raise StandardError, "The site setting `#{setting_name}` is missing default value."
end

if hash['hidden']&.is_a?(Hash)
raise Discourse::Deprecation, "Hidden site setting per env is no longer supported. Error setting: #{setting_name}"
raise Discourse::Deprecation, "The site setting `#{setting_name}`'s hidden property can no longer be set based on Rails environment. It can only be either `true` or `false`."
end

yield category, setting_name, value, hash.deep_symbolize_keys!
Expand Down
5 changes: 5 additions & 0 deletions spec/components/site_settings/yaml_loader_spec.rb
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ def setting(category, name, default = nil, opts = {})
let(:deprecated_env) { "#{Rails.root}/spec/fixtures/site_settings/deprecated_env.yml" }
let(:deprecated_hidden) { "#{Rails.root}/spec/fixtures/site_settings/deprecated_hidden.yml" }
let(:locale_default) { "#{Rails.root}/spec/fixtures/site_settings/locale_default.yml" }
let(:nil_default) { "#{Rails.root}/spec/fixtures/site_settings/nil_default.yml" }

it "loads simple settings" do
receiver.expects(:setting).with('category1', 'title', 'My Site', {}).once
Expand Down Expand Up @@ -77,6 +78,10 @@ def setting(category, name, default = nil, opts = {})
expect { receiver.load_yaml(deprecated_hidden) }.to raise_error(Discourse::Deprecation)
end

it "raises invalid parameter when default value is not present" do
expect { receiver.load_yaml(nil_default) }.to raise_error(StandardError)
end

it "can load settings with locale default" do
receiver.expects(:setting).with('search', 'min_search_term_length', 3, min: 2, client: true, locale_default: { zh_CN: 2, zh_TW: 2 })
receiver.load_yaml(locale_default)
Expand Down
3 changes: 3 additions & 0 deletions spec/fixtures/site_settings/nil_default.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
category1:
title:
hidden: true
42 changes: 42 additions & 0 deletions spec/integrity/site_setting_spec.rb
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
require "rails_helper"
require "i18n/duplicate_key_finder"

describe "site setting integrity checks" do
let(:site_setting_file) { File.join(Rails.root, 'config', 'site_settings.yml') }
let(:yaml) { YAML.load_file(site_setting_file) }

%w(hidden client).each do |property|
it "set #{property} value as true or not set" do
yaml.each_value do |category|
category.each_value do |setting|
next unless setting.is_a?(Hash)
expect(setting[property] == nil || setting[property] == true).to be_truthy
end
end
end
end

it "has no duplicate keys" do
duplicates = DuplicateKeyFinder.new.find_duplicates(site_setting_file)
expect(duplicates).to be_empty
end

it "no locale default has different type than default or invalid key" do
yaml.each_value do |category|
category.each_value do |setting|
next unless setting.is_a?(Hash)
if setting['locale_default']
setting['locale_default'].each_pair do |k, v|
expect(LocaleSiteSetting.valid_value?(k.to_s)).to be_truthy
case setting['default']
when TrueClass, FalseClass
expect(v.class == TrueClass || v.class == FalseClass).to be_truthy
else
expect(v).to be_a_kind_of(setting['default'].class)
end
end
end
end
end
end
end

0 comments on commit 1646bc0

Please sign in to comment.