scheming 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b21c99fc59c9fe7da35644b47be93b2d6bba2f13f4ef814008a64c92f2235323
-  data.tar.gz: c0ff8026a852f0b8e4c91bf86aa4a172502a12b3c89dcd693527863dc7cf58aa
+  metadata.gz: c861bcba1706b9ffe842a7d13cb55b047479d57a1c7e44a6e7fa7a934c83819a
+  data.tar.gz: 8837b76f3fa1c0c334387432a8c466085a96064482b4ff1dd00bbabc2b69c1ae
 SHA512:
-  metadata.gz: 93fa8e2cd04de2c77495754fe04aa2cbd84070a862835c83ef535a7830b6e41337b401f2e35dbf297434397523e24b50c8cb97063745fe58d61f881114187424
-  data.tar.gz: 61c3cf8462b6d9075e593d00fa76921bbb7958e1ac2590f2a4683ff5c2aeac40b28209e579270eff279cea0261d6d1ea8194a0a87d2ebd3b56f93f8bfc8a2966
+  metadata.gz: c8d822270972cb4abc4837c89fa8084b78132af50acc829e7b610fe74cb5ce6bc517ea579528b489b774daa4aec17dd971704ad7f54c3113589d0fee225b22ed
+  data.tar.gz: 3c72a5b224d4d345ee050045d75f72ae74413e1bb78be6f1203795b4ed015f5327ca2e998a05712e086aef4b5d4925818c09c3afb98c5ffb1ac94ba1b6374296

data/CHANGELOG.md

@@ -1,5 +1,47 @@
 ## [Unreleased]
 
+## [0.6.0]
+
+### Added
+
+- `Union` type added
+
+  # Example
+  ```ruby
+  Order = Scheming.object do
+    attribute :id, Union(String, Integer)
+  end
+
+  Scheming::Schema.json(Order)
+  # =>
+  {
+    oneOf: [
+      { type: 'string' },
+      { type: 'integer' }
+    ]
+  }
+  ```
+
+### Fixed
+
+- Incorrect YARD comment tags and syntax.
+
+### Breaking Change
+
+- Switch from `json-schema` to `json_schemer`
+
+  > TL;DR
+    required object properties for the JSON schema
+    are now strings instead of symbols
+
+  After doing to research I've found that `json_schemer` is
+  more maintained than what was currently being used.  It has
+  a smaller footprint and is much faster at validation.
+
+  As a consequence the `required` properties needed to be
+  changed from symbols to strings in the generated JSON schema.
+
+
 ## [0.5.0] - 2024-05-02
 
 ### Added

data/Gemfile

@@ -6,7 +6,7 @@ source 'https://rubygems.org'
 gemspec
 
 gem 'factory_bot', '~> 6.4'
-gem 'json-schema', '~> 4.3'
+gem 'json_schemer'
 gem 'pry', '~> 0.14.2'
 gem 'rake', '~> 13.0'
 gem 'rspec', '~> 3.0'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    scheming (0.5.0)
+    scheming (0.6.0)
 
 GEM
   remote: https://rubygems.org/
@@ -16,8 +16,6 @@ GEM
       minitest (>= 5.1)
       mutex_m
       tzinfo (~> 2.0)
-    addressable (2.8.6)
-      public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
     base64 (0.2.0)
     bigdecimal (3.1.7)
@@ -28,11 +26,16 @@ GEM
     drb (2.2.1)
     factory_bot (6.4.6)
       activesupport (>= 5.0.0)
+    hana (1.3.7)
     i18n (1.14.4)
       concurrent-ruby (~> 1.0)
     json (2.7.2)
-    json-schema (4.3.0)
-      addressable (>= 2.8)
+    json_schemer (2.2.1)
+      base64
+      bigdecimal
+      hana (~> 1.3)
+      regexp_parser (~> 2.0)
+      simpleidn (~> 0.2)
     language_server-protocol (3.17.0.3)
     method_source (1.1.0)
     minitest (5.22.3)
@@ -44,7 +47,6 @@ GEM
     pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    public_suffix (5.0.5)
     racc (1.7.3)
     rainbow (3.1.1)
     rake (13.2.1)
@@ -77,8 +79,13 @@ GEM
     rubocop-ast (1.31.2)
       parser (>= 3.3.0.4)
     ruby-progressbar (1.13.0)
+    simpleidn (0.2.2)
+      unf (~> 0.1.4)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.9.1)
     unicode-display_width (2.5.0)
 
 PLATFORMS
@@ -86,7 +93,7 @@ PLATFORMS
 
 DEPENDENCIES
   factory_bot (~> 6.4)
-  json-schema (~> 4.3)
+  json_schemer
   pry (~> 0.14.2)
   rake (~> 13.0)
   rspec (~> 3.0)

data/README.md

@@ -15,7 +15,7 @@ gem 'scheming'
 Definition:
 ```ruby
 LineItem = Scheming.object do
-  attribute :id, Integer
+  attribute :id, Union(Integer, String)
   attribute :name, String
   attribute :taxable, :bool
   attribute :price, Float
@@ -45,16 +45,21 @@ Scheming::Schema.json(Receipt)
 {
   type: 'object',
   additionalProperties: false,
-  required: %i[line_items total location],
+  required: %w[line_items total location],
   properties: {
     line_items: {
       type: 'array',
       items: {
         type: 'object',
         additionalProperties: false,
-        required: %i[id name taxable price],
+        required: %w[id name taxable price],
         properties: {
-          id: { type: 'integer' },
+          id: {
+            oneOf: [
+              { type: 'integer' },
+              { type: 'string' }
+            ]
+          },
           name: { type: 'string' },
           taxable: { type: 'boolean' },
           desc: {
@@ -75,7 +80,7 @@ Scheming::Schema.json(Receipt)
     location: {
       type: 'object',
       additionalProperties: false,
-      required: %i[x y],
+      required: %w[x y],
       properties: {
         x: { type: 'number' },
         y: { type: 'number' }

data/lib/scheming/dsl/data_builder.rb

@@ -12,7 +12,6 @@ class Scheming::DSL::DataBuilder
 
   # @param field_name [Symbol]
   # @param type_spec [Object]
-  # @param null [Boolean]
   # @return [void]
   def attribute(field_name, type_spec)
     @builder = @builder.attribute(

data/lib/scheming/dsl/tagging.rb

@@ -10,7 +10,7 @@ class Scheming::DSL::Tagging
   #
   class Tag
     # @param name [Symbo]
-    # @data [Hash<Symbol, Object>]
+    # @param data [Hash<Symbol, Object>]
     def initialize(name, data)
       @name = name
       @data = data
@@ -29,8 +29,8 @@ class Scheming::DSL::Tagging
     nil
   end
 
-  # @param taglist [Hash<Symbol, Object>]
   # @param name [Symbol]
+  # @param data [Hash<Symbol, Object>]
   # @return [Tag]
   def tag!(name, data)
     @tags[name] = Tag.new(name, data)

data/lib/scheming/dsl/type_specs.rb

@@ -26,4 +26,11 @@ module Scheming::DSL::TypeSpecs
     type = Scheming::DSL::TypeResolver.resolve(type_spec)
     Scheming::Type::Nullable.new(type)
   end
+
+  def Union(*type_specs) # rubocop:disable Naming/MethodName
+    types = type_specs.map do |type_spec|
+      Scheming::DSL::TypeResolver.resolve(type_spec)
+    end
+    Scheming::Type::Union.new(types)
+  end
 end

data/lib/scheming/schema/json.rb

@@ -29,7 +29,10 @@ module Scheming::Schema
       private
 
       def required
-        attributes.required.map!(&:field_name).freeze
+        attributes
+          .required
+          .map! { |attr| attr.field_name.to_s.freeze }
+          .freeze
       end
 
       def properties
@@ -39,6 +42,13 @@ module Scheming::Schema
       end
     end
 
+    refine Scheming::Type::Union do
+      # @!attribute [r] types
+      #   @return [Array<Scheming::Type::Base>]
+
+      def schema = { oneOf: types.map(&:schema).freeze }
+    end
+
     refine Scheming::Type::Nullable do
       # @!attribute [r] type
       #   @return [Scheming::Type::Base]

data/lib/scheming/type.rb

@@ -47,6 +47,23 @@ module Scheming::Type
     end
   end
 
+  # = Union Type Definition
+  #
+  # In cases where a value can be of many different
+  # types a union is how to describe this.
+  #
+  class Union < Base
+    # @return [Array<Scheming::Type::Base>]
+    attr_reader :types
+
+    # @param types [Array<Scheming::Type::Base>]
+    def initialize(types)
+      super()
+      @types = types
+      freeze
+    end
+  end
+
   # = Enumeration Type Definition
   #
   # The wrapper that describes a type and holds

data/lib/scheming/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Scheming
-  VERSION = '0.5.0'
+  VERSION = '0.6.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: scheming
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Ben Falk
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-05-03 00:00:00.000000000 Z
+date: 2024-05-04 00:00:00.000000000 Z
 dependencies: []
 description: Ergonomic Data Design for the Masses
 email: