mtangoo / sword-to-json

Python utility to convert Crosswire sword bible modules to JSON

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 [email protected]: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.

Romans 16:27 KJV