blueprinter 0.25.3 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c73ede4fa027d590c7a520d8dd04d3a81309402c1d0b02995d4170020f835d6d
-  data.tar.gz: 200760f033f25b31f170c97b98a274689209d921ab6f59f2f9069f06415abd90
+  metadata.gz: '084b38103a3fc3c3771e1c4c165ebc0886ffba618706e85550685b4009748b74'
+  data.tar.gz: aa06eb341bd07f58fa3a7db984d6904baf368cd3825fdddaca8c95ce28d3c89c
 SHA512:
-  metadata.gz: 97c8e428e09a65b3b44201201734441b84593932b4eda0ae3a30f081c0154802f9c808137df3c9ee8d5df2bb9d24cd06b2b327d45b8a24c59511e36905f1a307
-  data.tar.gz: 60c6456f14b0b3fc41e0539997b569ff80b376f8c4534b82151acfe0b010b04b2db28bfb3ec1ed5c0818008688b68e2b1e63d3fe802ed281f50e7d7db77d42c7
+  metadata.gz: 453f3c4833925ff58aff5db8f5b6593a0d7c4cd60871996440ed832a55d15d9d00493c7b6cf8aeabbbdb66d3b23bd3c0ca83d66d44d7aff93c16478b15176509
+  data.tar.gz: 7485797da5950803fec48384f950a8feb69880ed092e20db573b324484a600eb0898c80d0b311ceef5015b4e37a44f052b34f3867165b081258e1b95231acf31

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 0.26.0  - 2023/08/17
+* 🐛 [BREAKING] Transition to GitHub Actions from CircleCI and update to handle Ruby versions 2.7, 3.0, 3.1, 3.2. Drop support for any ruby version less than 2.7. See [#307](https://github.com/procore-oss/blueprinter/pull/307)
+
 ## 0.25.3  - 2021/03/03
 * 🐛 [BUGFIX] Fixes issue where fields and associations that are redefined by later views were not properly overwritten. See [#201](https://github.com/procore/blueprinter/pull/201) thanks to [@Berardpi](https://github.com/Berardpi).
 

data/README.md

@@ -1,18 +1,35 @@
-[![CircleCI](https://circleci.com/gh/procore/blueprinter.svg?style=svg)](https://circleci.com/gh/procore/blueprinter)
+[![Test](https://github.com/procore-oss/blueprinter/actions/workflows/test.yaml/badge.svg?branch=master)](https://github.com/procore-oss/blueprinter/actions/workflows/test.yaml)
 [![Gem Version](https://badge.fury.io/rb/blueprinter.svg)](https://badge.fury.io/rb/blueprinter)
 [![Gitter chat](https://badges.gitter.im/procore/blueprinter.svg)](https://gitter.im/blueprinter-gem/community)
 
 <img src="blueprinter_logo.svg" width="25%">
 
+# Recent Organization Move
+
+Please change your local remote to pull from this repository:
+
+```bash
+git remote set-url [previous-remote-name] git@github.com:procore-oss/blueprinter.git
+```
+
+to see the previous upstream remote name, run:
+
+```bash
+git remote -v
+```
+
 # Blueprinter
+
 Blueprinter is a JSON Object Presenter for Ruby that takes business objects and breaks them down into simple hashes and serializes them to JSON. It can be used in Rails in place of other serializers (like JBuilder or ActiveModelSerializers). It is designed to be simple, direct, and performant.
 
 It heavily relies on the idea of `views` which, similar to Rails views, are ways of predefining output for data in different contexts.
 
 ## Documentation
+
 Docs can be found [here](http://www.rubydoc.info/gems/blueprinter).
 
 ## Usage
+
 <details open>
 <summary>Basic</summary>
 
@@ -31,6 +48,7 @@ end
 ```
 
 and then, in your code:
+
 ```ruby
 puts UserBlueprint.render(user) # Output is a JSON string
 ```
@@ -49,7 +67,6 @@ And the output would look like:
 ---
 </details>
 
-
 <details>
 <summary>Collections</summary>
 
@@ -83,7 +100,6 @@ This will result in JSON that looks something like this:
 ---
 </details>
 
-
 <details>
 <summary>Renaming</summary>
 
@@ -114,13 +130,13 @@ This will result in JSON that looks something like this:
 ---
 </details>
 
-
 <details>
 <summary>Views</summary>
 
 ---
 
 You may define different outputs by utilizing views:
+
 ```ruby
 class UserBlueprint < Blueprinter::Base
   identifier :uuid
@@ -137,14 +153,17 @@ class UserBlueprint < Blueprinter::Base
   end
 end
 ```
+
 A view can include fields from another view by utilizing `include_view` and `include_views`.
 
 Usage:
+
 ```ruby
 puts UserBlueprint.render(user, view: :extended)
 ```
 
 Output:
+
 ```json
 {
   "uuid": "733f0758-8f21-4719-875f-262c3ec743af",
@@ -158,13 +177,39 @@ Output:
 ---
 </details>
 
+<details>
+<summary>Identifiers</summary>
+
+---
+
+`identifier`s are used to specify a field or method name used as an identifier. Usually, this is something like `:id`.
+
+Example:
+
+```rb
+class UserBlueprint < Blueprinter::Base
+  identifier :uuid
+end
+```
+
+Blueprinter `identifier`s have a few properties that set them apart from `field`s.
+
+1. Identifiers are **always** rendered and considered their own view (the `:identifier` view).
+2. When rendering, identifier fields are always sorted first, before other fields.
+
+If either of the above two developer conveniences are not desired, you can simply create your identifier fields as regular `field`s.
+
+---
+
+</details>
 
 <details>
 <summary>Root</summary>
-
+<a name="root"></a>
 ---
 
 You can also optionally pass in a root key to wrap your resulting json in:
+
 ```ruby
 class UserBlueprint < Blueprinter::Base
   identifier :uuid
@@ -177,11 +222,13 @@ end
 ```
 
 Usage:
+
 ```ruby
 puts UserBlueprint.render(user, view: :normal, root: :user)
 ```
 
 Output:
+
 ```json
 {
   "user": {
@@ -196,13 +243,13 @@ Output:
 ---
 </details>
 
-
 <details>
 <summary>Meta Attributes</summary>
 
 ---
 
 You can additionally add meta-data to the json as well:
+
 ```ruby
 class UserBlueprint < Blueprinter::Base
   identifier :uuid
@@ -215,6 +262,7 @@ end
 ```
 
 Usage:
+
 ```ruby
 json = UserBlueprint.render(user, view: :normal, root: :user, meta: {links: [
   'https://app.mydomain.com',
@@ -224,6 +272,7 @@ puts json
 ```
 
 Output:
+
 ```json
 {
   "user": {
@@ -240,18 +289,19 @@ Output:
   }
 }
 ```
+
 _NOTE:_ For meta attributes, a [root](#root) is mandatory.
 
 ---
 </details>
 
-
 <details>
 <summary>Exclude Fields</summary>
 
 ---
 
 You can specifically choose to exclude certain fields for specific views
+
 ```ruby
 class UserBlueprint < Blueprinter::Base
   identifier :uuid
@@ -270,11 +320,13 @@ end
 ```
 
 Usage:
+
 ```ruby
 puts UserBlueprint.render(user, view: :extended)
 ```
 
 Output:
+
 ```json
 {
   "uuid": "733f0758-8f21-4719-875f-262c3ec743af",
@@ -306,13 +358,13 @@ end
 ---
 </details>
 
-
 <details>
 <summary>Associations</summary>
 
 ---
 
 You may include associated objects. Say for example, a user has projects:
+
 ```ruby
 class ProjectBlueprint < Blueprinter::Base
   identifier :uuid
@@ -331,11 +383,13 @@ end
 ```
 
 Usage:
+
 ```ruby
 puts UserBlueprint.render(user, view: :normal)
 ```
 
 Output:
+
 ```json
 {
   "uuid": "733f0758-8f21-4719-875f-262c3ec743af",
@@ -357,6 +411,7 @@ Output:
 
 It is also possible to pass options from one Blueprint to another via an association.
 For example:
+
 ```ruby
 class VehicleBlueprint < Blueprinter::Base
   identifier :uuid
@@ -378,7 +433,6 @@ end
 ---
 </details>
 
-
 <details>
 <summary>Default Association/Field Option</summary>
 
@@ -386,7 +440,8 @@ end
 
 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
+### Global Config Setting
+
 ```ruby
 Blueprinter.configure do |config|
   config.field_default = "N/A"
@@ -394,7 +449,8 @@ Blueprinter.configure do |config|
 end
 ```
 
-#### Field-level/Association-level Setting
+### Field-level/Association-level Setting
+
 ```ruby
 class UserBlueprint < Blueprinter::Base
   identifier :uuid
@@ -409,7 +465,6 @@ end
 ---
 </details>
 
-
 <details>
 <summary>default_if</summary>
 
@@ -418,25 +473,29 @@ end
 Sometimes, you may want certain "empty" values to pass through to the default value.
 Blueprinter provides the ability to treat the following empty types as the default value (or `nil` if no default provided).
 
-#### Blueprinter::EMPTY_COLLECTION
+### Blueprinter::EMPTY_COLLECTION
+
 An empty array or empty active record collection.
 
-#### Blueprinter::EMPTY_HASH
+### Blueprinter::EMPTY_HASH
+
 An empty hash.
 
-#### Blueprinter::EMPTY_STRING
+### Blueprinter::EMPTY_STRING
+
 An empty string or symbol.
 
-#### Field-level/Association-level Setting
+#### Field-level/Association-level Setting - EMPTY_STRING
+
 ```ruby
 class UserBlueprint < Blueprinter::Base
   identifier :uuid
 
   view :normal do
     # If first_name is an empty string, it will become "N/A"
-    field :first_name, default_if: Blueprinter::EmptyString, default: "N/A"
+    field :first_name, default_if: Blueprinter::EMPTY_STRING, default: "N/A"
     # If the projects association collection is empty, it will become nil
-    association :projects, blueprint: ProjectBlueprint, default_if: Blueprinter::EmptyCollection
+    association :projects, blueprint: ProjectBlueprint, default_if: Blueprinter::EMPTY_COLLECTION
   end
 end
 ```
@@ -444,13 +503,13 @@ end
 ---
 </details>
 
-
 <details>
 <summary>Supporting Dynamic Blueprints For Associations</summary>
 
 ---
 
 When defining an association, we can dynamically evaluate the blueprint. This comes in handy when adding polymorphic associations, by allowing reuse of existing blueprints.
+
 ```ruby
 class Task < ActiveRecord::Base
   belongs_to :taskable, polymorphic: true
@@ -473,12 +532,12 @@ class TaskBlueprint < Blueprinter::Base
   end
 end
 ```
+
 _NOTE:_ `taskable.blueprint` should return a valid Blueprint class. Currently, `has_many` is not supported because of the very nature of polymorphic associations.
 
 ---
 </details>
 
-
 <details>
 <summary>Defining A Field Directly In The Blueprint</summary>
 
@@ -513,7 +572,6 @@ Output:
 ---
 </details>
 
-
 <details>
 <summary>Defining An Identifier Directly In The Blueprint</summary>
 
@@ -546,7 +604,6 @@ Output:
 ---
 </details>
 
-
 <details>
 <summary>Defining An Association Directly In The Blueprint</summary>
 
@@ -591,7 +648,6 @@ Output:
 ---
 </details>
 
-
 <details>
 <summary>Passing Additional Properties To #render</summary>
 
@@ -626,7 +682,6 @@ Output:
 ---
 </details>
 
-
 <details>
 <summary>Conditional Fields</summary>
 
@@ -634,7 +689,8 @@ Output:
 
 Both the `field` and the global Blueprinter Configuration supports `:if` and `:unless` options that can be used to serialize fields conditionally.
 
-#### Global Config Setting
+### Global Config Setting - if and unless
+
 ```ruby
 Blueprinter.configure do |config|
   config.if = ->(field_name, obj, _options) { !obj[field_name].nil? }
@@ -643,6 +699,7 @@ end
 ```
 
 #### Field-level Setting
+
 ```ruby
 class UserBlueprint < Blueprinter::Base
   identifier :uuid
@@ -656,7 +713,6 @@ _NOTE:_ The field-level setting overrides the global config setting (for the fie
 ---
 </details>
 
-
 <details>
 <summary>Custom Formatting for Dates and Times</summary>
 
@@ -667,18 +723,21 @@ This global or field-level option can be either a string representing the associ
 or a Proc which receives the original Date/DateTime object and returns the formatted value.
 When using a Proc, it is the Proc's responsibility to handle any errors in formatting.
 
+#### Global Config Setting - datetime
 
-#### Global Config Setting
 If a global datetime_format is set (either as a string format or a Proc), this option will be
 invoked and used to format all fields that respond to `strftime`.
+
 ```ruby
 Blueprinter.configure do |config|
   config.datetime_format = ->(datetime) { datetime.nil? ? datetime : datetime.strftime("%s").to_i }
 end
 ```
 
-#### Field-level Setting
+#### Field-level Setting - datetime_format
+
 Usage (String Option):
+
 ```ruby
 class UserBlueprint < Blueprinter::Base
   identifier :name
@@ -687,6 +746,7 @@ end
 ```
 
 Output:
+
 ```json
 {
   "name": "John Doe",
@@ -695,6 +755,7 @@ Output:
 ```
 
 Usage (Proc Option):
+
 ```ruby
 class UserBlueprint < Blueprinter::Base
   identifier :name
@@ -703,6 +764,7 @@ end
 ```
 
 Output:
+
 ```json
 {
   "name": "John Doe",
@@ -715,7 +777,6 @@ _NOTE:_ The field-level setting overrides the global config setting (for the fie
 ---
 </details>
 
-
 <details>
 <summary>Transform Classes</summary>
 
@@ -731,6 +792,7 @@ Whatever is returned from this `transform` method will end up being the resultin
 #### Example
 
 Create a Transform class extending from `Blueprinter::Transformer`
+
 ```ruby
 class DynamicFieldTransformer < Blueprinter::Transformer
   def transform(hash, object, options)
@@ -752,6 +814,7 @@ end
 ```
 
 Then specify the transform to use for the view.
+
 ```ruby
 class UserBlueprint < Blueprinter::Base
   fields :first_name, :last_name
@@ -762,6 +825,7 @@ end
 #### Global Transforms
 
 You can also specify global default transformers. Create one or more transformer classes extending from `Blueprinter::Transformer` and set the `default_transformers` configuration
+
 ```ruby
 class LowerCamelTransformer < Blueprinter::Transformer
   def transform(hash, _object, _options)
@@ -791,6 +855,7 @@ Blueprinter gets a given objects' values from the fields definitions using extra
 #### Examples
 
 For a specific kind of field, create an extractor class extending from `Blueprinter::Extractor`
+
 ```ruby
 class MyFieldExtractor < Blueprinter::Extractor
   def extract(_field_name, _object, _local_options, _options={})
@@ -807,6 +872,7 @@ end
 ```
 
 For a global default, create an extractor class extending from `Blueprinter::AutoExtractor` and set the `extractor_default` configuration
+
 ```ruby
 class MyAutoExtractor < Blueprinter::AutoExtractor
   def initialize
@@ -857,6 +923,7 @@ end
 ```
 
 Output:
+
 ```json
 {
   "name": "John Doe",
@@ -868,7 +935,6 @@ Output:
 ---
 </details>
 
-
 <details>
 <summary>Deprecations</summary>
 
@@ -885,7 +951,8 @@ However, deprecations can be configured to report at three different levels:
 | `:raise`            | Deprecations will be raised as `Blueprinter::BlueprinterError`s |
 | `:silence`          | Deprecations will be silenced and will not be raised or logged  |
 
-### Example:
+### Example - deprecations
+
 ```ruby
 Blueprinter.configure do |config|
   config.deprecations = :raise
@@ -895,7 +962,6 @@ end
 ---
 </details>
 
-
 <details>
 <summary>render_as_hash</summary>
 
@@ -921,7 +987,6 @@ Output:
 ---
 </details>
 
-
 <details>
 <summary>render_as_json</summary>
 
@@ -947,8 +1012,8 @@ Output:
 ---
 </details>
 
-
 ## Installation
+
 Add this line to your application's Gemfile:
 
 ```ruby
@@ -956,13 +1021,15 @@ gem 'blueprinter'
 ```
 
 And then execute:
+
 ```bash
-$ bundle
+bundle
 ```
 
 Or install it yourself as:
+
 ```bash
-$ gem install blueprinter
+gem install blueprinter
 ```
 
 You should also have `require 'json'` already in your project if you are not using Rails or if you are not using Oj.
@@ -1002,12 +1069,15 @@ end
 _NOTE:_ You should be doing this only if you aren't using `yajl-ruby` through the JSON API by requiring `yajl/json_gem`. More details [here](https://github.com/brianmario/yajl-ruby#json-gem-compatibility-api). In this case, `JSON.generate` is patched to use `Yajl::Encoder.encode` internally.
 
 ## Contributing
-Feel free to browse the issues, converse, and make pull requests. If you need help, first please see if there is already an issue for your problem. Otherwise, go ahead and make a new issue.
+
+Please read our [Contributing](CONTRIBUTING.md) file
 
 ### Tests
+
 You can run tests with `bundle exec rake`.
 
 ### Maintain The Docs
+
 We use Yard for documentation. Here are the following documentation rules:
 
 - Document all public methods we expect to be utilized by the end developers.
@@ -1022,7 +1092,9 @@ documentation rules:
 - Methods that are not set to private due to ruby visibility rule limitations should be marked with `@api private`.
 
 ### Releasing a New Version
+
 To release a new version, change the version number in `version.rb`, and update the `CHANGELOG.md`. Finally, maintainers need to run `bundle exec rake release`, which will automatically create a git tag for the version, push git commits and tags to Github, and push the `.gem` file to rubygems.org.
 
 ## License
+
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/lib/blueprinter/version.rb

@@ -1,3 +1,3 @@
 module Blueprinter
-  VERSION = '0.25.3'.freeze
+  VERSION = '0.26.0'.freeze
 end

metadata

@@ -1,16 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: blueprinter
 version: !ruby/object:Gem::Version
-  version: 0.25.3
+  version: 0.26.0
 platform: ruby
 authors:
-- Adam Hess
 - Derek Carter
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-03 00:00:00.000000000 Z
+date: 2023-09-19 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.1.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.1.7
+- !ruby/object:Gem::Dependency
+  name: ammeter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.4
 - !ruby/object:Gem::Dependency
   name: factory_bot
   requirement: !ruby/object:Gem::Requirement
@@ -53,20 +80,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: yajl-ruby
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.4.1
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.4.1
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -95,20 +108,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: activerecord
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 5.1.2
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 5.1.2
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -127,64 +126,64 @@ dependencies:
   name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: '6.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.6
+        version: 1.4.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.6
+        version: 1.4.2
 - !ruby/object:Gem::Dependency
-  name: yard
+  name: yajl-ruby
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.11
+        version: 1.4.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.11
+        version: 1.4.1
 - !ruby/object:Gem::Dependency
-  name: ammeter
+  name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.4
+        version: 0.9.11
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.4
+        version: 0.9.11
 description: Blueprinter is a JSON Object Presenter for Ruby that takes business objects
   and breaks them down into simple hashes and serializes them to JSON. It can be used
   in Rails in place of other serializers (like JBuilder or ActiveModelSerializers).
   It is designed to be simple, direct, and performant.
 email:
-- adamhess1991@gmail.com
+- blueprinter@googlegroups.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -216,10 +215,11 @@ files:
 - lib/generators/blueprinter/blueprint_generator.rb
 - lib/generators/blueprinter/templates/blueprint.rb
 - lib/tasks/blueprinter_tasks.rake
-homepage: https://github.com/procore/blueprinter
+homepage: https://github.com/procore-oss/blueprinter
 licenses:
 - MIT
-metadata: {}
+metadata:
+  allowed_push_host: https://rubygems.org
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -228,14 +228,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.2.2
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.4.10
 signing_key: 
 specification_version: 4
 summary: Simple Fast Declarative Serialization Library