relaton-bib 1.11.1 → 1.11.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2a973e714b86a5a78367ea697af8ba3eaa2861e571e3b035ec6ff411febc121
-  data.tar.gz: dabc25e318c346add35e69e383fa00762c5589e684983d708785a00d48a5d60e
+  metadata.gz: 66d703af6f525fba6b4cd25e054ab2f5f64e0d5040b75430c04296990a6a12ca
+  data.tar.gz: c0c85e99f1e3b511fbc329b9b631349ed63afee1a1779a2147a1756e6dbf0559
 SHA512:
-  metadata.gz: 6690ae53c5056fd830923eb85b5c04f1b652a5bb46c7024ae9f5ecf6f97cebd1d58d57a8069191b349dae9f50a050abdc8eb78375baa7e2f3e23ac1a8ec6290a
-  data.tar.gz: a8fa5e09f9630117c05e3594796f5eb04a8f54c7af344a709a264c8e9be45ce951ec1fc9f25b971193d64e824368babef489c29509bd2356a4c627d8ac384c47
+  metadata.gz: d8f4ef1047ad4d3ab345c3d67079ca66e986b707871f243c11eb8c52ba5792202bf046bbcb1b3722d957d3e882e3ce645b30d9f5a422a8f8ccd2ac38eb7a7d12
+  data.tar.gz: 2974513d8a823bc2efbbfe51e4bc9a88c7e7f77b3aa117e2835b5e13d6b33f366b0c15e7987afcb2dc1b5f5aa9f63d5a45e0df384ffb321132df30d2ed6ebe09

data/.github/workflows/rake.yml

@@ -16,7 +16,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: [ '3.0', '2.7', '2.6', '2.5' ]
+        ruby: [ '3.0', '2.7', '2.6' ]
         os: [ ubuntu-latest, windows-latest, macos-latest ]
         experimental: [ false ]
     steps:
@@ -24,10 +24,6 @@ jobs:
         with:
           submodules: true
 
-      # https://github.com/ruby-debug/debase/issues/89#issuecomment-686827382
-      - if: matrix.os == 'macos-latest' && matrix.ruby == '2.5'
-        run: echo BUNDLE_BUILD__DEBASE="--with-cflags=\"-Wno-error=implicit-function-declaration\"" >> $GITHUB_ENV
-
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}

data/README.adoc

@@ -213,7 +213,11 @@ item = RelatonBib::BibliographicItem.new(
   ),
   place: [
     "bib place",
-    RelatonBib::Place.new(name: "Geneva", uri: "geneva.place", region: "Switzelznd")
+    RelatonBib::Place.new(
+      city: "Geneva",
+      region: [RelatonBib::Place::RegionType.new(name: "Region")],
+      country: [RelatonBib::Place::RegionType.new(name: "Switzeland", iso: "SH", recommended: true)],
+    )
   ],
   extent: [
     RelatonBib::BibItemLocality.new("section", "Reference from", "Reference to"),
@@ -412,6 +416,19 @@ item.to_bibtex
   ...
 ----
 
+=== Export bibliographic item to Citeproc
+
+[source,ruby]
+----
+item.to_citeproc
+=> [{"title"=>"Geographic information",
+  "edition"=>"1",
+  "author"=>[{"family"=>"Bierman", "given"=>"A."}, {"family"=>"Bierman", "given"=>"Forename"}],
+  "publisher"=>"Institute of Electrical and Electronics Engineers",
+  "publisher-place"=>"bib place",
+  ...
+----
+
 === Exporting bibliographic item to AsciiBib
 
 [source,ruby]

data/grammars/biblio.rng

@@ -527,7 +527,7 @@
   </define>
   <define name="LocalityType">
     <data type="string">
-      <param name="pattern">section|clause|part|paragraph|chapter|page|whole|table|annex|figure|note|list|example|volume|issue|time|anchor|locality:[a-zA-Z0-9_]+</param>
+      <param name="pattern">section|clause|part|paragraph|chapter|page|title|line|whole|table|annex|figure|note|list|example|volume|issue|time|anchor|locality:[a-zA-Z0-9_]+</param>
     </data>
   </define>
   <define name="referenceFrom">
@@ -851,17 +851,46 @@
   </define>
   <define name="bplace">
     <element name="place">
-      <optional>
-        <attribute name="uri">
-          <data type="anyURI"/>
-        </attribute>
-      </optional>
-      <optional>
-        <attribute name="region"/>
-      </optional>
+      <choice>
+        <text/>
+        <group>
+          <ref name="bibliocity"/>
+          <zeroOrMore>
+            <ref name="biblioregion"/>
+          </zeroOrMore>
+          <zeroOrMore>
+            <ref name="bibliocountry"/>
+          </zeroOrMore>
+        </group>
+      </choice>
+    </element>
+  </define>
+  <define name="bibliocity">
+    <element name="city">
       <text/>
     </element>
   </define>
+  <define name="biblioregion">
+    <element name="region">
+      <ref name="RegionType"/>
+    </element>
+  </define>
+  <define name="bibliocountry">
+    <element name="country">
+      <ref name="RegionType"/>
+    </element>
+  </define>
+  <define name="RegionType">
+    <optional>
+      <attribute name="iso"/>
+    </optional>
+    <optional>
+      <attribute name="recommended">
+        <data type="boolean"/>
+      </attribute>
+    </optional>
+    <text/>
+  </define>
   <define name="bprice">
     <element name="price">
       <attribute name="currency"/>

data/lib/relaton_bib/bibliographic_item.rb

@@ -401,30 +401,26 @@ module RelatonBib
       hash
     end
 
-    # @param bibtex [BibTeX::Bibliography, NilClass]
+    #
+    # Reander BibTeX
+    #
+    # @param bibtex [BibTeX::Bibliography, nil]
+    #
     # @return [String]
-    def to_bibtex(bibtex = nil) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
-      item = BibTeX::Entry.new
-      item.type = bibtex_type
-      item.key = id
-      bibtex_title item
-      item.edition = edition if edition
-      bibtex_author item
-      bibtex_contributor item
-      item.address = place.first.name if place.any?
-      bibtex_note item
-      bibtex_relation item
-      bibtex_extent item
-      bibtex_date item
-      bibtex_series item
-      bibtex_classification item
-      item.keywords = keyword.map(&:content).join(", ") if keyword.any?
-      bibtex_docidentifier item
-      item.timestamp = fetched.to_s if fetched
-      bibtex_link item
-      bibtex ||= BibTeX::Bibliography.new
-      bibtex << item
-      bibtex.to_s
+    #
+    def to_bibtex(bibtex = nil)
+      bibtext_item(bibtex).to_s
+    end
+
+    #
+    # Render citeproc
+    #
+    # @param bibtex [BibTeX::Bibliography, nil]
+    #
+    # @return [Hash] citeproc
+    #
+    def to_citeproc(bibtex = nil)
+      bibtext_item(bibtex).to_citeproc.map { |cp| cp.transform_keys(&:to_s) }
     end
 
     # @param lang [String, nil] language code Iso639
@@ -555,13 +551,35 @@ module RelatonBib
 
     private
 
-    # @return [String]
-    def bibtex_title(item)
-      title.each do |t|
-        case t.type
-        when "main" then item.tile = t.title.content
-        end
-      end
+    #
+    # Create BibTeX item for this document
+    #
+    # @param [BibTeX::Bibliography, nil] bibtex <description>
+    #
+    # @return [BibTeX::Bibliography] BibTeX bibliography
+    #
+    def bibtext_item(bibtex) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+      item = BibTeX::Entry.new
+      item.type = bibtex_type
+      item.key = id
+      title.to_bibtex item
+      item.edition = edition if edition
+      bibtex_author item
+      bibtex_contributor item
+      item.address = place.first.name if place.any?
+      bibtex_note item
+      bibtex_relation item
+      bibtex_extent item
+      bibtex_date item
+      bibtex_series item
+      bibtex_classification item
+      item.keywords = keyword.map(&:content).join(", ") if keyword.any?
+      bibtex_docidentifier item
+      item.timestamp = fetched.to_s if fetched
+      bibtex_link item
+      bibtex ||= BibTeX::Bibliography.new
+      bibtex << item
+      bibtex
     end
 
     # @return [String]

data/lib/relaton_bib/place.rb

@@ -1,49 +1,141 @@
 module RelatonBib
   class Place
-    # @return [String]
-    attr_reader :name
-
-    # @return [String, NilClass]
-    attr_reader :uri, :region
-
-    # @param name [String]
-    # @param uri [String, NilClass]
-    # @param region [String, NilClass]
-    def initialize(name:, uri: nil, region: nil)
-      @name   = name
-      @uri    = uri
-      @region = region
+    # @return [String, nil]
+    attr_reader :name, :city
+
+    # @return [Array<RelatonBib::Place::RegionType>]
+    attr_reader :region, :country
+
+    #
+    # Initialize place.
+    #
+    # @param name [String, nil] name of place, name or city should be provided
+    # @param city [String, nil] name of city, city or name should be provided
+    # @param region [Array<RelatonBib::Place::RegionType>] region of place
+    # @param country [Array<RelatonBib::Place::RegionType>] country of place
+    #
+    def initialize(name: nil, city: nil, region: [], country: []) # rubocop:disable Metrics/CyclomaticComplexity
+      if name.nil? && city.nil?
+        raise ArgumentError, "`name` or `city` should be provided"
+      end
+
+      @name    = name
+      @city    = city
+      @region  = region.map { |r| r.is_a?(Hash) ? RegionType.new(**r) : r }
+      @country = country.map { |c| c.is_a?(Hash) ? RegionType.new(**c) : c }
     end
 
+    #
+    # Render place as XML.
+    #
     # @param builder [Nologiri::XML::Builder]
+    #
     def to_xml(builder)
-      xml = builder.place name
-      xml[:uri] = uri if uri
-      xml[:region] = region if region
+      if name
+        builder.place name
+      else
+        builder.place do |b|
+          b.city city
+          region.each { |r| b.region { r.to_xml b } }
+          country.each { |c| b.country { c.to_xml b } }
+        end
+      end
     end
 
+    #
+    # Render place as Hash.
+    #
     # @return [Hash]
+    #
     def to_hash
-      if uri || region
-        hash = { "name" => name }
-        hash["uri"] = uri if uri
-        hash["region"] = region if region
-        hash
+      if name then name
       else
-        name
+        hash = { "city" => city }
+        hash["region"] = region.map(&:to_hash) if region.any?
+        hash["country"] = country.map(&:to_hash) if country.any?
+        hash
       end
     end
 
+    #
+    # Render place as AsciiBib.
+    #
     # @param prefix [String]
     # @param count [Integer] number of places
+    #
     # @return [Stirng]
-    def to_asciibib(prefix = "", count = 1)
-      pref = prefix.empty? ? "place" : prefix + ".place"
+    #
+    def to_asciibib(prefix = "", count = 1) # rubocop:disable Metrics/AbcSize
+      pref = prefix.empty? ? "place" : "#{prefix}.place"
       out = count > 1 ? "#{pref}::\n" : ""
-      out += "#{pref}.name:: #{name}\n"
-      out += "#{pref}.uri:: #{uri}\n" if uri
-      out += "#{pref}.region:: #{region}\n" if region
-      out
+      return "#{out}#{pref}.name:: #{name}\n" if name
+
+      out += "#{pref}.city:: #{city}\n"
+      out += region.map { |r| r.to_asciibib("#{pref}.region", region.size) }.join
+      out + country.map { |c| c.to_asciibib("#{pref}.country", country.size) }.join
+    end
+
+    class RegionType
+      # @return [Strign] name of region
+      attr_reader :name
+
+      # @return [Strign, nil] ISO code of region
+      attr_reader :iso
+
+      # @return [Boolean, nil] <description>
+      attr_reader :recommended
+
+      #
+      # Initialize region type.
+      #
+      # @param [String] name name of region
+      # @param [String, nil] iso ISO code of region
+      # @param [Boolean, nil] recommended recommended region
+      #
+      def initialize(name:, iso: nil, recommended: nil)
+        @name = name
+        @iso  = iso
+        @recommended = recommended
+      end
+
+      #
+      # Render region type as XML.
+      #
+      # @param [Nokogiri::XML::Builder] builder XML builder
+      #
+      def to_xml(builder)
+        builder.parent["iso"] = iso if iso
+        builder.parent["recommended"] = recommended.to_s unless recommended.nil?
+        builder.text name
+      end
+
+      #
+      # Render region type as Hash.
+      #
+      # @return [Hash] region type as Hash
+      #
+      def to_hash
+        hash = { "name" => name }
+        hash["iso"] = iso if iso
+        hash["recommended"] = recommended unless recommended.nil?
+        hash
+      end
+
+      #
+      # Render region type as AsciiBib.
+      #
+      # @param [String] pref prefix
+      # @param [Integer] count number of region types
+      #
+      # @return [String] region type as AsciiBib
+      #
+      def to_asciibib(pref, count = 1) # rubocop:disable Metrics/AbcSize
+        out = count > 1 ? "#{pref}::\n" : ""
+        out += "#{pref}.name:: #{name}\n"
+        out += "#{pref}.iso:: #{iso}\n" if iso
+        out += "#{pref}.recommended:: #{recommended}\n" if recommended
+        out
+      end
     end
   end
 end

data/lib/relaton_bib/typed_title_string.rb

@@ -62,6 +62,18 @@ module RelatonBib
       tl.each { |t| opts[:builder].title { t.to_xml opts[:builder] } }
     end
 
+    #
+    # Add main title ot bibtex entry
+    #
+    # @param [BibTeX::Entry] item bibtex entry
+    #
+    def to_bibtex(item)
+      tl = titles.detect { |t| t.type == "main" }
+      return unless tl
+
+      item.title = tl.title.content
+    end
+
     private
 
     # @param lang [String]

data/lib/relaton_bib/version.rb

@@ -1,3 +1,3 @@
 module RelatonBib
-  VERSION = "1.11.1".freeze
+  VERSION = "1.11.4".freeze
 end

data/lib/relaton_bib/xml_parser.rb

@@ -72,7 +72,26 @@ module RelatonBib
 
       def fetch_place(item)
         item.xpath("./place").map do |pl|
-          Place.new(name: pl.text, uri: pl[:uri], region: pl[:region])
+          if (city = pl.at("./city"))
+            Place.new(city: city.text, region: create_region_country(pl),
+                      country: create_region_country(pl, "country"))
+          else
+            Place.new(name: pl.text)
+          end
+        end
+      end
+
+      #
+      # Create region or country from place element
+      #
+      # @param [Nokogiri::XML::Element] place place element
+      # @param [String] node name of the node to parse
+      #
+      # @return [Array<RelatonBib::Place::RegionType>] <description>
+      #
+      def create_region_country(place, node = "region")
+        place.xpath("./#{node}").map do |r|
+          Place::RegionType.new(name: r.text, iso: r[:iso], recommended: r[:recommended])
         end
       end
 

data/relaton-bib.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |spec|
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.5.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.6.0")
 
   spec.add_development_dependency "byebug"
   spec.add_development_dependency "equivalent-xml", "~> 0.6"
@@ -36,5 +36,5 @@ Gem::Specification.new do |spec|
   spec.add_dependency "addressable"
   spec.add_dependency "bibtex-ruby"
   spec.add_dependency "iso639"
-  spec.add_dependency "nokogiri", "~> 1.12.5"
+  spec.add_dependency "nokogiri", "~> 1.13.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relaton-bib
 version: !ruby/object:Gem::Version
-  version: 1.11.1
+  version: 1.11.4
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-04-11 00:00:00.000000000 Z
+date: 2022-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug
@@ -184,14 +184,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.12.5
+        version: 1.13.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.12.5
+        version: 1.13.0
 description: 'RelatonBib: Ruby XMLDOC impementation.'
 email:
 - open.source@ribose.com
@@ -270,7 +270,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 2.6.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="