Mericope

Mericope is a gem for parsing Book of Mormon references (i.e. Mormon Pericopes). It's based on Pericope, a gem for parsing Bible references.

It recognizes common abbreviations and misspellings for names of the books of the Bible and a variety of ways of denoting ranges of chapters and verses. It can parse mericopes singly or out of a block of text. It's useful for comparing two mericopes for intersection and normalizing them into a well-formatted string.

Examples

Recognize common abbreviations and misspellings for names of the books of the Bible

  Mericope.new("ps 118:17").to_s # => Psalm 118:17
  Mericope.new("jas 3:1-5").to_s # => James 3:1-5
  Mericope.new("1 ne 12:4").to_s  # => 1 Nephi 12:4

Compare two mericopes to see if they intersect

  a = Mericope.new("Mark 13:1-6")
  b = Mericope.new("Mark 13:5")
  c = Mericope.new("Mark 13:6, 7")
  
  a.intersects?(b) # => true
  a.intersects?(c) # => true
  b.intersects?(c) # => false

Parse mericopes out of a block of text

  text = <<-TEXT
  If then, the Word is so significant, great important attaches to its exact form. It has the form of a promise as in Isaiah 43:1: "Do not fear, for I have redeemed you; I have called you by name, you are mine," or as in Luke 2:10-11, "Do not be afraid..to you is born this day...a Savior." (Bayer, p51)
  TEXT
  
  Mericope.parse(text) # => [Isaiah 43:1, Luke 2:10-11]
  
  Mericope.split(text) # => ["  If then, the Word is so significant, great important attaches to its exact form. It has the form of a promise as in ", Isaiah 43:1, ": \"Do not fear, for I have redeemed you; I have called you by name, you are mine,\" or as in ", Luke 2:10-11, ", \"Do not be afraid..to you is born this day...a Savior.\" (Bayer, p51)\n"]

Converts mericopes into arrays of verses and reconstructs them from arrays of verses

  array = Mericope.new("gen 1:1-3").to_a # => [1001001, 1001002, 1001003]
  Mericope.new(array) # => Genesis 1:1-3

History

0.6.1

Deprecated the report and extract methods (they will be removed in 0.7.0)

0.6.0

Removed the index attribute
Deprecated the pattern argument to the method Mericope.split(text, pattern=nil) (it will be removed in 0.7.0)
Improved performance by 2x
Added this README
Fixed a bug with parsing inverted [invalid] ranges (e.g. Mark 3-1)

mericope

Development

Runtime