blueprinter 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 90196d2f88f21663e58a83d29f17e086b01ff4b4
-  data.tar.gz: d5773b0408dd8d11aede3f3970e618d43bc36990
+  metadata.gz: 56d342a22edbc9e7bc26d13d955b04a0a810a257
+  data.tar.gz: a6866070a40dc666f43bb04bb461a1065b45104b
 SHA512:
-  metadata.gz: efec9cf0d62ecd854144535b84cf421cfd34191b30aa8896bbd34753e75a172a056fefe6940ab94791d750f12e48838edb4a8a3e9dfb64fdfa10897877f9c2be
-  data.tar.gz: bb09550e791977703ec91448bab4da25781852b228f7c97feca16fde2a2c3273731bfac4c4906a83e95a278908347405a9d8f1fb5f346cd0997cffcbbb808d88
+  metadata.gz: 7f697e391cfc1ebf5ef3967ca73447b4ad96a2f1f5424289d865d096e7a24de84e97b19116e9c8cfdef16bac05dab71637c90c26c0d679d36b4823d3c855fb35
+  data.tar.gz: a2a88c85b099bf56c1eaa97eeb409d4aaec9567f8582cdd2abba34ea157abf21e3a7fb24511c3bb3be87f314d957ab51a43ee39ea9df11ba9091487d93e6bb93

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.12.0  - 2019/1/16
+
+* 🚀 [FEATURE] Enables the setting of global `:field_default` and `:association_default` option value in the Blueprinter Configuration that will be used as default values for fields and associations that evaluate to nil. [#128](https://github.com/procore/blueprinter/pull/128). Thanks to [@mcclayton](https://github.com/mcclayton).
+
 ## 0.11.0  - 2019/1/15
 
 * 🚀 [FEATURE] Enables the setting of a global `:if`/`:unless` proc in the Blueprinter Configuration that will be used to evaluate the conditional render of all fields. [#127](https://github.com/procore/blueprinter/pull/127). Thanks to [@mcclayton](https://github.com/mcclayton).

data/README.md

@@ -180,7 +180,17 @@ Output:
 ```
 
 ### Default Association/Field Option
-By default, an association or field that evaluates to `nil` is serialized as `nil`. A default serialized value can be specified as option on the association or field for cases when the association/field could potentially evaluate to `nil`.
+By default, an association or field that evaluates to `nil` is serialized as `nil`. A default serialized value can be specified as an option on the association or field for cases when the association/field could potentially evaluate to `nil`. You can also specify a global `field_default` or `association_default` in the Blueprinter config which will be used for all fields/associations that evaluate to nil.
+
+#### Global Config Setting
+```ruby
+Blueprinter.configure do |config|
+  config.field_default = "N/A"
+  config.association_default = {}
+end
+```
+
+#### Field-level/Associaion-level Setting
 ```ruby
 class UserBlueprint < Blueprinter::Base
   identifier :uuid

data/lib/blueprinter/configuration.rb

@@ -1,10 +1,12 @@
 module Blueprinter
   class Configuration
-    attr_accessor :generator, :if, :method, :sort_fields_by, :unless
+    attr_accessor :association_default, :field_default, :generator, :if, :method, :sort_fields_by, :unless
 
     VALID_CALLABLES = %i(if unless).freeze
 
     def initialize
+      @association_default = nil
+      @field_default = nil
       @generator = JSON
       @if = nil
       @method = :generate

data/lib/blueprinter/extractors/association_extractor.rb

@@ -6,14 +6,18 @@ module Blueprinter
 
     def extract(association_name, object, local_options, options={})
       value = @extractor.extract(association_name, object, local_options, options.except(:default))
-      return options[:default] if value.nil?
+      return default_value(options) if value.nil?
       view = options[:view] || :default
       blueprint = association_blueprint(options[:blueprint], value)
       blueprint.prepare(value, view_name: view, local_options: local_options)
     end
-    
+
     private
 
+    def default_value(association_options)
+      association_options.key?(:default) ? association_options.fetch(:default) : Blueprinter.configuration.association_default
+    end
+
     def association_blueprint(blueprint, value)
       blueprint.is_a?(Proc) ? blueprint.call(value) : blueprint
     end

data/lib/blueprinter/extractors/auto_extractor.rb

@@ -9,11 +9,15 @@ module Blueprinter
     def extract(field_name, object, local_options, options = {})
       extraction = extractor(object, options).extract(field_name, object, local_options, options)
       value = options.key?(:datetime_format) ? format_datetime(extraction, options[:datetime_format]) : extraction
-      value.nil? ? options[:default] : value
+      value.nil? ? default_value(options) : value
     end
 
     private
 
+    def default_value(field_options)
+      field_options.key?(:default) ? field_options.fetch(:default) : Blueprinter.configuration.field_default
+    end
+
     def extractor(object, options)
       if options[:block]
         @block_extractor

data/lib/blueprinter/version.rb

@@ -1,3 +1,3 @@
 module Blueprinter
-  VERSION = '0.11.0'
+  VERSION = '0.12.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: blueprinter
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Adam Hess
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-18 00:00:00.000000000 Z
+date: 2019-01-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: factory_bot