=====================
Python LDS Scriptures
=====================

python-lds-scriptures parses LDS scripture URIs and formats them
as human-readable strings.

Typical usage looks like this::

    >>> import scriptures
    >>> ref = scriptures.ref('/scriptures/bofm/mosiah/2.17')
    >>> ref
    ScriptureRef("/scriptures/bofm/mosiah/2.17")
    >>> unicode(ref)
    u'Mosiah 2:17'

Create references from their parts::

    >>> scriptures.ScriptureRef(testament='dc-testament', book='dc', chapter=46, verse_ranges=[(11, 12), (15, 15)])
    ScriptureRef("/scriptures/dc-testament/dc/46.11-12,15")

Sort references::

    >>> sorted([scriptures.ref('/scriptures/bofm/mosiah/2.17'), scriptures.ref('/scriptures/ot/isa/48.10')])
    [ScriptureRef("/scriptures/ot/isa/48.10"), ScriptureRef("/scriptures/bofm/mosiah/2.17")]

Merge references::

    >>> scriptures.merged([scriptures.ref('/scriptures/bofm/2-ne/2.25'), scriptures.ref('/scriptures/bofm/2-ne/2.1-2')])
    [ScriptureRef("/scriptures/bofm/2-ne/2.1-2,25")]
    
Manipulate references::

    >>> ref = scriptures.ref('/scriptures/bofm/2-ne/2.25')
    >>> ref.chapter = None
    >>> ref.verse_ranges = None
    >>> ref
    ScriptureRef("/scriptures/bofm/2-ne")
    
Query references::

    >>> scriptures.ref('/scriptures/ot/ruth').chapters()
    [1, 2, 3, 4]
    >>> scriptures.ref('/scriptures/nt/2-cor/12').verses()
    [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21]
    >>> scriptures.ref('/scriptures/dc-testament/dc/46.11-12,15').verses()
    [11, 12, 15]