File: README.rst

package info (click to toggle)
pysword 0.2.7-3
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 436 kB
  • sloc: python: 3,581; makefile: 14
file content (67 lines) | stat: -rw-r--r-- 2,441 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
.. image:: https://gitlab.com/tgc-dk/pysword/badges/master/build.svg
   :target: https://gitlab.com/tgc-dk/pysword/pipelines
.. image:: https://ci.appveyor.com/api/projects/status/7n8848av82arr9xv?svg=true
   :target: (https://ci.appveyor.com/project/OpenLP/pysword

A native Python reader of the SWORD Project Bible Modules

This project is **not** an official `CrossWire <http://crosswire.org/>`_
project. It merely provides an alternative way to read the bible modules
created by CrossWires `SWORD <http://crosswire.org/sword/index.jsp>`_ project.

Features
--------

-  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
   http://www.crosswire.org/sword/modules/ModDisp.jsp?modType=Bibles
-  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 io.open (introduced in python 2.6 and the unicode literal (available in pyhton 2 and
   reintroduced in python 3.3 - PEP 414)

License
-------

PySword is and can be distributed under the `MIT license <https://opensource.org/licenses/MIT>`_

Installation
------------

PySwords source code can be downloaded from PySwords `release list <https://gitlab.com/tgc-dk/pysword/tags>`_,
but it is also available from `PyPI <https://pypi.python.org/pypi/pysword/>`_
for install using ``pip``::

    pip install pysword

It also available for `ArchLinux (AUR) <https://aur.archlinux.org/packages/?K=pysword>`_ and
`Fedora <https://apps.fedoraproject.org/packages/python-pysword>`_ 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:

.. code:: sh

    $ python tests/resources/download_bibles.py
    $ nosetests -v tests/

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

Using PySword
-------------

Read the `documentation <https://tgc-dk.gitlab.io/pysword/>`_ for how to use pysword and to see the API docs.

Contributing
------------

If you want to contribute, you are most welcome to do so!
Feel free to report issues and create merge request at https://gitlab.com/tgc-dk/pysword
If you create a merge request please include a test the proves that your code actually works.