ja2r 0.4.3 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7f251df9dbf3a9e7c098a87bf32cfb3128967eb5daef41617545c0998714c28
-  data.tar.gz: e955a027273cd2157beaf532053f91308754bf868659b99c132ccd643dcdf2cd
+  metadata.gz: 2b11ae08daec17f6e284b5b693609cfe80a3c4cc1297ab3f4556a6179e8f7e57
+  data.tar.gz: 0ffe1c67097e3d9757952ec02afb65d7bd07779c9511f07781da3fe39dfcc7f4
 SHA512:
-  metadata.gz: 7384e93ff7b863f1a4cb099929714cc28ad7aea60ec23074579b56e8792c4ee8853453a1489b3ef5d7a02507ed0fef9e58471d56a56a632c686c52bcb5079fdd
-  data.tar.gz: 6ac8caa94054e25cc6518db78395469ed8e17e3d9d4210559ef6b28ce590f39fb4556e037d5be8ab48af433fcee9f2703c9e75fce90034f7901a4eec9119a602
+  metadata.gz: 52261c788ea4be45ae5036ee6b32ef811b53b5960a6e1759344e9e0c52932cb774616a0a7e9700834c47d70b45fd2c682baeea993d52fd8d3d6eb5a77a45914d
+  data.tar.gz: 97f6d511b64efad17d9fc67ba59a4703ddfa1965cc2c6152d0dbeb51e6e4b7451bc78864e4d73d598e96f69c0da34f3199840ae47329dddef034416c96272f59

data/README.md

@@ -41,3 +41,18 @@ JSON
 bart = JA2R.parse(JSON.parse(json))
 bart.sister.name # Lisa
 ```
+
+## Options
+
+You can pass options to `JA2R#parse` as second argument. Currently the only supported options are:
+
+| Name          | Type    | Description                                                                                                            |
+|---------------|---------|------------------------------------------------------------------------------------------------------------------------|
+| safe_traverse | boolean | When setting this option to true, unknown relationships or attributes will return nil instead of raising NoMethodError |
+
+Example:
+
+```ruby
+bart = JA2R.parse(hash, safe_traverse: true)
+bart.uncle&.name # nil
+```

data/lib/ja2r.rb

@@ -9,8 +9,8 @@ module JA2R
 
   module_function
 
-  def parse(hash)
-    Parser.new(hash).call
+  def parse(hash, options = {})
+    Parser.new(hash, options).call
   end
 
   def klass_for(hash)

data/lib/ja2r/element.rb

@@ -1,7 +1,8 @@
 module JA2R
   class Element
-    def initialize(origin_data)
+    def initialize(origin_data, options = {})
       @origin_data = origin_data.with_indifferent_access
+      @options = options
       @relationships = origin_data['relationships'] ? convert_relationships(origin_data['relationships']) : {}
     end
 
@@ -42,22 +43,26 @@ module JA2R
       return attributes[symbol] if attributes&.key? symbol
       return relationships[symbol] if relationships&.key? symbol
 
-      super
+      safe_traverse? ? nil : super
     end
 
     def respond_to_missing?(symbol, include_all = false)
       return true if attributes&.key?(symbol)
       return true if relationships&.key?(symbol)
 
-      super
+      safe_traverse? ? true : super
+    end
+
+    def safe_traverse?
+      @options[:safe_traverse]
     end
 
     def convert_relationships(hash)
       hash.each_with_object(ActiveSupport::HashWithIndifferentAccess.new) do |(key, data), memo|
         memo[key] = if data&.[]('data').is_a?(Array)
-                      data['data'].map { |d| KlassRegistry.instantiate(d) }
+                      data['data'].map { |d| KlassRegistry.instantiate(d, @options) }
                     elsif data&.[]('data').is_a?(Hash)
-                      KlassRegistry.instantiate(data&.[]('data'))
+                      KlassRegistry.instantiate(data&.[]('data'), @options)
                     end
       end
     end

data/lib/ja2r/klass_registry.rb

@@ -2,10 +2,10 @@ module JA2R
   module KlassRegistry
     extend self
 
-    def instantiate(hash)
+    def instantiate(hash, options)
       return unless hash&.key? 'type'
 
-      lookup(hash['type']).new(hash)
+      lookup(hash['type']).new(hash, options)
     end
 
     def lookup(type)

data/lib/ja2r/parser.rb

@@ -1,7 +1,8 @@
 module JA2R
   class Parser
-    def initialize(hash)
+    def initialize(hash, options = {})
       @hash = hash
+      @options = options
       @object_space = []
     end
 
@@ -29,20 +30,20 @@ module JA2R
     end
 
     def parse_single
-      root = KlassRegistry.instantiate(hash['data'])
+      root = KlassRegistry.instantiate(hash['data'], @options)
       object_space << root
       root
     end
 
     def parse_list
-      root = hash['data'].map { |data| KlassRegistry.instantiate(data) }
+      root = hash['data'].map { |data| KlassRegistry.instantiate(data, @options) }
       object_space.push(*root)
       root
     end
 
     def parse_included
       hash['included']&.map do |data|
-        object_space.push KlassRegistry.instantiate(data)
+        object_space.push KlassRegistry.instantiate(data, @options)
       end
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ja2r
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.5.0
 platform: ruby
 authors:
 - mkon
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-03-22 00:00:00.000000000 Z
+date: 2019-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -50,28 +50,28 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.63.1
+        version: 0.73.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.63.1
+        version: 0.73.0
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.32.0
+        version: 1.33.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.32.0
+        version: 1.33.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement