relaton 3.1.0 → 3.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0bdb2921b9e783bd265ac5fa7fdcf74e464624cc817f3a321e4206602ba94fcf
-  data.tar.gz: 5a329642cc5ed894e9008011cb99a7f35c49c9da624b19b87dbf53d12259325f
+  metadata.gz: d9eef3d372dd9873e179368bed9c4e49f80484881fd0e469db1e07ff2dbb7568
+  data.tar.gz: de460fda09be00fbe2580a2cb4c1fb6cb0beea9009519c84fa46b91cbb3e39fa
 SHA512:
-  metadata.gz: 9828c92364edaca6d9f56655f8e67aa0de7bdf221a2fdaf03d9fb185a8eb448337dc9f77af028133a390c392c14a273fa31b32e8ab8c00ff1b80813a58efcf9a
-  data.tar.gz: 05a358f667af4b048fb3503d8208c1ff60796b785719da720e1039160c66eaff3c58dc43dbda270d2171197f3636166a32bdc944682435c6d6ed4f63e393a1f8
+  metadata.gz: 6e42b68c6b256aebf17a83184db8939e286dfd70a7274ebe918619cb966277fd89607894207ca767e1d9b2cad59810bfa719284cdbb1b26168780a476086cda2
+  data.tar.gz: 26ca0ae9cf979c22d944bc0981048668e8d035983825f49ba6915d452604e39de17f51a6a025fc8d7ca71a068c5f8694d22f7b73668adc84cc2b407f82765d69

data/lib/relaton/cli/command.rb

@@ -234,10 +234,12 @@ module Relaton
         result = if /yaml|yml/.match?(options[:format])
                    item.to_yaml
                  elsif options[:format] == "citation"
-                   # The paths that exist in every published relaton-render;
-                   # the gem's conventional "relaton/render" entry is newer.
-require_relative "../render/general"
-require_relative "../render/iso690"
+                   # Lazy: the render engine loads on the first citation
+                   # request; the yaml/bibtex paths never pay for it. The
+                   # facade file both entries resolve through (the
+                   # consolidated surface, lib/relaton/render.rb) already
+                   # requires iso690 — general is its autoload target.
+                   require_relative "../../relaton/render"
                    Relaton::Render::General
                      .new(style: options[:style] || "author-date")
                      .render(item, embedded: true)

data/lib/relaton/iec/bibliography.rb

@@ -25,32 +25,30 @@ module Relaton
         end
 
         # @param ref [String, Pubid::Iec::Identifier] the IEC standard code to
-        #   look up (e.g. "IEC 8000"), or the parse that Relaton::Db routed
-        #   with (relaton#205); a pubid is never mutated
+        #   look up (e.g. "IEC 8000", "IEC 80000 (all parts)"), or the parse
+        #   that Relaton::Db routed with (relaton#205); a pubid is never mutated
         # @param year [String] the year the standard was published (optional)
-        # @param opts [Hash] options; restricted to :all_parts if all-parts
-        #   reference is required
+        # @param opts [Hash] options; `:all_parts` asks for all parts of a
+        #   reference that does not say so itself. The hash is not changed.
         # @return [Relaton::Iec::ItemData, nil]
-        def get(ref, year = nil, opts = {}) # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity,Metrics/MethodLength
+        def get(ref, year = nil, opts = {}) # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
           if ref.is_a?(String)
-            opts[:all_parts] ||= ref.match?(/\s\(all parts\)/)
-            text = ref.sub(/\s\(all parts\)/, "")
-            return iev if text.casecmp("IEV").zero?
-
-            pubid = ::Pubid::Iec::Identifier.parse text.upcase
-          elsif ref.all_parts?
-            opts[:all_parts] = true
-            pubid = ref.identifiers.first
-          else
-            pubid = ref
+            return iev if ref.strip.casecmp?("IEV")
+
+            ref = parse_ref ref
           end
+          # The pubid says whether all parts are asked for (relaton-iec#64):
+          # the option is folded into it, as Core::Processor#cache_key does.
+          ref = ref.to_all_parts if opts[:all_parts] && !ref.all_parts?
+          all_parts = ref.all_parts?
+          pubid = all_parts ? ref.identifiers.first : ref
           if year
             # Copy first: a caller's pubid is also its Db cache key.
             pubid = pubid.class.from_hash(pubid.to_hash)
             pubid.date = ::Pubid::Components::Date.new(year: year.to_s)
           end
 
-          ret = iecbib_get(pubid, opts)
+          ret = iecbib_get(pubid, all_parts, opts)
           return nil if ret.nil?
 
           ret = ret.to_most_recent_reference unless pubid.date&.year || opts[:keep_year] ||
@@ -98,17 +96,31 @@ module Relaton
           )
         end
 
-        # @param pubid [Pubid::Iec::Identifier]
+        # The reference as written, else upcased: pubid reads the other
+        # components only in upper case, and `(all parts)` only in lower
+        # case, so the upcase keeps that suffix as pubid spells it.
+        #
+        # @param ref [String]
+        # @return [Pubid::Iec::Identifier]
+        def parse_ref(ref)
+          ::Pubid::Iec::Identifier.parse ref
+        rescue ::Pubid::Errors::Error
+          ::Pubid::Iec::Identifier.parse ref.upcase.sub("(ALL PARTS)", "(all parts)")
+        end
+
+        # @param pubid [Pubid::Iec::Identifier] the document (the inner
+        #   identifier of an all-parts reference)
+        # @param all_parts [Boolean] all parts of the document are asked for
         # @param opts [Hash]
         # @return [Relaton::Iec::ItemData, nil]
-        def iecbib_get(pubid, opts) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        def iecbib_get(pubid, all_parts, opts) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
           Util.info "Fetching from Relaton repository ...", key: pubid.to_s
           # pubid 2.x splits multi-level numbers ("61326-2-6") into part +
           # subpart, so all-parts matching must ignore subpart too.
-          exclude = opts[:all_parts] ? %i[year part subpart] : %i[year]
+          exclude = all_parts ? %i[year part subpart] : %i[year]
           result = search(pubid, exclude: exclude) || return
 
-          if opts[:all_parts]
+          if all_parts
             ret = result.to_all_parts(pubid.date&.year&.to_s, opts)
             Util.info "Found: `#{ret&.docidentifier&.first&.content}`", key: pubid.to_s if ret
             return ret

data/lib/relaton/render.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# The rendering surface of the consolidated gem — the `relaton/render`
+# entry the standalone relaton-render gem served as its primary require
+# path. `require "relaton-render"` (the hyphen umbrella in
+# lib/relaton-render.rb) resolves to this same surface: one gem ships
+# both codebases, so both spellings must keep working, and neither may
+# fall through to a still-bundled retired gem.
+require_relative "render/iso690"
+
+module Relaton
+  module Render
+    # A bibliographic item whose style template resolves to nothing: the
+    # single-item API raises, the batch API skips
+    class Unrenderable < StandardError; end
+  end
+end

data/lib/relaton/sae/CLAUDE.md

@@ -37,7 +37,9 @@ therefore index-based, the ECMA/IALA shape:
   a partial crawl would publish a partial index). Each work goes through
   `Relaton::Doi::Parser`, then gets SAE's code as its **primary**
   docidentifier (type `SAE`), the DOI beside it, and `ext` doctype
-  `standard`, flavor `sae`.
+  `standard`, flavor `sae`. `fetched` is cleared: a data file carries no
+  fetch date, or every daily crawl would rewrite and commit all ~47,700
+  files. `Bibliography#fetch_doc` sets it when it reads a document.
 - **Consumer** — `Bibliography.get` reads the `relaton-data-sae` Pages index
   (`PAGES_URL`) and the document from `ENDPOINT` (raw GitHub).
 

data/lib/relaton/sae/data_fetcher.rb

@@ -153,10 +153,15 @@ module Relaton
       # The `Relaton::Doi::Parser` item, with SAE's edition code (as SAE
       # prints it) as its primary identifier and the DOI kept beside it.
       #
+      # `Doi::Parser` stamps today as `fetched`. A data file must not carry
+      # it: the daily crawl would then rewrite every file and commit the
+      # whole corpus. `Bibliography#fetch_doc` sets `fetched` on reading.
+      #
       # @return [Relaton::Sae::ItemData]
       #
       def to_item(work, code)
         bib = Relaton::Doi::Parser.parse work
+        bib.fetched = nil
         bib.id = code.native.delete(" /").gsub(/\W/, "")
         bib.docidentifier = [
           Bib::Docidentifier.new(type: "SAE", content: code.printed,

data/lib/relaton/version.rb

@@ -1,3 +1,3 @@
 module Relaton
-  VERSION = "3.1.0".freeze
+  VERSION = "3.1.1".freeze
 end

data/lib/relaton-render.rb

@@ -1,12 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "relaton/render/iso690"
-
-module Relaton
-  module Render
-    # A bibliographic item whose style template resolves to nothing: the
-    # single-item API raises, the batch API skips
-    class Unrenderable < StandardError; end
-
-  end
-end
+# Compatibility umbrella: the standalone relaton-render gem's documented
+# require entry. The surface lives at lib/relaton/render.rb — one gem
+# ships both codebases, so both spellings resolve inside relaton.
+require_relative "relaton/render"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relaton
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 3.1.1
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-11-05 00:00:00.000000000 Z
+date: 2026-11-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -1339,6 +1339,7 @@ files:
 - lib/relaton/plateau/processor.rb
 - lib/relaton/plateau/technical_report_parser.rb
 - lib/relaton/plateau/util.rb
+- lib/relaton/render.rb
 - lib/relaton/render/general.rb
 - lib/relaton/render/iso690.rb
 - lib/relaton/render/iso690/csl_import.rb