Class: RelatonBib::DocumentIdentifier

Inherits:
Object
  • Object
show all
Defined in:
lib/relaton_bib/document_identifier.rb

Overview

Document identifier.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(id:, type: nil, scope: nil) ⇒ DocumentIdentifier

Returns a new instance of DocumentIdentifier.

Parameters:

  • id (String)
  • type (String, NilClass) (defaults to: nil)
  • scoope (String, NilClass) 


13
14
15
16
17
 
# File 'lib/relaton_bib/document_identifier.rb', line 13

def initialize(id:, type: nil, scope: nil)
  @id    = id
  @type  = type
  @scope = scope
end

Instance Attribute Details

#id ⇒ String (readonly)

Returns:

  • (String) 


5
6
7
 
# File 'lib/relaton_bib/document_identifier.rb', line 5

def id
  @id
end

#scope ⇒ String, NilClass (readonly)

Returns:

  • (String, NilClass) 


8
9
10
 
# File 'lib/relaton_bib/document_identifier.rb', line 8

def scope
  @scope
end

#type ⇒ String, NilClass (readonly)

Returns:

  • (String, NilClass) 


8
9
10
 
# File 'lib/relaton_bib/document_identifier.rb', line 8

def type
  @type
end

Instance Method Details

#all_parts ⇒ Object 



37
38
39
40
41
42
43
 
# File 'lib/relaton_bib/document_identifier.rb', line 37

def all_parts
  if type == "URN"
    @id.sub!(%r{^(urn:iec:std(?::[^:]*){4}).*}, '\1:ser')
  else
    @id += " (all parts)"
  end
end

#remove_date ⇒ Object 



28
29
30
31
32
33
34
35
 
# File 'lib/relaton_bib/document_identifier.rb', line 28

def remove_date
  case @type
  when "Chinese Standard" then @id.sub!(/-[12]\d\d\d/, "")
  when "ISO", "IEC" then @id.sub!(/:[12]\d\d\d/, "")
  when "URN"
    @id.sub!(/^(urn:iec:std:[^:]+:[^:]+:)[^:]*/, '\1')
  end
end

#remove_part ⇒ Object

in docid manipulations, assume ISO as the default: id-part:year



20
21
22
23
24
25
26
 
# File 'lib/relaton_bib/document_identifier.rb', line 20

def remove_part
  case @type
  when "Chinese Standard" then @id.sub!(/\.\d+/, "")
  when "ISO", "IEC" then @id.sub!(/-[^:]+/, "")
  when "URN" then remove_urn_part
  end
end

#to_asciibib(prefix = "", count = 1) ⇒ String

Parameters:

  • prefix (String) (defaults to: "")
  • count (Integer) (defaults to: 1) —

    number of docids

Returns:

  • (String) 


72
73
74
75
76
77
78
79
80
 
# File 'lib/relaton_bib/document_identifier.rb', line 72

def to_asciibib(prefix = "", count = 1)
  pref = prefix.empty? ? prefix : prefix + "."
  return "#{pref}docid:: #{id}\n" unless type || scope

  out = count > 1 ? "#{pref}docid::\n" : ""
  out += "#{pref}docid.type:: #{type}\n" if type
  out += "#{pref}docid.scope:: #{scope}\n" if scope
  out + "#{pref}docid.id:: #{id}\n"
end

#to_hash ⇒ Hash

Returns:

  • (Hash) 


62
63
64
65
66
67
 
# File 'lib/relaton_bib/document_identifier.rb', line 62

def to_hash
  hash = { "id" => id }
  hash["type"] = type if type
  hash["scope"] = scope if scope
  hash
end

#to_xml(**opts) ⇒ Object

Add docidentifier xml element

Parameters:

  • opts (Hash)

Options Hash (**opts):

  • :builder (Nokogiri::XML::Builder) —

    XML builder

  • :lang (String) —

    language



51
52
53
54
55
56
57
58
59
 
# File 'lib/relaton_bib/document_identifier.rb', line 51

def to_xml(**opts) # rubocop:disable Metrics/AbcSize
  lid = if type == "URN" && opts[:lang]
          id.sub %r{(?<=:)(?:\w{2},)*?(#{opts[:lang]})(?:,\w{2})*}, '\1'
        else id
        end
  element = opts[:builder].docidentifier lid
  element[:type] = type if type
  element[:scope] = scope if scope
end