versicles

Lib and CLI tool to manipulate biblical verses!

Pure Nim score 15/100 · tests present · no docs generated

Summary

Latest Version Unknown
License MIT
CI Status Failing
Downloads 0
Last Indexed 2026-07-22 05:28

Installation

nimble install versicles
choosenim install versicles
git clone https://github.com/thisago/versicles

OS Compatibility

Platform Linux macOS Windows FreeBSD OpenBSD NetBSD Android iOS WASM Embedded
versicles - - - - - - -

Source

Repository https://github.com/thisago/versicles
Homepage https://github.com/thisago/versicles
Registry Source nimble_official

README

Versicles

Lib and CLI tool to manipulate biblical verses!

parseList

Converts a commented verse list into a JSON

Help

Usage:
  parseList [REQUIRED,optional-params] 
Converts a commented verse list into a JSON
Options:
  -h, --help                            print this cligen-erated help
  --help-syntax                         advanced: prepend,plurals,..
  -l=, --list=        string  REQUIRED  Input list file path
  -o=, --outJson=     string  REQUIRED  Output JSON file path
  -s, --saveAllLines  bool    false     Enable all lines saving to JSON. The default is to ignore lines that haven't a verse reference

Example

in.txt

(Bereshit (Ex) 4:21) Yuval, brother of Yaval was the father of all who play the harp and flute

Run:

versicles parseList -l in.txt -o out.json

out.json (formatted)

[
  {
    "text": "(Ex 4:5 en_cjb) Kayin rages against Hevel and his face shows hatred.",
    "textNoVerses": "Kayin rages against Hevel and his face shows hatred.",
    "verses": ["Ex 4:5 en_cjb"]
  }
]

toMd

Generates a markdown with JSON data (parsed with parseList)

Help

Usage:
  genMd [REQUIRED,optional-params] 
Generates a markdown with JSON data (parsed with `parseList`)
Options:
  -h, --help                                          print this cligen-erated help
  --help-syntax                                       advanced: prepend,plurals,..
  -j=, --jsonFile=                  string  REQUIRED  Input JSON file path
  -o=, --outMd=                     string  ""        Output Markdown file path
  -d=, --defaultTranslation=        string  "pt_yah"  Default bible translation to use in Ozzuu Bible URLs
  -t, --hebrewTransliterations      bool    true      Disables the addiction of hebrew transliterated names
  -k, --keepInlineVersesReferences  bool    false     set keepInlineVersesReferences
  -a, --addVerseTranslation         bool    false     set addVerseTranslation
  -l=, --toLang=                    string  ""        Set the language to translate

Example

in.json (formatted)

[
  {
    "text": "(Ex 4:5 en_cjb) Kayin rages against Hevel and his face shows hatred.",
    "textNoVerses": "Kayin rages against Hevel and his face shows hatred.",
    "verses": ["Ex 4:5 en_cjb"]
  }
]

Run:

versicles genMd -j in.json -d en_wyc2014

stdout

#### [Ex 4:5](https://bible.ozzuu.com/en_cjb/Ex/4#5)

Kayin rages against Hevel and his face shows hatred.

Todo

  • [x] Optional hebrew names for books
  • [ ] Create a website to use this tool in browser
  • [ ] Change genMd to genHtml

License

MIT