json_data_extractor 0.0.12 → 0.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b205c1e3094b426d39161a47261d0d0168244cff62b3c99b557d7f0e286a322
-  data.tar.gz: 3bf7cc322309d9e0c7bb8997eaae41346fbb97e42280a78b5e663c8307ec5311
+  metadata.gz: bb96ee66beec96f117282087fadea7c8bf91febb79eddf8d588bfb26a4301466
+  data.tar.gz: b0a5221e3eb012da640233fac6fb5ff6a41715327de6cb381bd8896e184095bd
 SHA512:
-  metadata.gz: 7973f7ca4b7575333282cbb0033f6d326b30003b8c36a7f9b7f0be4e7ee6194bbeb712e5abe2446d77e8ab8ffd5b7bf48c9d125a280da4c7d54aa62d11d2c0a8
-  data.tar.gz: 23507463438d1a106da73c0b561912ac16963aa49160563d876883586792c89ca2a2b0531ab236fffb11a45dc2eba0573f012727b28b518cb72ea3b7db35d558
+  metadata.gz: 48e16964d90fc098e3d2b1c9ad5136f642546a9fa04121aea8b2ed28847224fe85ee43a576476e61fbcdf501e0ae188488c23cdd1bab6bf9d1af9781d301df60
+  data.tar.gz: 8b7fd89bbd4ecd36b24a542112da82baeccc789e8cf86b8ce8cbbbf3444d28c2073809ba105cb96f261d88c847ca74ba31d8cbeacfe95d74d79a22b2af913907

data/README.md

@@ -120,6 +120,35 @@ The resulting json will be:
 
 ```
 
+
+### Handling Default Values
+
+With JsonDataExtractor, you can specify default values in your schema for keys that might be absent in the input JSON. Use the `path` and `default` keys in the schema for this purpose.
+
+```ruby
+schema = {
+  absent_value: { path: nil },
+  default: { path: '$.some_real_path', default: 'foo' },
+  default_with_lambda: { path: '$.table', default: -> { 'DEFAULT' } },
+  absent_with_default: { path: nil, default: 'bar' }
+}
+```
+
+- `absent_value`: Will be `nil` in the output as there's no corresponding key in the input JSON and no default is provided.
+- `default`: Will either take the value from `$.some_real_path` in the input JSON or 'foo' if the path does not exist.
+- `default_with_lambda`: Will take the value from `$..table` in the input JSON or 'DEFAULT' if the path does not exist.
+- `absent_with_default`: Will be 'bar' in the output as there's no corresponding key in the input JSON but a default is provided.
+
+#### Simplified Syntax for Absent Values
+
+For keys that you expect to be absent in the input JSON but still want to include in the output with a `nil` value, you can use a simplified syntax by setting the schema value to `nil`.
+
+```ruby
+schema = {
+  absent_value: nil
+}
+```
+
 ### Modifiers
 
 Modifiers can be supplied on object creation and/or added later by calling `#add_modifier` method.
@@ -191,7 +220,7 @@ schema     = {
     map:  FUEL_TYPES
   }
 }
-result     = described_class.new(data).extract(schema) # => {"fuel":["Petrol","Diesel",nil,"Unknown"]}
+result     = JsonDataExtractor.new(data).extract(schema) # => {"fuel":["Petrol","Diesel",nil,"Unknown"]}
 ```
 
 A map is essentially a dictionary that defines key-value pairs, where the keys represent the source

data/lib/json_data_extractor.rb

@@ -20,9 +20,11 @@ class JsonDataExtractor
   def extract(schema)
     results = {}
     schema.each do |key, val|
+      default_value = nil
       if val.is_a?(Hash)
         val.transform_keys!(&:to_sym)
         path       = val[:path]
+        default_value = val[:default]
         maps       = Array([val[:maps] || val[:map]]).flatten.compact.map do |map|
           if map.is_a?(Hash)
             map
@@ -48,11 +50,12 @@ class JsonDataExtractor
         maps      = []
       end
 
-      extracted_data = JsonPath.on(@data, path)
+      extracted_data = JsonPath.on(@data, path) if path
 
-      if extracted_data.empty?
-        results[key] = nil
+      if extracted_data.nil? || extracted_data.empty?
+        results[key] = default_value.is_a?(Proc) ? default_value.call : (default_value || nil)
       else
+        extracted_data.map! { |val| val.nil? ? default_value : val }
         transformed_data = apply_modifiers(extracted_data, modifiers)
         results[key]     = apply_maps(transformed_data, maps)
 

data/lib/src/version.rb

@@ -1,3 +1,3 @@
 class JsonDataExtractor
-  VERSION = '0.0.12'
+  VERSION = '0.0.13'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: json_data_extractor
 version: !ruby/object:Gem::Version
-  version: 0.0.12
+  version: 0.0.13
 platform: ruby
 authors:
 - Max Buslaev
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-07-07 00:00:00.000000000 Z
+date: 2023-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler