Skip to main content

A native Python2/3 reader module for the SWORD Project Bible Modules

Project description

A native Python reader of the SWORD Project Bible Modules

This project is not an official CrossWire project. It merely provides an alternative way to read the bible modules created by CrossWires SWORD project.


  • Read SWORD bibles (not commentaries etc.)
  • Detection of locally installed bible modules.
  • Supports all known SWORD module formats (ztext, ztext4, rawtext, rawtext4)
  • Read from zipped modules, like those available from
  • Clean text of OSIS, GBF or ThML tags.
  • Supports both python 2.7 and 3.3+ [*] (CI tested with 2.7 to 3.7)
[*]pysword makes use of (introduced in python 2.6 and the unicode literal (available in pyhton 2 and reintroduced in python 3.3 - PEP 414)


PySword is and can be distributed under the MIT license


PySwords source code can be downloaded from PySwords release list, but it is also available from PyPI for install using pip:

pip install pysword

It also available for ArchLinux (AUR) and Fedora and will soon be available as a package in Debian.

Run tests

To run the testsuite, first run the script that download the files used for testing, and then use nosetests to run the testsuite:

$ python tests/resources/
$ nosetests -v tests/

The tests should run and pass using both python 2 and 3.

Using PySword

Read the documentation for how to use pysword and to see the API docs.


If you want to contribute, you are most welcome to do so! Feel free to report issues and create merge request at If you create a merge request please include a test the proves that your code actually works.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pysword, version 0.2.7
Filename, size File type Python version Upload date Hashes
Filename, size pysword-0.2.7.tar.gz (27.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page