Class: RelatonBib::ContributorRole

Inherits:
Object
  • Object
show all
Includes:
RelatonBib
Defined in:
lib/relaton_bib/contribution_info.rb

Overview

Contributor’s role.

Constant Summary collapse

TYPES = 
%w[author performer publisher editor adapter translator
distributor].freeze

Constants included from RelatonBib

VERSION

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from RelatonBib

parse_date

Constructor Details

#initialize(**args) ⇒ ContributorRole

Returns a new instance of ContributorRole.

Parameters:

  • type (String) —

    allowed types “author”, “editor”, “cartographer”, “publisher”

  • description (Array<String>) 


23
24
25
26
27
28
29
30
31
32
 
# File 'lib/relaton_bib/contribution_info.rb', line 23

def initialize(**args)
  if args[:type] && !TYPES.include?(args[:type])
    warn %{[relaton-bib] Contributor's type "#{args[:type]}" is invalid.}
  end

  @type = args[:type]
  @description = args.fetch(:description, []).map do |d|
    FormattedString.new content: d, format: nil
  end
end

Instance Attribute Details

#description ⇒ Array<RelatonBib::FormattedString> (readonly)

Returns:



15
16
17
 
# File 'lib/relaton_bib/contribution_info.rb', line 15

def description
  @description
end

#type ⇒ Strig (readonly)

Returns:

  • (Strig) 


18
19
20
 
# File 'lib/relaton_bib/contribution_info.rb', line 18

def type
  @type
end

Instance Method Details

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

2return [String]

Parameters:

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

    number of contributors



61
62
63
64
65
66
67
68
69
 
# File 'lib/relaton_bib/contribution_info.rb', line 61

def to_asciibib(prefix = "", count = 1)
  pref = prefix.empty? ? prefix : prefix + "."
  out = count > 1 ? "#{prefix}::\n" : ""
  description.each do |d|
    out += d.to_asciibib "#{pref}role.description", description.size
  end
  out += "#{pref}role.type:: #{type}\n" if type
  out
end

#to_hash ⇒ Hash, String

Returns:

  • (Hash, String) 


48
49
50
51
52
53
54
55
56
 
# File 'lib/relaton_bib/contribution_info.rb', line 48

def to_hash
  if description&.any?
    hash = { "description" => single_element_array(description) }
    hash["type"] = type if type
    hash
  elsif type
    type
  end
end

#to_xml(**opts) ⇒ Object

Parameters:

  • opts (Hash)

Options Hash (**opts):

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

    XML builder

  • :lang (String) —

    language



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

def to_xml(**opts) # rubocop:disable Metrics/AbcSize
  opts[:builder].role(type: type) do |builder|
    desc = description.select { |d| d.language&.include? opts[:lang] }
    desc = description unless desc.any?
    desc.each do |d|
      builder.description { |b| d.to_xml(b) }
    end
  end
end