Bible-IO

A Rust library for working with Bible text data structures, providing efficient parsing and access to Bible books, chapters, and verses.

Features

• Parse Bible data from JSON files
• Access books, chapters, and verses by various identifiers

Usage

Add this to your Cargo.toml:

[dependencies]

bible-io = "1.0.0"

Basic usage:

use rust_bible_struct::{Bible, BibleBook};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let bible = Bible::new_from_json("path/to/bible.json")?;

    // Get a specific verse
    if let Ok(verse) = bible.get_verse(BibleBook::Genesis, 1, 1) {
        println!("{}", verse);
    }

    // Get all verses from a chapter
    if let Ok(verses) = bible.get_verses(BibleBook::Psalms, 23) {
        for verse in verses {
            println!("{}", verse);
        }
    }

    Ok(())
}

JSON Structure

The library expects Bible data in the following JSON format:

{
    "id": "en-kjv",
    "name": "King James Version",
    "description": "King James Version of the Holy Bible",
    "language": "English",
    "books": {
        "gn": {
            "name": "Genesis",
            "chapters": [
                [
                    "In the beginning God created the heaven and the earth.",
                    "And the earth was without form, and void; and darkness was upon the face of the deep. And the Spirit of God moved upon the face of the waters.",
                    "And God said, Let there be light: and there was light."
                ]
            ]
        }
    }
}

Top-level fields identify the translation. Each entry in books uses a book abbreviation (e.g., "gn") and contains a name and a chapters array, where each chapter is a list of verse strings.

Examples

Run the included example:

cargo run --example basic_usage

Running Tests

# Run all tests (requires en_kjv.json)

cargo test


# Run only unit tests (no external data required)

cargo test --lib


# Run only integration tests

cargo test --test integration_tests

License

MIT License - see LICENSE file for details.