freebible library
Free holy bibles data and toolkit for Python developers
Project Home Page
https://github.com/neocl/freebible
Installation
freebible package is available on PyPI, so it can be installed via pip by using
pip install freebible
# or even better
python3 -m pip install freebiblePlease note that freebible requires Python 3. It does not work on Python 2 anymore.
Sample code
Easy access
>>> from freebible import bibles
# Quote everything
>>> bibles.print("Gen")
[1] ε΅δΈθ¨
[1] Genesis
>>> bibles.print("Gen", 1, 1)
[Ge 1:1] ε
ε§γ«η₯倩ε°γε΅ι γγΎγΈγ
[Gen 1:1] In the beginning God created the heavens and the earth.
# Quote from a specific bible
>>> bibles.kougo.quote("John") # this returns a book object
Book(ID='104', title='γ¨γγε³η¦ι³ζΈ', filename='John', title_eng='John', short_name='John')
>>> bibles.kougo.quote("John", 1) # this returns a chapter object
Chapter(ID='1')
>>> bibles.kougo.quote("John", 1, 1) # this returns a verse object
John 1:1 ε€ͺεγ«θ¨γγγθ¨γ―η₯γ¨εγ«γγγθ¨γ―η₯γͺγγγ
>>> bibles.web.quote("John")
Book(ID='43', title='John', filename='', title_eng='John', short_name='John')
>>> bibles.web.quote("John", 1)
Chapter(ID='1')
>>> bibles.web.quote("John", 1, 1)
John 1:1 In the beginning was the Word, and the Word was with God, and the Word was God.Accessing Kougo
>>> from freebible import read_kougo
>>> kougo = read_kougo()
>>> print(len(kougo))
66
>>> print(kougo['John'])
[104] γ¨γγε³η¦ι³ζΈ
>>> print(len(kougo['John']))
21
>>> print(kougo['John'][1])
Chapter(ID='1')
>>> print(kougo['John'][1][1])
[John 1:1] ε€ͺεγ«θ¨γγγθ¨γ―η₯γ¨εγ«γγγθ¨γ―η₯γͺγγγAccessing World English Bible (WEB)
>>> from freebible import read_web
>>> web = read_web()
>>> print(len(web))
66
>>> print(web['John'])
[43] John
>>> print(len(web['John']))
21
>>> print(web['John'][1])
Chapter(ID='1')
>>> print(len(web['John'][1]))
51
>>> print(web['John'][1][1])
[John 1:1] In the beginning was the Word, and the Word was with God, and the Word was God.Developer setup
If you want to contribute to the source code, you can setup the development environment like this
# Create a virtual environment to install packages
python3 -venv ~/.envfreebible
# Activate the virtual environment
. ~/.envfreebible/bin/activate
# Check out the source code to your machine
git clone https://github.com/freebible freebible-project
cd freebible-project
# Install required packages
python3 -m pip install -r requirements.txt
# Run the demo to make sure that this source code work
python3 demo.pyBible sources:
Japanese Colloquial ε£θͺ訳: http://jco.ibibles.net/
World English Bible: https://github.com/scrollmapper/bible_databases
