BibleStudent.KJV.Bible 2.0.0

BibleStudent.KJV.Bible

Complete King James Version Bible library for .NET.
All 66 books · 1,189 chapters · 31,102 verses — embedded offline, no network required.

Installation

dotnet add package BibleStudent.KJV.Bible

Quick start

using BibleStudent.KJV;

var bible = new Bible();

// Verse of the day (deterministic per date)
BibleVerse votd = bible.GetVerseOfTheDay();
Console.WriteLine(votd);                         // John 3:16  For God so loved…

// Read a chapter
BibleChapter? ch = bible.GetChapter("John", 3);
Console.WriteLine(ch!.ToFormattedText());

// Search
var results = bible.Search("God so loved", new SearchOptions { MaxResults = 10 });
foreach (var v in results)
    Console.WriteLine($"{v.Reference}: {v.Text}");

Namespace

using BibleStudent.KJV;

All public types live in the BibleStudent.KJV namespace.

API Reference

Bible — main class

Properties:

BibleVerse

record BibleVerse
{
    string BookName          // "Genesis", "1 Corinthians", …
    string BookAbbreviation  // "Gen", "1Cor", …
    int    Chapter           // 1-based
    int    Verse             // 1-based
    string Text              // KJV verse text
    string Reference         // "John 3:16"  (computed)
    int    GlobalIndex       // 0-based sequential index across all 31,102 verses
}

BibleBook

record BibleBook
{
    string    Name           // "Psalms"
    string    Abbreviation   // "Ps"
    int       ChapterCount   // number of chapters
    int       VerseCount     // total verses across all chapters
    Testament Testament      // Testament.Old / Testament.New
    int       BookNumber     // 1-based canonical position
}

BibleChapter

record BibleChapter
{
    string                  BookName
    string                  BookAbbreviation
    int                     ChapterNumber
    IReadOnlyList<BibleVerse> Verses
    int                     VerseCount       // computed
    string                  ToFormattedText() // "John 3\n\n[1] In the beginning…"
}

SearchOptions

All properties are init-only — use an object initialiser:

var opts = new SearchOptions
{
    CaseSensitive   = false,   // default false
    WholeWord       = false,   // default false
    MaxResults      = 200,     // default 200; 0 = unlimited
    TestamentFilter = Testament.New,  // default null (both)
    BookFilter      = "Romans",       // default null (all books)
};

BibleStats

record BibleStats
{
    int    TotalBooks
    int    TotalChapters
    int    TotalVerses
    int    TotalWordCount
    string LongestBook
    string ShortestBook
}

Extension methods (BibleExtensions)

WordFrequency

IReadOnlyList<(string Word, int Count)> WordFrequency(
    this IEnumerable<BibleVerse> verses,
    bool caseSensitive = false)

Returns word-frequency pairs, sorted by count descending:

var top20 = bible.Search("love")
                 .WordFrequency(caseSensitive: false)
                 .Take(20);

foreach (var (word, count) in top20)
    Console.WriteLine($"{word}: {count}");

Book names and abbreviations

Books can be identified by their full name or any of these abbreviations:

| # | Book | Abbreviation | Also accepted | |---|------|-------------|---------------| | 1 | Genesis | Gen | Ge, Gn | | 19 | Psalms | Ps | Psa, Psalm | | 22 | Song of Solomon | Song | SoS, SS, Cant | | 43 | John | John | Jn, Joh | | 46 | 1 Corinthians | 1Cor | 1 Cor, 1Co, I Cor | | 66 | Revelation | Rev | Re, Rv, Apoc | (all 66 books supported — see source for full alias list)

Bible text

The King James Version (KJV) is in the public domain. The text included in this package is sourced from the public domain dataset at github.com/aruljohn/Bible-kjv.

License

MIT — see LICENSE