relaton-iec 1.20.0 → 1.20.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f20588ecb2038b53252427cb01e0993d843195c12ea912a274116787f20ce74
-  data.tar.gz: 13f77733184dd0e26a46a83cf9b05838903818e6f6b68e91ce397c529370878f
+  metadata.gz: 075af8973d061da09f15b28a62c0fce39013f6c6e662c2fa1e3ac4566e31633b
+  data.tar.gz: d0c18b4633244d88b20ea2fa69bedbbaff2e74421736728cd5c6ed0e821228d5
 SHA512:
-  metadata.gz: ca90f4613d002f0845e966e5c80f03bdb3e813daa11363d78c0c35540ed0e6ee2216e1da61dd0582393bd41d62666377ceec22a9cbc9be3313ce66cba02832c9
-  data.tar.gz: 83025369d42c19658ac6948f92f8b41e07148a7c66f46e7e24a32e5504a675d188406152cddfa0aa155caa2218eb24821179d2092fbcaf947f17b0615e62c90a
+  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/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.20.0".freeze
+  VERSION = "1.20.1".freeze
 end

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,6 +25,7 @@ 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.20.0"
   spec.add_dependency "rubyzip"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relaton-iec
 version: !ruby/object:Gem::Version
-  version: 1.20.0
+  version: 1.20.1
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-12-12 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
@@ -93,6 +107,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
+- CLAUDE.md
 - Gemfile
 - LICENSE.txt
 - README.adoc
@@ -158,7 +173,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.27
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: 'RelatonIec: retrieve IEC Standards for bibliographic use using the IecBibliographicItem