relaton 2.1.0 → 3.0.0.pre.alpha.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5774763b35647935239061ed5da1c618f8c2c84b31adbf83afb56aa7a920da10
-  data.tar.gz: 612177a17fbbca7af8d5a32d5a408ef82e6ce7a00a1f37e9c6e6302976d6dd70
+  metadata.gz: bc5caa9d5213f1beb15ba9b972f40a3b6acbf7440d58ca1a958d6c5537f172a2
+  data.tar.gz: d3091a1f1228ffa5fd3113c41fc0781c4150a3705586fb070acfdb24057bd9f2
 SHA512:
-  metadata.gz: 3284e5fc96ed6d0b4035c093d8bef53dcda4225a9477fb137610829f6676674702020541cba00ba8cc41dafcd6548eb8eafbcf6fc2e6a800b1ba844d38e71e91
-  data.tar.gz: 97acc11738d7b016522b9b145e056c3b9fe934307a94e3d83ea5d78c2259a55260f94c49dcd5fb928bf184373fa79a37708900326323c29fc4388522da7fa88b
+  metadata.gz: 6274eda8271b12eb7fc122d6125cd9c70c42351b00298b28777731f1b8fbb7d6fad98b837f5b7f686dede0b6aab5c2da36166fb44c83d25dceb394aa5314a1f5
+  data.tar.gz: 3fc1db36905ae3ae93b8de640370b428688d804c8a86c5f5e4510e292fe6cf30ae69a74caf2125a636d9ae7f67dc27859aa79975b647bb911b1373789aa62f36

data/{docs/README.adoc → README.adoc}

@@ -1,12 +1,19 @@
 = Relaton
 
 image:https://img.shields.io/gem/v/relaton.svg["Gem Version", link="https://rubygems.org/gems/relaton"]
-image:https://github.com/relaton/relaton/workflows/rake/badge.svg["Build Status", link="https://github.com/relaton/relaton/actions?workflow=rake"]
-image:https://codeclimate.com/github/relaton/relaton/badges/gpa.svg["Code Climate", link="https://codeclimate.com/github/relaton/relaton"]
-image:https://img.shields.io/github/issues-pr-raw/relaton/relaton.svg["Pull Requests", link="https://github.com/relaton/relaton/pulls"]
-image:https://img.shields.io/github/commits-since/relaton/relaton/latest.svg["Commits since latest",link="https://github.com/relaton/relaton/releases"]
+image:https://github.com/relaton/relaton/actions/workflows/rake.yml/badge.svg["Build Status", link="https://github.com/relaton/relaton/actions/workflows/rake.yml"]
 
 Gem for importing and caching bibliographic references to technical standards.
+Every standards-body flavor ships inside this single gem; flavor code loads on
+demand via `autoload`, and the `Relaton::Db` API routes a reference to the right
+flavor by its prefix. The command-line interface, `relaton-cli`, is a separate gem.
+
+== Installation
+
+[source,ruby]
+----
+gem "relaton"
+----
 
 == Scope
 
@@ -14,40 +21,13 @@ The Relaton gem obtains authoritative bibliographic entries for technical standa
 
 The gem also caches entries it has retrieved so that subsequent iterations do not need to go back online to retrieve the same entries. The gem uses two caches: a global cache (for all bibliographic entries retrieved by the user), and a local cache (intended to store references specific to the current document being processed.)
 
-Entries are retrieved and stored in https://github.com/relaton/relaton-models[Relaton bibliographic model], which is an expression of ISO 690. The subset of the model used and serialized for Relaton is defined in the https://github.com/relaton/relaton-bib[relaton-bib] and https://github.com/relaton/relaton-iso-bib[relaton-iso-bib] gems.
+Entries are retrieved and stored in https://github.com/relaton/relaton-models[Relaton bibliographic model], which is an expression of ISO 690. The subset of the model used and serialized for Relaton is defined by the bundled `Relaton::Bib` model.
 
 Entries are serialized to and from an internal data model, and multiple formats are intended to be supported. Currently, only https://github.com/relaton/relaton-models/blob/master/grammars/biblio.rnc[Relaton XML] is supported.
 
-Relaton imports bibliographic entries from:
-
-* 3GPP through the portal.3gpp.org website, via the https://github.com/relaton/relaton-3gpp[relaton-3gpp] gem
-* BIPM through the https://github.com/metanorma/bipm-data-outcomes[bipm-data-outcomes], https://github.com/metanorma/bipm-si-brochure[bipm-si-brochure], https://github.com/relaton/rawdata-bipm-metrologia[rawdata-bipm-metrologia] datasets, via the the https://github.com/relaton/relaton-bipm[relaton-bipm] gem
-* BSI through the knowledge.bsigroup.com/search website, via the https://github.com/relaton/relaton-bsi[relaton-bsi] gem
-* CalConnect through the standards.calconnect.org website, via the https://github.com/relaton/relaton-calconnect[relaton-calconnect] gem
-* CCSDS through the public.ccsds.org/Publications/AllPubs.aspx website, via the https://github.com/relaton/relaton-ccsds[relaton-ccsds] gem
-* CEN through the standards.cencenelec.eu website, via the https://github.com/relaton/relaton-cen[relaton-cen] gem
-* 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
-* IEEE through the standards.ieee.org website, via the https://github.com/relaton/relaton-ieee[relaton-ieee] gem
-* IETF standards (Internet Drafts, RFC) through the http://xml2rfc.tools.ietf.org website, via the https://github.com/relaton/relaton-ietf[relaton-ietf] gem
-* 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
-* 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://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
+Relaton fetches bibliographic entries from ~29 standards bodies. Each is a
+flavor bundled in this gem (ISO, IEC, IETF, NIST, IEEE, GB, W3C, ...) -- see
+<<Flavors>> for the full list and per-flavor notes.
 
 The identifiers for which bibliographic entries are to be retrieved need to indicate which standards body they belong to. To do so, this gem adopts the convention of bracketing identifiers, and preceding them with a code that indicates the standards body:
 
@@ -55,9 +35,9 @@ The identifiers for which bibliographic entries are to be retrieved need to indi
 * Otherwise, the wrappers use the agreed abbreviation of the standards body. So `IETF(I-D.ribose-asciirfc-08)` identifies `I-D.ribose-asciirfc` as an Internet Engineering Task Force identifier.
 * Some prefixes to identifiers indicate the standards body they belong to unambiguously; e.g. `ISO` followed by a slash or space. The scope wrapper is not required for those prefixes: `ISO(ISO 639-1)` can be recognized as just `ISO 639-1`.
 
-The gem can be extended to use other standards-specific gems. Standards-specific gems like isobib register themselves against Relaton using `Relaton::Registry.instance.register`, which takes as an argument a subclass of `Relaton::Processor` defined in the gem; see isobib/lib/relaton for an example. The processor within the standards-specific gem needs to define
+Each flavor registers a `Relaton::<Flavor>::Processor` (a subclass of `Relaton::Core::Processor`) with the registry. A processor defines:
 
-* `@short`, the name of the gem
+* `@short`, the flavor name
 * `@prefix`, the regex which scopes the identifier, and constrains it to belong to a particular standards class.
 * `@defaultprefix`, the identifier prefixes which can be recognized without a scope wrapper.
 * `@idtype`, the type assigned to document identifiers for the standard class.
@@ -99,7 +79,7 @@ Relaton.configure do |conf|
 end
 ----
 
-Logger configuration is managed through the `relaton-logger` gem via `Relaton.logger_pool`:
+Logger configuration is managed via `Relaton.logger_pool`:
 
 [source,ruby]
 ----
@@ -439,3 +419,94 @@ db.save_entry("ISO(ISO 19011)", nil)
 db.load_entry("ISO(ISO 19011)")
 => nil
 ----
+
+== Layout
+
+----
+relaton.gemspec          # the one gemspec (union of every flavor's external deps)
+lib/
+├── relaton.rb           # entry point: autoload per flavor, then require relaton/db
+└── relaton/
+    ├── version.rb       # Relaton::VERSION — the single source of truth
+    ├── db.rb, db/       # Relaton::Db: registry, cache, workers pool
+    ├── core/ bib/ index/ logger/   # shared infrastructure
+    └── iso/ iec/ ietf/ … 3gpp/     # ~29 flavor plugins
+spec/<flavor>/           # each flavor's spec suite
+grammar/                 # shared RelaxNG test schemas (test-only, not shipped)
+gems/relaton-cli/        # the separate relaton-cli gem
+----
+
+== Flavors
+
+Every flavor lives under `lib/relaton/<flavor>/` and keeps its own README with
+usage and architecture notes.
+
+Standards bodies:
+
+link:lib/relaton/3gpp/README.adoc[3gpp],
+link:lib/relaton/bipm/README.adoc[bipm],
+link:lib/relaton/bsi/README.adoc[bsi],
+link:lib/relaton/calconnect/README.adoc[calconnect],
+link:lib/relaton/ccsds/README.adoc[ccsds],
+link:lib/relaton/cen/README.adoc[cen],
+link:lib/relaton/cie/README.adoc[cie],
+link:lib/relaton/doi/README.adoc[doi],
+link:lib/relaton/ecma/README.adoc[ecma],
+link:lib/relaton/etsi/README.adoc[etsi],
+link:lib/relaton/gb/README.adoc[gb],
+link:lib/relaton/iana/README.adoc[iana],
+link:lib/relaton/iec/README.adoc[iec],
+link:lib/relaton/ieee/README.adoc[ieee],
+link:lib/relaton/ietf/README.adoc[ietf],
+link:lib/relaton/iho/README.adoc[iho],
+link:lib/relaton/isbn/README.adoc[isbn],
+link:lib/relaton/iso/README.adoc[iso],
+link:lib/relaton/itu/README.adoc[itu],
+link:lib/relaton/jis/README.adoc[jis],
+link:lib/relaton/nist/README.adoc[nist],
+link:lib/relaton/oasis/README.adoc[oasis],
+link:lib/relaton/ogc/README.adoc[ogc],
+link:lib/relaton/oiml/README.adoc[oiml],
+link:lib/relaton/omg/README.adoc[omg],
+link:lib/relaton/plateau/README.adoc[plateau],
+link:lib/relaton/un/README.adoc[un],
+link:lib/relaton/w3c/README.adoc[w3c],
+link:lib/relaton/xsf/README.adoc[xsf].
+
+Foundational libraries:
+
+link:lib/relaton/bib/README.adoc[bib],
+link:lib/relaton/core/README.adoc[core],
+link:lib/relaton/index/README.adoc[index],
+link:lib/relaton/logger/README.adoc[logger].
+
+
+== Development
+
+[source,shell]
+----
+bundle install
+bundle exec rake spec              # run every flavor's spec suite
+bundle exec rake spec:iso          # run one flavor's suite
+bundle exec rake build             # build the relaton gem into pkg/
+bundle exec rake build_all         # build relaton + relaton-cli
+----
+
+Each flavor's specs live in `spec/<flavor>/` and run self-contained against the
+single gem (each in its own directory, so relative fixture/cassette/grammar
+paths resolve). See `CLAUDE.md` for the architecture notes (lazy registry,
+autoload, single version, grammar schemas).
+
+== Versioning
+
+One version, `Relaton::VERSION` in `lib/relaton/version.rb`; every flavor derives
+from it. Bump that file (and `relaton-cli`'s own version) to cut a release.
+
+== Release
+
+The `release` GitHub Actions workflow builds and pushes two gems: `relaton` and
+`relaton-cli`. Requires the `RELATON_CI_RUBYGEMS_API_KEY` secret.
+
+== License
+
+BSD-2-Clause.

data/lib/relaton/3gpp/bibdata.rb

@@ -0,0 +1,9 @@
+module Relaton
+  module ThreeGpp
+    # This class represents a bibliographic item as a bibdata.
+    class Bibdata < Item
+      model ItemData
+      include Bib::BibdataShared
+    end
+  end
+end

data/lib/relaton/3gpp/bibitem.rb

@@ -0,0 +1,9 @@
+module Relaton
+  module ThreeGpp
+    # This class represents a bibliographic item as a bibitem.
+    class Bibitem < Item
+      model ItemData
+      include Bib::BibitemShared
+    end
+  end
+end

data/lib/relaton/3gpp/bibliography.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Relaton
+  module ThreeGpp
+    # Methods for search IANA standards.
+    module Bibliography
+      SOURCE = "https://raw.githubusercontent.com/relaton/relaton-data-3gpp/v2/"
+
+      # @param text [String]
+      # @return [RelatonBib::BibliographicItem]
+      def search(text) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+        index = Relaton::Index.find_or_create "3GPP", url: "#{SOURCE}#{INDEXFILE}.zip", file: "#{INDEXFILE}.yaml"
+        row = index.search(text.sub(/^3GPP\s/, "")).min_by { |r| r[:id] }
+        return unless row
+
+        url = "#{SOURCE}#{row[:file]}"
+        resp = Net::HTTP.get_response URI(url)
+        return unless resp.code == "200"
+
+        item = Item.from_yaml(resp.body)
+        item.fetched = Date.today.to_s
+        item
+      rescue  SocketError, Timeout::Error, Errno::EINVAL, Errno::ECONNRESET,
+              EOFError, Net::HTTPBadResponse, Net::HTTPHeaderSyntaxError,
+              Net::ProtocolError, Errno::ETIMEDOUT => e
+        raise Relaton::RequestError, e.message
+      end
+
+      # @param ref [String] the W3C standard Code to look up
+      # @param year [String, NilClass] not used
+      # @param opts [Hash] options
+      # @return [RelatonBib::BibliographicItem]
+      def get(ref, _year = nil, _opts = {})
+        Util.info "Fetching from Relaton repository ...", key: ref
+        result = search(ref)
+        unless result
+          Util.info "Not found.", key: ref
+          return
+        end
+
+        Util.info "Found: `#{result.docidentifier[0].content}`", key: ref
+        result
+      end
+
+      extend Bibliography
+    end
+  end
+end

data/lib/relaton/3gpp/data_fetcher.rb

@@ -0,0 +1,255 @@
+require "fileutils"
+require "net/http"
+require "uri"
+require_relative "../3gpp"
+require_relative "parser"
+
+module Relaton
+  module ThreeGpp
+    class DataFetcher < Core::DataFetcher
+      CURRENT = "current.yaml".freeze
+      CSV_URL = "https://www.3gpp.org/ftp/Information/Databases/3GPPBibliography.csv".freeze
+
+      def log_error(msg)
+        Util.error msg
+      end
+
+      def index
+        @index ||= Relaton::Index.find_or_create "3gpp", file: "#{INDEXFILE}.yaml"
+      end
+
+      #
+      # Parse documents
+      #
+      # @param [String] source source of documents, status-smg-3gpp for updare
+      #   or status-smg-3gpp-force for renewal
+      #
+      def fetch(source) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+        renewal = source == "status-smg-3GPP-force"
+        file = get_file renewal
+        return unless file && File.exist?(file) && File.size(file) > 20_000_000
+
+        if renewal
+          FileUtils.rm_f Dir.glob(File.join(@output, "/*"))
+          index.remove_all # if renewal
+        end
+        CSV.open(file, "r:bom|utf-8", headers: true, col_sep: ";").each do |row|
+          save_doc Parser.parse(row, @errors)
+        end
+        File.write CURRENT, @current.to_yaml, encoding: "UTF-8"
+        index.save
+        report_errors
+      end
+
+      #
+      # Get file via HTTPS. If file has not changed, return nil
+      #
+      # @param [Boolean] renewal force to update all documents
+      #
+      # @return [String, nil] file name
+      #
+      def get_file(renewal) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        @current = YAML.load_file CURRENT if File.exist? CURRENT
+        @current ||= {}
+        uri = URI(CSV_URL)
+        n = 0
+        begin
+          last_modified = head_last_modified(uri)
+          return unless last_modified
+
+          dt = DateTime.parse(last_modified)
+          if !renewal && !@current["date"].to_s.empty? &&
+              dt == DateTime.parse(@current["date"])
+            return
+          end
+
+          tmp_file = File.join Dir.tmpdir, "3gpp.csv"
+          download(uri, tmp_file)
+        rescue Net::OpenTimeout, Net::ReadTimeout, SocketError => e
+          n += 1
+          retry if n < 5
+          raise e
+        end
+        @current["date"] = dt.to_s
+        tmp_file
+      end
+
+      def head_last_modified(uri)
+        Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https",
+                                            open_timeout: 30, read_timeout: 30) do |http|
+          resp = http.request(Net::HTTP::Head.new(uri.request_uri))
+          raise "HTTP #{resp.code} from #{uri}" unless resp.is_a?(Net::HTTPSuccess)
+
+          resp["last-modified"]
+        end
+      end
+
+      def download(uri, tmp_file)
+        Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https",
+                                            open_timeout: 30, read_timeout: 120) do |http|
+          http.request(Net::HTTP::Get.new(uri.request_uri)) do |resp|
+            raise "HTTP #{resp.code} from #{uri}" unless resp.is_a?(Net::HTTPSuccess)
+
+            File.open(tmp_file, "wb") { |f| resp.read_body { |chunk| f.write(chunk) } }
+          end
+        end
+      end
+
+      #
+      # Save document to file
+      #
+      # @param [RelatonW3c::W3cBibliographicItem, nil] bib bibliographic item
+      #
+      def save_doc(bib) # rubocop:disable Metrics/MethodLength,Metrics/AbcSize
+        return unless bib
+
+        bib1 = bib
+        file = output_file(bib1.docnumber)
+        if @files.include? file
+          bib1 = merge_duplication bib1, file
+          Util.warn "File #{file} already exists. Document: #{bib.docnumber}" if bib1.nil?
+        else
+          @files << file
+          index.add_or_update bib1.docnumber, file
+        end
+        File.write file, serialize(bib1), encoding: "UTF-8" unless bib1.nil?
+      end
+
+      #
+      # Merge duplication
+      #
+      # @param [Relaton3gpp::BibliographicItem] bib new bibliographic item
+      # @param [String] file file name of existing bibliographic item
+      #
+      # @return [Relaton3gpp::BibliographicItem, nil] merged bibliographic item or nil if no merge has been done
+      #
+      def merge_duplication(bib, file)
+        hash = YAML.load_file file
+        existed = Item.from_hash hash
+        changed = update_source? bib, existed
+        bib1, bib2, chng = transposed_relation bib, existed
+        changed ||= chng
+        chng = add_contributor(bib1, bib2)
+        changed ||= chng
+        bib1 if changed
+      end
+
+      #
+      # Update link in case one of bibliographic items has no link
+      #
+      # @param [Relaton3gpp::BibliographicItem] bib1
+      # @param [Relaton3gpp::BibliographicItem] bib2
+      #
+      # @return [Boolean] true if link has been updated
+      #
+      def update_source?(bib1, bib2)
+        if bib1.source.any? && bib2.source.empty?
+          bib2.source = bib1.source
+          true
+        elsif bib1.source.empty? && bib2.source.any?
+          bib1.source = bib2.source
+          true
+        else false
+        end
+      end
+
+      #
+      # If one of bibliographic items has date gereater than anotherm=, make it relation
+      #
+      # @param [Relaton3gpp::BibliographicItem] bib new bibliographic item
+      # @param [Relaton3gpp::BibliographicItem] existed existing bibliographic item
+      #
+      # @return [Array<Relaton3gpp::BibliographicItem, Boolean>] main bibliographic item,
+      #   related bibliographic item, true if relation has been added
+      #
+      def transposed_relation(bib, existed) # rubocop:disable Metrics/CyclomaticComplexity
+        if (bib.date.none? && existed.date.none?) || (bib.date.any? && existed.date.none?)
+          return [bib, existed, false]
+        end
+        return [existed, bib, true] if bib.date.none? && existed.date.any?
+
+        check_transposed_date bib, existed
+      end
+
+      #
+      # Check if date of one bibliographic item is transposed to another
+      #
+      # @param [Relaton3gpp::BibliographicItem] bib new bibliographic item
+      # @param [Relaton3gpp::BibliographicItem] existed existing bibliographic item
+      #
+      # @return [Array<Relaton3gpp::BibliographicItem, Boolean>] main bibliographic item,
+      #   related bibliographic item, true if relation has been added
+      #
+      def check_transposed_date(bib, existed)
+        if bib.date[0].at < existed.date[0].at
+          add_transposed_relation bib, existed
+          [bib, existed, true]
+        elsif bib.date[0].at > existed.date[0].at
+          add_transposed_relation existed, bib
+          [existed, bib, true]
+        else [bib, existed, false]
+        end
+      end
+
+      #
+      # Add transposed relation
+      #
+      # @param [Relaton3gpp::BibliographicItem] bib1 the main bibliographic item
+      # @param [Relaton3gpp::BibliographicItem] bib2 the transposed bibliographic item
+      #
+      # @return [Relaton3gpp::BibliographicItem]
+      #
+      def add_transposed_relation(bib1, bib2)
+        bib2.relation.each { |r| bib1.relation << r }
+        bib2.relation.clear
+        desc = Bib::LocalizedMarkedUpString.new content: "equivalent"
+        rel = Bib::Relation.new(type: "adoptedAs", bibitem: bib2, description: desc)
+        bib1.relation << rel
+      end
+
+      def add_contributor(bib1, bib2) # rubocop:disable Metrics/MethodLength,Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
+        changed = false
+
+        bib2.contributor.each do |bc|
+          next unless bc.person
+
+          existed = bib1.contributor.find { |ic| ic.person&.name == bc.person.name }
+          if existed
+            chng = add_affiliation existed, bc.person.affiliation
+            changed ||= chng
+          else
+            bib1.contributor << bc
+            changed = true
+          end
+        end
+
+        changed
+      end
+
+      def add_affiliation(contrib, affiliation)
+        changed = false
+
+        affiliation.each do |a|
+          unless contrib.person.affiliation.include? a
+            contrib.person.affiliation << a
+            changed = true
+          end
+        end
+
+        changed
+      end
+
+      def to_xml(bib)
+        bib.to_xml(bibdata: true)
+      end
+
+      def to_yaml(bib)
+        bib.to_yaml
+      end
+
+      def to_bibxml(bib)
+        bib.to_rfcxml
+      end
+    end
+  end
+end

data/lib/relaton/3gpp/doctype.rb

@@ -0,0 +1,9 @@
+module Relaton
+  module ThreeGpp
+    class Doctype < Relaton::Bib::Doctype
+      TYPES = %w[TR TS].freeze
+
+      attribute :content, :string, values: TYPES
+    end
+  end
+end

data/lib/relaton/3gpp/ext.rb

@@ -0,0 +1,31 @@
+require_relative "doctype"
+require_relative "release"
+
+module Relaton
+  module ThreeGpp
+    class Ext < Bib::Ext
+      attribute :doctype, Doctype
+      attribute :release, Release
+      attribute :subdoctype, :string, values: %w[spec release]
+      attribute :radiotechnology, :string, values: %w[2G 3G LTE 5G]
+      attribute :common_ims_spec, :boolean
+      attribute :internal, :boolean
+
+      def get_schema_version = Relaton.schema_versions["relaton-model-3gpp"]
+
+      xml do
+        map_element "radiotechnology", to: :radiotechnology
+        map_element "common-ims-spec", to: :common_ims_spec
+        map_element "internal", to: :internal
+        map_element "release", to: :release
+      end
+
+      key_value do
+        map_element "radiotechnology", to: :radiotechnology
+        map_element "common_ims_spec", to: :common_ims_spec
+        map_element "internal", to: :internal
+        map_element "release", to: :release
+      end
+    end
+  end
+end

data/lib/relaton/3gpp/item.rb

@@ -0,0 +1,12 @@
+require_relative "item_data"
+require_relative "ext"
+
+module Relaton
+  module ThreeGpp
+    class Item < Bib::Item
+      model ItemData
+
+      attribute :ext, Ext
+    end
+  end
+end

data/lib/relaton/3gpp/item_data.rb

@@ -0,0 +1,15 @@
+module Relaton
+  module ThreeGpp
+    class ItemData < Bib::ItemData
+      def create_id(without_date: false)
+        return id if id && !id.empty?
+
+        docid = find_primary_docid
+        return unless docid
+
+        pubid = without_date ? docid.content.sub(/:\d{4}$/, "") : docid.content
+        self.id = pubid.to_s.sub(/\A3GPP\s+/, "").gsub(/\W+/, "")
+      end
+    end
+  end
+end