Bible Versions

A collection of Bible versions in JSON format, organized by version, book, and chapter.

This data is used in production for Bible Planner.

Supported Versions and Books

This repository contains various translations of the Bible. For a complete list of supported versions, their descriptions, and the abbreviations used for each book, please refer to the Legends Documentation.

Project Structure

• bible/: Contains the Bible data organized by version.
  • [Version]/: Directory for a specific Bible version (e.g., ACF, WEB).
    • [Book]/: Directory for a specific book (using abbreviations).
      • [Chapter].json: JSON file containing the verses for that chapter.
    • metadata.json: JSON file containing metadata about the version.

Data Format

Each chapter is stored in a JSON file with the following structure:

{
  "version": "WEB",
  "book": "Gn",
  "chapter": 1,
  "verses": [
    {
      "number": 1,
      "text": "In the beginning, God created the heavens and the earth."
    },
    ...
  ]
}

Version Metadata

Each version directory contains a metadata.json file with general information:

{
  "name": "Almeida Corrigida Fiel",
  "id": "ACF",
  "language": "pt",
  "country": "br",
  "year": {
    "begin": 1994,
    "end": 2011
  }
}

Documentation

• Legends and Abbreviations

Quality Assurance

We have a suite of integrity tests to ensure the data is complete and accurate. These tests verify:

• All 66 books of the Bible are present.
• Each book contains the correct number of chapters.
• Each chapter contains the correct number of verses.
• Data consistency across different versions.
• JSON structure validity.
• Presence and validity of version metadata.

Running Tests

We use a suite of integrity tests to ensure the data is complete and accurate. You can run all tests using the following command:

python3 -m unittest discover tests

Or run specific test files:

# Bible data integrity (structure, chapters, verses)
python3 tests/test_bible_integrity.py

# Version metadata validation
python3 tests/test_metadata_integrity.py