sword-to-json
Python utility to convert Crosswire sword bible modules to JSON
Introduction
sword-to-json dumbly converts Crosswire sword bible modules to JSON.
It does some minimalistic tidying up of verse data - trimming, removing double spaces, etc
Under the hood sword-to-json uses the excellent pysword
Examples
Check out the bibles folder for examples of bible JSON generated using sword-to-json
Usage
If our examples don't offer the translation you want, you can use sword-to-json to generate JSON from any sword module:
(1) Install Python 3.6 or higher
(2) Git clone this repo .. git clone git@github.com:danday74/sword-to-json.git
(3) Move to the root folder .. cd sword-to-json
(4) Install dependencies .. pip install -r requirements.txt
(5) Place the ZIP file for each sword module you want to convert into the sword-modules folder or a sub folder thereof
NOTE: Download sword module ZIP files from Crosswire or Ebible
(6) run .. python sword_to_json.py
(7) Wait for processing to complete
(8) The JSON for your chosen sword modules will appear in the bibles folder
Advanced Usage
At step (6) above you can run any of the following:
python sword_to_json.py Creates JSON for sword modules, skipping modules for which the JSON already exists
python sword_to_json.py --overwrite Creates JSON for sword modules without skipping
python sword_to_json.py --partials Creates JSON and partial JSON for sword modules, skipping as above
NOTE: Partial JSON only shows some of the bible data and is pretty printed. Its sole purpose is to help you understand the structure of the JSON and is otherwise useless.
python sword_to_json.py --overwrite --partials Creates JSON and partial JSON for sword modules without skipping
Limitations
sword-to-json does not attempt to fix sword verse data but dumbly provides data as is.
For example, using the KJV sword module Romans 16:27 KJV reads:
To God only wise, be glory through Jesus Christ for ever. Amen. Written to the Romans from Corinthus, and sent by Phebe servant of the church at Cenchrea.
Whereas it should read:
To God only wise, be glory through Jesus Christ for ever. Amen.
The additional text being present in the KJV but not forming part of the verse itself.
Author Says
In case you weren't listening the first time, let me say it again:
To God only wise, be glory through Jesus Christ for ever. Amen.