Module: Iev

Defined in:
lib/iev/cli.rb,
lib/iev.rb,
lib/iev/cli/ui.rb,
lib/iev/config.rb,
lib/iev/scraper.rb,
lib/iev/section.rb,
lib/iev/version.rb,
lib/iev/exporter.rb,
lib/iev/iev_code.rb,
lib/iev/profiler.rb,
lib/iev/converter.rb,
lib/iev/db_writer.rb,
lib/iev/utilities.rb,
lib/iev/relaton_db.rb,
lib/iev/cli/command.rb,
lib/iev/data_source.rb,
lib/iev/iso_639_code.rb,
lib/iev/subject_area.rb,
lib/iev/term_builder.rb,
lib/iev/source_parser.rb,
lib/iev/subject_areas.rb,
lib/iev/figure_builder.rb,
lib/iev/scraper/browser.rb,
lib/iev/data_conversions.rb,
lib/iev/term_attrs_parser.rb,
lib/iev/cli/command_helper.rb,
lib/iev/scraper/page_parser.rb,
lib/iev/supersession_parser.rb,
lib/iev/bibliography_builder.rb,
lib/iev/subject_area_concepts.rb,
lib/iev/converter/mathml_to_asciimath.rb

Overview

© Copyright 2020 Ribose Inc.

Defined Under Namespace

Modules: BibliographyBuilder, Cli, Converter, DataConversions, DataSource, FigureBuilder, SubjectAreaConcepts, SubjectAreas, Utilities Classes: Config, DbWriter, Exporter, IevCode, Iso639Code, Profiler, RelatonDb, Scraper, Section, SourceParser, SubjectArea, SupersessionParser, TermAttrsParser, TermBuilder

Constant Summary collapse

IEV_SOURCE =

IEV dataset URN — single source of truth for all concept references.

"urn:iec:std:iec:60050"
VERSION = 
"0.4.7"

Class Method Summary collapse

Class Method Details

.area_for_section(section_code) ⇒ SubjectArea?

Return the parent subject area for a given section code.

Parameters:

  • section_code (String) —

    e.g. “102-01”

Returns:



143
144
145
 
# File 'lib/iev.rb', line 143

def self.area_for_section(section_code)
  SubjectAreas.area_for_section(section_code)
end

.config ⇒ Config

Returns:



51
52
53
 
# File 'lib/iev.rb', line 51

def self.config
  @config ||= Config.new
end

.configure {|Config| ... } ⇒ Object

Yield the config object for initialization.

Yields:



57
58
59
 
# File 'lib/iev.rb', line 57

def self.configure
  yield(config) if block_given?
end

.fetch_concept(code) ⇒ Hash

Fetch full concept data (all languages) for a given IEV code.

Parameters:

  • code (String) —

    IEV code, e.g. “103-01-02”

Returns:

  • (Hash) —

    concept data hash with all languages

Raises:



86
87
88
 
# File 'lib/iev.rb', line 86

def self.fetch_concept(code)
  DataSource.fetch_concept(code)
end

.fetch_term(code, lang) ⇒ Hash?

Fetch localized term data for a given IEV code and language.

Parameters:

  • code (String) —

    IEV code, e.g. “103-01-02”

  • lang (String) —

    language code, e.g. “en” or “eng”

Returns:

  • (Hash, nil) —

    localized concept data or nil if not found

Raises:



96
97
98
 
# File 'lib/iev.rb', line 96

def self.fetch_term(code, lang)
  DataSource.fetch_term(code, lang)
end

.find_section(section_code) ⇒ Section?

Find a section by its section code.

Parameters:

  • section_code (String) —

    e.g. “102-01”

Returns:



129
130
131
 
# File 'lib/iev.rb', line 129

def self.find_section(section_code)
  SubjectAreas.find_section(section_code)
end

.find_subject_area(code) ⇒ SubjectArea?

Find a subject area by code.

Parameters:

  • code (String, Integer) —

    e.g. “102”

Returns:



122
123
124
 
# File 'lib/iev.rb', line 122

def self.find_subject_area(code)
  SubjectAreas.find_area(code)
end

.get(code, lang) ⇒ String?

Fetch term designation from IEV data.

Parameters:

  • code (String) —

    for example “103-01-02”

  • lang (String) —

    language code, for example “en”

Returns:

  • (String, nil) —

    if found then term, if code or language not found then nil.



75
76
77
78
79
 
# File 'lib/iev.rb', line 75

def self.get(code, lang)
  DataSource.fetch_term_designation(code, lang)
rescue DataSource::NotFoundError
  nil
end

.parse_code(code) ⇒ IevCode?

Parse an IEV code into its structural components.

Parameters:

  • code (String) —

    e.g. “103-01-02”

Returns:

  • (IevCode, nil) —

    nil if the code is blank



150
151
152
 
# File 'lib/iev.rb', line 150

def self.parse_code(code)
  IevCode.parse(code)
end

.reset_config! ⇒ Object

Reset config (useful in tests).



62
63
64
 
# File 'lib/iev.rb', line 62

def self.reset_config!
  @config = nil
end

.scrape_concept(code) ⇒ Hash?

Scrape concept data from Electropedia for a given IEV code. Uses Ferrum (headless Chrome) to handle AWS WAF challenge.

Parameters:

  • code (String) —

    IEV code, e.g. “103-01-02”

Returns:

  • (Hash, nil) —

    concept data hash or nil if not found



107
108
109
 
# File 'lib/iev.rb', line 107

def self.scrape_concept(code)
  Scraper.new.fetch_concept(code)
end

.sections_for(code) ⇒ Array<Section>

Return sections for a given area code.

Parameters:

  • code (String, Integer) —

    e.g. “102”

Returns:



136
137
138
 
# File 'lib/iev.rb', line 136

def self.sections_for(code)
  SubjectAreas.sections_for(code)
end

.subject_areas ⇒ Array<SubjectArea>

Return all IEV subject areas with their sections (from bundled data).

Returns:



115
116
117
 
# File 'lib/iev.rb', line 115

def self.subject_areas
  SubjectAreas.all
end