relaton-iec 1.19.1 → 1.20.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7153721bcd73a90080e9ac70e5cc041cb3f943711f11cdd82ef335f01f07cf64
-  data.tar.gz: 9c84261060e5363ac7f5e961ca38c467703bd3043bd782e764054f407388cf83
+  metadata.gz: 075af8973d061da09f15b28a62c0fce39013f6c6e662c2fa1e3ac4566e31633b
+  data.tar.gz: d0c18b4633244d88b20ea2fa69bedbbaff2e74421736728cd5c6ed0e821228d5
 SHA512:
-  metadata.gz: 10d2990ec6d73858fe68c0f85424c8bf0037205837a3ae3787dc0952de5883f3f104ef56bcf9cd266fed8816e35b5d32c5e0993ff2f2c7eebcb4792e755ab161
-  data.tar.gz: 900bffdce5c4b87976a351f10d0a75ea17c7efff1bdd8791a0660df5a352e3c6a4701b273882556b6822edc0f3af7dd0fbf439d5dfccc3ee3b491c904a5d65db
+  metadata.gz: ae4e37b4b94b7d8f0708189183e54d4488d3144dcab2d000f7372ce9cd1c18d6150196604024c95cb201b24ec4bd26505c0b9278326ce4351d9206480a2bb06a
+  data.tar.gz: c2d717a267b3faf09d378fd0b6461107458fabb33ea2e55dba7715859f3aeeca4a5edce7538194468cc5e521c73cd9bfe0676279f9984d616edd59b65efd808f

data/CLAUDE.md

@@ -0,0 +1,49 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build and Test Commands
+
+```bash
+bundle install           # Install dependencies
+rake spec                # Run all tests (or just `rspec`)
+rspec spec/relaton_iec_spec.rb           # Run single test file
+rspec spec/relaton_iec_spec.rb:69        # Run test at specific line
+bin/console              # Interactive Ruby console with gem loaded
+```
+
+## Architecture Overview
+
+relaton-iec is a Ruby gem that retrieves IEC (International Electrotechnical Commission) standards metadata. It's part of the Relaton family of bibliographic gems.
+
+### Data Flow
+
+1. **Search/Get requests** go through `IecBibliography.get(code, year, opts)` or `.search(ref, year)`
+2. `HitCollection` queries an index file from GitHub (relaton/relaton-data-iec)
+3. Individual `Hit` objects fetch full YAML documents from the same GitHub repository
+4. Results are parsed into `IecBibliographicItem` objects
+
+### Key Classes
+
+- **IecBibliography** ([lib/relaton_iec/iec_bibliography.rb](lib/relaton_iec/iec_bibliography.rb)) - Main entry point for searching and fetching standards
+- **IecBibliographicItem** ([lib/relaton_iec/iec_bibliographic_item.rb](lib/relaton_iec/iec_bibliographic_item.rb)) - Extends `RelatonIsoBib::IsoBibliographicItem` with IEC-specific attributes (function, updates_document_type, accessibility_color_inside, cen_processing, secretary, interest_to_committees)
+- **HitCollection** ([lib/relaton_iec/hit_collection.rb](lib/relaton_iec/hit_collection.rb)) - Manages search results from the index
+- **Hit** ([lib/relaton_iec/hit.rb](lib/relaton_iec/hit.rb)) - Single search result; fetches full document on demand from GitHub
+- **DataFetcher** ([lib/relaton_iec/data_fetcher.rb](lib/relaton_iec/data_fetcher.rb)) - Fetches documents from IEC Harmonized API (requires credentials)
+- **Processor** ([lib/relaton_iec/processor.rb](lib/relaton_iec/processor.rb)) - Relaton framework integration
+
+### URN Conversion
+
+The module provides `RelatonIec.code_to_urn(code, lang)` and `RelatonIec.urn_to_code(urn)` for converting between document identifiers and URN format.
+
+### Testing
+
+- Uses RSpec with VCR for HTTP interaction recording
+- VCR cassettes stored in `spec/vcr_cassettes/`
+- Tests use webmock for HTTP stubbing
+
+### DataFetcher Environment Variables
+
+When fetching from IEC Harmonized API directly:
+- `IEC_HAPI_PROJ_PUBS_KEY` - API key
+- `IEC_HAPI_PROJ_PUBS_SECRET` - API secret

data/lib/relaton_iec/data_parser.rb

@@ -64,13 +64,11 @@ module RelatonIec
     # @return [RelatonIsoBib::StructuredIdentifier] structured identifier
     #
     def structuredidentifier
-      m = @pub["reference"].match(
-        /(?<=\s)(?<project>\w+)(?:-(?<part>\w*)(?:-(?<subpart>\w*))?)?/,
-      )
-      RelatonIsoBib::StructuredIdentifier.new(
-        project_number: m[:project], part: m[:part], subpart: m[:subpart],
-        type: "IEC", id: @pub["reference"]
-      )
+      urn = @pub.dig("project", "urn")
+      return unless urn
+
+      pnum = urn.split(":").last
+      RelatonIsoBib::StructuredIdentifier.new(project_number: pnum, type: "IEC")
     end
 
     #

data/lib/relaton_iec/hash_converter.rb

@@ -3,6 +3,20 @@ module RelatonIec
     include RelatonIsoBib::HashConverter
     extend self
 
+    def hash_to_bib(hash)
+      ret = super
+      ret[:function] = ret[:ext][:function] if ret.dig(:ext, :function)
+      ret[:updates_document_type] = ret[:ext][:updates_document_type] if ret.dig(:ext, :updates_document_type)
+      unless ret.dig(:ext, :accessibility_color_inside).nil?
+        ret[:accessibility_color_inside] = ret[:ext][:accessibility_color_inside]
+      end
+      ret[:price_code] = ret[:ext][:price_code] if ret.dig(:ext, :price_code)
+      ret[:cen_processing] = ret[:ext][:cen_processing] unless ret.dig(:ext, :cen_processing).nil?
+      ret[:secretary] = ret[:ext][:secretary] if ret.dig(:ext, :secretary)
+      ret[:interest_to_committees] = ret[:ext][:interest_to_committees] if ret.dig(:ext, :interest_to_committees)
+      ret
+    end
+
     #
     # Ovverides superclass's method
     #

data/lib/relaton_iec/iec_bibliographic_item.rb

@@ -5,7 +5,7 @@ module RelatonIec
     FUNCTION = %w[emc safety enviroment quality-assurance].freeze
 
     # @return [String, nil]
-    attr_reader :function, :updates_document_type, :price_code, :secretary,
+    attr_reader :function, :updates_document_type, :secretary,
                 :interest_to_committees
 
     # @return [Boolean, nil]
@@ -43,7 +43,6 @@ module RelatonIec
       @function = args.delete :function
       @updates_document_type = args.delete :updates_document_type
       @accessibility_color_inside = args.delete :accessibility_color_inside
-      @price_code = args.delete :price_code
       @cen_processing = args.delete :cen_processing
       @secretary = args.delete :secretary
       @interest_to_committees = args.delete :interest_to_committees
@@ -103,20 +102,24 @@ module RelatonIec
     # @return [Hash]
     def to_hash(embedded: false) # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength,Metrics/PerceivedComplexity
       hash = super
-      hash["function"] = function if function
+      hash["ext"]["function"] = function if function
       if updates_document_type
-        hash["updates_document_type"] = updates_document_type
+        hash["ext"]["updates_document_type"] = updates_document_type
       end
       unless accessibility_color_inside.nil?
-        hash["accessibility_color_inside"] = accessibility_color_inside
+        hash["ext"]["accessibility_color_inside"] = accessibility_color_inside
       end
-      hash["price_code"] = price_code if price_code
-      hash["cen_processing"] = cen_processing unless cen_processing.nil?
-      hash["secretary"] = secretary if secretary
+      hash["ext"]["cen_processing"] = cen_processing unless cen_processing.nil?
+      hash["ext"]["secretary"] = secretary if secretary
       if interest_to_committees
-        hash["interest_to_committees"] = interest_to_committees
+        hash["ext"]["interest_to_committees"] = interest_to_committees
       end
       hash
     end
+
+    def has_ext?
+      super || function || updates_document_type || !accessibility_color_inside.nil? ||
+        !cen_processing.nil? || secretary || interest_to_committees
+    end
   end
 end

data/lib/relaton_iec/index.rb

@@ -122,9 +122,11 @@ module RelatonIec
     # @return [Hash] index content
     #
     def get_index_from_gh # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
-      resp = Zip::InputStream.new URI("#{Hit::GHURL}index.zip").open
-      zip = resp.get_next_entry
-      yaml = zip.get_input_stream.read
+      url = "#{Hit::GHURL}index.zip"
+      resp = Mechanize.new.get(url)
+      zip = Zip::InputStream.new(StringIO.new(resp.body))
+      entry = zip.get_next_entry
+      yaml = entry.get_input_stream.read
       index = RelatonBib.parse_yaml yaml, [Symbol]
       File.write path, index.to_yaml, encoding: "UTF-8"
       index

data/lib/relaton_iec/version.rb

@@ -1,3 +1,3 @@
 module RelatonIec
-  VERSION = "1.19.1".freeze
+  VERSION = "1.20.1".freeze
 end

data/lib/relaton_iec/xml_parser.rb

@@ -13,7 +13,6 @@ module RelatonIec
         data[:updates_document_type] = ext.at("./updates-document-type")&.text
         aci = ext.at("./accessibility-color-inside")
         data[:accessibility_color_inside] = aci.text == "true" if aci
-        data[:price_code] = ext.at("./price-code")&.text
         cp = ext.at("./cen-processing")
         data[:cen_processing] = cp.text == "true" if cp
         data[:secretary] = ext.at("./secretary")&.text

data/lib/relaton_iec.rb

@@ -3,6 +3,7 @@ require "net/http"
 require "nokogiri"
 require "zip"
 require "open-uri"
+require "mechanize"
 require "relaton/index"
 require "relaton_iso_bib"
 require "relaton_iec/hit"

data/relaton_iec.gemspec

@@ -25,7 +25,8 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency "addressable"
   spec.add_dependency "base64"
+  spec.add_dependency "mechanize", "~> 2.8"
   spec.add_dependency "relaton-index", "~> 0.2.0"
-  spec.add_dependency "relaton-iso-bib", "~> 1.19.0"
+  spec.add_dependency "relaton-iso-bib", "~> 1.20.0"
   spec.add_dependency "rubyzip"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relaton-iec
 version: !ruby/object:Gem::Version
-  version: 1.19.1
+  version: 1.20.1
 platform: ruby
 authors:
 - Ribose Inc.
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-10-01 00:00:00.000000000 Z
+date: 2026-01-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: mechanize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
 - !ruby/object:Gem::Dependency
   name: relaton-index
   requirement: !ruby/object:Gem::Requirement
@@ -58,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.19.0
+        version: 1.20.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.19.0
+        version: 1.20.0
 - !ruby/object:Gem::Dependency
   name: rubyzip
   requirement: !ruby/object:Gem::Requirement
@@ -93,6 +107,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
+- CLAUDE.md
 - Gemfile
 - LICENSE.txt
 - README.adoc
@@ -143,7 +158,7 @@ homepage: https://github.com/relaton/relaton-iec
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -158,8 +173,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.27
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: 'RelatonIec: retrieve IEC Standards for bibliographic use using the IecBibliographicItem
   model'