canon 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a8c9da045b6e04e129d80c19a1ff7a3437841c28b5e3036913259eb3dc9fc7d
-  data.tar.gz: c0a871782a39c618ac5f947f748b6d2674f6c18c574d94a7526cdfc32bf58238
+  metadata.gz: fcf999be5f47b3ee417e783de5b54be7efe27c8123d0b2becaa8263587d224e6
+  data.tar.gz: 86c5c3679003d3b6ff1c96674ba10b7dc5ca6e92b39200b3729170185b030c2f
 SHA512:
-  metadata.gz: 7351aa91465f71a18cadb390b58fe9f39563822f9333f3d1e80a88538561c42518bb597873ac70d23ada797f39a3d9f2019e450cb498329aff4eeda32dd1c1a7
-  data.tar.gz: 05fee78316eebc60ebe29c99c755933a4c96e3cb463dabbffa07929505eb400e5c7a1aeb8cbf608e01cbaeaa859e4c4864ee4a415ddd379136d47fc70090ccc4
+  metadata.gz: 592cb969e6c55b8b19081f19a412746409b01113bdb1ec638931638606a301d0de360fd25a227681068f3ffbece325b180a85ccc9b5087bebd0b22ee24d67677
+  data.tar.gz: 0e96447cef7283e641218d3be17511d5fb49fa1995013136af1b3c8281d90feada43bcd95316621af01e69b7a065f4dc1635701b0991668a15f72bbdfe81819e

data/.rubocop.yml

@@ -2,10 +2,10 @@
 # See https://github.com/metanorma/cimas
 inherit_from:
   - .rubocop_todo.yml
-  - https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml
+  - https://raw.githubusercontent.com/riboseinc/oss-guides/main/ci/rubocop.yml
 
 # local repo-specific modifications
 # ...
 
 AllCops:
-  TargetRubyVersion: 2.7
+  TargetRubyVersion: 3.0

data/.rubocop_todo.yml

@@ -1,40 +1,29 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-07-29 05:56:24 UTC using RuboCop version 1.79.0.
+# on 2025-08-24 10:22:06 UTC using RuboCop version 1.79.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
-# URISchemes: http, https
-Layout/LineLength:
-  Exclude:
-    - 'canon.gemspec'
-    - 'spec/canon/xml/formatter_spec.rb'
-
 # Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleForMultiline.
-# SupportedStylesForMultiline: comma, consistent_comma, no_comma
-Style/TrailingCommaInArguments:
+# Configuration parameters: Severity, Include.
+# Include: **/*.gemspec
+Gemspec/RequiredRubyVersion:
   Exclude:
-    - 'lib/canon/rspec_matchers.rb'
+    - 'canon.gemspec'
 
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleForMultiline.
-# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
-Style/TrailingCommaInArrayLiteral:
+Layout/EmptyLineAfterGuardClause:
   Exclude:
     - 'lib/canon/rspec_matchers.rb'
 
-# Offense count: 1
+# Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleForMultiline.
-# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
-Style/TrailingCommaInHashLiteral:
+# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
   Exclude:
-    - 'lib/canon/rspec_matchers.rb'
+    - 'canon.gemspec'
+    - 'spec/canon/xml/formatter_spec.rb'

data/README.adoc

@@ -67,6 +67,26 @@ The `format` method is used to pretty-print and canonicalize the input data,
 with the arguments of the method taking the content and the format type as
 arguments.
 
+Syntax:
+
+[source,ruby]
+----
+# Generic method
+Canon.format({content}, {format})
+
+# Format-specific method
+Canon.format_{format}({content})
+----
+
+Where,
+
+`{content}`:: is the input string
+`{format}`:: is the format type, which can be `:xml`, `:yaml`, or `:json`.
+
+
+.Demonstration of formatting methods
+[example]
+====
 [source,ruby]
 ----
 require 'canon'
@@ -75,17 +95,24 @@ require 'canon'
 xml_input = '<root><b>2</b><a>1</a></root>'
 formatted_xml = Canon.format(xml_input, :xml)
 # => Pretty-printed XML with consistent formatting
+# or
+formatted_xml = Canon.format_xml(xml_input)
 
 # YAML formatting
 yaml_input = "---\nz: 3\na: 1\nb: 2\n"
 formatted_yaml = Canon.format(yaml_input, :yaml)
 # => YAML with keys sorted alphabetically
+# or
+formatted_yaml = Canon.format_yaml(yaml_input)
 
 # JSON formatting
 json_input = '{"z":3,"a":1,"b":2}'
 formatted_json = Canon.format(json_input, :json)
 # => Pretty-printed JSON with keys sorted alphabetically
+# or
+formatted_json = Canon.format_json(json_input)
 ----
+====
 
 
 === Parsing
@@ -94,20 +121,44 @@ Canon can also parse XML, YAML, and JSON strings into Ruby objects. The `parse`
 method takes the content and the format type as arguments, returning a Ruby
 object (Hash, Array, etc.) for YAML and JSON, or a Nokogiri XML document for XML.
 
+Syntax:
+
+[source,ruby]
+----
+# Generic method
+Canon.parse({content}, {format})
+
+# Format-specific method
+Canon.parse_{format}({content})
+----
+
+Where,
+
+`{content}`:: is the input string
+`{format}`:: is the format type, which can be `:xml`, `:yaml`, or `:json`.
+
+.Demonstration of parsing methods
+[example]
+====
 [source,ruby]
 ----
 # Parse XML
 xml_doc = Canon.parse(xml_input, :xml)
+xml_doc = Canon.parse_xml(xml_input)
 # => Nokogiri::XML::Document
 
 # Parse YAML
 yaml_obj = Canon.parse(yaml_input, :yaml)
+yaml_obj = Canon.parse_yaml(yaml_input)
 # => Ruby object (Hash, Array, etc.)
 
 # Parse JSON
 json_obj = Canon.parse(json_input, :json)
+json_obj = Canon.parse_json(json_input)
 # => Ruby object (Hash, Array, etc.)
 ----
+====
+
 
 === RSpec matchers
 
@@ -166,4 +217,3 @@ https://github.com/lutaml/canon.
 == Copyright and license
 
 Copyright Ribose. https://opensource.org/licenses/BSD-2-Clause[BSD-2-Clause License].
-

data/lib/canon/rspec_matchers.rb

@@ -15,14 +15,17 @@ module Canon
     class SerializationMatcher
       def initialize(expected, format = :xml)
         @expected = expected
+        unless SUPPORTED_FORMATS.include?(format.to_sym)
+          raise Canon::Error, "Unsupported format: #{format}"
+        end
+
         @format = format.to_sym
         @result = nil
       end
 
       def matches?(target)
         @target = target
-        send("match_#{@format}") ||
-          raise(Canon::Error, "Unsupported format: #{@format}")
+        send("match_#{@format}")
       rescue NoMethodError
         raise Canon::Error, "Unsupported format: #{@format}"
       end

data/lib/canon/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Canon
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

data/lib/canon.rb

@@ -8,6 +8,8 @@ require_relative "canon/formatters/json_formatter"
 require_relative "canon/rspec_matchers" if defined?(::RSpec)
 
 module Canon
+  SUPPORTED_FORMATS = %i[xml yaml json].freeze
+
   # Format content based on the specified format type
   # @param content [String] The content to format
   # @param format [Symbol] The format type (:xml, :yaml, :json)
@@ -37,5 +39,17 @@ module Canon
     end
   end
 
+  # Define shorthand methods for each supported format
+  # Creates parse_{format} and format_{format} methods
+  SUPPORTED_FORMATS.each do |format|
+    define_singleton_method("parse_#{format}") do |content|
+      parse(content, format)
+    end
+
+    define_singleton_method("format_#{format}") do |content|
+      format(content, format)
+    end
+  end
+
   class Error < StandardError; end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: canon
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-29 00:00:00.000000000 Z
+date: 2025-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: compare-xml