kwalify_to_json_schema 0.2.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0655ac6570cc133063989b7781e8057fe9054ad609a7306411de16d7f3318e20
-  data.tar.gz: 49e0cb1f1473f3688b4c3a993c0c0c49057581d640d5f0ec0f131152c76e74df
+  metadata.gz: b6c69311e6acfcc28fea0bcfaeb66c5378f87a6021bf51e275c55946bf6fe2f4
+  data.tar.gz: 1424cced2ddf03ee281266745b9bc5b52a230ac2f99ba58b1cc772eb611ca100
 SHA512:
-  metadata.gz: 535ae226d987f26c1d4d8d1348486bfaefe6d37e927a80a4b0db3265018758aea2cc3953010706398c9802fc6c55f8cc083216b1bb3d4a325179aa12ef1baefa
-  data.tar.gz: fd6257842bc6ec9327152d67f6ae879fc8d5aad8cfc1897d5247b93d6152711a705f53bd244546c8f704f2bcbcf1ce2ccda6455ca3a6ab5c90a8a7710f4d2730
+  metadata.gz: 4e517fcf1bef41d0ff88c5d1dab70c7c4322791675cf905598f06aab6320358f9375691f3123584cd9c327f7c8a023e1eaf89f3768f01b68bb801edfeefa7b87
+  data.tar.gz: 40efd0e3eb515e9f441cc4a6a0d09bdfca4b2cd993a2a597942f921e27fc463ba72a1294788a1399370c558e66717b9a18f1856ea41b3e8908a88396f9ce806b

data/lib/kwalify_to_json_schema.rb

@@ -6,6 +6,8 @@ require_relative "kwalify_to_json_schema/kwalify_to_json_schema"
 require_relative "kwalify_to_json_schema/serialization"
 require_relative "kwalify_to_json_schema/options"
 require_relative "kwalify_to_json_schema/limitations"
+require_relative "kwalify_to_json_schema/issue"
+require_relative "kwalify_to_json_schema/issues"
 require_relative "kwalify_to_json_schema/converter"
 require_relative "kwalify_to_json_schema/custom_processing"
 require_relative "kwalify_to_json_schema/cli"

data/lib/kwalify_to_json_schema/cli.rb

@@ -29,6 +29,9 @@ module KwalifyToJsonSchema
     option(*Options.cli_option(Options::TITLE))
     option(*Options.cli_option(Options::DESCRIPTION))
     option(*Options.cli_option(Options::ISSUES_TO_DESCRIPTION))
+    option(*Options.cli_option(Options::ISSUES_TO_STDERR))
+    option(*Options.cli_option(Options::SCHEMA_VERSION))
+    option(*Options.cli_option(Options::VERBOSE))
     option Options::CUSTOM_PROCESSING,
            :type => :string,
            :desc => <<~DESC
@@ -58,6 +61,8 @@ module KwalifyToJsonSchema
            :default => false,
            :desc => "Process files recursively",
            :long_desc => ""
+    option(*Options.cli_option(Options::SCHEMA_VERSION))
+    option(*Options.cli_option(Options::VERBOSE))
     option Options::CUSTOM_PROCESSING,
            :type => :string,
            :desc => <<~DESC
@@ -67,11 +72,9 @@ module KwalifyToJsonSchema
            DESC
 
     def convert_dir(kwalify_schema_dir, result_dir)
-      opts = {
-        Options::ISSUES_TO_DESCRIPTION => options[:issues_to_description],
-        Options::CUSTOM_PROCESSING => custom_processing(options),
-      }
-
+      opts = options.dup
+      opts[Options::CUSTOM_PROCESSING] = custom_processing(options)
+      
       path = [kwalify_schema_dir, options["recursive"] ? "**" : nil, "*.yaml"].compact
       Dir.glob(File.join(*path)).each { |kwalify_schema_file|
         result_file = File.join(result_dir, File.basename(kwalify_schema_file, File.extname(kwalify_schema_file))) + ".#{options["format"]}"

data/lib/kwalify_to_json_schema/converter.rb

@@ -11,7 +11,7 @@ module KwalifyToJsonSchema
   #
   # File.write("json_schema.json", JSON.pretty_generate(json_schema))
   class Converter
-    SCHEMA = "http://json-schema.org/draft-07/schema#"
+    SCHEMA = "http://json-schema.org/%s/schema#"
 
     # The options given used to initialized the converter
     attr_reader :options
@@ -24,12 +24,16 @@ module KwalifyToJsonSchema
     # | :id                   | string | nil          | The JSON schema identifier                                                               |
     # | :title                | string | nil          | The JSON schema title                                                                    |
     # | :description          | string | nil          | The JSON schema description. If not given the Kwalify description will be used if present|
-    # | :issues_to_description| boolean| false        | To append the issuses to the JSON schema description                                     |
+    # | :issues_to_description| boolean| false        | To append the issues to the JSON schema description                                      |
+    # | :issues_to_stderr     | boolean| false        | To write the issues to standard error output                                             |
     # | :custom_processing    | object | nil          | To customize the conversion                                                              |
+    # | :schema_version       | string | "draft-04"   | JSON schema version. Changing this value only change the value of $schema field          |
+    # | :verbose              | boolean| false        | To be verbose when converting                                                            |
     # --
-    def initialize(options_hash = {})
-      @options = Options.new(options_hash)
-      @issues = []
+    # @param options {Options} or {Hash}
+    def initialize(options = {})
+      @options = Options.new(options)
+      @issues = Issues.new
     end
 
     # Execute the conversion process
@@ -43,11 +47,12 @@ module KwalifyToJsonSchema
       if issues.any? && options.issues_to_description?
         description = json_schema["description"] ||= ""
         description << "Issues when converting from Kwalify:\n"
-        description << issues.map { |issue| "* #{issue}" }.join("\n")
+        description << issues.descriptions_uniq.map { |description| "* #{description}" }.join("\n")
       end
 
       # Override description if given in option
       json_schema["description"] = options.description if options.description
+      STDERR.puts issues if options.issues_to_stderr?
 
       postprocess(json_schema)
     end
@@ -56,20 +61,22 @@ module KwalifyToJsonSchema
 
     def root
       {
-        "$schema" => SCHEMA,
-        "$id" => options.id,
+        "$schema" => SCHEMA % options.schema_version,
+        "id" => options.id,
         "title" => options.title,
       }.reject { |k, v| v.nil? }
     end
 
     # @param target Json schema target
     # @param kelem Kwalify element
-    def process(target, kelem)
+    def process(target, kelem, path = [])
 
       # Add description if available
       target["description"] = kelem["desc"] if kelem["desc"]
+      ktype = kelem["type"]
+      path += [ktype] if ktype
 
-      case ktype = kelem["type"]
+      case ktype
       when "map"
         target["type"] = "object"
         target["additionalProperties"] = false
@@ -78,7 +85,12 @@ module KwalifyToJsonSchema
         if mapping.is_a? Hash
           properties = target["properties"] = {}
           mapping.each_pair { |name, e|
-            process(properties[name] = {}, e)
+            # Ignore mapping default value
+            if name == "="
+              new_issue path, Limitations::MAPPING_DEFAULT_VALUE_NOT_SUPPORTED
+              next
+            end
+            process(properties[name] = {}, e, path + [name])
             required << name if e["required"] == true
           }
           target["required"] = required unless required.empty?
@@ -105,13 +117,13 @@ module KwalifyToJsonSchema
         target["type"] = "boolean"
       when "date"
         # TODO
-        new_issue Limitations::DATE_TYPE_NOT_IMPLEMENTED
+        new_issue path, Limitations::DATE_TYPE_NOT_IMPLEMENTED
       when "time"
         # TODO
-        new_issue Limitations::TIME_TYPE_NOT_IMPLEMENTED
+        new_issue path, Limitations::TIME_TYPE_NOT_IMPLEMENTED
       when "timestamp"
         # TODO
-        new_issue Limitations::TIMESTAMP_TYPE_NOT_IMPLEMENTED
+        new_issue path, Limitations::TIMESTAMP_TYPE_NOT_IMPLEMENTED
       when "scalar"
         # Use one of
         target["oneOf"] = [
@@ -123,7 +135,7 @@ module KwalifyToJsonSchema
       when "any"
         # Don't put type
       else
-        new_issue("Unknown Kwalify type #{ktype}")
+        new_issue(path, "Unknown Kwalify type #{ktype}")
       end
 
       target["enum"] = kelem["enum"] if kelem["enum"]
@@ -154,7 +166,7 @@ module KwalifyToJsonSchema
         end
       end
 
-      new_issue UNIQUE_NOT_SUPPORTED if kelem["unique"]
+      new_issue path, Limitations::UNIQUE_NOT_SUPPORTED if kelem["unique"]
 
       target
     end
@@ -171,8 +183,8 @@ module KwalifyToJsonSchema
       ep.postprocess(json_schema)
     end
 
-    def new_issue(description)
-      @issues << description
+    def new_issue(path, description)
+      @issues << Issue.new(path, description)
     end
   end
 end

data/lib/kwalify_to_json_schema/issue.rb

@@ -0,0 +1,16 @@
+module KwalifyToJsonSchema
+  # Used to represent issues encoutered while converting
+  class Issue
+    attr_reader :path
+    attr_reader :description
+
+    def initialize(path, description)
+      @path = path
+      @description = description
+    end
+
+    def to_s
+      "Issue #{path.join "/"}: #{description}"
+    end
+  end
+end

data/lib/kwalify_to_json_schema/issues.rb

@@ -0,0 +1,10 @@
+module KwalifyToJsonSchema
+  # Used to hold issues encoutered while converting
+  class Issues < Array
+
+    # Get an array with only one instance of each description
+    def descriptions_uniq
+      map(&:description).uniq
+    end
+  end
+end

data/lib/kwalify_to_json_schema/kwalify_to_json_schema.rb

@@ -10,12 +10,18 @@ module KwalifyToJsonSchema
   # | :id                   | string | nil          | The JSON schema identifier                                                               |
   # | :title                | string | nil          | The JSON schema title                                                                    |
   # | :description          | string | nil          | The JSON schema description. If not given the Kwalify description will be used if present|
-  # | :issues_to_description| boolean| false        | To append the issuses to the JSON schema description                                     |
+  # | :issues_to_description| boolean| false        | To append the issues to the JSON schema description                                      |
+  # | :issues_to_stderr     | boolean| false        | To write the issues to standard error output                                             |
   # | :custom_processing    | object | nil          | To customize the conversion                                                              |
+  # | :schema_version       | string | "draft-04"   | JSON schema version. Changing this value only change the value of $schema field          |
+  # | :verbose              | boolean| false        | To be verbose when converting                                                            |
   # --
   # @param source Path to Kwalify YAML schema
   # @param dest Path to resulting JSON schema
   def self.convert_file(source, dest, options = {})
+    options = Options.new(options)
+    puts "Converting file://#{File.expand_path source } to file://#{File.expand_path dest}" if options.verbose?
+
     # Get a converter
     converter = Converter.new(options)
     # Convert
@@ -33,14 +39,18 @@ module KwalifyToJsonSchema
   # | :id                   | string | nil          | The JSON schema identifier                                                               |
   # | :title                | string | nil          | The JSON schema title                                                                    |
   # | :description          | string | nil          | The JSON schema description. If not given the Kwalify description will be used if present|
-  # | :issues_to_description| boolean| false        | To append the issuses to the JSON schema description                                     |
+  # | :issues_to_description| boolean| false        | To append the issues to the JSON schema description                                      |
+  # | :issues_to_stderr     | boolean| false        | To write the issues to standard error output                                             |
   # | :custom_processing    | object | nil          | To customize the conversion                                                              |
+  # | :schema_version       | string | "draft-04"   | JSON schema version. Changing this value only change the value of $schema field          |
+  # | :verbose              | boolean| false        | To be verbose when converting                                                            |
   # --
   # @param kwalify_schema Kwalify schema as YAML or JSON
   # @param source_format format of the source schema
   # @param dest_format format of the destination schema
   # @param options
   def self.convert_string(kwalify_schema, source_format = "yaml", dest_format = "json", options = {})
+    options = Options.new(options)
     # Get a converter
     converter = Converter.new(options)
     # Convert

data/lib/kwalify_to_json_schema/limitations.rb

@@ -5,5 +5,6 @@ module KwalifyToJsonSchema
     TIME_TYPE_NOT_IMPLEMENTED = "Kwalify 'time' type is not supported and is ignored"
     TIMESTAMP_TYPE_NOT_IMPLEMENTED = "Kwalify 'timestamp' type is not supported and is ignored"
     UNIQUE_NOT_SUPPORTED = "Kwalify 'unique' is not supported by JSON Schema and is ignored"
+    MAPPING_DEFAULT_VALUE_NOT_SUPPORTED = "Kwalify mapping default value is not supported by JSON Schema and is ignored"
   end
 end

data/lib/kwalify_to_json_schema/options.rb

@@ -7,22 +7,32 @@ module KwalifyToJsonSchema
     # | :id                   | string | nil          | The JSON schema identifier                                                               |
     # | :title                | string | nil          | The JSON schema title                                                                    |
     # | :description          | string | nil          | The JSON schema description. If not given the Kwalify description will be used if present|
-    # | :issues_to_description| boolean| false        | To append the issuses to the JSON schema description                                     |
+    # | :issues_to_description| boolean| false        | To append the issues to the JSON schema description                                      |
+    # | :issues_to_stderr     | boolean| false        | To write the issues to standard error output                                             |
     # | :custom_processing    | object | nil          | To customize the conversion                                                              |
+    # | :schema_version       | string | "draft-04"   | JSON schema version. Changing this value only change the value of $schema field          |
+    # | :verbose              | boolean| false        | To be verbose when converting                                                            |
     # --
     DECLARATION = %q(
     ID                    # The JSON schema identifier [string] (nil)
     TITLE                 # The JSON schema title [string] (nil)
     DESCRIPTION           # The JSON schema description. If not given the Kwalify description will be used if present [string] (nil)
-    ISSUES_TO_DESCRIPTION # To append the issuses to the JSON schema description [boolean] (false)
+    ISSUES_TO_DESCRIPTION # To append the issues to the JSON schema description [boolean] (false)
+    ISSUES_TO_STDERR      # To write the issues to standard error output [boolean] (false)
     CUSTOM_PROCESSING     # To customize the conversion [object] (nil)
+    SCHEMA_VERSION        # JSON schema version. Changing this value only change the value of $schema field[string] ("draft-04")
+    VERBOSE               # To be verbose when converting [boolean] (false)
     )
 
     # The options as Hash
     attr_reader :options_hash
 
-    def initialize(options_hash)
-      @options_hash = options_hash
+    def initialize(options)
+      @options_hash = options.is_a?(Options) ? options.options_hash : options
+    end
+
+    def to_s
+      YAML.dump("Options" => options_hash)
     end
 
     # Parse options declaration text and give an array of Hash

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kwalify_to_json_schema
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Sylvain Gamot
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-10 00:00:00.000000000 Z
+date: 2020-07-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -80,7 +80,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 12.3.0
-description: Allows to convert Kwalify schemas to JSON schemas Draft 7
+description: Allows to convert Kwalify schemas to JSON schemas
 email: ''
 executables:
 - kwalify_to_json_schema
@@ -92,6 +92,8 @@ files:
 - lib/kwalify_to_json_schema/cli.rb
 - lib/kwalify_to_json_schema/converter.rb
 - lib/kwalify_to_json_schema/custom_processing.rb
+- lib/kwalify_to_json_schema/issue.rb
+- lib/kwalify_to_json_schema/issues.rb
 - lib/kwalify_to_json_schema/kwalify_to_json_schema.rb
 - lib/kwalify_to_json_schema/limitations.rb
 - lib/kwalify_to_json_schema/options.rb
@@ -117,7 +119,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubyforge_project: 
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Kwalify schemas to JSON schemas conversion