Scripture Lookup is a Python library and command-line tool for looking up scripture verses or chapters. It can also convert scripture references between formats and languages. The tool is built around data from Python Scripture Scraper.
The Python package and command-line tool can be installed from PyPI via pip:
pip install scripturelookup
Pattern:
scripturelookup [command] [input] [options]
Examples:
% scripturelookup get_content "john 3:16" --lang "en"
16 ¶ For God so loved the world, that he gave his only begotten Son, that whosoever believeth in him should not perish, but have everlasting life.
% scripturelookup get_label "니파이전서 3:7" --lang "fr" --abbreviated
1 Né 3:7
% scripturelookup get_church_url "helaman 5:12"
https://www.churchofjesuschrist.org/study/scriptures/bofm/hel/5?id=p12&lang=eng#p12
% scripturelookup get_label "/scriptures/nt/1-jn/3.2-3" --lang "cmn-Hant"
約翰一書3：2-3
% scripturelookup get_church_url "/scriptures/ot" --lang "es"
https://www.churchofjesuschrist.org/study/scriptures/ot?lang=spa
Examples:
from scripturelookup import lookup
lookup.get_content('john 3:16', lang = 'en')
# 16 ¶ For God so loved the world, that he gave his only begotten Son, that whosoever believeth in him should not perish, but have everlasting life.
lookup.get_label('니파이전서 3:7', lang = 'fr', abbreviated = True)
# 1 Né 3:7
lookup.get_church_url('helaman 5:12')
# https://www.churchofjesuschrist.org/study/scriptures/bofm/hel/5?id=p12&lang=eng#p12
lookup.get_label('/scriptures/nt/1-jn/3.2-3', lang = 'cmn-Hant')
# 約翰一書3：2-3
lookup.get_church_url('/scriptures/ot', lang = 'es')
# https://www.churchofjesuschrist.org/study/scriptures/ot?lang=spa
- get_content – Get chapter or verse content.
- get_label – Get a scripture reference label (i.e. "John 3:16").
- get_church_uri – Get a Gospel Library URI (i.e. "/scriptures/bofm/hel/5.12").
- get_church_url – Get a Gospel Library URL.
- get_church_link – Get an HTML link to Gospel Library.
Any of the following input types are supported. You can also provide several inputs at once as a list (separated by semicolons or line-breaks).
- Chapter or verse references, in any supported language. Examples:
- John 3:16
- Enos 1:13, 15–18
- Psalm 23
- Gen. 1:3 (3–4)
- D&C 20:23; 76:41
- Scripture publication or book names. Examples:
- Old Testament
- Book of Mormon
- 1 Corinthians
- Psalms
- Gospel Library URIs (starting with
/scriptures). Examples:- /scriptures/ot/gen
- /scriptures/nt/matt/1
- /scriptures/nt/john/3.16
- /scriptures/bofm/enos/1.13,15-18
- /scriptures/pgp
- Gospel Library URLs (old or new). Examples:
Several options are available. Some are only applicable to certain commands.
- lang (optional) – Output language. BCP 47 language codes and Gospel Library language codes are supported. Default: 'en'.
- separator (optional) – String separator between outputs when a list of references is being requested. Default: '\n'.
- source (optional) – Content source. Default: 'python-scripture-scraper'. Supported values: 'python-scripture-scraper' or 'ChurchofJesusChrist.org'.
- link_class (optional) – String for the “class” attribute on links. Default: None.
- link_target (optional) – String for the “target” attribute on links. Default: None.
- use_query_parameters (optional) – Whether query parameters should be used on URIs. Default: False.
- skip_lang (optional) – Whether “lang” query parameters should be skipped on URLs. Default: False.
- skip_fragment (optional) – Whether fragments should be skipped on URLs. Default: False.
- skip_book_name (optional) – Whether book names should be skipped on labels. Default: False.
- abbreviated (optional) – Whether book abbrevions should be used on labels. Default: False.
Python Scripture Scraper – tool for scraping scripture content and metadata from ChurchofJesusChrist.org. geezify-python – tool for converting numbers to and from Geez numerals.