pubid-core 0.2.1 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8847ef40fe0ba41c09fa45dd46c2451d3d5f855a95528f740211a5558197b7b4
-  data.tar.gz: 200ac6ed205bfd7a2f145995f070f45725fbcf20fc7e9ad70739781bbaf0e0fa
+  metadata.gz: 6fc24ad8424ccb4843c213b8642d558e4139671d9f7a302246f917510a20ad71
+  data.tar.gz: c8284af8dcb32ae4e13853ea8195e376769bbc745984f6639ee86780405f57d4
 SHA512:
-  metadata.gz: 7a1c32702076a06496b53347c050db49b563543749a001f0876a1b0c4da61dee598bacb70a46bea8707ec6d97d9046a9f1bacaa89e3255d6ffb80c7ac0c69a80
-  data.tar.gz: d426ab52f5f2e81dd90fdcbc435910f9e71ff4347d980260743975408d060b7e0b5462b8b990cd8248298b47716b1750a666b07d33ccc4562d2d2f3bb77cfc78
+  metadata.gz: 6dafa25189561f26dd3e3908294d4649af1c891175eb6b546ca8e95c90aafb4dfbde8b1fa4271ca8bb540ce3824947a7d7e08c10945853530615204692990504
+  data.tar.gz: d7b4857f481c5aac96491c83b70367ebc50d3dd3e9d2ee4956d2c5b825f210657419e3778d23f3c8fccb975acd444c051c6aebb93eec392143bd35747218f831

data/lib/pubid/core/identifier.rb

@@ -4,7 +4,23 @@ module Pubid::Core
                   :type, :year, :edition, :language, :amendments,
                   :corrigendums
 
-    def initialize(amendments: nil, corrigendums: nil, **opts)
+    # Creates new identifier from options provided:
+    # @param publisher [String] document's publisher, eg. "ISO"
+    # @param copublisher [String,Array<String>] document's copublisher, eg. "IEC"
+    # @param number [Integer] document's number, eg. "1234"
+    # @param part [String] document's part and subparts, eg. "1", "1-1A", "2-3D"
+    # @param type [String] document's type, eg. "TR", "TS"
+    # @param year [Integer] document's year, eg. "2020"
+    # @param edition [Integer] document's edition, eg. "1"
+    # @param language [String] document's translation language
+    #   (available languages: "ru", "fr", "en", "ar")
+    # @param amendments [Array<Amendment>] document's amendments
+    # @param corrigendums [Array<Corrigendum>] document's corrigendums
+    # @see Amendment
+    # @see Corrigendum
+    def initialize(publisher:, number:, copublisher: nil, part: nil, type: nil,
+                   year: nil, edition: nil, language: nil, amendments: nil,
+                   corrigendums: nil)
       if amendments
         @amendments = if amendments.is_a?(Array)
                         amendments.map do |amendment|
@@ -24,9 +40,17 @@ module Pubid::Core
                         end
       end
 
-      opts.each { |key, value| send("#{key}=", value.is_a?(Parslet::Slice) && value.to_s || value) }
+      @publisher = publisher.to_s
+      @number = number
+      @copublisher = copublisher if copublisher
+      @part = part.to_s if part
+      @type = type.to_s if type
+      @year = year.to_i if year
+      @edition = edition.to_i if edition
+      @language = language.to_s if language
     end
 
+    # @return [String] Rendered URN identifier
     def urn
       Renderer::Urn.new(get_params).render
     end
@@ -35,29 +59,19 @@ module Pubid::Core
       instance_variables.map { |var| [var.to_s.gsub("@", "").to_sym, instance_variable_get(var)] }.to_h
     end
 
+    # Render identifier using default renderer
     def to_s
       self.class.get_renderer_class.new(get_params).render
     end
 
     class << self
-      def get_amendment_class
-        Amendment
-      end
-
-      def get_corrigendum_class
-        Corrigendum
-      end
-
-      def get_renderer_class
-        Renderer::Base
-      end
-
-      def get_transformer_class
-        Transformer
-      end
-
+      # Parses given identifier
+      # @param code_or_params [String, Hash] code or hash from parser
+      #   eg. "ISO 1234", { }
+      # @return [Pubid::Core::Identifier] identifier
       def parse(code_or_params)
-        params = code_or_params.is_a?(String) ? get_parser_class.new.parse(code_or_params) : code_or_params
+        params = code_or_params.is_a?(String) ?
+                   get_parser_class.new.parse(update_old_code(code_or_params)) : code_or_params
         # Parslet returns an array when match any copublisher
         # otherwise it's hash
         if params.is_a?(Array)
@@ -82,6 +96,36 @@ module Pubid::Core
       rescue Parslet::ParseFailed => failure
         raise Errors::ParseError, "#{failure.message}\ncause: #{failure.parse_failure_cause.ascii_tree}"
       end
+
+      def get_amendment_class
+        Amendment
+      end
+
+      def get_corrigendum_class
+        Corrigendum
+      end
+
+      def get_renderer_class
+        Renderer::Base
+      end
+
+      def get_transformer_class
+        Transformer
+      end
+
+      # @return [Hash, nil] replacement patterns
+      def get_update_codes
+        nil
+      end
+
+      def update_old_code(code)
+        return code unless get_update_codes
+
+        get_update_codes.each do |from, to|
+          code = code.gsub(from.match?(/^\/.*\/$/) ? Regexp.new(from[1..-2]) : /^#{Regexp.escape(from)}$/, to)
+        end
+        code
+      end
     end
   end
 end

data/lib/pubid/core/parser.rb

@@ -41,5 +41,11 @@ module Pubid::Core
     rule(:year_month) do
       year_digits >> dash >> month_digits
     end
+
+    def array_to_str(array)
+      array.reduce(str(array.first)) do |acc, value|
+        acc | str(value)
+      end
+    end
   end
 end

data/lib/pubid/core/renderer/base.rb

@@ -34,9 +34,12 @@ module Pubid::Core::Renderer
       render_identifier(params)
     end
 
+    def render_base(params, prefix = "")
+      "%{publisher}%{copublisher}#{prefix} %{number}" % params
+    end
+
     def render_identifier(params)
-      "%{publisher}%{copublisher}%{type}%{stage} %{number}%{part}%{iteration}"\
-        "%{year}%{edition}%{amendments}%{corrigendums}%{language}" % params
+      render_base(params)
     end
 
     def render_copublisher(copublisher, _opts, _params)
@@ -58,21 +61,6 @@ module Pubid::Core::Renderer
       corrigendums.sort.map(&:render_pubid).join("+")
     end
 
-    def render_type(type, opts, params)
-      if params[:copublisher]
-        " #{type}"
-      else
-        "/#{type}"
-      end
-    end
-
-    def render_stage(stage, opts, params)
-      if params[:copublisher]
-        " #{stage}"
-      else
-        "/#{stage}"
-      end
-    end
 
     def render_part(part, opts, _params)
       "-#{part}"
@@ -89,13 +77,5 @@ module Pubid::Core::Renderer
         "(#{language})"
       end
     end
-    
-    def render_edition(edition, _opts, _params)
-      " ED#{edition}"
-    end
-
-    def render_iteration(iteration, _opts, _params)
-      ".#{iteration}"
-    end
   end
 end

data/lib/pubid/core/renderer/urn.rb

@@ -1,18 +1,12 @@
 module Pubid::Core::Renderer
   class Urn < Base
-    STAGES = { PWI: 0,
-               NP: 10,
-               AWI: 20,
-               WD: 20.20,
-               CD: 30,
-               DIS: 40,
-               FDIS: 50,
-               PRF: 50,
-               IS: 60 }.freeze
+
+    def render_base(params)
+      "urn:iso:std:%{publisher}%{copublisher}%{type}:%{number}%{part}" % params
+    end
 
     def render_identifier(params)
-      "urn:iso:std:%{publisher}%{copublisher}%{type}:%{number}%{part}%{stage}"\
-      "%{urn_stage}%{corrigendum_stage}%{iteration}%{edition}%{amendments}%{corrigendums}%{language}" % params
+      render_base(params)
     end
 
     def render_publisher(publisher, _opts, _params)
@@ -20,7 +14,7 @@ module Pubid::Core::Renderer
     end
 
     def render_copublisher(copublisher, _opts, _params)
-      return "-#{copublisher.downcase}" unless copublisher.is_a?(Array)
+      return "-#{copublisher.to_s.downcase}" unless copublisher.is_a?(Array)
 
       copublisher.map(&:to_s).sort.map do |copublisher|
         "-#{copublisher.downcase}"
@@ -47,15 +41,6 @@ module Pubid::Core::Renderer
       ":#{language}"
     end
 
-    def render_stage(stage, _opts, _params)
-      return ":stage-#{sprintf('%05.2f', stage)}" if stage.is_a?(Float)
-
-      ":stage-#{sprintf('%05.2f', STAGES[stage.to_sym])}"
-    end
-
-    def render_urn_stage(stage, opts, params)
-      render_stage(stage, opts, params)
-    end
 
     def render_corrigendum_stage(stage, opts, params)
       render_stage(stage, opts, params)

data/lib/pubid/core/supplement.rb

@@ -3,6 +3,9 @@ module Pubid::Core
     include Comparable
     attr_accessor :version, :number
 
+    # Creates new supplement with provided version and optional number
+    # @param version [Integer]
+    # @param number [Integer]
     def initialize(version:, number: nil)
       @version, @number = version&.to_i, number&.to_i
     end

data/lib/pubid/core/version.rb

@@ -1,5 +1,5 @@
 module Pubid
   module Core
-    VERSION = "0.2.1".freeze
+    VERSION = "1.0.1".freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pubid-core
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 1.0.1
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-06-22 00:00:00.000000000 Z
+date: 2022-08-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake