scripref 0.15.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9424ceb062e9f3a2aa526c65f567b0bcf701c50fef3179f62e3ebe379cbae657
-  data.tar.gz: 6743fc2a2e22cadc78ab32a58ae0886e9f99d72ae8e53c1902130b81b72f3cbf
+  metadata.gz: e62a77dfe3ad29cd0a26f5321ca555364a9031e7f366509b6de98d2537fc3894
+  data.tar.gz: 2cea8d7e4c6bb09c74509f0a95a656e5d9bc4b5079fe8a47e24697c51804c1c2
 SHA512:
-  metadata.gz: 6213a3eafeacb7f56ae929f7d09b083e9eaffd92b09115492cebfd2b343761dac77899d2e2d2394a4e84c72a82ae60abf84811eee5f32a5fdfcfa1a068089265
-  data.tar.gz: 820bb49d040ca7b05c9a6367f6f30b0aeb09737362a3303ce498c306b98ac4015e6e7e25817666a33cefd674a21d8d4522cb74816a20942c00df8a699d5548bb
+  metadata.gz: e5ea83b84641277e5e01d04dc31e0381d66f547ef44117692713d23db8f880ee674db96458be0709776029be7b99ec913859675ba289096eed3689d11bdb352b
+  data.tar.gz: cde42713e59b183d3c605fe2cee0ce0667802b90dd79a115f538480053bb1b71eda0ba554c64b9772c58536dfd4ce2eb11b1e778e08877a556cba38e2afe73d7

data/.aspell.pws

@@ -1,5 +1,7 @@
-personal_ws-1.1 en 21 
+personal_ws-1.1 en 23 
 Bookname
+Bookorder
+OSIS
 ParserError
 PassSep
 Philipper

data/Changelog

@@ -1,3 +1,9 @@
+1.0.0
+Major release with following two incompatible changes:
+Use OSIS abbreviations for books.
+Remove Passage#+ and Passage#-. This methods seems not to be so useful.
+Further a new module Bookorder is introduced.
+
 0.15.0
 Add some more abbreviations for German book names.
 

data/lib/scripref.rb

@@ -1,11 +1,14 @@
-# - encoding: utf-8 -
+# encoding: utf-8
+# frozen_string_literal: true
+
 require 'delegate'
 
 module Scripref
 
-  VERSION = '0.15.0'
+  VERSION = '1.0.0'
 
   autoload :Bookname, 'scripref/bookname'
+  autoload :Bookorder, 'scripref/bookorder'
   autoload :English, 'scripref/english'
   autoload :Formatter, 'scripref/formatter'
   autoload :German, 'scripref/german'

data/lib/scripref/basic_methods.rb

@@ -1,4 +1,6 @@
-# - encoding: utf-8 -
+# encoding: utf-8
+# frozen_string_literal: false
+
 module Scripref
 
   # Mixin with methods of basic functionality

data/lib/scripref/bookname.rb

@@ -1,12 +1,14 @@
-# - encoding: utf-8 -
+# encoding: utf-8
+# frozen_string_literal: true
 
 module Scripref
 
   class Bookname
 
-    attr_reader :names, :abbrevs
+    attr_reader :osis_id, :names, :abbrevs
 
-    def initialize names, abbrevs
+    def initialize osis_id:, names:, abbrevs:
+      @osis_id = osis_id
       @names = Array(names)
       @abbrevs = Array(abbrevs)
     end
@@ -20,7 +22,7 @@ module Scripref
     end
 
     def to_s
-      @names.first
+      @osis_id
     end
 
     alias to_str to_s

data/lib/scripref/bookorder.rb

@@ -0,0 +1,20 @@
+# encoding: utf-8
+# frozen_string_literal: true
+
+module Scripref
+
+  # Constants of different orderings of bible books using standardized IDs
+  # (see https://wiki.crosswire.org/OSIS_Book_Abbreviations)
+  module Bookorder
+
+    # Canonical order (the default order without any apocryphal books)
+    CANONICAL = %i[
+      Gen Exod Lev Num Deut Josh Judg Ruth 1Sam 2Sam 1Kgs 2Kgs 1Chr 2Chr Ezra
+      Neh Esth Job Ps Prov Eccl Song Isa Jer Lam Ezek Dan Hos Joel Amos Obad
+      Jonah Mic Nah Hab Zeph Hag Zech Mal Matt Mark Luke John Acts Rom 1Cor
+      2Cor Gal Eph Phil Col 1Thess 2Thess 1Tim 2Tim Titus Phlm Heb Jas 1Pet
+      2Pet 1John 2John 3John Jude Rev
+    ]
+  end
+
+end

data/lib/scripref/const_reader.rb

@@ -1,4 +1,5 @@
-# - encoding: utf-8 -
+# encoding: utf-8
+# frozen_string_literal: false
 
 # Mixin to generate instance methods to access of mixin constants.
 #

data/lib/scripref/english.rb

@@ -1,5 +1,6 @@
-# - encoding: utf-8 -
-require 'scripref/bookname'
+# encoding: utf-8
+# frozen_string_literal: true
+
 require 'scripref/const_reader'
 
 module Scripref
@@ -31,7 +32,10 @@ module Scripref
     END
 
     # Array of book names.
-    BOOK_NAMES = book_names.zip(book_abbrevs).map {|name, abbrev| Bookname.new(name, abbrev)}
+    BOOK_NAMES = Bookorder::CANONICAL.zip(book_names, book_abbrevs).map {|osis_book_id, names, abbrevs| Bookname.new(osis_id: osis_book_id, names: names, abbrevs: abbrevs)}
+
+    # Map of OSIS book ID to instance of Bookname
+    OSIS_BOOK_ID_TO_BOOK_NAME = Bookorder::CANONICAL.zip(BOOK_NAMES).map {|id, n| [id, n]}.to_h
 
     # Separator between chapter and verse.
     CV_SEPARATOR = ':'
@@ -73,9 +77,9 @@ module Scripref
     POSTFIX_MORE_FOLLOWING_VERSES_RE = /ff\b\s*/o
 
     # Check if book has only one chapter
-    # @param book book as number
-    def book_has_only_one_chapter? book
-      [31, 57, 63, 64, 65].include?(book)
+    # @param osis_id OSIS-ID of the book
+    def book_has_only_one_chapter? osis_id
+      %i[Obad Phlm 2John 3John Jude].include?(osis_id)
     end
 
     # Regular expression to match punctuation marks

data/lib/scripref/formatter.rb

@@ -1,4 +1,5 @@
-# - encoding: utf-8 -
+# encoding: utf-8
+# frozen_string_literal: true
 
 module Scripref
 
@@ -27,9 +28,9 @@ module Scripref
     end
 
     # Formats a book
-    # @param num number of book (starting at 1)
-    def format_book num
-      book_names[num - 1].send @bookformat
+    # @param osis_book_id OSIS-ID for book
+    def format_book osis_book_id
+      osis_book_id_to_book_name[osis_book_id].send @bookformat
     end
 
     # Formats a chapter

data/lib/scripref/german.rb

@@ -1,5 +1,6 @@
-# - encoding: utf-8 -
-require 'scripref/bookname'
+# encoding: utf-8
+# frozen_string_literal: true
+
 require 'scripref/const_reader'
 
 module Scripref
@@ -31,7 +32,10 @@ module Scripref
     END
 
     # Array of book names.
-    BOOK_NAMES = book_names.zip(book_abbrevs).map {|name, abbrev| Bookname.new(name, abbrev)}
+    BOOK_NAMES = Bookorder::CANONICAL.zip(book_names, book_abbrevs).map {|osis_book_id, names, abbrevs| Bookname.new(osis_id: osis_book_id, names: names, abbrevs: abbrevs)}
+
+    # Map of OSIS book ID to instance of Bookname
+    OSIS_BOOK_ID_TO_BOOK_NAME = Bookorder::CANONICAL.zip(BOOK_NAMES).map {|id, n| [id, n]}.to_h
 
     # Separator between chapter and verse.
     CV_SEPARATOR = ','
@@ -73,9 +77,9 @@ module Scripref
     POSTFIX_MORE_FOLLOWING_VERSES_RE = /ff\b\s*/o
 
     # Check if book has only one chapter
-    # @param book book as number
-    def book_has_only_one_chapter? book
-      [31, 57, 63, 64, 65].include?(book)
+    # @param osis_id OSIS-ID of the book
+    def book_has_only_one_chapter? osis_id
+      %i[Obad Phlm 2John 3John Jude].include?(osis_id)
     end
 
     # Regular expression to match punctuation marks

data/lib/scripref/include.rb

@@ -1,4 +1,6 @@
-# - encoding: utf-8 -
+# encoding: utf-8
+# frozen_string_literal: true
+
 require 'scripref'
 
 include Scripref

data/lib/scripref/parser.rb

@@ -1,4 +1,6 @@
-# - encoding: utf-8 -
+# encoding: utf-8
+# frozen_string_literal: false
+
 require 'scripref/basic_methods'
 require 'strscan'
 
@@ -35,7 +37,7 @@ module Scripref
     def b1
       s = scan(book_re) or return nil
       @text << s
-      @b1 = @b2 = abbrev2num(s)
+      @b1 = @b2 = abbrev2osis_book_id(s)
       @c1 = @v1 = @c2 = @v2 = nil
 
       if pass_sep
@@ -108,7 +110,7 @@ module Scripref
     def b2
       s = scan(book_re) or return nil
       @text << s
-      @b2 = abbrev2num(s)
+      @b2 = abbrev2osis_book_id(s)
       @c2 = @v2 = nil
 
       if pass_sep
@@ -237,10 +239,10 @@ module Scripref
       @a1 = @a2 = nil
     end
 
-    def abbrev2num str
+    def abbrev2osis_book_id str
       s = str.strip
       s.sub! /\.$/, ''
-      str2book_num(s) or str2book_num(abbrev2book(s))
+      str2osis_book_id(s) or str2osis_book_id(abbrev2book(s))
     end
 
     def abbrev2book str
@@ -250,7 +252,7 @@ module Scripref
       pattern = s.chars.map {|c| Regexp.escape(c) << '[^#]*'}.join
       re = /(?<=#)#{pattern}(?=#)/
       names = @books_str.scan(re)
-      uniq_numbers = names.map {|n| str2book_num(n)}.uniq
+      uniq_numbers = names.map {|n| str2osis_book_id(n)}.uniq
       if uniq_numbers.size != 1
         unscan
         give_up format("Abbreviation %s is ambiguous it matches %s!", s, names.join(', '))
@@ -258,23 +260,23 @@ module Scripref
       names.first
     end
 
-    def init_str2book_num
-      unless @str2book_num
-        @str2book_num = {}
-        book_names.each_with_index do |bn, i|
+    def init_str2osis_book_id
+      unless @str2osis_book_id
+        @str2osis_book_id = {}
+        book_names.each do |bn|
           bn.names.each do |n|
-            @str2book_num[n] = i+1
+            @str2osis_book_id[n] = bn.osis_id
           end
           bn.abbrevs.each do |n|
-            @str2book_num[n] = i+1
+            @str2osis_book_id[n] = bn.osis_id
           end
         end
       end
     end
 
-    def str2book_num str
-      init_str2book_num
-      @str2book_num[str]
+    def str2osis_book_id str
+      init_str2osis_book_id
+      @str2osis_book_id[str]
     end
 
     def inspect

data/lib/scripref/passage.rb

@@ -1,66 +1,27 @@
-# - encoding: utf-8 -
+# encoding: utf-8
+# frozen_string_literal: true
+
 module Scripref
 
   Passage = Struct.new(:text, :b1, :c1, :v1, :b2, :c2, :v2, :a1, :a2, keyword_init: true) do
 
     include Comparable
 
-    def + other
-      to_a.zip(other.to_a).map {|a, b| a + b}
-    end
-
-    def - other
-      to_a.zip(other.to_a).map {|a, b| b - a}
-    end
-
     def to_a
       [b1, c1, v1, b2, c2, v2]
     end
 
     def <=> other
       return unless other.kind_of? Passage
-      self.make_comparable.to_a <=> other.make_comparable.to_a
-    end
-
-    # Returns a copy which is comparable, that means
-    # all values are numeric.
-    # This is a heuristic approach.
-    def make_comparable max: 999, ff: 3
-      self.dup.make_comparable! max: max, ff: ff
-    end
-
-    # Makes the Passage instance comparable, that means
-    # all values are numeric.
-    # This is a heuristic approach.
-    def make_comparable! max: 999, ff: 3
-      self.b1 ||= 1
-      self.c1 ||= 1
-      self.v1 ||= 1
-      self.b2 ||= max
-      self.c2 ||= max
-      self.v2 ||= max
-      if self.v2 == :f
-        self.v2 = self.v1 + 1
-      end
-      if self.v2 == :ff
-        self.v2 = self.v1 + ff
-      end
-      self
-    end
-
-    # Checks if the instance is comparable, that means
-    # all values are numeric and so the <=> method
-    # can be applied.
-    def comparable?
-      to_a.map {|e| Numeric === e}.uniq == [true]
+      self.to_numeric_array <=> other.to_numeric_array
     end
 
     # Returns true if the instance and the given passage overlap.
     # That means both has at least one verse in common.
     def overlap? passage
       fail ArgumentError, 'value must be a passage' unless passage.kind_of? Passage
-      a = self.make_comparable.to_a
-      b = passage.make_comparable.to_a
+      a = self.to_numeric_array
+      b = passage.to_numeric_array
       [a[0..2] <=> b[3..5], b[0..2] <=> a[3..5]].max < 1
     end
 
@@ -74,7 +35,40 @@ module Scripref
       [b2, c2, v2]
     end
 
+    def to_numeric_array max: 999, ff: 3
+      _b1 = Passage.book_id2num[b1]
+      _c1 = c1 || 1
+      _v1 = v1 || 1
+      _b2 = Passage.book_id2num[b2]
+      _c2 = c2 || max
+      _v2 = v2 || max
+      if _v2 == :f
+        _v2 = _v1 + 1
+      end
+      if _v2 == :ff
+        _v2 = _v1 + ff
+      end
+      [_b1, _c1, _v1, _b2, _c2, _v2]
+    end
+
     alias to_s text
+
+    @book_id2num = {}
+    osis_book_ids = %i[
+      Gen Exod Lev Num Deut Josh Judg Ruth 1Sam 2Sam 1Kgs 2Kgs 1Chr 2Chr Ezra
+      Neh Esth Job Ps Prov Eccl Song Isa Jer Lam Ezek Dan Hos Joel Amos Obad
+      Jonah Mic Nah Hab Zeph Hag Zech Mal Matt Mark Luke John Acts Rom 1Cor
+      2Cor Gal Eph Phil Col 1Thess 2Thess 1Tim 2Tim Titus Phlm Heb Jas 1Pet
+      2Pet 1John 2John 3John Jude Rev
+    ]
+    osis_book_ids.each_with_index do |book_id, i|
+      @book_id2num[book_id] = i+1
+    end
+
+    class << self
+      attr_reader :book_id2num
+    end
+
   end
 
 end

data/lib/scripref/pipelining.rb

@@ -1,4 +1,5 @@
-# - encoding: utf-8 -
+# encoding: utf-8
+# frozen_string_literal: true
 
 module Scripref
 

data/lib/scripref/processor.rb

@@ -1,7 +1,8 @@
-# - encoding: utf-8 -
+# encoding: utf-8
+# frozen_string_literal: true
+
 require 'strscan'
 require 'scripref/basic_methods'
-require 'scripref/parser'
 
 module Scripref
 

data/scripref.gemspec

@@ -1,5 +1,5 @@
 # -*- encoding: utf-8 -*-
-# stub: scripref 0.15.0 ruby lib
+# stub: scripref 1.0.0 ruby lib
 #
 # This file is automatically generated by rim.
 # PLEASE DO NOT EDIT IT DIRECTLY!
@@ -7,7 +7,7 @@
 
 Gem::Specification.new do |s|
   s.name = "scripref"
-  s.version = "0.15.0"
+  s.version = "1.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib"]
@@ -15,7 +15,7 @@ Gem::Specification.new do |s|
   s.date = "2020-05-22"
   s.description = ""
   s.email = "janfri26@gmail.com"
-  s.files = ["./.aspell.pws", "Changelog", "LICENSE", "README.md", "Rakefile", "lib/scripref", "lib/scripref.rb", "lib/scripref/basic_methods.rb", "lib/scripref/bookname.rb", "lib/scripref/const_reader.rb", "lib/scripref/english.rb", "lib/scripref/formatter.rb", "lib/scripref/german.rb", "lib/scripref/include.rb", "lib/scripref/parser.rb", "lib/scripref/passage.rb", "lib/scripref/pipelining.rb", "lib/scripref/processor.rb", "regtest/formatter.rb", "regtest/formatter.yml", "regtest/parser.rb", "regtest/parser.yml", "regtest/processor.rb", "regtest/processor.yml", "scripref.gemspec", "test/test_bookname.rb", "test/test_english.rb", "test/test_formatter.rb", "test/test_german.rb", "test/test_helper.rb", "test/test_integration.rb", "test/test_parser.rb", "test/test_passage.rb", "test/test_pipelining.rb", "test/test_processor.rb"]
+  s.files = ["./.aspell.pws", "Changelog", "LICENSE", "README.md", "Rakefile", "lib/scripref", "lib/scripref.rb", "lib/scripref/basic_methods.rb", "lib/scripref/bookname.rb", "lib/scripref/bookorder.rb", "lib/scripref/const_reader.rb", "lib/scripref/english.rb", "lib/scripref/formatter.rb", "lib/scripref/german.rb", "lib/scripref/include.rb", "lib/scripref/parser.rb", "lib/scripref/passage.rb", "lib/scripref/pipelining.rb", "lib/scripref/processor.rb", "regtest/formatter.rb", "regtest/formatter.yml", "regtest/parser.rb", "regtest/parser.yml", "regtest/processor.rb", "regtest/processor.yml", "scripref.gemspec", "test/test_bookname.rb", "test/test_english.rb", "test/test_formatter.rb", "test/test_german.rb", "test/test_helper.rb", "test/test_integration.rb", "test/test_parser.rb", "test/test_passage.rb", "test/test_pipelining.rb", "test/test_processor.rb"]
   s.homepage = "https://github.com/janfri/scripref"
   s.required_ruby_version = Gem::Requirement.new(">= 2.5.0")
   s.rubygems_version = "3.1.2"