relaton 1.20.1 → 2.0.0.pre.alpha.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13dbf084ccd28b8edc98d3e9b8774eb6eef7998f73627332fb7f92809cf635fd
-  data.tar.gz: d81e1084ff58259e9d2f91d1cbbb1b6590ab6531a15f643209091fcdba1ea978
+  metadata.gz: 72340d2ac1023cae6be18414bf12e0aab5ffdf24d2385d2025bd91785d99f933
+  data.tar.gz: e995b4afd240b028524f1c174a28780aab74a9a20eab9b19ae4a288cee38ae16
 SHA512:
-  metadata.gz: b6191397dde96436e07a88c62b4995991f50b1aae1d347a52b5ee5262e494498a4c7991ff62e9924086e39023956342900a914d527b77bfa8299b2b97c13b89d
-  data.tar.gz: 817aca4c0d54b585cffa7d14c1645fa9bcd078aa281ab33aaa51e8c2cc125a07d4ea6a268b62b507baa06dce66410c2d2cd46a9fb7fd0ad019636e6470ce9d6b
+  metadata.gz: caa95533b83a97042cac9886ea93b4149b73a6d57e4f47b88b297d0a2a08d0f1d884be7092feab7d9daaf3f870578e6be3dd41e26c1c4ec2ad60814b8eaa9105
+  data.tar.gz: dd627fbe5b2bf14d06805aa04ae7a5dd5a60cbb67ba6c93e71fb44151e736a30976bccff5cbcf11fd7a0665dffa4f6767a84e26dc3eac57ac22a61d02db7fc95

data/.github/workflows/rubocop.yml

@@ -0,0 +1,48 @@
+name: Rubocop
+
+on: pull_request
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  rubocop:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+      - name: Determine Ruby version for ruby/setup-ruby
+        shell: bash
+        run: |
+          RUBY_VERSION=${{ vars.RUBY_VERSION }}
+
+          if [[ -r .rubocop.yml ]]
+          then
+            RUBY_VERSION=$( \
+              command grep \
+              -E '^\s*TargetRubyVersion:\s*[0-9]+(\.[0-9]+)*' \
+              .rubocop.yml \
+              | command awk '{print $2}' \
+            )
+          fi
+
+          if [[ -z $RUBY_VERSION ]]
+          then
+            # Let setup-ruby determine the Ruby version if no .ruby-version,
+            # .tool-versions or mise.toml file exists
+            RUBY_VERSION=default
+          fi
+
+          echo "RUBY_VERSION=$RUBY_VERSION" >> $GITHUB_ENV
+      - uses: ruby/setup-ruby@v1
+        with:
+          # input ruby-version needs to be specified if no .ruby-version,
+          # .tool-versions or mise.toml file exists
+          #
+          # Use the version that matches the one in gemspec & .rubocop.yml
+          ruby-version: ${{ env.RUBY_VERSION }}
+      - uses: reclaim-the-stack/rubocop-action@v1.1.0
+        with:
+          gem_versions: rubocop:1.84.2 rubocop-performance:1.26.1 rubocop-rails:2.34.3

data/.gitignore

@@ -8,3 +8,5 @@ testcache2
 .vscode/
 pkg/
 Gemfile.lock
+.rubocop-remote-87c7cdd254a8d09d005ee06efac7acc0.yml
+.claude/

data/.rubocop.yml

@@ -2,11 +2,11 @@
 # https://github.com/riboseinc/oss-guides
 # All project-specific additions and overrides should be specified in this file.
 
-require: rubocop-rails
+plugins: rubocop-rails
 
 inherit_from:
   - https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml
 AllCops:
-  TargetRubyVersion: 3.0
+  TargetRubyVersion: 3.2
 Rails:
   Enabled: false

data/CLAUDE.md

@@ -0,0 +1,70 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+# Run full test suite
+bundle exec rake        # or: bundle exec rspec
+
+# Run a single spec file
+bundle exec rspec spec/relaton/db_spec.rb
+
+# Run a specific test by line number
+bundle exec rspec spec/relaton/db_spec.rb:234
+
+# Lint
+bundle exec rubocop
+
+# Lint with auto-fix
+bundle exec rubocop -a
+```
+
+## Architecture
+
+Relaton is a Ruby gem that fetches, caches, and manages bibliographic references to technical standards from 25+ organizations (ISO, IEC, IETF, NIST, IEEE, etc.).
+
+### Plugin Registry Pattern
+
+**Relaton::Registry** (singleton) auto-discovers and manages backend processor gems (relaton-iso, relaton-iec, relaton-ietf, etc.). Each processor implements the **Relaton::Processor** interface (`get`, `from_xml`, `from_yaml`, `grammar_hash`, `prefix`, `defaultprefix`). The registry routes reference codes to the correct processor by matching prefixes (e.g., "ISO 19115" → `:relaton_iso`).
+
+### Db (lib/relaton/db.rb) — Main Public API
+
+`Relaton::Db#fetch(ref, year, opts)` is the primary entry point. It:
+1. Identifies the processor via Registry prefix matching
+2. Handles combined references (`+` for derivedFrom, `,` for amendments) in `combine_doc`
+3. Delegates to `check_bibliocache` which manages the dual-cache lookup and network fetch flow
+
+`Relaton::Db#fetch_all(text, edition, year)` searches cached entries, filtering by text content (via `match_xml_text?`), edition, and/or year. Returns an array of deserialized bibliographic items from both local and global caches.
+
+The dual-cache strategy uses a **global cache** (`~/.relaton/cache`) and an optional **local cache** (project-level). `check_bibliocache` checks local first, falls back to global, and syncs between them.
+
+### DbCache (lib/relaton/db_cache.rb) — File-based Storage
+
+Stores entries as files under `{dir}/{prefix}/{filename}.{ext}` (e.g., `testcache/iso/iso_19115-1.xml`). Key behaviors:
+- Cache keys are wrapped like `ISO(ISO 19115-1:2014)` and converted to filenames via regex
+- Entries can be XML, "not_found {date}", or "redirection {target_key}"
+- Undated references expire after 60 days; dated ones persist indefinitely
+- Version tracking per prefix directory invalidates cache when processor grammar changes
+- File locking (`LOCK_EX`) for thread-safe concurrent writes
+
+### WorkersPool (lib/relaton/workers_pool.rb)
+
+Thread pool for `fetch_async`. Default 10 threads per processor, overridable via `RELATON_FETCH_PARALLEL` env var.
+
+### Cache Key Format
+
+`std_id` builds keys like `ISO(ISO 19115-1:2014 (all parts) after-2020-01-01)`. The filename regex in `db_cache.rb` uses `[^)]+` — suffixes use `-` not parentheses to avoid breaking it.
+
+## Testing
+
+- RSpec with VCR cassettes in `spec/vcr_cassetes/` for recorded HTTP interactions
+- Tests create `testcache`/`testcache2` directories and clean them in `before(:each)`
+- Cache-related tests need `<fetched>` elements in XML for `valid_entry?` to return true
+- Integration tests in `spec/relaton_spec.rb`; unit tests mirror `lib/` structure under `spec/relaton/`
+
+## Style
+
+- RuboCop config inherits from [Ribose OSS guides](https://github.com/riboseinc/oss-guides), target Ruby 3.2
+- Thread safety via `@semaphore` (Mutex) around cache reads/writes in Db

data/Gemfile

@@ -3,16 +3,16 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in gemspec
 gemspec
 
-gem "byebug", "~> 11.0"
+gem "byebug"
 gem "equivalent-xml", "~> 0.6"
 gem "guard", "~> 2.14"
 gem "guard-rspec", "~> 4.7"
-gem "pry-byebug", "~> 3.9.0"
+gem "pry-byebug"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.6"
-gem "rubocop", "~> 1.17.0"
-gem "rubocop-performance", "~> 1.11.0"
-gem "rubocop-rails", "~> 2.10.0"
+gem "rubocop"
+gem "rubocop-performance"
+gem "rubocop-rails"
 gem "simplecov", "~> 0.15"
 gem "timecop", "~> 0.9"
 gem "vcr", "~> 6"

data/Rakefile

@@ -3,4 +3,4 @@ require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
+task default: :spec

data/bin/rspec

@@ -1,5 +1,5 @@
 #!/usr/bin/env ruby
-  
+
 # This file was generated by Bundler.
 #
 # The application 'rspec' is installed as part of a gem, and
@@ -15,4 +15,3 @@ require "rubygems"
 require "bundler/setup"
 
 load Gem.bin_path("rspec-core", "rspec")
-

data/docs/README.adoc

@@ -29,6 +29,7 @@ Relaton imports bibliographic entries from:
 * CIE through the techstreet.com website, via the https://github.com/relaton/relaton-cie[relaton-cie] gem
 * DOI through the api.crossref.org website, via the https://github.com/relaton/relaton-doi[relaton-doi] gem
 * ECMA through the ecma-international.org website, via the https://github.com/relaton/relaton-ecma[relaton-ecma] gem
+* ETSI through the etsi.org website, via the https://github.com/relaton/relaton-etsi[relaton-etsi] gem
 * GB (Chinese national standards) through the GB websites, via the https://github.com/relaton/relaton-gb[relaton-gb] gem
 * IANA through the https://github.com/ietf-tools/iana-registries[iana-registries] dataset, via the https://github.com/relaton/relaton-iana[relaton-iana] gem
 * IEC through the iec.ch website, via the https://github.com/relaton/relaton-iec[relaton-iec] gem
@@ -37,11 +38,13 @@ Relaton imports bibliographic entries from:
 * IHO through the iho.int website, via the https://github.com/relaton/relaton-iho[relaton-iho] gem
 * ISO through the iso.org website, via the https://github.com/relaton/relaton-iso[relaton-iso] gem
 * ITU through the itu.int website, via the https://github.com/relaton/relaton-itu[relaton-itu] gem
-* JIS through the webdesk.jsa.or.jp website, via the https://gihub.com/relaton/relaton-jis[relaton-jis] gem
-* NIST standards through the nist.gov website, via the https://github.com/relaton/relaton-nist[relaotn-nist] gem
+* ISBN through the openlibrary.org website, via the https://github.com/relaton/relaton-isbn[relaton-isbn] gem
+* JIS through the webdesk.jsa.or.jp website, via the https://github.com/relaton/relaton-jis[relaton-jis] gem
+* NIST standards through the nist.gov website, via the https://github.com/relaton/relaton-nist[relaton-nist] gem
 * OASIS through the www.oasis-open.org/standards website, via the https://github.com/relaton/relaton-oasis[relaton-oasis] gem
-* OGC through the https://github.com/opengeospatial/NamingAuthority[dataset], via the https://gibhub.com/relaton/relaton-ogc[relaton-ogc] gem
+* OGC through the https://github.com/opengeospatial/NamingAuthority[dataset], via the https://github.com/relaton/relaton-ogc[relaton-ogc] gem
 * OMG through the omg.org/spec website, via the https://github.com/relaton/relaton-omg[relaton-omg] gem
+* Plateau through the www.mlit.go.jp website, via the https://github.com/relaton/relaton-plateau[relaton-plateau] gem
 * UN through the documents.un.org website, via the https://github.com/relaton/relaton-un[relaton-un] gem
 * W3C through the w3c.org website, via the https://github.com/relaton/relaton-w3c[relaton-w3c] gem
 * XSF through the xmpp.org website, via the https://github.com/relaton/relaton-xsf[relaton-xsf] gem
@@ -82,7 +85,6 @@ e.g. `get("ISO 19115-1", "2014", all_parts: true)` is transformed into a referen
 
 === Configuration
 
-* `logger` - `Logger` instance. By default, the logger is `Logger.new($stderr)` with `Logger::WARN` level.
 * `use_api` - `true` if it needs to use an online cache, `false` if not. The default value is `true`.
 * `api_host` - URL of an online cache. The default value is https://api.relaton.org.
 
@@ -92,12 +94,20 @@ require "relaton"
 => true
 
 Relaton.configure do |conf|
-  conf.logger.level = Logger::DEBUG
   conf.use_api = true
   conf.api_host = "https://api.relaton.org"
 end
 ----
 
+Logger configuration is managed through the `relaton-logger` gem via `Relaton.logger_pool`:
+
+[source,ruby]
+----
+require "relaton"
+
+Relaton.logger_pool[:default] = Relaton::Logger::Log.new($stderr, levels: [:debug, :info, :warn, :error, :fatal])
+----
+
 === Create DB
 
 `Relaton::Db#new(globalcache, localcache)` creates new DB. Returns Relaton::Db instance.
@@ -109,29 +119,17 @@ end
 ----
 # Do not cache any entries retrieved
 db = Relaton::Db.new(nil, nil)
-=> #<Relaton::Db:0x007faaaba77648
- @db=nil,
- @db_name=nil,
- @local_db=nil,
- @local_db_name=nil,
+=> #<Relaton::Db:0x0000000127622a50
 ...
 
 # Use only the global cache for any entries retrieved
 db = Relaton::Db.new("globalcache", nil)
-=> #<Relaton::Db:0x007faabc0e7b30
- @db=#<Relaton::DbCache:0x007faabc0e7ab8 @dir="globalcache", @ext="xml">,
- @db_name="globalcache",
- @local_db=nil,
- @local_db_name=nil,
+=> #<Relaton::Db:0x00000001277cd120
 ...
 
 # Use both a local and a global cache
 db = Relaton::Db.new("globalcache", "localcache")
-=> #<Relaton::Db:0x007faabc900628
- @db=#<Relaton::DbCache:0x007faabc900060 @dir="globalcache", @ext="xml">,
- @db_name="globalcache",
- @local_db=#<Relaton::DbCache:0x007faabc8fa5c0 @dir="localcache", @ext="xml">,
- @local_db_name="localcache",
+=> #<Relaton::Db:0x0000000127aaf6e0
 ...
 ----
 
@@ -157,7 +155,7 @@ db.mv("new_local_dir", type: :local)
 
 `Relaton::Db#clear` removes all entries form DB
 
-=== Fetch documens
+=== Fetch documents
 
 ==== Fetch document by references
 
@@ -169,13 +167,15 @@ There are 3 fetching methods:
 
 Arguments:
 
-* `reference` - (String) reference to fethc document
-* `year` - (String or nil) year to filter relult (optional)
-* `options` - (Hash) hash of options. Alloved options:
+* `reference` - (String) reference to fetch document
+* `year` - (String or nil) year to filter result (optional)
+* `options` - (Hash) hash of options. Allowed options:
 - `:all_parts` - (Boolean) should be `true` if all-parts reference is required
-- `:keep_yer` - (Boolean) should be `true` if undated reference should return an actual reference with the year
+- `:keep_year` - (Boolean) should be `true` if undated reference should return an actual reference with the year
 - `:retries` - (Number) number of network retries. Default 1
 - `:no_cache` - (Boolean) should be `true` if cache should be ignored
+- `:publication_date_after` - (String) filter for documents published on or after this date (inclusive, `"YYYY-MM-DD"`)
+- `:publication_date_before` - (String) filter for documents published before this date (exclusive, `"YYYY-MM-DD"`)
 
 [source,ruby]
 ----
@@ -185,34 +185,34 @@ x = db.fetch("IEEE 19011")
 => nil
 
 x = db.fetch("ISO 19011")
-[relaton-iso] (ISO 19011) fetching...
-[relaton-iso] (ISO 19011) found `ISO 19011 (all parts)`
-=> #<RelatonIsoBib::IsoBibliographicItem:0x007fb1d0ab2f00
+[relaton-iso] INFO: (ISO 19011) Fetching from Relaton repository ...
+[relaton-iso] INFO: (ISO 19011) Found: `ISO 19011:2018`
+=> #<Relaton::Iso::ItemData:0x0000000128631e00
 ...
 
 x = db.fetch("ISO 19011", "2011", retries: 3)
-[relaton-iso] (ISO 19011) fetching...
-[relaton-iso] (ISO 19011) found `ISO 19011:2011`
-=> #<RelatonIsoBib::IsoBibliographicItem:0x007fb1d2593068
+[relaton-iso] INFO: (ISO 19011:2011) Fetching from Relaton repository ...
+[relaton-iso] INFO: (ISO 19011:2011) Found: `ISO 19011:2011`
+=> #<Relaton::Iso::ItemData:0x000000013af95020
 ...
 
 x = db.fetch("ISO 19115", nil, all_parts: true)
-[relaton-iso] (ISO 19115) fetching...
-[relaton-iso] (ISO 19115) found `ISO 19115 (all parts)`
-=> #<RelatonIsoBib::IsoBibliographicItem:0x007fb1d0ae8bf0
+[relaton-iso] INFO: (ISO 19115 (all parts)) Fetching from Relaton repository ...
+[relaton-iso] INFO: (ISO 19115 (all parts)) Found: `ISO 19115 (all parts)`
+=> #<Relaton::Iso::ItemData:0x00000001276f7f98
 ...
 
-# Fetchig from local cache
+# Fetching from local cache
 
 x = db.fetch("ISO 19011")
-=> #<RelatonIsoBib::IsoBibliographicItem:0x007fde5f48a9f0
+=> #<Relaton::Db:0x00000001390b0b00
 ...
 
 x = db.fetch_db("ISO 5749")
 => nil
 
 # Fetching asynchronously
-# RELATON_FETCH_PARALLEL environment variable can be used to ovveride default number of parallel fetches
+# RELATON_FETCH_PARALLEL environment variable can be used to override default number of parallel fetches
 
 # prepare queue for results
 results = Queue.new
@@ -235,6 +235,37 @@ refs.size.times do
 end
 ----
 
+==== Fetch with publication date filter
+
+The `:publication_date_after` and `:publication_date_before` options restrict results to documents published within a date range. The range is inclusive of `:publication_date_after` and exclusive of `:publication_date_before`.
+
+When a date filter is used, the cache is checked first for an existing entry whose publication date satisfies the range. If no match is found, a date-specific cache entry is created.
+
+[source,ruby]
+----
+# Fetch documents published on or after 2018-01-01
+x = db.fetch("IEC 80000-6", nil, publication_date_after: Date.parse("2018-01-01"))
+[relaton-iec] INFO: (IEC 80000-6) Fetching from Relaton repository ...
+[relaton-iec] INFO: (IEC 80000-6) Found: `IEC 80000-6:2022`
+=> #<Relaton::Iec::ItemData:0x000000013f311920
+...
+
+# Fetch documents published before 2020-01-01
+x = db.fetch("IEC 80000-6", nil, publication_date_before: Date.parse("2020-01-01"))
+[relaton-iec] INFO: (IEC 80000-6) Fetching from Relaton repository ...
+[relaton-iec] INFO: (IEC 80000-6) Found: `IEC 80000-6:2008`
+=> #<Relaton::Iec::ItemData:0x00000001282b5290
+...
+
+# Fetch documents published within a range
+x = db.fetch("IEC 80000-6", nil, publication_date_after: Date.parse("2018-01-01"), publication_date_before: Date.parse("2020-01-01"))
+[relaton-iec] INFO: (IEC 80000-6) Fetching from Relaton repository ...
+[relaton-iec] INFO: (IEC 80000-6) Not found.
+[relaton-iec] INFO: (IEC 80000-6) TIP: No match for type, but matches exist: `IEC 80000-6:2008`, `IEC 80000-6:2022`.
+[relaton-iec] INFO: (IEC 80000-6) TIP: No match for type, but matches exist: `IEC 80000-6:2008`, `IEC 80000-6:2022`.
+=> nil
+----
+
 ==== Fetch by URN
 
 This functionality works only for IEC documents.
@@ -242,9 +273,9 @@ This functionality works only for IEC documents.
 [source,ruby]
 ----
 x = db.fetch "urn:iec:std:iec:60050-102:2007:::"
-[relaton-iec] (IEC 60050-102) fetching...
-[relaton-iec] (IEC 60050-102) found `IEC 60050-102:2007`
-=> #<RelatonIec::IecBibliographicItem:0x007fbd6c3790e8
+[relaton-iec] INFO: (IEC 60050-102:2007) Fetching from Relaton repository ...
+[relaton-iec] INFO: (IEC 60050-102:2007) Found: `IEC 60050-102:2007`
+=> #<Relaton::Iec::ItemData:0x0000000130e37a98
 ...
 ----
 
@@ -256,56 +287,52 @@ This functionality works only for ISO, IEC, ITU, and NIST documents.
 [source,ruby]
 ----
 bib = db.fetch "ISO 19115-1 + Amd 1"
-[relaton-iso] (ISO 19115-1) fetching...
-[relaton-iso] (ISO 19115-1) found `ISO 19115-1:2014`
-[relaton-iso] (ISO 19115-1/Amd 1) fetching...
-[relaton-iso] (ISO 19115-1/Amd 1) found ISO `19115-1:2014/Amd 1:2018`
-=> #<RelatonIsoBib::IsoBibliographicItem:0x007f95a929a748
+[relaton-iso] INFO: (ISO 19115-1) Fetching from Relaton repository ...
+[relaton-iso] INFO: (ISO 19115-1) Found: `ISO 19115-1:2014`
+[relaton-iso] INFO: (ISO 19115-1/Amd 1) Fetching from Relaton repository ...
+[relaton-iso] INFO: (ISO 19115-1/Amd 1) Found: `ISO 19115-1:2014/Amd 1:2018`
+=> #<Relaton::Iso::ItemData:0x000000012782e4c0
+...
 
-bib.docidentifier[0].id
+bib.docidentifier[0].content.to_s
 => "ISO 19115-1 + Amd 1"
 
 bib.relation[0].type
 => "updates"
 
-bib.relation[0].bibitem.docidentifier[0].id
+bib.relation[0].bibitem.docidentifier[0].content.to_s
 => "ISO 19115-1"
 
 bib.relation[1].type
 => "derivedFrom"
 
-bib.relation[1].bibitem.docidentifier[0].id
-=> "ISO 19115-1/Amd 1:2018"
+bib.relation[1].bibitem.docidentifier[0].content.to_s
+=> "ISO 19115-1/Amd 1"
+----
 
-bib.docidentifier[0].id
+==== Fetch applied documents
+[source,ruby]
+----
+bib = db.fetch "ISO 19115-1, Amd 1"
+=> #<Relaton::Iso::ItemData:0x00000001265d5f08
+
+bib.docidentifier[0].content.to_s
 => "ISO 19115-1, Amd 1"
 
 bib.relation[0].type
 => "updates"
 
-bib.relation[0].bibitem.docidentifier[0].id
+bib.relation[0].bibitem.docidentifier[0].content.to_s
 => "ISO 19115-1"
 
 bib.relation[1].type
 => "complements"
 
-bib.relation[1].description
+bib.relation[1].description.content
 => "amendment"
 
-bib.relation[1].bibitem.docidentifier[0].id
-=> "ISO 19115-1/Amd 1:2018"
-----
-
-==== Fetch applied documents
-[source,ruby]
-----
-bib = db.fetch "ISO 19115-1, Amd 1"
-=> ["Chinese Standard", "GB/T 1.1"]
-[relaton-iso] (ISO 19115-1) fetching...
-[relaton-iso] (ISO 19115-1) found ISO `19115-1:2014`
-[relaton-iso] (ISO 19115-1/Amd 1) fetching...
-[relaton-iso] (ISO 19115-1/Amd 1) found ISO `19115-1:2014/Amd 1:2018`
-=> #<RelatonIsoBib::IsoBibliographicItem:0x007fb09b36d1b8
+bib.relation[1].bibitem.docidentifier[0].content.to_s
+=> "ISO 19115-1/Amd 1"
 ...
 ----
 
@@ -319,28 +346,28 @@ bib = db.fetch "ISO 19115-1, Amd 1"
 
 [source,ruby]
 ----
-# query for all entries in a cahche
+# query for all entries in a cache
 
 items = db.fetch_all
-=> [#<RelatonIec::IecBibliographicItem:0x007facda8fdc28
+=> [#<Relaton::Iso::ItemData:0x00000001265d5c88
 ...
 
 items.size
 => 6
 
-# query for all entries in a cahche for a certain string
+# query for all entries in a cache for a certain string
 
 items = db.fetch_all("mathematical terminology")
-=> [#<RelatonIec::IecBibliographicItem:0x007ffeae5bd240
+=> [<Relaton::Iec::ItemData:0x0000000125dabd50
 ...
 
 items.size
 => 1
 
-items[0].docidentifier[0].id
+items[0].docidentifier[0].content.to_s
 => "IEC 60050-102:2007"
 
-# query for all entries in a cahche for a certain string and edition
+# query for all entries in a cache for a certain string and edition
 
 items = db.fetch_all("system", edition: "2")
 => [#<RelatonIsoBib::IsoBibliographicItem:0x007ffebe2d1be8
@@ -352,17 +379,17 @@ items.size
 items[0].docidentifier[0].id
 => "ISO 19011:2011"
 
-# query for all entries in a cahche for a certain string and year
+# query for all entries in a cache for a certain string and year
 
-items = db.fetch_all("system", year: 2018)
-=> [#<RelatonIsoBib::IsoBibliographicItem:0x007ffeae645fa0
+items = db.fetch_all("Electromagnetism", edition: "2")
+=> [#<Relaton::Iec::ItemData:0x0000000123a93e80
 ...
 
 items.size
 => 1
 
-items[0].docidentifier[0].id
-=> "ISO 19011 (all parts)"
+items[0].docidentifier[0].content.to_s
+=> "IEC 80000-6:2022"
 ----
 
 === Get document type
@@ -376,29 +403,29 @@ db.docid_type("CN(GB/T 1.1)")
 [source,ruby]
 ----
 x.to_xml
-=> "<bibitem id="ISO19115(allparts)" type="standard">
+=> "<bibitem id="IEC600501022007" type="standard" schema-version="v1.4.1">
       ...
     </bibitem>"
 
 db.to_xml
 => "<?xml version"1.0" encoding="UTF-8"?>
     <documents>
-      <bibdata type="standard">
+      <bibdata type="standard" schema-version="v1.4.1">
         ...
       </bibdata>
-      <bibdata type="standard">
+      <bibdata type="standard" schema-version="v1.4.1">
         ...
       </bibdata>
       ...
     </documents"
 
 x.to_xml bibdata: true
-=> "<bibdata type="standard">
+=> "<bibdata type="standard" schema-version="v1.4.1">
       ...
     </bibdata>"
 
 db.load_entry("ISO(ISO 19011)")
-=> "<bibdata type="standard">
+=> "<bibdata type="standard" schema-version="v1.4.1">
       ...
     </bibdata>"
 ----
@@ -407,7 +434,7 @@ db.load_entry("ISO(ISO 19011)")
 [source,ruby]
 ----
 db.save_entry("ISO(ISO 19011)", nil)
-=> nil
+=> true
 
 db.load_entry("ISO(ISO 19011)")
 => nil

data/lib/relaton/config.rb

@@ -8,10 +8,9 @@ module Relaton
       @configuration ||= self::Configuration.new
     end
   end
-  extend Config
-
-  class Configuration # < RelatonBib::Configuration
 
+  # < RelatonBib::Configuration
+  class Configuration
     attr_accessor :use_api, :api_host
 
     def initialize