bible_ref 1.2.0 → 1.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5d54495720e89fd21d2971e70edd654e335803b5d5041b10cfaf9d236355f8e
-  data.tar.gz: 32eb420422295190f04503a39f66185500b34f88d6069408d59811e3636f568f
+  metadata.gz: 8ff84390f97873c222f3b4f3de5cc4eddecf4248e96fd4969dfcee397989687f
+  data.tar.gz: 27188298c69c82dc025d680c2725b71d3169e90aca47d64ad94322221aa01121
 SHA512:
-  metadata.gz: bcea0883f760b833857c5dbd05885cb9f653bd85961591a6e3dfc6c2099bfc98da23170326674b274796b71d3e92991fb2a8ba0c8c3a9433073002c8fdba8539
-  data.tar.gz: '094e075be4d9d87cac62e873b0e522a6daa171e4116195ebad6cff3927cc3dab5d6348ce6c6fb1fe9332820367683c00af555dfe1e34782222eaf23bbf352864'
+  metadata.gz: e30d34f9878276275e136e974b114ecf2365e21be79821d3513a278e9094fa134a2ef80743dc07a1daa572b9c48f402a13def18966abf54bdfb902523a4697df
+  data.tar.gz: 4e2bf7bfe56773162e8618d7f189284b283b3c15e4b0b56092390a0df4b6c5accf5efe8ee6272aa136d5766198aee98c5943a1c8d1df792780a7964e5ef7816c

data/README.md

@@ -53,6 +53,11 @@ verses = ranges.map do |from_ref, to_ref|
 end
 ```
 
+## Note
+
+When searching a book that contains a single chapter (ie. Obadiah, Philemon, Jude, 2 John, 3 John), you can use either Jude 1 or Jude 1:1 to retrieve verse 1.
+This is quite different from searching a book with multiple chapters.  **John 1** will return all of chapter 1, where as **Jude 1** only returns the first verse.
+
 ## Copyright
 
 Copyright [Tim Morgan](http://timmorgan.org). Licensed MIT.

data/lib/bible_ref/canons/all.rb

@@ -0,0 +1,15 @@
+module BibleRef
+  module Canons
+    class All
+      def books
+        %w(
+          GEN EXO LEV NUM DEU JOS JDG RUT 1SA 2SA 1KI 2KI 1CH 2CH EZR NEH EST JOB
+          PSA PRO ECC SNG ISA JER LAM EZK DAN HOS JOL AMO OBA JON MIC NAM HAB ZEP HAG
+          ZEC MAL TOB JDT ESG WIS SIR BAR LJE S3Y SUS BEL 1MA 2MA 1ES MAN PS2 3MA 2ES
+          4MA MAT MRK LUK JHN ACT ROM 1CO 2CO GAL EPH PHP COL 1TH 2TH 1TI 2TI TIT PHM
+          HEB JAS 1PE 2PE 1JN 2JN 3JN JUD REV
+        )
+      end
+    end
+  end
+end

data/lib/bible_ref/canons.rb

@@ -1,7 +1,8 @@
 require_relative 'canons/protestant'
-
+require_relative 'canons/all'
 module BibleRef
   CANONS = {
-    'protestant' => Canons::Protestant
+    'protestant' => Canons::Protestant,
+    'all' => Canons::All
   }
 end

data/lib/bible_ref/languages/base.rb

@@ -5,6 +5,11 @@ module BibleRef
         fail NotImplementedError, "You must override #books in your language class."
       end
 
+      # Is it a single chapter book?
+      def has_single_chapter?(reference)
+        fail NotImplementedError, "You must override #has_single_chapter? in your language class."
+      end
+
       def book_id(book_name, canon)
         book_name = replace_roman_numerals(book_name)
         return book_name.upcase if books[book_name.upcase] # already normalized

data/lib/bible_ref/languages/cherokee.rb

@@ -4,6 +4,13 @@ require_relative 'base'
 module BibleRef
   module Languages
     class Cherokee < Base
+
+      # Is it a single chapter book?
+      def has_single_chapter?(reference)
+          matches = ['ᏉᎳ ᏆᎵᎹᏂ ᎤᏬᏪᎳᏁᎸᎯ', 'ᏣᏂ ᏔᎵᏁ ᎤᏬᏪᎳᏅᎯ', 'ᏣᏂ ᏦᎢᏁ ᎤᏬᏪᎳᏅᎯ', 'ᏧᏓᏏ ᎤᏬᏪᎳᏅᎯ']
+          return matches.any? { |e| reference.include?(e)  }
+      end
+
       def books
         {
           'MAT' => { name: 'ᎣᏍᏛ ᎧᏃᎮᏛ ᎹᏚ ᎤᏬᏪᎳᏅᎯ' },

data/lib/bible_ref/languages/english.rb

@@ -4,6 +4,12 @@ require_relative 'base'
 module BibleRef
   module Languages
     class English < Base
+      # Is it a single chapter book?
+      def has_single_chapter?(reference)
+        matches = [/^ob/, /^(jud|jd|jude)\b/, /^2 ?jo?h?n/, /^3 ?jo?h?n/, /^(philem|phm|pm)/]
+        return Regexp.union(matches).match?(reference.downcase)
+      end
+
       def books
         {
           'GEN' => { match: /^gen/,              name: 'Genesis'                },
@@ -46,7 +52,7 @@ module BibleRef
           'ZEC' => { match: /^zec/,              name: 'Zechariah'              },
           'MAL' => { match: /^mal/,              name: 'Malachi'                },
           'TOB' => { match: /^tob/,              name: 'Tobit'                  },
-          'JDT' => { match: /^(jud|jdt)/,        name: 'Judith'                 },
+          'JDT' => { match: /^(jth|jdth?|judith)/, name: 'Judith'                 },
           'ESG' => { match: /^(est.*greek|esg)/, name: 'Esther (Greek)'         },
           'WIS' => { match: /^wis(dom)?/,        name: 'Wisdom of Solomon'      },
           'SIR' => { match: /^sir/,              name: 'Sirach'                 },
@@ -64,7 +70,7 @@ module BibleRef
           '2ES' => { match: /^2 ?esd?/,          name: '2 Esdras'               },
           '4MA' => { match: /^4 ?mac?/,          name: '4 Maccabees'            },
           'MAT' => { match: /^mat/,              name: 'Matthew'                },
-          'MRK' => { match: /^ma?rk/,            name: 'Mark'                   },
+          'MRK' => { match: /^(ma?rk|mk)/,       name: 'Mark'                   },
           'LUK' => { match: /^lu?k/,             name: 'Luke'                   },
           'JHN' => { match: /^(john|jn|jhn)/,    name: 'John'                   },
           'ACT' => { match: /^act/,              name: 'Acts'                   },
@@ -73,14 +79,14 @@ module BibleRef
           '2CO' => { match: /^2 ?cor?/,          name: '2 Corinthians'          },
           'GAL' => { match: /^gal/,              name: 'Galatians'              },
           'EPH' => { match: /^eph/,              name: 'Ephesians'              },
-          'PHP' => { match: /^(phill?i|php)/,    name: 'Philippians'            },
+          'PHP' => { match: /^(phil|php|pp)/,    name: 'Philippians'            },
           'COL' => { match: /^col/,              name: 'Colossians'             },
           '1TH' => { match: /^1 ?the?s?/,        name: '1 Thessalonians'        },
           '2TH' => { match: /^2 ?the?s?/,        name: '2 Thessalonians'        },
           '1TI' => { match: /^1 ?tim?/,          name: '1 Timothy'              },
           '2TI' => { match: /^2 ?tim?/,          name: '2 Timothy'              },
           'TIT' => { match: /^tit/,              name: 'Titus'                  },
-          'PHM' => { match: /^ph(i?l|m)/,        name: 'Philemon'               },
+          'PHM' => { match: /^(philem|phm|pm)/,  name: 'Philemon'               },
           'HEB' => { match: /^heb/,              name: 'Hebrews'                },
           'JAS' => { match: /^ja(m|s)/,          name: 'James'                  },
           '1PE' => { match: /^1 ?pet?/,          name: '1 Peter'                },
@@ -88,7 +94,7 @@ module BibleRef
           '1JN' => { match: /^1 ?jo?h?n/,        name: '1 John'                 },
           '2JN' => { match: /^2 ?jo?h?n/,        name: '2 John'                 },
           '3JN' => { match: /^3 ?jo?h?n/,        name: '3 John'                 },
-          'JUD' => { match: /^jud/,              name: 'Jude'                   },
+          'JUD' => { match: /^(jud|jd|jude)$/,   name: 'Jude'                   },
           'REV' => { match: /^re?v/,             name: 'Revelation'             }
         }
       end

data/lib/bible_ref/languages/latin.rb

@@ -4,6 +4,12 @@ require_relative 'base'
 module BibleRef
   module Languages
     class Latin < Base
+      # Is it a single chapter book?
+      def has_single_chapter?(reference)
+        matches = ['Abdias', 'ad Philemonem', 'Joannis II', 'Joannis III', 'Judæ']
+        return matches.any? { |e| reference.include?(e)  }
+      end
+
       def books
         {
           'GEN' => { name: 'Genesis' },

data/lib/bible_ref/languages/portuguese.rb

@@ -4,6 +4,13 @@ require_relative 'base'
 module BibleRef
   module Languages
     class Portuguese < Base
+
+      # Is it a single chapter book?
+      def has_single_chapter?(reference)
+          matches = [/^ob/, /^jud/, /^2 jo/, /^3 jo/, /^fil/]
+          return Regexp.union(matches).match?(reference.downcase)
+      end
+
       def books
         {
           'GEN' => { match: /^g[eê]n/,          name: 'Gênesis'           },
@@ -46,7 +53,7 @@ module BibleRef
           'ZEC' => { match: /^zac/,             name: 'Zacarias'          },
           'MAL' => { match: /^mal/,             name: 'Malaquias'         },
           'MAT' => { match: /^mat/,             name: 'Mateus'            },
-          'MRK' => { match: /^mar/,             name: 'Marcos'            },
+          'MRK' => { match: /^(mar|mk)/,        name: 'Marcos'            },
           'LUK' => { match: /^lu/,              name: 'Lucas'             },
           'JHN' => { match: /^jo/,              name: 'João'              },
           'ACT' => { match: /^at/,              name: 'Atos'              },

data/lib/bible_ref/languages/romanian.rb

@@ -4,6 +4,13 @@ require_relative 'base'
 module BibleRef
   module Languages
     class Romanian < Base
+
+      # Is it a single chapter book?
+      def has_single_chapter?(reference)
+          matches = [/^ob/, /^iud/, /^2 io/, /^3 io/, /^fil/]
+          return Regexp.union(matches).match?(reference.downcase)
+      end
+
       def books
         {
           'GEN' => { match: /^gen/,             name: 'Geneza'                },
@@ -46,7 +53,7 @@ module BibleRef
           'ZEC' => { match: /^za/,              name: 'Zaharia'               },
           'MAL' => { match: /^mal/,             name: 'Maleahi'               },
           'MAT' => { match: /^mat/,             name: 'Matei'                 },
-          'MRK' => { match: /^mar/,             name: 'Marcu'                 },
+          'MRK' => { match: /^(mar|mk)/,        name: 'Marcu'                 },
           'LUK' => { match: /^lu/,              name: 'Luca'                  },
           'JHN' => { match: /^io/,              name: 'Ioan'                  },
           'ACT' => { match: /^fa/,              name: 'Faptele apostolilor'   },

data/lib/bible_ref/reference.rb

@@ -7,11 +7,12 @@ module BibleRef
     attr_reader :book, :reference, :language, :canon
 
     # Create a new Reference instance by passing in the user-supplied bible reference as a string.
-    def initialize(reference, language: 'eng', canon: 'protestant')
-      @reference = reference
-      @details = parse
+    def initialize(reference, language: 'eng', canon: 'all')
       @language = language.respond_to?(:book_id) ? language : LANGUAGES.fetch(language.to_s).new
       @canon = canon.respond_to?(:books) ? canon : CANONS.fetch(canon.to_s).new
+      @reference = reference
+      standardize_reference()
+      @details = parse
     end
 
     # Returns an array of pairs, each one being the from and to for a range.
@@ -22,7 +23,6 @@ module BibleRef
     def ranges
       return nil unless valid?
       @chapter = nil
-      fix_chapter_for_jude if book_id == 'JUD'
       [@details[:refs]].flatten.map do |ref|
         normalize_range(ref) || normalize_ref(ref)
       end
@@ -75,6 +75,19 @@ module BibleRef
       end
     end
 
+    # standardize the reference so it can be handed to the parser.
+    def standardize_reference
+        return @reference unless @language.has_single_chapter?(@reference)
+        return @reference if @reference.include? ':'
+
+        matches = @reference.match(/^([\d]?[\D\s]*)/)
+        return @reference if matches.length() == 0
+
+        book = matches[0].strip
+        requested = @reference.sub(book, '').strip
+        @reference = "#{book} 1:#{requested}"
+    end
+
     def parse
       begin
         parsed = Parser.new.parse(@reference)
@@ -102,23 +115,5 @@ module BibleRef
       end
     end
 
-    def fix_chapter_for_jude
-      (start, finish) = @details[:refs]
-      finish ||= start
-      @details[:refs] = [
-        {
-          range: {
-            from: {
-              chapter: 1,
-              verse: start[:chapter]
-            },
-            to: {
-              chapter: 1,
-              verse: finish[:chapter]
-            }
-          }
-        }
-      ]
-    end
   end
 end

data/lib/bible_ref/version.rb

@@ -1,3 +1,3 @@
 module BibleRef
-  VERSION = '1.2.0'
+  VERSION = '1.5.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bible_ref
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.5.2
 platform: ruby
 authors:
 - Tim Morgan
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-03-03 00:00:00.000000000 Z
+date: 2021-11-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parslet
@@ -62,6 +62,7 @@ files:
 - README.md
 - lib/bible_ref.rb
 - lib/bible_ref/canons.rb
+- lib/bible_ref/canons/all.rb
 - lib/bible_ref/canons/protestant.rb
 - lib/bible_ref/languages.rb
 - lib/bible_ref/languages/base.rb
@@ -77,7 +78,7 @@ homepage: https://github.com/seven1m/bible_ref
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -92,8 +93,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.2
-signing_key: 
+rubygems_version: 3.1.6
+signing_key:
 specification_version: 4
 summary: Bible reference parser
 test_files: []