• 💅 [ENHANCEMENT] Introduce rubocop and add a Github action for it

• 🐛 [BUGFIX] Fix accidental hard dependency requirement of yajl and oj in gemspec from a routine cleanup commit

• 🚀 [FEATURE] Allow configuring custom array-like classes to be treated as collections when serializing. More details can be found here. Thanks to @toddnestor.
• 💅 [ENHANCEMENT] Reduce object allocations in fields calculations to save some memory. More details can be found here. Thanks to @nametoolong.

• 🚀 [Official Release] Released blueprinter-rb under a new organisation. More details can be found here.

• 🐛 [BUGFIX] Fixes issue where fields and associations that are redefined by later views were not properly overwritten. See #201 thanks to @Berardpi.

• 🚀 [FEATURE] Make deprecation behavior configurable (:silence, :stderror, :raise). See #248 thanks to @mcclayton.

• 🐛 [BUGFIX] Raise Blueprinter::BlueprinterError if Blueprint given is not of class Blueprinter::Base. Before it just raised a generic undefined method 'prepare'. See #233 thanks to @caws.

• 🚀 [FEATURE] Enable default Blueprinter::Transformers to be set in the global configuration. #222. Thanks to @supremebeing7.

• 🚀 [FEATURE] Add an options option to associations to facilitate passing options from one blueprint to another. #220. Thanks to @mcclayton.

• 🚀 [FEATURE] Public class method has_view? on Blueprinter::Base subclasses introduced in #213. Thanks to @spencerneste.

• 🐛 [BUGFIX] Fixes issue where exclude fields in deeply nested views were not respected. Resolved issue 207 in #208 by @tpltn.

• 🐛 [BUGFIX] Fixes issue where fields "bled" into other views due to merge side-effects. Resolved issue 205 in #204 by @trevorrjohn.

• 🐛 [BUGFIX] Fixes #172 where views would unintentionally ignore sort_fields_by: :definition configuration. Resolved in #197 by @wlkrw.

• 🚀 [FEATURE] Configurable default extractor introduced in #198 by @wlkrw. You can now set a default extractor like so:

Blueprinter.configure do |config|
  config.extractor_default = MyAutoExtractor
end

• 🚀 [FEATURE] Add rails generators. See rails g blueprinter:blueprint --help for usage. Introduced in #176 by @wlkrw.

• 🚀 [FEATURE] Ability to specify default_if field/association option for more control on when the default value is applied. 191. Thanks to @mcclayton.

• 🚀 [FEATURE] Ability to include multiple views in a single method call with include_views. 184. Thanks to @narendranvelmurugan.

• 💅 [ENHANCEMENT] Update field-level conditional settings to reflect new three-argument syntax. 183. Thanks to @danirod.

• 💅 [ENHANCEMENT] Modify Extractor access control in documentation. 182. Thanks to @cagmz.

• 💅 [ENHANCEMENT] Fix the Transformer example documentation. 174. Thanks to @tjwallace.

• 🚀 [FEATURE] Added ability to specify transformers for Blueprinter views to further process the resulting hash before serialization. #164. Thanks to @amalarayfreshworks.

• ⚠️ [DEPRECATION] :if/:unless procs with two arguments are now deprecated. These procs now take in three arguments (field_name, obj, options) instead of just (obj, options). In order to be compliant with the the next major release, all conditional :if/:unless procs must be augmented to take in three arguments instead of two. i.e. (obj, options) to (field_name, obj, options).

• 🐛 [BUGFIX] Fixing view: :identifier including non-identifier fields. #154. Thanks to @AllPurposeName.

• 💅 [ENHANCEMENT] Add ability to override :extractor option for an ::association. #152. Thanks to @hugopeixoto.

• 🚀 [FEATURE] Add ability to exclude multiple fields inline using excludes. #141. Thanks to @pabhinaya.

• 🚀 [FEATURE] Add ability to pass in datetime_format field option as either a string representing the strftime format, or a Proc which takes in the Date or DateTime object and returns the formatted date. #145. Thanks to @mcclayton.

• 🚀 [FEATURE] Added a global datetime_format option. #135. Thanks to @ritikesh.

• 🐛 [BUGFIX] Replacing use of rails-specific method Hash::except so that Blueprinter continues to work in non-Rails environments. #140. Thanks to @checkbutton.

• 💅 [MAINTENANCE | ENHANCEMENT] Cleaning up the include_associations section. This is not a documented/supported feature and is calling respond_to?(:klass) on every object passed to blueprinter. #139. Thanks to @ritikesh.

• 🚀 [FEATURE] Added an option to render with a root key. #135. Thanks to @ritikesh.
• 🚀 [FEATURE] Added an option to render with a top-level meta attribute. #135. Thanks to @ritikesh.

• 🐛 [BUGFIX] Fix boolean false values getting serialized as null. Please see PR #132. Thanks to @samsongz.

• 🚀 [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. Thanks to @mcclayton.

• 🚀 [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. Thanks to @mcclayton.

• 🚀 [FEATURE] Association Blueprints can be dynamically evaluated using a proc. #122. Thanks to @ritikesh.

• 🚀 [FEATURE] Added a render_as_json API. Similar to render_as_hash but returns a JSONified hash. Please see pr #119. Thanks to @ritikesh.
• 🚀 [FEATURE] Sorting of fields in the response is now configurable to sort by definition or by name(asc only). Please see pr #119. Thanks to @ritikesh.
• 💅 [ENHANCEMENT] Updated readme for above features and some existing undocumented features like exclude fields, render_as_hash. Please see pr #119. Thanks to @ritikesh.

• 🚀 [FEATURE] Extend Support for other JSON encoders like yajl-ruby. Please see pr #118. Thanks to @ritikesh.
• 🐛 [BUGFIX] Do not raise error on null date with date_format option. Please see pr #117. Thanks to @tpltn.
• 🚀 [FEATURE] Add default option to fields which will be used as the serialized value instead of null when the field evaluates to null. Please see pr #115. Thanks to @mcclayton.
• 🐛 [BUGFIX] Made Base.associations completely private since they are not used outside of the Blueprinter base. Please see pr #112. Thanks to @philipqnguyen.
• 🐛 [BUGFIX] Fix issue where entire Blueprinter module was marked api private. Please see pr #111. Thanks to @philipqnguyen.
• 🚀 [FEATURE] Allow identifiers to be defined with a block. Please see pr #110. Thanks to @hugopeixoto.
• 💅 [ENHANCEMENT] Update docs regarding the args yielded to blocks. Please see pr #108. Thanks to @philipqnguyen.
• 💅 [ENHANCEMENT] Use field method in fields. Please see pr #107. Thanks to @hugopeixoto.

• [FEATURE] Allow associations to be defined with a block. Please see pr #106. Thanks to @hugopeixoto.
• [FEATURE] Inherit view definition when using inheritance. Please see pr #105. Thanks to @hugopeixoto.

• 🚀 [FEATURE] Add date_time format as an option to field. Please see pr #68. Thanks to @njbbaer.
• 🚀 [FEATURE] Add conditional field support :unless and :if as an option to field. Please see pr #86. Thanks to @ojab.
• 🐛 [BUGFIX] Fix case where miscellaneous options were not being passed through the AutoExtractor. See pr #83.

• 🚀 [FEATURE] Add default option to association which will be used as the serialized value instead of null when the association evaluates to null. See PR #78 by @vinaya-procore.

• 🚀 [FEATURE] Add render_as_hash which will output a hash instead of a JSON String. See PR #76 by @amayer171 and Issue #73.

💥 [BREAKING] Sort of a breaking Change. Serializer classes has been renamed to Extractor. To upgrade, if you passed in a specific serializer to field or identifier such as:

field(:first_name, serializer: CustomSerializer)

Please rename that to:

field(:first_name, extractor: CustomExtractor)

• 💅 [ENHANCEMENT] Renamed Serializer classes to Extractor. See #72.
• 💅 [ENHANCEMENT] Updated README. See pr #66, #65

💥 [BREAKING] Breaking Changes. To upgrade, ensure that any associated objects have a blueprint. For example:

association :comments, blueprint: CommentsBlueprint

• 🐛 [BUGFIX] Remove Optimizer class. See #61.
• 🐛 [BUGFIX] Require associated objects to have a Blueprint, so that objects will always serialize properly. See #60.

• 🚀 [FEATURE] Initial release of Blueprinter