rsmp_schema 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: badefc8cfd4f1df332cad770cd02b9394d19fe327860206cf59ed745b7f051cd
-  data.tar.gz: d04eebeede6747cd5b245ef66c83b1d0256c14bd7df21f6f2d94176bfd146536
+  metadata.gz: d77598d55d8ad5356f08539dae9c80c2f0887240f3d7cc45fe8f81a39e22467f
+  data.tar.gz: 376dde9dc8d380588293178dba3b968ac8a558c52832804e0aea5c0d065627f1
 SHA512:
-  metadata.gz: 4ba94206d0fc23153dff5474dc4fea59112d24319a7bf1932ea5ada2bf1f77412b2231913cce74f11f69f9783fa319aff41b0a57cc08a35770ee401e7c01205f
-  data.tar.gz: afb8edf5054d2e430b174bb881b149eab1487891ef774239e3cbc9b87419b1afbbc2aa7a6504e35a512c7694480c762c08e42a77c72a84fa673e2d3c3ed9db63
+  metadata.gz: f49e353daeca137c0a542dfad6f49f6c927786fbef5f3b8242bf9dd29f091e398ef10ba206ebf71a64c8d64f258400c0b3b24c87b4e62cc39aaa6dd3d76bbbaa
+  data.tar.gz: 7c0565ff56406fbfc56f6b711e1b26a42d9bf1a50b708ed659b53628963f42b37922814ed2e0f517c302dd205ffbf888d22bd11f93be9a875f88ab84d6241dbc

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rsmp_schema (0.2.0)
+    rsmp_schema (0.2.1)
       json_schemer (~> 0.2.21)
       thor (~> 1.2.1)
 

data/lib/rsmp_schema/schema.rb

@@ -6,32 +6,66 @@ end
 module RSMP::Schema
   @@schemas = nil
 
-  def self.schemas
-    return @@schemas if @@schemas
+  def self.setup
+    @@schemas = {}
     schemas_path = File.expand_path( File.join(__dir__,'..','..','schemas') )
-    @@schemas = {
-      core: {
-        '3.1.1' => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'core','3.1.1','rsmp.json')) ),
-        '3.1.2' => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'core','3.1.2','rsmp.json')) ),
-        '3.1.3' => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'core','3.1.3','rsmp.json')) ),
-        '3.1.4' => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'core','3.1.4','rsmp.json')) ),
-        '3.1.5' => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'core','3.1.5','rsmp.json')) ),
-        '3.2'   => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'core','3.2',  'rsmp.json')) )
-      },
-      # note that tlc 1.0.11 and 1.0.12 does not exist (unreleased drafts)
-      tlc: {
-        '1.0.7'  => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'tlc','1.0.7' ,'sxl.json')) ),
-        '1.0.8'  => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'tlc','1.0.8' ,'sxl.json')) ),
-        '1.0.9'  => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'tlc','1.0.9' ,'sxl.json')) ),
-        '1.0.10' => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'tlc','1.0.10','sxl.json')) ),
-        '1.0.13' => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'tlc','1.0.13','sxl.json')) ),
-        '1.0.14' => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'tlc','1.0.14','sxl.json')) ),
-        '1.0.15' => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'tlc','1.0.15','sxl.json')) ),
-        '1.1'    => JSONSchemer.schema( Pathname.new(File.join(schemas_path, 'tlc','1.1',   'sxl.json')) )
-      }
-    }
+    Dir.glob("#{schemas_path}/*").select {|f| File.directory? f}.each do |type_path|
+      type = File.basename(type_path).to_sym
+      @@schemas[type] = {}
+      Dir.glob("#{type_path}/*").select {|f| File.directory? f}.each do |schema_path|
+        version = File.basename(schema_path)
+        if type == :core
+          file = 'rsmp.json'
+        else
+          file = 'sxl.json'
+        end
+        @@schemas[type][version] = JSONSchemer.schema(
+          Pathname.new(File.join(schema_path,file))
+        )
+      end
+    end
+  end
+
+  # get all schemas, oganized by type and version
+  def self.schemas
+    raise RuntimeError.new("No schemas available, perhaps Schema.setup was never called?") unless @@schemas
+    @@schemas
+  end
+
+  # get array of core schema versions
+  def self.core_versions
+    versions :core
+  end
+
+  # get earliest core schema version
+  def self.earliest_core_version
+    earliest_version :core
   end
 
+  # get latesty core schema version
+  def self.latest_core_version
+    latest_version :core
+  end
+
+  # get array of  schema versions for a particular schema type
+  def self.versions type
+    schemas = find_schemas!(type).keys
+    sort_versions(schemas)
+  end
+
+  # get earliest schema version for a particular schema type
+  def self.earliest_version type
+    schemas = find_schemas!(type).keys
+    sort_versions(schemas).first
+  end
+
+  # get latest schema version for a particular schema type
+  def self.latest_version type
+    schemas = find_schemas!(type).keys
+    sort_versions(schemas).last
+  end
+
+  # validate an rsmp messages using a schema object
   def self.validate_using_schema message, schema
     raise ArgumentError.new("message missing") unless message
     raise ArgumentError.new("schema missing") unless schema
@@ -44,17 +78,28 @@ module RSMP::Schema
     end
   end
 
+  # sort version strings
+  def self.sort_versions versions
+    versions.sort_by { |k| Gem::Version.new(k) }
+  end
+
+  # find schemas versions for particular schema type
+  # return nil if type not found
   def self.find_schemas type
     raise ArgumentError.new("type missing") unless type
-    schemas[type.to_sym]
+    schemas = @@schemas[type.to_sym]
   end
 
+  # find schemas versions for particular schema type
+  # raise error if not found
   def self.find_schemas! type
     schemas = find_schemas type
     raise UnknownSchemaTypeError.new("Unknown schema type #{type}") unless schemas
     schemas
   end
 
+  # find schema for a particular schema and version
+  # return nil if not found
   def self.find_schema type, version, options={}
     raise ArgumentError.new("version missing") unless version
     version = sanitize_version version if options[:lenient]
@@ -65,11 +110,18 @@ module RSMP::Schema
     nil
   end
 
+  # get major.minor.patch part of a version string, where patch is optional
+  # ignore trailing characters, e.g.
+  #   3.1.3.32A => 3.1.3
+  #   3.1A3r3 >= 3.1
+  # return nil if string doesn't match
   def self.sanitize_version version
     matched = /^\d+\.\d+(\.\d+)?/.match version
     matched.to_s if matched
   end
 
+  # find schema for a particular schema and version
+  # raise error if not found
   def self.find_schema! type, version, options={}
     schema = find_schema type, version, options
     raise ArgumentError.new("version missing") unless version
@@ -82,10 +134,14 @@ module RSMP::Schema
     raise UnknownSchemaVersionError.new("Unknown schema version #{type} #{version}")
   end
 
+  # true if a particular schema type and version found
   def self.has_schema? type, version, options={}
     find_schema(type,version, options) != nil
   end
 
+  # validate using a particular schema and version
+  # raises error if schema is not found
+  # return nil if validation succeds, otherwise returns an array of errors
   def self.validate message, schemas, options={}
     raise ArgumentError.new("message missing") unless message
     raise ArgumentError.new("schemas missing") unless schemas

data/lib/rsmp_schema/version.rb

@@ -1,5 +1,5 @@
 module RSMP
   module Schema
-    VERSION = "0.2.0"
+    VERSION = "0.2.1"
   end
 end

data/lib/rsmp_schema.rb

@@ -5,3 +5,5 @@ require 'rsmp_schema/schema'
 require 'rsmp_schema/convert/import/yaml'
 require 'rsmp_schema/convert/export/json_schema'
 require 'rsmp_schema/version'
+
+RSMP::Schema.setup

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rsmp_schema
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Emil Tin
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-08-24 00:00:00.000000000 Z
+date: 2022-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json_schemer