relaton-bib 1.4.0 → 2.1.7

data/lib/relaton_bib/localized_string.rb

@@ -1,93 +0,0 @@
-# frozen_string_literal: true
-
-module RelatonBib
-  # Localized string.
-  class LocalizedString
-    include RelatonBib
-
-    # @return [Array<String>] language Iso639 code
-    attr_reader :language
-
-    # @return [Array<String>] script Iso15924 code
-    attr_reader :script
-
-    # @return [String, Array<RelatonBib::LocalizedString>]
-    attr_accessor :content
-
-    # @param content [String, Array<RelatonBib::LocalizedString>]
-    # @param language [String] language code Iso639
-    # @param script [String] script code Iso15924
-    def initialize(content, language = nil, script = nil) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
-      if content.is_a? Array
-        inv = content.reject { |c| c.is_a?(LocalizedString) || c.is_a?(Hash) }
-      end
-      unless content.is_a?(String) || inv&.none? && content.any?
-        klass = content.is_a?(Array) ? inv.first.class : content.class
-        raise ArgumentError, "invalid LocalizedString content type: #{klass}"
-      end
-      @language = language.is_a?(String) ? [language] : language
-      @script = script.is_a?(String) ? [script] : script
-      @content = if content.is_a?(Array)
-                   content.map do |c|
-                     if c.is_a?(Hash)
-                       LocalizedString.new c[:content], c[:language], c[:script]
-                     else c
-                     end
-                   end
-                 else content
-                 end
-    end
-
-    # @return [String]
-    def to_s
-      content.is_a?(String) ? content : content.first.to_s
-    end
-
-    # @return [TrueClass, FalseClass]
-    def empty?
-      content.empty?
-    end
-
-    # @param builder [Nokogiri::XML::Builder]
-    def to_xml(builder) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
-      return unless content
-
-      if content.is_a?(Array)
-        content.each { |c| builder.variant { c.to_xml builder } }
-      else
-        builder.parent["language"] = language.join(",") if language&.any?
-        builder.parent["script"]   = script.join(",") if script&.any?
-        builder.text content.encode(xml: :text)
-      end
-    end
-
-    # @return [Hash]
-    def to_hash # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
-      if content.is_a? String
-        return content unless language || script
-
-        hash = { "content" => content }
-        hash["language"] = single_element_array(language) if language&.any?
-        hash["script"] = single_element_array(script) if script&.any?
-        hash
-      else content.map &:to_hash
-      end
-    end
-
-    # @param prefix [String]
-    # @param count [Integer] number of elements
-    # @return [String]
-    def to_asciibib(prefix = "", count = 1) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
-      pref = prefix.empty? ? prefix : prefix + "."
-      if content.is_a? String
-        out = count > 1 ? "#{prefix}::\n" : ""
-        out += "#{pref}content:: #{content}\n"
-        language&.each { |l| out += "#{pref}language:: #{l}\n" }
-        script&.each { |s| out += "#{pref}script:: #{s}\n" }
-        out
-      else
-        content.map { |c| c.to_asciibib "#{pref}variant", content.size }.join
-      end
-    end
-  end
-end

data/lib/relaton_bib/medium.rb

@@ -1,44 +0,0 @@
-module RelatonBib
-  class Medium
-    # @return [String, NilClass]
-    attr_reader :form, :size, :scale
-
-    # @param form [String, NilClass]
-    # @param size [String, NilClass]
-    # @param scale [String, NilClass]
-    def initialize(form: nil, size: nil, scale: nil)
-      @form  = form
-      @size  = size
-      @scale = scale
-    end
-
-    # @param builder [Nokogiri::XML::Builder]
-    def to_xml(builder)
-      builder.medium do
-        builder.form form if form
-        builder.size size if size
-        builder.scale scale if scale
-      end
-    end
-
-    # @return [Hash]
-    def to_hash
-      hash = {}
-      hash["form"] = form if form
-      hash["size"] = size if size
-      hash["scale"] = scale if scale
-      hash
-    end
-
-    # @param prefix [String]
-    # @return [String]
-    def to_asciibib(prefix = "")
-      pref = prefix.empty? ? "medium." : prefix + ".medium."
-      out = ""
-      out += "#{pref}form:: #{form}\n" if form
-      out += "#{pref}size:: #{size}\n" if size
-      out += "#{pref}scale:: #{scale}\n" if scale
-      out
-    end
-  end
-end

data/lib/relaton_bib/organization.rb

@@ -1,135 +0,0 @@
-# frozen_string_literal: true
-
-require "relaton_bib/contributor"
-
-module RelatonBib
-  # Organization identifier.
-  class OrgIdentifier
-    ORCID = "orcid"
-    URI   = "uri"
-
-    # @return [String]
-    attr_reader :type
-
-    # @return [String]
-    attr_reader :value
-
-    # @param type [String] "orcid" or "uri"
-    # @param value [String]
-    def initialize(type, value)
-      unless [ORCID, URI].include? type
-        raise ArgumentError, 'Invalid type. It should be "orsid" or "uri".'
-      end
-
-      @type  = type
-      @value = value
-    end
-
-    # @param builder [Nokogiri::XML::Builder]
-    def to_xml(builder)
-      builder.identifier(value, type: type)
-    end
-
-    # @return [Hash]
-    def to_hash
-      { "type" => type, "id" => value }
-    end
-
-    # @param prefix [String]
-    # @param count [Integer]
-    # @return [String]
-    def to_asciibib(prefix = "", count = 1)
-      pref = prefix.empty? ? prefix : prefix + "."
-      out = count > 1 ? "#{pref}identifier::\m" : ""
-      out += "#{pref}identifier.type:: #{type}\n"
-      out += "#{pref}identifier.value:: #{value}\n"
-      out
-    end
-  end
-
-  # Organization.
-  class Organization < Contributor
-    # @return [Array<RelatonBib::LocalizedString>]
-    attr_reader :name
-
-    # @return [RelatonBib::LocalizedString, NilClass]
-    attr_reader :abbreviation
-
-    # @return [RelatonBib::LocalizedString, NilClass]
-    attr_reader :subdivision
-
-    # @return [Array<RelatonBib::OrgIdentifier>]
-    attr_reader :identifier
-
-    # @param name [String, Hash, Array<String, Hash>]
-    # @param abbreviation [RelatoBib::LocalizedString, String]
-    # @param subdivision [RelatoBib::LocalizedString, String]
-    # @param url [String]
-    # @param identifier [Array<RelatonBib::OrgIdentifier>]
-    # @param contact [Array<RelatonBib::Address, RelatonBib::Contact>]
-    def initialize(**args) # rubocop:disable Metrics/AbcSize
-      raise ArgumentError, "missing keyword: name" unless args[:name]
-
-      super(url: args[:url], contact: args.fetch(:contact, []))
-
-      @name = if args[:name].is_a?(Array)
-                args[:name].map { |n| localized_string(n) }
-              else
-                [localized_string(args[:name])]
-              end
-
-      @abbreviation = localized_string args[:abbreviation]
-      @subdivision  = localized_string args[:subdivision]
-      @identifier   = args.fetch(:identifier, [])
-    end
-
-    # @param builder [Nokogiri::XML::Builder]
-    def to_xml(builder) # rubocop:disable Metrics/AbcSize
-      builder.organization do
-        name.each do |n|
-          builder.name { |b| n.to_xml b }
-        end
-        builder.subdivision { |s| subdivision.to_xml s } if subdivision
-        builder.abbreviation { |a| abbreviation.to_xml a } if abbreviation
-        builder.uri url if uri
-        identifier.each { |identifier| identifier.to_xml builder }
-        super
-      end
-    end
-
-    # @return [Hash]
-    def to_hash
-      hash = { "name" => single_element_array(name) }
-      hash["abbreviation"] = abbreviation.to_hash if abbreviation
-      hash["identifier"] = single_element_array(identifier) if identifier&.any?
-      hash["subdivision"] = subdivision.to_hash if subdivision
-      { "organization" => hash.merge(super) }
-    end
-
-    # @param prefix [String]
-    # @param count [Integer]
-    # @return [String]
-    def to_asciibib(prefix = "", count = 1) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
-      pref = prefix.sub /\*$/, "organization"
-      out = count > 1 ? "#{pref}::\m" : ""
-      name.each { |n| out += n.to_asciibib "#{pref}.name", name.size }
-      out += abbreviation.to_asciibib "#{pref}.abbreviation" if abbreviation
-      out += subdivision.to_asciibib "#{pref}.subdivision" if subdivision
-      identifier.each { |n| out += n.to_asciibib pref, identifier.size }
-      out += super pref
-      out
-    end
-
-    private
-
-    # @param arg [String, Hash, RelatoBib::LocalizedString]
-    # @return [RelatoBib::LocalizedString]
-    def localized_string(arg)
-      if arg.is_a?(String) then LocalizedString.new(arg)
-      elsif arg.is_a?(Hash)
-        LocalizedString.new(arg[:content], arg[:language], arg[:script])
-      elsif arg.is_a? LocalizedString then arg
-      end
-    end
-  end
-end

data/lib/relaton_bib/person.rb

@@ -1,206 +0,0 @@
-# frozen_string_literal: true
-
-require "relaton_bib/contributor"
-
-module RelatonBib
-  # Person's full name
-  class FullName
-    include RelatonBib
-
-    # @return [Array<RelatonBib::LocalizedString>]
-    attr_accessor :forename
-
-    # @return [Array<RelatonBib::LocalizedString>]
-    attr_accessor :initial
-
-    # @return [RelatonBib::LocalizedString]
-    attr_accessor :surname
-
-    # @return [Array<RelatonBib::LocalizedString>]
-    attr_accessor :addition
-
-    # @return [Array<RelatonBib::LocalizedString>]
-    attr_accessor :prefix
-
-    # @return [RelatonBib::LocalizedString]
-    attr_reader :completename
-
-    # @param surname [RelatonBib::LocalizedString]
-    # @param forename [Array<RelatonBib::LocalizedString>]
-    # @param initial [Array<RelatonBib::LocalizedString>]
-    # @param addition [Array<RelatonBib::LocalizedString>]
-    # @param prefix [Array<RelatonBib::LocalizedString>]
-    # @param completename [RelatonBib::LocalizedString]
-    def initialize(**args)
-      unless args[:surname] || args[:completename]
-        raise ArgumentError, "Should be given :surname or :completename"
-      end
-
-      @surname      = args[:surname]
-      @forename     = args.fetch :forename, []
-      @initial      = args.fetch :initial, []
-      @addition     = args.fetch :addition, []
-      @prefix       = args.fetch :prefix, []
-      @completename = args[:completename]
-    end
-
-    # @param builder [Nokogiri::XML::Builder]
-    def to_xml(builder) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
-      builder.name do
-        if completename
-          builder.completename { completename.to_xml builder }
-        else
-          prefix.each { |p| builder.prefix { p.to_xml builder } }
-          forename.each { |f| builder.forename { f.to_xml builder } }
-          initial.each { |i| builder.initial { i.to_xml builder } }
-          builder.surname { surname.to_xml builder }
-          addition.each { |a| builder.addition { a.to_xml builder } }
-        end
-      end
-    end
-
-    # @return [Hash]
-    def to_hash # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
-      hash = {}
-      hash["forename"] = single_element_array(forename) if forename&.any?
-      hash["initial"] = single_element_array(initial) if initial&.any?
-      hash["surname"] = surname.to_hash if surname
-      hash["addition"] = single_element_array(addition) if addition&.any?
-      hash["prefix"] = single_element_array(prefix) if prefix&.any?
-      hash["completename"] = completename.to_hash if completename
-      hash
-    end
-
-    # @param pref [String]
-    # @return [String]
-    def to_asciibib(pref) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
-      prf = pref.empty? ? pref : pref + "."
-      prf += "name."
-      out = forename.map do |fn|
-        fn.to_asciibib "#{prf}forename", forename.size
-      end.join
-      initial.each { |i| out += i.to_asciibib "#{prf}initial", initial.size }
-      out += surname.to_asciibib "#{prf}surname" if surname
-      addition.each do |ad|
-        out += ad.to_asciibib "#{prf}addition", addition.size
-      end
-      prefix.each { |pr| out += pr.to_asciibib "#{prf}prefix", prefix.size }
-      out += completename.to_asciibib "#{prf}completename" if completename
-      out
-    end
-  end
-
-  # Person identifier type.
-  module PersonIdentifierType
-    ISNI = "isni"
-    URI  = "uri"
-
-    # Checks type.
-    # @param type [String]
-    # @raise [ArgumentError] if type isn't "isni" or "uri"
-    def self.check(type)
-      unless [ISNI, URI].include? type
-        raise ArgumentError, 'Invalid type. It should be "isni" or "uri".'
-      end
-    end
-  end
-
-  # Person identifier.
-  class PersonIdentifier
-    # @return [RelatonBib::PersonIdentifierType::ISNI,
-    #   RelatonBib::PersonIdentifierType::URI]
-    attr_accessor :type
-
-    # @return [String]
-    attr_accessor :value
-
-    # @param type [RelatonBib::PersonIdentifierType::ISNI,
-    #   RelatonBib::PersonIdentifierType::URI]
-    # @param value [String]
-    def initialize(type, value)
-      PersonIdentifierType.check type
-
-      @type  = type
-      @value = value
-    end
-
-    # @param builser [Nokogiri::XML::Builder]
-    def to_xml(builder)
-      builder.identifier value, type: type
-    end
-
-    # @return [Hash]
-    def to_hash
-      { "type" => type, "id" => value }
-    end
-
-    # @param prefix [String]
-    # @param count [Integer] number of ids
-    # @return [String]
-    def to_asciibib(prefix = "", count = 1)
-      pref = prefix.empty? ? prefix : prefix + "."
-      out = count > 1 ? "#{prefix}::\n" : ""
-      out += "#{pref}type:: #{type}\n"
-      out += "#{pref}value:: #{value}\n"
-      out
-    end
-  end
-
-  # Person class.
-  class Person < Contributor
-    # @return [RelatonBib::FullName]
-    attr_accessor :name
-
-    # @return [Array<RelatonBib::Affiliation>]
-    attr_accessor :affiliation
-
-    # @return [Array<RelatonBib::PersonIdentifier>]
-    attr_accessor :identifier
-
-    # @param name [RelatonBib::FullName]
-    # @param affiliation [Array<RelatonBib::Affiliation>]
-    # @param contact [Array<RelatonBib::Address, RelatonBib::Contact>]
-    # @param identifier [Array<RelatonBib::PersonIdentifier>]
-    # @param url [String, NilClass]
-    def initialize(name:, affiliation: [], contact: [], identifier: [],
-                   url: nil)
-      super(contact: contact, url: url)
-      @name        = name
-      @affiliation = affiliation
-      @identifier = identifier
-    end
-
-    # @param builder [Nokogiri::XML::Builder]
-    def to_xml(builder)
-      builder.person do
-        name.to_xml builder
-        affiliation.each { |a| a.to_xml builder }
-        identifier.each { |id| id.to_xml builder }
-        contact.each { |contact| contact.to_xml builder }
-      end
-    end
-
-    # @return [Hash]
-    def to_hash
-      hash = { "name" => name.to_hash }
-      if affiliation&.any?
-        hash["affiliation"] = single_element_array(affiliation)
-      end
-      hash["identifier"] = single_element_array(identifier) if identifier&.any?
-      { "person" => hash.merge(super) }
-    end
-
-    # @param prefix [String]
-    # @count [Integer] number of persons
-    # @return [String]
-    def to_asciibib(prefix = "", count = 1) # rubocop:disable Metrics/AbcSize
-      pref = prefix.sub /\*$/, "person"
-      out = count > 1 ? "#{pref}::\n" : ""
-      out += name.to_asciibib pref
-      affiliation.each { |af| out += af.to_asciibib pref, affiliation.size }
-      identifier.each { |id| out += id.to_asciibib pref, identifier.size }
-      out += super pref
-      out
-    end
-  end
-end

data/lib/relaton_bib/place.rb

@@ -1,49 +0,0 @@
-module RelatonBib
-  class Place
-    # @return [String]
-    attr_reader :name
-
-    # @return [String, NilClass]
-    attr_reader :uri, :region
-
-    # @param name [String]
-    # @param uri [String, NilClass]
-    # @param region [String, NilClass]
-    def initialize(name:, uri: nil, region: nil)
-      @name   = name
-      @uri    = uri
-      @region = region
-    end
-
-    # @param builder [Nologiri::XML::Builder]
-    def to_xml(builder)
-      xml = builder.place name
-      xml[:uri] = uri if uri
-      xml[:region] = region if region
-    end
-
-    # @return [Hash]
-    def to_hash
-      if uri || region
-        hash = { name: name }
-        hash["uri"] = uri if uri
-        hash["region"] = region if region
-        hash
-      else
-        name
-      end
-    end
-
-    # @param prefix [String]
-    # @param count [Integer] number of places
-    # @return [Stirng]
-    def to_asciibib(prefix = "", count = 1)
-      pref = prefix.empty? ? "place" : prefix + ".place"
-      out = count > 1 ? "#{pref}::\n" : ""
-      out += "#{pref}.name:: #{name}\n"
-      out += "#{pref}.uri:: #{uri}\n" if uri
-      out += "#{pref}.region:: #{region}\n" if region
-      out
-    end
-  end
-end

data/lib/relaton_bib/series.rb

@@ -1,134 +0,0 @@
-# frozen_string_literal: true
-
-module RelatonBib
-  #
-  # Series class.
-  #
-  class Series
-    TYPES = %w[main alt].freeze
-
-    # @return [String, NilClass] allowed values: "main" or "alt"
-    attr_reader :type
-
-    # @return [RelatonBib::FormattedRef, NilClass]
-    attr_reader :formattedref
-
-    # @return [RelatonBib::FormattedString, NilClass] title
-    attr_reader :title
-
-    # @return [String, NilClass]
-    attr_reader :place
-
-    # @return [String, NilClass]
-    attr_reader :organization
-
-    # @return [RelatonBib::LocalizedString, NilClass]
-    attr_reader :abbreviation
-
-    # @return [String, NilClass] date or year
-    attr_reader :from
-
-    # @return [String, NilClass] date or year
-    attr_reader :to
-
-    # @return [String, NilClass]
-    attr_reader :number
-
-    # @return [String, NilClass]
-    attr_reader :partnumber
-
-    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
-
-    # @param type [String, NilClass] title or formattedref argument should be
-    #   passed
-    # @param formattedref [RelatonBib::FormattedRef, NilClass]
-    # @param title [RelatonBib::TypedTitleString, NilClass]
-    # @param place [String, NilClass]
-    # @param orgaization [String, NilClass]
-    # @param abbreviation [RelatonBib::LocalizedString, NilClass]
-    # @param from [String, NilClass]
-    # @param to [String, NilClass]
-    # @param number [String, NilClass]
-    # @param partnumber [String, NilClass]
-    def initialize(**args)
-      unless args[:title].is_a?(RelatonBib::TypedTitleString) ||
-          args[:formattedref]
-        raise ArgumentError, "argument `title` or `formattedref` should present"
-      end
-
-      if args[:type] && !TYPES.include?(args[:type])
-        warn "[relaton-bib] Series type is invalid: #{args[:type]}"
-      end
-
-      @type         = args[:type] # if %w[main alt].include? args[:type]
-      @title        = args[:title]
-      @formattedref = args[:formattedref]
-      @place        = args[:place]
-      @organization = args[:organization]
-      @abbreviation = args[:abbreviation]
-      @from         = args[:from]
-      @to           = args[:to]
-      @number       = args[:number]
-      @partnumber   = args[:partnumber]
-    end
-    # rubocop:enable Metrics/MethodLength
-
-    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
-
-    # @param builder [Nokogiri::XML::Builder]
-    def to_xml(builder) # rubocop:disable Metrics/MethodLength
-      xml = builder.series do
-        if formattedref
-          formattedref.to_xml builder
-        else
-          builder.title { title.to_xml builder }
-          builder.place place if place
-          builder.organization organization if organization
-          builder.abbreviation { abbreviation.to_xml builder } if abbreviation
-          builder.from from if from
-          builder.to to if to
-          builder.number number if number
-          builder.partnumber partnumber if partnumber
-        end
-      end
-      xml[:type] = type if type
-    end
-    # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity
-    # rubocop:enable Metrics/PerceivedComplexity
-
-    # @return [Hash]
-    def to_hash # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
-      hash = {}
-      hash["type"] = type if type
-      hash["formattedref"] = formattedref.to_hash if formattedref
-      hash["title"] = title.to_hash if title
-      hash["place"] = place if place
-      hash["organization"] = organization if organization
-      hash["abbreviation"] = abbreviation.to_hash if abbreviation
-      hash["from"] = from if from
-      hash["to"] = to if to
-      hash["number"] = number if number
-      hash["partnumber"] = partnumber if partnumber
-      hash
-    end
-
-    # @param prefix [String]
-    # @param count [Integer]
-    # @return [String]
-    def to_asciibib(prefix = "", count = 1) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength,Metrics/PerceivedComplexity
-      pref = prefix.empty? ? "series" : prefix + ".series"
-      out = count > 1 ? "#{pref}::\n" : ""
-      out += "#{pref}.type:: #{type}\n" if type
-      out += formattedref.to_asciibib pref if formattedref
-      out += title.to_asciibib pref if title
-      out += "#{pref}.place:: #{place}\n" if place
-      out += "#{pref}.organization:: #{organization}\n" if organization
-      out += abbreviation.to_asciibib "#{pref}.abbreviation" if abbreviation
-      out += "#{pref}.from:: #{from}\n" if from
-      out += "#{pref}.to:: #{to}\n" if to
-      out += "#{pref}.number:: #{number}\n" if number
-      out += "#{pref}.partnumber:: #{partnumber}\n" if partnumber
-      out
-    end
-  end
-end