All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.15.5 - 2026-01-24
- Issue #235 - Error getting reference to Jonah
0.15.4 - 2026-01-01
- Moved docs dependencies out of core pythonbible config and into a separate config (no functional changes).
- Bumped docs dependencies to their latest versions (no functional changes).
- Updated all translation packages to use the latest version of pythonbible (0.15.3) and bumped their version numbers.
0.15.3 - 2025-12-31
- Changed the optional "extra" dependency reference for the "Diaglot NT" version to be "Diaglot" instead of "Dialgot".
0.15.2 - 2025-12-31
- Fixed the pythonbible package README file to, for now, be a copy of the main project README file so that it displays in PyPI correctly.
0.15.1 - 2025-12-31
- Added an optional
bibleparameter to most public functions so that standard book, chapter, verse, and text definitions can be overridden by a specific Bible translation.
- Modified the values in the max verses dictionary to be the mode (instead of max) chapter/verse info across all versions/translations.
- Separated the Bible versions/translations into their own packages to reduce the file size of the main pythonbible package.
- The main pythonbible package now only includes the ASV version by default.
- Other versions/translations can be optionally installed along with the pythonbible package or separately as their own package.
- Removed all versions/translations except for ASV from the main pythonbible package to reduce file size.
- Other versions/translations can be optionally installed along with the pythonbible package or separately as their own package.
0.15.0 - unreleased due to file size restrictions on PyPI
- Added several new English version/translation Bibles:
- American King James Version (AKJV)
- Bible in Basic English (BBE)
- Bible in Worldwide English NT (BWE)
- Darby (DAR)
- Diaglot NT - 1865 (DIAGLOT)
- Douay-Rheims (DR)
- The Emphasized Bible by J. B. Rotherham (ROTHERHAM)
- Geneva Bible (GB)
- Leeser Old Testament (LEESER)
- Living Oracles NT (LONT)
- Modern KJV 1963 (MKJV1963)
- Montgomery New Testament (MONT)
- New Heart English Bible (NHEB)
- Open English Bible (OEB)
- The Peschito Syriac New Testament (ETHERIDGE)
- Revised 1833 Webster Version (RWEBSTER)
- Revised Young's Literal Translation NT (RYLT)
- Updated King James Version (UKJV)
- Webster (WBS)
- Wesley's New Testament (WESLEY)
- Weymouth NT (WMTH)
- Willam Tyndale Bible (TYN)
- World English Bible (WEB)
- Wycliffe Bible (WYC)
- Young's Literal Translation of the Bible (YLT)
- Added functionality to the Bible class to be able to get the books, chapter numbers, and verse numbers for the given version/translation.
- BREAKING CHANGE: Modified the NormalizedReference class to allow start chapter, start verse, end chapter, and end verse to be None.
- The parser has also been updated to set those values to None unless they are explicitly set in the reference string. As we added more version/translation Bible texts, we realized the differences in chapter and verse numbers between versions/translations was much greater than initially assumed. This change allows for more flexibility in handling those differences.
- The formatter has also been updated to get the appropriate start chapter, start verse, end chapter, and end verse at format time rather than parse time.
- Moved all versions to be separate python packages that can be optionally installed.
- The ASV version is still included as the default version.
- Updated release workflow to publish all version packages to PyPI as well as the pythonbible package.
- The release workflow will compare the version of each package to the version in the previous tag/release and only publish if the version number has increased.
0.14.0 - 2025-11-09
- Added Python 3.14 to the list of supported Python versions.
- Modified the header image url to be an absolute url so that it hopefully shows up in PyPI correctly.
- Switched package build and publish tool from flit to uv.
- Updated GitHub Actions workflow to use uv for building and publishing to PyPI.
- Removed Python 3.8 from the list of supported Python versions.
- Removed Python 3.9 from the list of supported Python versions.
0.13.1 - 2024-05-21
- Modified max verses dictionary with chapter/verse info from multiple versions/translations.
0.13.0 - 2024-05-21
- Official support for Python 3.12
- Additional English Versions
- Modified some Version names and values to match their OSIS values
0.12.0 - 2023-10-03
- Official support for Python 3.12
0.11.1 - 2023-10-02
The goal of this release was to address Issue #118 (When trying to get the scripture text for a verse that is in a book that is not included in the given version, the entire scripture text for that version was returned.)
- VersionMissingVerseError exception
- Raise an error when trying to get scripture text for a verse that is in a book that is not included in the given version.
0.11.0 - 2023-06-27
- Updated README to more accurately describe current OSIS parser and Bible text formatting functionality
- Minor code quality improvements based on static code analysis
- Python 3.7 support (due to official end of life on June 27, 2021)
0.10.0 - 2023-05-27
The goal of this release was to address Issue #90, and to make things related to Books, BookGroups, and Versions structured in a more object-oriented way.
- started this Changelog
- new abbreviations list property of Book Enum
- Jupyter notebook for Basic Usage documentation
- Jupyter notebook for Advanced Usage, Single Chapter Books documentation
- Jupyter notebook for Advanced Usage, Multi Book References documentation
- Jupyter notebook for Advanced Usage, Book Groups documentation
- moved book specific regular expressions to new regular_expression property of Book
- moved book default titles to be encapsulated within the Book Enum and updated the title property to use them
- moved book group regular expressions to be encapsulated within the BookGroup Enum and updated the regular_expression property to use them
- moved book group books tuple to be encapsulated within the BookGroup Enum and updated the books property to use them
- moved version titles to be encapsulated within the Version Enum and updated the title property to use them
- updated Technical Reference documentation to use autodocs (generate documentation from docstrings)
- changed the default Version to AMERICAN_STANDARD in order to match the existing documentation
- updated Advanced Usage documentation to reference the format_scripture_references function rather than the format_references function (which doesn't exist)
- fixed a typo on the documentation index page