Class: RelatonIetf::RfcEntry

Inherits:
Object
  • Object
show all
Defined in:
lib/relaton_ietf/rfc_entry.rb

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(doc) ⇒ RfcEntry

Initalize parser

Parameters:

  • doc (Nokogiri::XML::Element) —

    document



8
9
10
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 8

def initialize(doc)
  @doc = doc
end

Class Method Details

.parse(doc) ⇒ RelatonIetf::IetfBibliographicItem

Initialize parser & parse document

Parameters:

  • doc (Nokogiri::XML::Element) —

    document

Returns:



19
20
21
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 19

def self.parse(doc)
  new(doc).parse
end

Instance Method Details

#anchor ⇒ String

Create acnhor

Returns:

  • (String) —

    anchor



119
120
121
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 119

def anchor
  "RFC#{docnum}"
end

#code ⇒ String

Parse document code

Returns:

  • (String) —

    document code



110
111
112
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 110

def code
  @doc.at("./xmlns:doc-id").text
end

#docnum ⇒ String

Parse document number

Returns:

  • (String) —

    document number



101
102
103
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 101

def docnum
  /\d+$/.match(code).to_s.sub(/^0+/, "")
end

#forename(int) ⇒ Array<RelatonBib::Forename>

Ctreat initials

Parameters:

  • int (String)

Returns:

  • (Array<RelatonBib::Forename>) 


184
185
186
187
188
189
190
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 184

def forename(int)
  return [] unless int

  int.split(/\.-?\s?|\s/).map do |i|
    RelatonBib::Forename.new initial: i, language: "en", script: "Latn"
  end
end

#parse ⇒ RelatonIetf::IetfBibliographicItem

Parse document

Returns:



28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 28

def parse # rubocop:disable Metrics/MethodLength
  IetfBibliographicItem.new(
    type: "standard",
    language: ["en"],
    script: ["Latn"],
    docid: parse_docid,
    docnumber: code,
    title: parse_title,
    link: parse_link,
    date: parse_date,
    contributor: parse_contributor,
    keyword: parse_keyword,
    abstract: parse_abstract,
    relation: parse_relation,
    status: parse_status,
    series: parse_series,
    editorialgroup: parse_editorialgroup,
  )
end

#parse_abstract ⇒ Array<RelatonBib::FormattedString>

Parse document abstract

Returns:

  • (Array<RelatonBib::FormattedString>) —

    document abstract



206
207
208
209
210
211
212
213
214
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 206

def parse_abstract
  @doc.xpath("./xmlns:abstract").map do |c|
    content = c.xpath("./xmlns:p").map do |p|
      "<#{p.name}>#{p.text.strip}</#{p.name}>"
    end.join
    RelatonBib::FormattedString.new(content: content, language: "en",
                                    script: "Latn", format: "text/html")
  end
end

#parse_contributor ⇒ Array<RelatonBib::ContributionInfo>

Parse document contributors

Returns:

  • (Array<RelatonBib::ContributionInfo>) —

    document contributors



152
153
154
155
156
157
158
159
160
161
162
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 152

def parse_contributor
  @doc.xpath("./xmlns:author").map do |contrib|
    name = contrib.at("./xmlns:name").text
    entity = BibXMLParser.full_name_org name
    unless entity
      fname = BibXMLParser.full_name name, nil, nil, "en", "Latn"
      entity = RelatonBib::Person.new(name: fname)
    end
    RelatonBib::ContributionInfo.new(entity: entity, role: parse_role(contrib))
  end
end

#parse_date ⇒ Array<RelatonBib::BibliographicDate>

Parse document date

Returns:

  • (Array<RelatonBib::BibliographicDate>) —

    document date



138
139
140
141
142
143
144
145
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 138

def parse_date
  @doc.xpath("./xmlns:date").map do |date|
    month = date.at("./xmlns:month").text
    year = date.at("./xmlns:year").text
    on = "#{year}-#{Date::MONTHNAMES.index(month).to_s.rjust(2, '0')}"
    RelatonBib::BibliographicDate.new(on: on, type: "published")
  end
end

#parse_docid ⇒ Array<RelatonBib::DocumentIdettifier>

Parse document identifiers

Returns:

  • (Array<RelatonBib::DocumentIdettifier>) —

    document identifiers



67
68
69
70
71
72
73
74
75
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 67

def parse_docid
  ids = [
    RelatonBib::DocumentIdentifier.new(id: pub_id, type: "IETF", primary: true),
    # RelatonBib::DocumentIdentifier.new(id: anchor, type: "IETF", scope: "anchor"),
  ]
  doi = @doc.at("./xmlns:doi").text
  ids << RelatonBib::DocumentIdentifier.new(id: doi, type: "DOI")
  ids
end

#parse_editorialgroup ⇒ RelatonBib::EditorialGroup

Parse document editorial group

Returns:

  • (RelatonBib::EditorialGroup) —

    document editorial group



246
247
248
249
250
251
252
253
254
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 246

def parse_editorialgroup
  tc = @doc.xpath("./xmlns:wg_acronym").each_with_object([]) do |wg, arr|
    next if wg.text == "NON WORKING GROUP"

    wg = RelatonBib::WorkGroup.new(name: wg.text)
    arr << RelatonBib::TechnicalCommittee.new(wg)
  end
  RelatonBib::EditorialGroup.new(tc) if tc.any?
end

#parse_keyword ⇒ Array<String>

Parse document keywords

Returns:

  • (Array<String>) —

    document keywords



197
198
199
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 197

def parse_keyword
  @doc.xpath("./xmlns:keywords/xmlns:kw").map &:text
end

#parse_link ⇒ Array<RelatonBib::TypedUri>

Create link

Returns:

  • (Array<RelatonBib::TypedUri>) 


128
129
130
131
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 128

def parse_link
  url = "https://www.rfc-editor.org/info/rfc#{docnum}"
  [RelatonBib::TypedUri.new(content: url, type: "src")]
end

#parse_relation ⇒ Arra<RelatonBib::DocumentRelation>

Parse document relations

Returns:

  • (Arra<RelatonBib::DocumentRelation>) —

    document relations



221
222
223
224
225
226
227
228
229
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 221

def parse_relation
  types = { "updates" => "updates", "obsoleted-by" => "obsoletedBy"}
  @doc.xpath("./xmlns:updates/xmlns:doc-id|./xmlns:obsoleted-by/xmlns:doc-id").map do |r|
    fref = RelatonBib::FormattedRef.new(content: r.text)
    docid = RelatonBib::DocumentIdentifier.new type: "IETF", id: r.text, primary: true
    bib = IetfBibliographicItem.new(formattedref: fref, docid: [docid])
    RelatonBib::DocumentRelation.new(type: types[r.parent.name], bibitem: bib)
  end
end

#parse_role(contrib) ⇒ Array<Hash>

Parse contributors role

Parameters:

  • contrib (Nokogiri::XML::Node) —

    contributor

Returns:

  • (Array<Hash>) —

    contributor’s role



171
172
173
174
175
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 171

def parse_role(contrib)
  type = contrib.at("./xmlns:title")&.text&.downcase || "author"
  role = { type: type }
  [role]
end

#parse_series ⇒ Array<RelatonBib::Series>

Parse series

Returns:

  • (Array<RelatonBib::Series>) —

    series



53
54
55
56
57
58
59
60
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 53

def parse_series
  title = RelatonBib::TypedTitleString.new(content: "RFC")
  @doc.xpath("./xmlns:is-also/xmlns:doc-id").map do |s|
    /^(?<name>\D+)(?<num>\d+)/ =~ s.text
    t = RelatonBib::TypedTitleString.new(content: name)
    RelatonBib::Series.new title: t, number: num.gsub(/^0+/, "")
  end + [RelatonBib::Series.new(title: title, number: docnum)]
end

#parse_status ⇒ RelatonBib::DocuemntStatus

Parse document status

Returns:

  • (RelatonBib::DocuemntStatus) —

    document status



236
237
238
239
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 236

def parse_status
  stage = @doc.at("./xmlns:current-status").text
  RelatonBib::DocumentStatus.new(stage: stage)
end

#parse_title ⇒ Array<RelatonBib::TypedTileString>

Parse document title

Returns:

  • (Array<RelatonBib::TypedTileString>) —

    document title



82
83
84
85
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 82

def parse_title
  content = @doc.at("./xmlns:title").text
  [RelatonBib::TypedTitleString.new(content: content, type: "main")]
end

#pub_id ⇒ String

Create PubID

Returns:

  • (String) —

    PubID



92
93
94
 
# File 'lib/relaton_ietf/rfc_entry.rb', line 92

def pub_id
  "RFC #{docnum}"
end