Skip to content

TomFaulkner/bible

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Python Classes for manipulating Bible references

Python classes for Bible Verse and Passage - useful for storing, comparing, and formatting Bible references. Also includes Django form classes to make it easy to add Bible references to your Django models.

Note that this module does not let you actually pull and display the text of a Bible verse or passage - it is just for working with and displaying the reference to the verses. Other tools and APIs can be used to grab and display the actual verse text for a reference.

Installation

pip install bible3

Using Classes

While this section is being expanded, please see the test program, test_bible.py for numerous examples of use. Here are some basics:

  • create Verse objects: bible.Verse('James 2:10')
  • create Passage objects: bible.Passage('John 4:3', 'John 4:10') bible.Passage('John 4:3-10') or supply 2 Verse objects
  • test for a Verse to be included in a passage: Passage.includes(Verse)
  • test for a Passage to have overlap with another Passage: Passage1.overlap(Passage2)
  • and more

Fork and Thanks

I forked this to make it Python 3 compatible. I've added some tests, certainly more could be included. All tests pass in Python 2.7.13 and Python 3.6.2.

_str_ and _repr_ added to both Verse and Passage classes, _len_ added to Passage, other changes were minimal.

Thanks to Jason Ford for writing this and making it available to the world.

SDG,

Tom Faulkner