pubid 2.0.8 → 2.0.10

data/lib/pubid/sae/renderer.rb

@@ -2,34 +2,31 @@
 
 module Pubid
   module Sae
-    # Human-readable renderer for SAE identifiers.
+    # Human-readable renderer for SAE identifiers, in the form SAE prints:
     #
-    # Produces strings like:
-    #   "SAE AS5553"
-    #   "SAE ARP4754A"
-    #   "SAE AMS2475:2023"
+    #   "SAE J3016"            "SAE AMS4121J"
+    #   "SAE J3016_202104"     "SAE ARP4754A:2010"
+    #   "SAE AS22520/45A"      "SAE AMS-QQ-A-250/4B"
+    #   "SAE AS5259/7A_A1"     "SAE USCAR-2-6"
     #
-    # The renderer is registered as the +:human+ format in the SAE format
-    # registry and invoked via +render(format: :human)+.
+    # A dated edition with a month renders SAE's native edition code
+    # (+_YYYYMM+); a year alone renders +:YYYY+.
     class Renderer < ::Pubid::Renderers::Base
       def render(context: nil, **_opts)
         id = @id
+        type = id.type
+        code = type ? "#{type.abbr}#{type.separator}" : ""
+        result = [id.publisher, code + id.designation].compact.join(" ")
+        result + date_suffix(id, context)
+      end
 
-        parts = []
-
-        # Publisher and type
-        parts << id.publisher if id.publisher
-        parts << id.type.to_s if id.type
-
-        # Number
-        parts << id.number.to_s if id.number
-
-        result = parts.join(" ")
+      private
 
-        # Date
-        result += ":#{id.date.render(context:)}" if id.date
+      def date_suffix(id, context)
+        return "" unless id.date&.year
 
-        result
+        separator = id.date.month ? "_" : ":"
+        "#{separator}#{id.date.render(context:)}"
       end
     end
   end

data/lib/pubid/sae/urn_generator.rb

@@ -2,6 +2,11 @@
 
 module Pubid
   module Sae
+    # urn:sae:{type|std}:{designation}[:{yyyy|yyyymm}]
+    #
+    # The designation is the printed code after the type (Identifier#
+    # designation): "4121J", "22520/45A", "5259/7A_A1". The date segment is
+    # the year, or SAE's year-and-month edition date.
     class UrnGenerator < Pubid::UrnGenerator::Base
       def urn_type
         return "std" unless identifier.type
@@ -12,7 +17,7 @@ module Pubid
       def urn_number
         return nil unless identifier.number
 
-        identifier.number.to_s
+        identifier.designation
       end
 
       def generate

data/lib/pubid/sae/urn_parser.rb

@@ -5,7 +5,7 @@ module Pubid
     # Parses SAE URNs back into identifiers.
     #
     # UrnGenerator emits:
-    #   urn:sae:{type|std}:{number}:{year}
+    #   urn:sae:{type|std}:{designation}[:{yyyy|yyyymm}]
     # where slot[1] is overwritten with the publisher string when a publisher
     # is set. The common single-publisher case keeps slot[1] = "sae".
     #
@@ -25,10 +25,15 @@ module Pubid
 
       private
 
+      # The designation follows the type with no separator; the grammar
+      # reads a glued number for every family. A six-digit date segment is
+      # SAE's year-and-month edition date.
       def build_text(type_token, number, year)
         head = type_token == "std" ? "" : type_token.upcase
-        text = "SAE #{head}#{number}"
-        text += ":#{year}" if year
+        # The designation's letters are upper-case in every SAE code; a URN
+        # that a consumer lower-cased (urn:sae:ams:4121j) still resolves.
+        text = "SAE #{head}#{number.to_s.upcase}"
+        text += "#{year.to_s.length == 6 ? '_' : ':'}#{year}" if year
         text
       end
     end

data/lib/pubid/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pubid
-  VERSION = "2.0.8"
+  VERSION = "2.0.10"
 end

data/lib/pubid/w3c/pubid_urn_schema.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Pubid
+  module W3c
+    # The pubid-scheme URN of w3c (issue #656; docs/URN-SCHEMES.adoc).
+    #
+    # Declared from the doc's section: the atom, facet and type tables
+    # below are the doc's design, conforming token-for-token.
+    PubidUrnSchema = Pubid::PubidUrn.define("w3c") do
+      atom "date", "date"
+
+
+      type "pubid:w3c:candidate-recommendation", "cr"
+      type "pubid:w3c:candidate-recommendation-draft", "crd"
+      type "pubid:w3c:draft-note", "dn"
+      type "pubid:w3c:identifier", "id"
+      type "pubid:w3c:note", "note"
+      type "pubid:w3c:obsolete-recommendation", "or"
+      type "pubid:w3c:proposed-edited-recommendation", "per"
+      type "pubid:w3c:proposed-recommendation", "pr"
+      type "pubid:w3c:recommendation", "rec"
+      type "pubid:w3c:standard", "std"
+      type "pubid:w3c:superseded-recommendation", "sr"
+      type "pubid:w3c:working-draft", "wd"
+    end
+  end
+end

data/lib/pubid/w3c.rb

@@ -16,6 +16,7 @@ module Pubid
     autoload :Renderer, "#{__dir__}/w3c/renderer"
     autoload :UrnGenerator, "#{__dir__}/w3c/urn_generator"
     autoload :UrnParser, "#{__dir__}/w3c/urn_parser"
+    autoload :PubidUrnSchema, "#{__dir__}/w3c/pubid_urn_schema"
 
     # Parse a W3C identifier string
     def self.parse(identifier)

data/lib/pubid/xsf/pubid_urn_schema.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Xsf
+    # The pubid-scheme URN of xsf (issue #656; docs/URN-SCHEMES.adoc).
+    #
+    # Declared from the doc's section: the atom, facet and type tables
+    # below are the doc's design, conforming token-for-token.
+    PubidUrnSchema = Pubid::PubidUrn.define("xsf") do
+      type "pubid:xsf:identifier", "id"
+      type "pubid:xsf:xep", "xep"
+    end
+  end
+end

data/lib/pubid/xsf.rb

@@ -21,6 +21,7 @@ module Pubid
     autoload :Renderer, "#{__dir__}/xsf/renderer"
     autoload :UrnGenerator, "#{__dir__}/xsf/urn_generator"
     autoload :UrnParser, "#{__dir__}/xsf/urn_parser"
+    autoload :PubidUrnSchema, "#{__dir__}/xsf/pubid_urn_schema"
 
     # Parse an XSF identifier string
     def self.parse(identifier)

data/lib/pubid.rb

@@ -300,6 +300,26 @@ module Pubid
     urn_parser.parse(string)
   end
 
+  # The slug form (relaton#441): the pubid-scheme URN of +source+ in
+  # HTTP-path clothes — "/"-joined segments after the "urn:pubid:"
+  # prefix ("iso/is/9001/year-2015"). Bijective with
+  # {PubidUrn.from_slug}.
+  #
+  # @param source [Identifier, String] an identifier or its pubid-scheme URN
+  # @return [String]
+  def self.to_slug(source)
+    PubidUrn.to_slug(source)
+  end
+
+  # Parse a slug (see {PubidUrn.from_slug}).
+  #
+  # @param string [String] the slug
+  # @return [Identifier]
+  def self.from_slug(string)
+    eager_load_flavors!
+    PubidUrn.from_slug(string)
+  end
+
   # Parse a pubid-scheme URN, and only that: an official URN such as
   # "urn:iso:std:…" raises. For a consumer that takes a slug and must not
   # accept a lossy official URN by mistake (relaton/relaton#441).

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pubid
 version: !ruby/object:Gem::Version
-  version: 2.0.8
+  version: 2.0.10
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-11-04 00:00:00.000000000 Z
+date: 2026-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model
@@ -142,6 +142,7 @@ files:
 - lib/pubid/adobe/identifiers/publication.rb
 - lib/pubid/adobe/identifiers/tech_note.rb
 - lib/pubid/adobe/parser.rb
+- lib/pubid/adobe/pubid_urn_schema.rb
 - lib/pubid/adobe/renderer.rb
 - lib/pubid/adobe/urn_generator.rb
 - lib/pubid/adobe/urn_parser.rb
@@ -325,6 +326,7 @@ files:
 - lib/pubid/calconnect/identifiers.rb
 - lib/pubid/calconnect/identifiers/standard.rb
 - lib/pubid/calconnect/parser.rb
+- lib/pubid/calconnect/pubid_urn_schema.rb
 - lib/pubid/calconnect/renderer.rb
 - lib/pubid/calconnect/urn_generator.rb
 - lib/pubid/calconnect/urn_parser.rb
@@ -335,6 +337,7 @@ files:
 - lib/pubid/ccsds/identifiers/base.rb
 - lib/pubid/ccsds/identifiers/corrigendum.rb
 - lib/pubid/ccsds/parser.rb
+- lib/pubid/ccsds/pubid_urn_schema.rb
 - lib/pubid/ccsds/single_identifier.rb
 - lib/pubid/ccsds/supplement_identifier.rb
 - lib/pubid/ccsds/urn_generator.rb
@@ -361,6 +364,7 @@ files:
 - lib/pubid/cen_cenelec/identifiers/technical_report.rb
 - lib/pubid/cen_cenelec/identifiers/technical_specification.rb
 - lib/pubid/cen_cenelec/parser.rb
+- lib/pubid/cen_cenelec/pubid_urn_schema.rb
 - lib/pubid/cen_cenelec/renderer.rb
 - lib/pubid/cen_cenelec/single_identifier.rb
 - lib/pubid/cen_cenelec/urn_generator.rb
@@ -449,6 +453,7 @@ files:
 - lib/pubid/easc/identifiers/pmg.rb
 - lib/pubid/easc/identifiers/rmg.rb
 - lib/pubid/easc/parser.rb
+- lib/pubid/easc/pubid_urn_schema.rb
 - lib/pubid/easc/renderer.rb
 - lib/pubid/easc/urn_generator.rb
 - lib/pubid/easc/urn_parser.rb
@@ -461,6 +466,7 @@ files:
 - lib/pubid/ecma/identifiers/standard.rb
 - lib/pubid/ecma/identifiers/technical_report.rb
 - lib/pubid/ecma/parser.rb
+- lib/pubid/ecma/pubid_urn_schema.rb
 - lib/pubid/ecma/renderer.rb
 - lib/pubid/ecma/urn_generator.rb
 - lib/pubid/ecma/urn_parser.rb
@@ -479,6 +485,7 @@ files:
 - lib/pubid/etsi/identifiers/etsi_standard.rb
 - lib/pubid/etsi/identifiers/supplement_identifier.rb
 - lib/pubid/etsi/parser.rb
+- lib/pubid/etsi/pubid_urn_schema.rb
 - lib/pubid/etsi/renderer.rb
 - lib/pubid/etsi/urn_generator.rb
 - lib/pubid/etsi/urn_parser.rb
@@ -491,6 +498,7 @@ files:
 - lib/pubid/evs/identifiers/international_adoption.rb
 - lib/pubid/evs/identifiers/national_adoption.rb
 - lib/pubid/evs/parser.rb
+- lib/pubid/evs/pubid_urn_schema.rb
 - lib/pubid/evs/renderer.rb
 - lib/pubid/evs/urn_generator.rb
 - lib/pubid/evs/urn_parser.rb
@@ -521,6 +529,7 @@ files:
 - lib/pubid/gost/identifiers/interstate_standard.rb
 - lib/pubid/gost/identifiers/national_standard.rb
 - lib/pubid/gost/parser.rb
+- lib/pubid/gost/pubid_urn_schema.rb
 - lib/pubid/gost/renderer.rb
 - lib/pubid/gost/urn_generator.rb
 - lib/pubid/gost/urn_parser.rb
@@ -541,6 +550,7 @@ files:
 - lib/pubid/iala/identifiers/resolution.rb
 - lib/pubid/iala/identifiers/standard.rb
 - lib/pubid/iala/parser.rb
+- lib/pubid/iala/pubid_urn_schema.rb
 - lib/pubid/iala/renderer.rb
 - lib/pubid/iala/urn_generator.rb
 - lib/pubid/iala/urn_parser.rb
@@ -551,6 +561,7 @@ files:
 - lib/pubid/iana/identifiers.rb
 - lib/pubid/iana/identifiers/registry.rb
 - lib/pubid/iana/parser.rb
+- lib/pubid/iana/pubid_urn_schema.rb
 - lib/pubid/iana/renderer.rb
 - lib/pubid/iana/urn_generator.rb
 - lib/pubid/iana/urn_parser.rb
@@ -884,6 +895,7 @@ files:
 - lib/pubid/oasis/identifiers.rb
 - lib/pubid/oasis/identifiers/standard.rb
 - lib/pubid/oasis/parser.rb
+- lib/pubid/oasis/pubid_urn_schema.rb
 - lib/pubid/oasis/renderer.rb
 - lib/pubid/oasis/urn_generator.rb
 - lib/pubid/oasis/urn_parser.rb
@@ -894,6 +906,7 @@ files:
 - lib/pubid/ogc/identifiers.rb
 - lib/pubid/ogc/identifiers/document.rb
 - lib/pubid/ogc/parser.rb
+- lib/pubid/ogc/pubid_urn_schema.rb
 - lib/pubid/ogc/renderer.rb
 - lib/pubid/ogc/urn_generator.rb
 - lib/pubid/ogc/urn_parser.rb
@@ -943,6 +956,7 @@ files:
 - lib/pubid/parsers/urn.rb
 - lib/pubid/pg.rb
 - lib/pubid/plateau.rb
+- lib/pubid/plateau/CLAUDE.md
 - lib/pubid/plateau/builder.rb
 - lib/pubid/plateau/identifier.rb
 - lib/pubid/plateau/identifiers.rb
@@ -951,6 +965,7 @@ files:
 - lib/pubid/plateau/identifiers/handbook.rb
 - lib/pubid/plateau/identifiers/technical_report.rb
 - lib/pubid/plateau/parser.rb
+- lib/pubid/plateau/pubid_urn_schema.rb
 - lib/pubid/plateau/renderer.rb
 - lib/pubid/plateau/supplement_identifier.rb
 - lib/pubid/plateau/urn_generator.rb
@@ -982,6 +997,7 @@ files:
 - lib/pubid/rendering/stage.rb
 - lib/pubid/rendering/supplement.rb
 - lib/pubid/sae.rb
+- lib/pubid/sae/CLAUDE.md
 - lib/pubid/sae/builder.rb
 - lib/pubid/sae/components.rb
 - lib/pubid/sae/components/code.rb
@@ -1044,6 +1060,7 @@ files:
 - lib/pubid/w3c/identifiers/superseded_recommendation.rb
 - lib/pubid/w3c/identifiers/working_draft.rb
 - lib/pubid/w3c/parser.rb
+- lib/pubid/w3c/pubid_urn_schema.rb
 - lib/pubid/w3c/renderer.rb
 - lib/pubid/w3c/urn_generator.rb
 - lib/pubid/w3c/urn_parser.rb
@@ -1054,6 +1071,7 @@ files:
 - lib/pubid/xsf/identifiers.rb
 - lib/pubid/xsf/identifiers/xep.rb
 - lib/pubid/xsf/parser.rb
+- lib/pubid/xsf/pubid_urn_schema.rb
 - lib/pubid/xsf/renderer.rb
 - lib/pubid/xsf/urn_generator.rb
 - lib/pubid/xsf/urn_parser.rb