Metadata-Version: 2.1
Name: bibleparser
Version: 0.0.2
Summary: Parse a mistranscribed dictated bible reference into a standard format
Author-email: Taylor Vance <mirrors.cities0w@icloud.com>
License: MIT
Project-URL: Homepage, https://github.com/taylorvance/bibleparser
Project-URL: Issues, https://github.com/taylorvance/bibleparser/issues
Keywords: bible,parser,reference,passage,dictation,transcription,text processing,siri,alexa
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# Bible Parser

Bible Parser is a Python library for parsing a Bible reference into a structured format. It was designed to interpret dictated references that may have been mistranscribed by Siri or other voice recognition software (e.g., "John 316" becomes "John 3:16").


## Examples

Dictation                   | Transcription     | Parsed Reference
---------                   | -------------     | ----------------
john three sixteen          | John 316          | John 3:16
john three two through four | John 32 through 4 | John 3:2-4
matthew twenty one twelve   | Matthew 2112      | Matthew 21:12
first john one one          | 1st John 11       | 1 John 1:1
micah one one               | Michael 11        | Micah 1:1
jude one one                | June one one      | Jude 1:1
haggai two twenty three     | Hey guy 223       | Haggai 2:23
acts one twenty three       | X123              | Acts 1:23


## API

### Siri Shortcut
I originally created this project to use with a Siri Shortcut that accepts a Bible reference as input and returns the text of the passage.

### AWS Serverless API
I set up an AWS Lambda function behind an API Gateway to expose the functionality of this library as an HTTP API.

### Bible API by Tim Morgan
Special thanks to Tim Morgan for creating and hosting [bible-api](https://bible-api.com/)! My library merely parses the reference. Tim's API provides the actual text of the passage.


## Quick Reference Commands

Action                     | Command
------                     | -------
Create virtual environment | `python -m venv venv`
Activate venv              | `source venv/bin/activate`
Deactivate venv            | `deactivate`
Install package (editable) | `pip install -e .`
Run all tests              | `python -m unittest discover tests`
Build the package          | `python -m build`
Upload to PyPI             | `twine upload dist/*`
