relaton-etsi 1.20.1 → 1.20.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7eb7d28bd38802dabf44bb9829c1fafcc0684d3ac1ebeadd42cce18cc7ecec87
-  data.tar.gz: 0e6496f3c29a8bc929ceacc333bb02d9edb87e2d795a4e91b55d525adbbc2d2c
+  metadata.gz: 9db12fcd09fa10052380fe87eac90777880e224594c4f47487b6010283cf5d82
+  data.tar.gz: b33c26ffb892562a8a46eb07f2e10cfe50d83585596f6331baa93f360894f6c5
 SHA512:
-  metadata.gz: 859319f0d1eacbcde84a5e235ef697ef5dbe6e8edb147381b1f0c53610ea1417cf9fb200eaf3d3924de9ad8aa780118308bbcd512187e49936218076697e585e
-  data.tar.gz: c7cd3a40a80bc5a721b937a1be63b6d64e1214404fe5be06fade0ba4ee030c94952a836f3f6e4e4f3f0d21c8d7f04c59641aa42198c8d29c0220871509ad2ee7
+  metadata.gz: 227db6b7da0fd223ad0f272fbf4c7da06dcbe587dc973cafd32af8d3de9a09ef0d2600f427a14f56945dac93fb5f65d486c02b7ba61ad09e659f8d36b9b49b4a
+  data.tar.gz: ebeec237a1f36122db9d6178201ab44b2dcc347cd0141e3b12e418d35b45f7eb31999dbf1710b911ef041964b0aeded269ff4231f17bf490292598211d3f7949

data/CLAUDE.md

@@ -0,0 +1,67 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build and Test Commands
+
+```bash
+# Install dependencies
+bin/setup
+
+# Run all tests
+bundle exec rake spec
+
+# Run a single test file
+bundle exec rspec spec/relaton_etsi/bibliography_spec.rb
+
+# Run a single test by line number
+bundle exec rspec spec/relaton_etsi/bibliography_spec.rb:15
+
+# Run linter
+bundle exec rubocop
+
+# Run linter with auto-fix
+bundle exec rubocop -a
+
+# Interactive console for experimentation
+bin/console
+```
+
+## Architecture
+
+This gem is part of the [Relaton](https://github.com/relaton) ecosystem for retrieving and managing bibliographic data from standards organizations. It specifically handles ETSI (European Telecommunications Standards Institute) standards.
+
+### Core Dependencies
+- `relaton-bib` - Base bibliographic classes that this gem extends
+- `relaton-index` - Document indexing for search functionality
+
+### Key Classes
+
+**Entry Points:**
+- `Bibliography` - Main API: `RelatonEtsi::Bibliography.get("ETSI GS ZSM 012 V1.1.1")` searches the Relaton index and returns a `BibliographicItem`
+- `Processor` - Relaton integration point, registered with the main relaton gem
+
+**Data Model:**
+- `BibliographicItem` extends `RelatonBib::BibliographicItem` with ETSI-specific fields: `marker`, `frequency`, `mandate`, `custom_collection`
+- `DocumentType` - ETSI document type abbreviations (EN, ES, EG, TS, GS, GR, TR, etc.) and their full names
+- `PubId` - Parser for ETSI document identifiers, extracting type, docnumber, version, edition, and date
+
+**Data Fetching:**
+- `DataFetcher` - Bulk fetches all documents from www.etsi.org CSV export
+- `DataParser` - Transforms CSV rows into `BibliographicItem` objects
+
+**Serialization:**
+- `XMLParser` extends `RelatonBib::XMLParser` for ETSI-specific XML parsing
+- `HashConverter` includes `RelatonBib::HashConverter` for YAML/Hash conversion
+
+### Data Flow
+1. `Bibliography.search` queries the GitHub-hosted index (`relaton-data-etsi`)
+2. Matching documents are fetched as YAML from the data repository
+3. `HashConverter` transforms YAML to constructor arguments
+4. `BibliographicItem` is instantiated and returned
+
+For bulk data generation, `DataFetcher` downloads CSV from etsi.org, parses each row with `DataParser`, and saves to files.
+
+## Testing
+
+Tests use VCR cassettes in `spec/vcr_cassettes/` to record/replay HTTP interactions. When updating tests that make HTTP calls, delete the relevant cassette to re-record.

data/lib/relaton_etsi/data_fetcher.rb

@@ -34,7 +34,7 @@ module RelatonEtsi
             "title=1&etsiNumber=1&content=1&version=0&onApproval=1&published=1&withdrawn=1&historical=1&isCurrent=1&" \
             "superseded=1&startDate=1988-01-15&endDate=#{date}&harmonized=0&keyword=&TB=&stdType=&frequency=&" \
             "mandate=&collection=&sort=1&x=#{timestamp}"
-      csv = OpenURI.open_uri(url) { |f| f.readlines.join }
+      csv = Mechanize.new.get(url).body
       CSV.parse(csv, headers: true, col_sep: ';', skip_lines: /sep=;/).each do |row|
         save DataParser.new(row).parse
       end

data/lib/relaton_etsi/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RelatonEtsi
-  VERSION = "1.20.1"
+  VERSION = "1.20.2"
 end

data/lib/relaton_etsi.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "net/http"
-require "open-uri"
+require "mechanize"
 require "csv"
 require "relaton/index"
 require "relaton_bib"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relaton-etsi
 version: !ruby/object:Gem::Version
-  version: 1.20.1
+  version: 1.20.2
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-20 00:00:00.000000000 Z
+date: 2026-01-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: csv
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.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-bib
   requirement: !ruby/object:Gem::Requirement
@@ -62,6 +76,7 @@ extra_rdoc_files: []
 files:
 - ".rspec"
 - ".rubocop.yml"
+- CLAUDE.md
 - LICENSE.txt
 - README.adoc
 - Rakefile