Class: RelatonBib::HashConverter

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

Class Method Summary collapse

Class Method Details

.abstract_hash_to_bib(ret) ⇒ Object 



83
84
85
86
87
88
89
 
# File 'lib/relaton_bib/hash_converter.rb', line 83

def abstract_hash_to_bib(ret)
  return unless ret[:abstract]

  ret[:abstract] = array(ret[:abstract]).map do |a|
    a.is_a?(String) ? FormattedString.new(content: a) : a
  end
end

.accesslocation_hash_to_bib(ret) ⇒ Object 



105
106
107
108
109
 
# File 'lib/relaton_bib/hash_converter.rb', line 105

def accesslocation_hash_to_bib(ret)
  return unless ret[:accesslocation]

  ret[:accesslocation] = array(ret[:accesslocation])
end

.affiliation_hash_to_bib(person) ⇒ Object 



241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
 
# File 'lib/relaton_bib/hash_converter.rb', line 241

def affiliation_hash_to_bib(person)
  return [] unless person[:affiliation]

  array(person[:affiliation]).map do |a|
    a[:description] = array(a[:description])&.map do |d|
      cnt = if d.is_a?(Hash)
              { content: d[:content], language: d[:language],
                script: d[:script], format: d[:format] }
            else { content: d }
            end
      FormattedString.new cnt
    end
    Affiliation.new(
      organization: Organization.new(org_hash_to_bib(a[:organization])),
      description: a[:description],
    )
  end
end

.array(arr) ⇒ Array

Parameters:

  • arr (NilClass, Array, #is_a?)

Returns:



436
437
438
439
440
441
 
# File 'lib/relaton_bib/hash_converter.rb', line 436

def array(arr)
  return [] unless arr
  return [arr] unless arr.is_a?(Array)

  arr
end

.bib_item(item_hash) ⇒ RelatonBib::BibliographicItem

Parameters:

  • item_hash (Hash)

Returns:



312
313
314
 
# File 'lib/relaton_bib/hash_converter.rb', line 312

def bib_item(item_hash)
  BibliographicItem.new item_hash
end

.biblionote_hash_to_bib(ret) ⇒ Object 



143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
 
# File 'lib/relaton_bib/hash_converter.rb', line 143

def biblionote_hash_to_bib(ret)
  return unless ret[:biblionote]

  ret[:biblionote] = array(ret[:biblionote])
  (ret[:biblionote])&.each_with_index do |n, i|
    ret[:biblionote][i] = if n.is_a?(String)
      BiblioNote.new content: n
    else
      BiblioNote.new(
        content: n[:content], type: n[:type], language: n[:language],
        script: n[:script], format: n[:format]
      )
    end
  end
end

.classification_hash_to_bib(ret) ⇒ Object

Parameters:

  • ret (Hash) 


370
371
372
373
374
375
376
 
# File 'lib/relaton_bib/hash_converter.rb', line 370

def classification_hash_to_bib(ret)
  if ret[:classification]
    ret[:classification] = array(ret[:classification]).map do |cls|
      Classification.new cls
    end
  end
end

.contacts_hash_to_bib(person) ⇒ Object 



260
261
262
263
264
265
266
267
268
269
270
271
272
273
 
# File 'lib/relaton_bib/hash_converter.rb', line 260

def contacts_hash_to_bib(person)
  return [] unless person[:contact]

  array(person[:contact]).map do |a|
    if a[:city] || a[:country]
      RelatonBib::Address.new(
        street: Array(a[:street]), city: a[:city], postcode: a[:postcode],
        country: a[:country], state: a[:state]
      )
    else
      RelatonBib::Contact.new(type: a[:type], value: a[:value])
    end
  end
end

.contributors_hash_to_bib(ret) ⇒ Object 



180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
 
# File 'lib/relaton_bib/hash_converter.rb', line 180

def contributors_hash_to_bib(ret)
  return unless ret[:contributor]

  ret[:contributor] = array(ret[:contributor])
  ret[:contributor]&.each_with_index do |c, i|
    roles = array(ret[:contributor][i][:role]).map do |r|
      if r.is_a? Hash
        { type: r[:type], description: array(r[:description]) }
      # elsif r.is_a? Array
      #   { type: r[0], description: r.fetch(1) }
      else
        { type: r }
      end
    end
    ret[:contributor][i][:role] = roles
    ret[:contributor][i][:entity] = if c[:person]
                                      person_hash_to_bib(c[:person])
                                    else
                                      org_hash_to_bib(c[:organization])
                                    end
    ret[:contributor][i].delete(:person)
    ret[:contributor][i].delete(:organization)
  end
end

.copyright_hash_to_bib(ret) ⇒ Object

Parameters:

  • ret (Hash) 


276
277
278
279
280
281
282
283
 
# File 'lib/relaton_bib/hash_converter.rb', line 276

def copyright_hash_to_bib(ret)
  return unless ret[:copyright]

  ret[:copyright] = array(ret[:copyright]).map do |c|
    c[:owner] = array(c[:owner])
    c
  end
end

.dates_hash_to_bib(ret) ⇒ Object 



111
112
113
114
115
116
117
118
119
120
121
122
 
# File 'lib/relaton_bib/hash_converter.rb', line 111

def dates_hash_to_bib(ret)
  return unless ret[:date]

  ret[:date] = array(ret[:date])
  ret[:date].each_with_index do |d, i|
    # value is synonym of on: it is reserved word in YAML
    if d[:value]
      ret[:date][i][:on] ||= d[:value]
      ret[:date][i].delete(:value)
    end
  end
end

.docid_hash_to_bib(ret) ⇒ Object 



124
125
126
127
128
129
130
131
132
 
# File 'lib/relaton_bib/hash_converter.rb', line 124

def docid_hash_to_bib(ret)
  return unless ret[:docid]

  ret[:docid] = array(ret[:docid])
  ret[:docid]&.each_with_index do |id, i|
    type = id[:type] || id[:id].match(/^\w+/)&.to_s
    ret[:docid][i] = DocumentIdentifier.new(id: id[:id], type: type)
  end
end

.docstatus_hash_to_bib(ret) ⇒ Object 



163
164
165
166
167
168
169
 
# File 'lib/relaton_bib/hash_converter.rb', line 163

def docstatus_hash_to_bib(ret)
  ret[:docstatus] && ret[:docstatus] = DocumentStatus.new(
    stage: stage(ret[:docstatus][:stage]),
    substage: stage(ret[:docstatus][:substage]),
    iteration: ret[:docstatus][:iteration],
  )
end

.editorialgroup_hash_to_bib(ret) ⇒ Object

Parameters:

  • ret (Hash) 


392
393
394
395
396
397
398
399
 
# File 'lib/relaton_bib/hash_converter.rb', line 392

def editorialgroup_hash_to_bib(ret)
  return unless ret[:editorialgroup]

  technical_committee = array(ret[:editorialgroup]).map do |wg|
    TechnicalCommittee.new WorkGroup.new(wg)
  end
  ret[:editorialgroup] = EditorialGroup.new technical_committee
end

.extent_hash_to_bib(ret) ⇒ Object 



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

def extent_hash_to_bib(ret)
  return unless ret[:extent]

  ret[:extent] = array(ret[:extent])
  ret[:extent]&.each_with_index do |e, i|
    ret[:extent][i] = BibItemLocality.new(e[:type], e[:reference_from],
                                          e[:reference_to])
  end
end

.formattedref(frf) ⇒ RelatonBib::FormattedRef

Parameters:

  • frf (Hash, String)

Returns:



469
470
471
472
473
474
475
 
# File 'lib/relaton_bib/hash_converter.rb', line 469

def formattedref(frf)
  if frf.is_a?(Hash)
    RelatonBib::FormattedRef.new(frf)
  else
    RelatonBib::FormattedRef.new(content: frf)
  end
end

.formattedref_hash_to_bib(ret) ⇒ Object 



159
160
161
 
# File 'lib/relaton_bib/hash_converter.rb', line 159

def formattedref_hash_to_bib(ret)
  ret[:formattedref] && ret[:formattedref] = formattedref(ret[:formattedref])
end

.fullname_hash_to_bib(person) ⇒ Object 



223
224
225
226
227
228
229
230
231
232
233
 
# File 'lib/relaton_bib/hash_converter.rb', line 223

def fullname_hash_to_bib(person)
  n = person[:name]
  FullName.new(
    forename: array(n[:forename])&.map { |f| localname(f, person) },
    initial: array(n[:initial])&.map { |f| localname(f, person) },
    addition: array(n[:addition])&.map { |f| localname(f, person) },
    prefix: array(n[:prefix])&.map { |f| localname(f, person) },
    surname: localname(n[:surname], person),
    completename: localname(n[:completename], person),
  )
end

.hash_to_bib(args, nested = false) ⇒ Hash

Parameters:

  • args (Hash)
  • neated (TrueClas, FalseClass) —

    default true

Returns:

  • (Hash) 


9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/relaton_bib/hash_converter.rb', line 9

def hash_to_bib(args, nested = false)
  return nil unless args.is_a?(Hash)

  ret = Marshal.load(Marshal.dump(symbolize(args))) # deep copy
  timestamp_hash(ret) unless nested
  title_hash_to_bib(ret)
  link_hash_to_bib(ret)
  language_hash_to_bib(ret)
  script_hash_to_bib(ret)
  dates_hash_to_bib(ret)
  docid_hash_to_bib(ret)
  version_hash_to_bib(ret)
  biblionote_hash_to_bib(ret)
  abstract_hash_to_bib(ret)
  formattedref_hash_to_bib(ret)
  docstatus_hash_to_bib(ret)
  contributors_hash_to_bib(ret)
  copyright_hash_to_bib(ret)
  relations_hash_to_bib(ret)
  series_hash_to_bib(ret)
  medium_hash_to_bib(ret)
  place_hash_to_bib(ret)
  extent_hash_to_bib(ret)
  accesslocation_hash_to_bib(ret)
  classification_hash_to_bib(ret)
  validity_hash_to_bib(ret)
  ret[:keyword] = array(ret[:keyword])
  ret[:license] = array(ret[:license])
  editorialgroup_hash_to_bib ret
  ics_hash_to_bib ret
  structuredidentifier_hash_to_bib ret
  ret
end

.ics_hash_to_bib(ret) ⇒ Object

Parameters:

  • ret (Hash) 


402
403
404
405
406
 
# File 'lib/relaton_bib/hash_converter.rb', line 402

def ics_hash_to_bib(ret)
  return unless ret[:ics]

  ret[:ics] = array(ret[:ics]).map { |ics| ICS.new ics }
end

.language_hash_to_bib(ret) ⇒ Object 



71
72
73
74
75
 
# File 'lib/relaton_bib/hash_converter.rb', line 71

def language_hash_to_bib(ret)
  return unless ret[:language]

  ret[:language] = array(ret[:language])
end

.link_hash_to_bib(ret) ⇒ Object 



91
92
93
94
95
 
# File 'lib/relaton_bib/hash_converter.rb', line 91

def link_hash_to_bib(ret)
  return unless ret[:link]

  ret[:link] = array(ret[:link])
end

.localizedstring(lst) ⇒ RelatonBib::LocalizedString

Parameters:

Returns:



459
460
461
462
463
464
465
 
# File 'lib/relaton_bib/hash_converter.rb', line 459

def localizedstring(lst)
  if lst.is_a?(Hash)
    RelatonBib::LocalizedString.new(lst[:content], lst[:language], lst[:script])
  else
    RelatonBib::LocalizedString.new(lst)
  end
end

.localname(name, person) ⇒ RelatonBib::LocalizedString

Parameters:

  • name (Hash, String, NilClass)
  • person (Hash)

Returns:



446
447
448
449
450
451
452
453
454
455
 
# File 'lib/relaton_bib/hash_converter.rb', line 446

def localname(name, person)
  return nil if name.nil?

  lang = name[:language] if name.is_a?(Hash)
  lang ||= person[:name][:language]
  script = name[:script] if name.is_a?(Hash)
  script ||= person[:name][:script]
  n = name.is_a?(Hash) ? name[:content] : name
  RelatonBib::LocalizedString.new(n, lang, script)
end

.medium_hash_to_bib(ret) ⇒ Object

Parameters:

  • ret (Hash) 


365
366
367
 
# File 'lib/relaton_bib/hash_converter.rb', line 365

def medium_hash_to_bib(ret)
  ret[:medium] = Medium.new(ret[:medium]) if ret[:medium]
end

.org_hash_to_bib(org) ⇒ Object 



205
206
207
208
209
210
211
212
 
# File 'lib/relaton_bib/hash_converter.rb', line 205

def org_hash_to_bib(org)
  return nil if org.nil?

  org[:identifier] = array(org[:identifier])&.map do |a|
    OrgIdentifier.new(a[:type], a[:id])
  end
  org
end

.person_hash_to_bib(person) ⇒ Object 



214
215
216
217
218
219
220
221
 
# File 'lib/relaton_bib/hash_converter.rb', line 214

def person_hash_to_bib(person)
  Person.new(
    name: fullname_hash_to_bib(person),
    affiliation: affiliation_hash_to_bib(person),
    contact: contacts_hash_to_bib(person),
    identifier: person_identifiers_hash_to_bib(person),
  )
end

.person_identifiers_hash_to_bib(person) ⇒ Object 



235
236
237
238
239
 
# File 'lib/relaton_bib/hash_converter.rb', line 235

def person_identifiers_hash_to_bib(person)
  array(person[:identifier])&.map do |a|
    PersonIdentifier.new(a[:type], a[:id])
  end
end

.place_hash_to_bib(ret) ⇒ Object 



97
98
99
100
101
102
103
 
# File 'lib/relaton_bib/hash_converter.rb', line 97

def place_hash_to_bib(ret)
  return unless ret[:place]

  ret[:place] = array(ret[:place]).map do |pl|
    pl.is_a?(String) ? Place.new(name: pl) : Place.new(pl)
  end
end

.relation_bibitem_hash_to_bib(rel) ⇒ Object

Parameters:

  • rel (Hash) —

    relation



301
302
303
304
305
306
307
308
 
# File 'lib/relaton_bib/hash_converter.rb', line 301

def relation_bibitem_hash_to_bib(rel)
  if rel[:bibitem]
    rel[:bibitem] = bib_item hash_to_bib(rel[:bibitem], true)
  else
    warn "[relaton-bib] bibitem missing: #{rel}"
    rel[:bibitem] = nil
  end
end

.relation_locality_hash_to_bib(rel) ⇒ RelatonBib::LocalityStack

Parameters:

  • rel (Hash) —

    relation

Returns:



318
319
320
321
322
323
324
325
326
327
328
329
 
# File 'lib/relaton_bib/hash_converter.rb', line 318

def relation_locality_hash_to_bib(rel)
  rel[:locality] = array(rel[:locality])&.map do |bl|
    ls = if bl[:locality_stack]
           array(bl[:locality_stack]).map do |l|
             Locality.new(l[:type], l[:reference_from], l[:reference_to])
           end
         else
           [Locality.new(bl[:type], bl[:reference_from], bl[:reference_to])]
         end
    LocalityStack.new ls
  end
end

.relation_source_locality_hash_to_bib(rel) ⇒ Object

Parameters:

  • rel (Hash) —

    relation



332
333
334
335
336
337
338
339
340
341
342
343
 
# File 'lib/relaton_bib/hash_converter.rb', line 332

def relation_source_locality_hash_to_bib(rel)
  rel[:source_locality] = array(rel[:source_locality])&.map do |sl|
    sls = if sl[:source_locality_stack]
            array(sl[:source_locality_stack]).map do |l|
              SourceLocality.new(l[:type], l[:reference_from], l[:reference_to])
            end
          else
            [SourceLocality.new(sl[:type], sl[:reference_from], sl[:reference_to])]
          end
    SourceLocalityStack.new sls
  end
end

.relations_hash_to_bib(ret) ⇒ Object

Parameters:

  • ret (Hash) 


286
287
288
289
290
291
292
293
294
295
296
297
298
 
# File 'lib/relaton_bib/hash_converter.rb', line 286

def relations_hash_to_bib(ret)
  return unless ret[:relation]

  ret[:relation] = array(ret[:relation])
  ret[:relation]&.each do |r|
    if r[:description]
      r[:description] = FormattedString.new r[:description]
    end
    relation_bibitem_hash_to_bib(r)
    relation_locality_hash_to_bib(r)
    relation_source_locality_hash_to_bib(r)
  end
end

.script_hash_to_bib(ret) ⇒ Object 



77
78
79
80
81
 
# File 'lib/relaton_bib/hash_converter.rb', line 77

def script_hash_to_bib(ret)
  return unless ret[:script]

  ret[:script] = array(ret[:script])
end

.series_hash_to_bib(ret) ⇒ Object

Parameters:

  • ret (Hash) 


346
347
348
349
350
351
352
353
354
355
356
 
# File 'lib/relaton_bib/hash_converter.rb', line 346

def series_hash_to_bib(ret)
  ret[:series] = array(ret[:series])&.map do |s|
    s[:formattedref] && s[:formattedref] = formattedref(s[:formattedref])
    if s[:title]
      s[:title] = { content: s[:title] } unless s[:title].is_a?(Hash)
      s[:title] = typed_title_strig(s[:title])
    end
    s[:abbreviation] && s[:abbreviation] = localizedstring(s[:abbreviation])
    Series.new(s)
  end
end

.stage(stg) ⇒ RelatonBib::DocumentStatus::Stage

Parameters:

  • stg (Hash)

Returns:



173
174
175
176
177
178
 
# File 'lib/relaton_bib/hash_converter.rb', line 173

def stage(stg)
  return unless stg

  args = stg.is_a?(String) ? { value: stg } : stg
  DocumentStatus::Stage.new(**args)
end

.structuredidentifier_hash_to_bib(ret) ⇒ Object

Parameters:

  • ret (Hash) 


409
410
411
412
413
414
415
416
417
 
# File 'lib/relaton_bib/hash_converter.rb', line 409

def structuredidentifier_hash_to_bib(ret)
  return unless ret[:structuredidentifier]

  sids = array(ret[:structuredidentifier]).map do |si|
    si[:agency] = array si[:agency]
    StructuredIdentifier.new si
  end
  ret[:structuredidentifier] = StructuredIdentifierCollection.new sids
end

.symbolize(obj) ⇒ Hash, ...

Parameters:

  • ogj (Hash, Array, String)

Returns:



421
422
423
424
425
426
427
428
429
430
431
432
 
# File 'lib/relaton_bib/hash_converter.rb', line 421

def symbolize(obj)
  if obj.is_a? Hash
    obj.reduce({}) do |memo, (k, v)|
      memo[k.to_sym] = symbolize(v)
      memo
    end
  elsif obj.is_a? Array
    obj.reduce([]) { |memo, v| memo << symbolize(v) }
  else
    obj
  end
end

.timestamp_hash(ret) ⇒ Object

rubocop:enable Metrics/MethodLength, Metrics/AbcSize



44
45
46
 
# File 'lib/relaton_bib/hash_converter.rb', line 44

def timestamp_hash(ret)
  ret[:fetched] ||= Date.today.to_s
end

.title_hash_to_bib(ret) ⇒ Object 



58
59
60
61
62
63
64
65
66
67
68
69
 
# File 'lib/relaton_bib/hash_converter.rb', line 58

def title_hash_to_bib(ret)
  return unless ret[:title]

  ret[:title] = array(ret[:title]).reduce([]) do |m, t|
    if t.is_a?(Hash) then m << t
    else
      m + TypedTitleString.from_string(t)
      # { content: t, language: "en", script: "Latn", format: "text/plain",
      #   type: "main" }
    end
  end
end

.typed_title_strig(title) ⇒ RelatonBib::TypedTitleString

Parameters:

  • title (Hash)

Returns:



360
361
362
 
# File 'lib/relaton_bib/hash_converter.rb', line 360

def typed_title_strig(title)
  TypedTitleString.new title
end

.validity_hash_to_bib(ret) ⇒ Object

Parameters:

  • ret (Hash) 


381
382
383
384
385
386
387
388
 
# File 'lib/relaton_bib/hash_converter.rb', line 381

def validity_hash_to_bib(ret)
  return unless ret[:validity]

  ret[:validity][:begins] && b = Time.parse(ret[:validity][:begins].to_s)
  ret[:validity][:ends] && e = Time.parse(ret[:validity][:ends].to_s)
  ret[:validity][:revision] && r = Time.parse(ret[:validity][:revision].to_s)
  ret[:validity] = Validity.new(begins: b, ends: e, revision: r)
end

.version_hash_to_bib(ret) ⇒ Object 



134
135
136
137
138
139
140
141
 
# File 'lib/relaton_bib/hash_converter.rb', line 134

def version_hash_to_bib(ret)
  return unless ret[:version]

  ret[:version][:draft] = array(ret[:version][:draft])
  ret[:version] && ret[:version] = BibliographicItem::Version.new(
    ret[:version][:revision_date], ret[:version][:draft]
  )
end