json_schematize 0.3.1 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 545006e10e9c73489b4a2db37d7b787a49c4427dd58d541ac938bad4c73954ce
-  data.tar.gz: 38f4d89c9cb2ffc8b9863531d8745eae5acd2b2bc1379ea6e9f459d66550525e
+  metadata.gz: f7c2935672acaea1a2d0dd6cb77478ba381b3b59af9f6e67006e950a11a31d31
+  data.tar.gz: aa3af45a457f4c0e842c4d39366158f4ec833f123ef85fddb137706918a20359
 SHA512:
-  metadata.gz: d640bd68de88a3e6e3b4a73fd8688e9c017bbb8948a73abb3a2f4bf36a87c3ba1bd31bb08f052b8fd36bca9a7758f825f32448ae39930610eaae7323ccd336fb
-  data.tar.gz: 344f9dd96df21d5b5f8f8b6daca078281403606c5b75dcc958d999186380e83a56ddb592f071b271656882ad9d4a117ce7211ca050cb901e4f57fbb90fe2355e
+  metadata.gz: 7a02efdb0960ba3bbfa9369a1e6a4d0b987bd414d676f1b701c5f2890e59153312dd490751f802fb0f27fbd51686c86fe00e6c6a5ab6ed83cfee2477aaf689fb
+  data.tar.gz: 4c0b7cae2ffed160d64c925c60ac00004bc9a688476021615ccd8889ecc45839d225648d581b5a258644869b7f528a215855e7db250de1b3dcc4054ba42e913d

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    json_schematize (0.3.1)
+    json_schematize (0.5.1)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -74,7 +74,7 @@ schema.id #=> 999999
 ```
 
 ### Field options:
-```bash
+```
 name -- Name of the field. Field name can be accessed from the instance
 type -- Class of the expected field type
 types -- To be used when you want the field to have multiple types. Useful for similar classes like DateTime, Date, Time (converter must be supplied when multiple types are given)
@@ -84,7 +84,23 @@ validator -- Proc value to validate the data found in the params. Proc given (tr
 required -- Default is true. When not set, each instance class can optionally decide if they want to raise when an this is set to false.
 converter -- Proc return is set to the field value. No furter validation is done. Given (value) as a parameter
 array_of_types -- Detailed example above. Set this value to true when the dig param is to an array and you want all values in array to be parsed the given type
+empty_value -- When required is false, this value is used to fill the field. By default it is JsonSchematize::EmptyValue, but can be changed to anything
+```
+
+### Schema defaults
+
+Defaults can be added for all fields for any of the available options. This can be useful for returned API calls when the body is parsed as a Hash with String keys.
+
+```ruby
+class SchemaWithDefaults < JsonSchematize::Generator
+  schema_default option: :dig_type, value: :string
+
+  add_field name: :internals, type: InternalBody, array_of_types: true
+  add_field name: :id, type: Integer
+  add_field name: :status, type: Symbol, required: false, empty_value: "empty"
+end
 ```
+
 ### Custom Classes
 
 ```ruby

data/lib/json_schematize/empty_value.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+class JsonSchematize::EmptyValue
+  def initialize(*)
+  end
+end

data/lib/json_schematize/field.rb

@@ -5,11 +5,12 @@ require 'json_schematize/field_validators'
 
 class JsonSchematize::Field
 
-  attr_reader :name, :types, :dig, :symbol, :validator, :acceptable_types, :required, :converter, :array_of_types
+  attr_reader :name, :types, :dig, :dig_type, :symbol, :validator, :empty_value
+  attr_reader :acceptable_types, :required, :converter, :array_of_types
 
   EXPECTED_DIG_TYPE = [DIG_SYMBOL = :symbol, DEFAULT_DIG = DIG_NONE =:none, DIG_STRING = :string]
 
-  def initialize(name:, types:, dig:, dig_type:, validator:, type:, required:, converter:, array_of_types: false)
+  def initialize(name:, types:, dig:, dig_type:, validator:, type:, required:, converter:, empty_value:, array_of_types: false)
     @name = name
     @types = types
     @type = type
@@ -19,13 +20,15 @@ class JsonSchematize::Field
     @validator = validator
     @acceptable_types = []
     @converter = converter
+    @empty_value = empty_value
     @array_of_types = array_of_types
   end
 
   def setup!
-    # validations must be done beofre transformations
-    valiadtions!
+    # validations must be done before transformations
+    validations!
     transformations!
+    @acceptable_types << ((empty_value.class == Class) ? empty_value : empty_value.class)
   end
 
   def value_transform(value:)
@@ -102,9 +105,15 @@ class JsonSchematize::Field
   end
 
   def raw_converter_call(value:)
+    return convert_empty_value if value.nil? && (required == false)
+
     converter.call(value)
   end
 
+  def convert_empty_value
+    empty_value.class == Class ? empty_value.new : empty_value
+  end
+
   include JsonSchematize::FieldTransformations
   include JsonSchematize::FieldValidators
 end

data/lib/json_schematize/field_validators.rb

@@ -2,7 +2,7 @@
 
 module JsonSchematize::FieldValidators
 
-  def valiadtions!
+  def validations!
     validate_type!(t: @type)
     validate_types!
     validate_name!

data/lib/json_schematize/generator.rb

@@ -1,29 +1,33 @@
 # frozen_string_literal: true
 
+require "json_schematize/empty_value"
 require "json_schematize/field"
-
-# SchemafiedJSON
-# JSONSchematize
+require "json_schematize/introspect"
 
 class JsonSchematize::Generator
-  EMPTY_VALIDATOR = ->(_transformed_value,_raw_value) { true }
+  EMPTY_VALIDATOR = ->(_transformed_value, _raw_value) { true }
   PROTECTED_METHODS = [:assign_values!, :convenience_methods, :validate_required!, :validate_optional!, :validate_value]
 
-  def self.add_field(name:, type: nil, types: [], dig_type: nil, dig: nil, validator: EMPTY_VALIDATOR, required: true, converter: nil, array_of_types: false)
+  include JsonSchematize::Introspect
+
+  def self.add_field(name:, type: nil, types: nil, dig_type: nil, dig: nil, validator: nil, required: nil, converter: nil, array_of_types: nil, empty_value: nil)
     field_params = {
-      converter: converter,
-      dig: dig,
-      dig_type: dig_type,
+      converter: converter || schema_defaults[:converter],
+      dig: dig || schema_defaults[:dig],
+      dig_type: dig_type || schema_defaults[:dig_type],
       name: name,
-      required: required,
-      type: type,
-      types: types,
-      validator: validator,
+      required: (required.nil? ? schema_defaults.fetch(:required, true) : required),
+      type: type || schema_defaults[:type],
+      types: types || schema_defaults.fetch(:types, []),
+      empty_value: empty_value || schema_defaults.fetch(:empty_value, JsonSchematize::EmptyValue),
+      validator: validator || schema_defaults.fetch(:validator, EMPTY_VALIDATOR),
+      array_of_types: (array_of_types.nil? ? schema_defaults.fetch(:array_of_types, false) : array_of_types),
     }
+
     field = JsonSchematize::Field.new(**field_params)
     field.setup!
 
-    if required
+    if field_params[:required] == true
       required_fields << field
     else
       optional_fields << field
@@ -31,6 +35,18 @@ class JsonSchematize::Generator
     convenience_methods(field: field)
   end
 
+  def self.schema_default(option:, value:)
+    if fields.length > 0
+      ::Kernel.warn("Default [#{option}] set after fields #{fields.map(&:name)} created. #{option} default will behave inconsistently")
+    end
+
+    schema_defaults[option.to_sym] = value
+  end
+
+  def self.schema_defaults
+    @schema_defaults ||= {}
+  end
+
   def self.fields
     required_fields + optional_fields
   end
@@ -65,16 +81,21 @@ class JsonSchematize::Generator
     end
   end
 
-  attr_reader :__raw_params, :raise_on_error
+  attr_reader :__raw_params, :raise_on_error, :values_assigned
 
   # stringified_params allows for params with stringed keys
-  def initialize(stringified_params = {}, raise_on_error: true, **params)
-    @__params = stringified_params.empty? ? params : stringified_params
+  def initialize(stringified_params = nil, raise_on_error: true, **params)
+    @values_assigned = false
+    @__params = stringified_params.nil? ? params : stringified_params
+    @__raw_params = @__params
     @raise_on_error = raise_on_error
 
-    validate_required!
-    validate_optional!
-    assign_values!
+    if @__params
+      validate_required!
+      validate_optional!
+      assign_values!
+      @values_assigned = true
+    end
   end
 
   private

data/lib/json_schematize/introspect.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module JsonSchematize::Introspect
+  def to_h
+    self.class.fields.map do |field|
+      [field.name, instance_variable_get(:"@#{field.name}")]
+    end.to_h
+  end
+  alias :to_hash :to_h
+
+  def deep_inspect(with_raw_params: false, with_field: false)
+    self.class.fields.map do |field|
+      value = {
+        required: field.required,
+        acceptable_types: field.acceptable_types,
+        value: instance_variable_get(:"@#{field.name}"),
+      }
+      value[:field] = field if with_field
+      value[:raw_params] = @__raw_params if with_raw_params
+      [field.name, value]
+    end.to_h
+  end
+
+  def inspect
+    stringify = to_h.map { |k, v| "#{k}:#{v}" }.join(", ")
+    "#<#{self.class} - required fields: #{self.class.required_fields.map(&:name)}; #{stringify}>"
+  end
+end

data/lib/json_schematize/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JsonSchematize
-  VERSION = "0.3.1"
+  VERSION = "0.5.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: json_schematize
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.5.1
 platform: ruby
 authors:
 - Matt Taylor
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-03-11 00:00:00.000000000 Z
+date: 2022-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry-byebug
@@ -90,10 +90,12 @@ files:
 - lib/json_schematize.rb
 - lib/json_schematize/base.rb
 - lib/json_schematize/boolean.rb
+- lib/json_schematize/empty_value.rb
 - lib/json_schematize/field.rb
 - lib/json_schematize/field_transformations.rb
 - lib/json_schematize/field_validators.rb
 - lib/json_schematize/generator.rb
+- lib/json_schematize/introspect.rb
 - lib/json_schematize/version.rb
 homepage: https://github.com/matt-taylor/json_schematize
 licenses: