use 'defaults' scope for the attributes that used across several models

CHANGELOG.md

@@ -1,3 +1,28 @@
+## master
+
+### enhancements
+  * Use 'defaults' scope in the localization file for the attributes that used across several models. This will help to avoid conflicting keys with model names and attribute names. Example:
+
+  ```yml
+    en:
+      enumerize:
+        defaults:
+          sex:
+            male: Male
+            female: Female
+  ```
+
+  You still can use the old solution without "default" scope:
+
+  ```yml
+    en:
+      enumerize:
+        sex:
+          male: Male
+          female: Female
+  ```
+  (by [@nashby](https://github.com/nashby))
+
 ## 0.8.0 (March 4, 2014) ##
 
 ### enhancements

README.md

@@ -78,14 +78,15 @@ en:
         female: "Female"
 ```
 
-or if you use `sex` attribute across several models you can use this:
+or if you use `sex` attribute across several models you can use `defaults` scope:
 
 ```ruby
 en:
   enumerize:
-    sex:
-      male: "Male"
-      female: "Female"
+    defaults:
+      sex:
+        male: "Male"
+        female: "Female"
 ```
 
 You can also pass `i18n_scope` option to specify scope (or array of scopes) storring the translations. Note that `i18n_scope` option does not accept scope as array:

lib/enumerize/value.rb

@@ -34,6 +34,7 @@ def #{value}?
     def i18n_keys
       @i18n_keys ||= begin
         i18n_keys = i18n_scopes
+        i18n_keys << [:"enumerize.defaults.#{@attr.name}.#{self}"]
         i18n_keys << [:"enumerize.#{@attr.name}.#{self}"]
         i18n_keys << self.humanize # humanize value if there are no translations
         i18n_keys.flatten

test/value_test.rb

@@ -21,6 +21,12 @@
       end
     end
 
+    it 'uses default translation from the "default" section if its present' do
+      store_translations(:en, :enumerize => {:defaults => {:attribute_name => {:test_value => "Common translation"}}}) do
+        value.text.must_be :==, "Common translation"
+      end
+    end
+
     it 'uses model specific translation' do
       attr.i18n_scopes = ["enumerize.model_name.attribute_name"]