#bible #command-line-tool #lookup #verse #cache #day #file

app votd

A command-line tool to lookup Bible verses

8 releases (stable)

1.0.6 Sep 16, 2024
1.0.5 Jul 19, 2024
1.0.4 Oct 23, 2023
1.0.3 Jul 25, 2023
0.1.0 Jul 11, 2023

#784 in Command line utilities

Download history 117/week @ 2024-09-11 52/week @ 2024-09-18 46/week @ 2024-09-25 10/week @ 2024-10-02

364 downloads per month

MIT license

16KB
182 lines

VotD

Crates.io MIT License

A command-line utility to look up the Bible verse-of-the-day. Use votd to get the current verse-of-the-day, or votd --help for command-line flags.

You can install it via cargo:

$ cargo install votd

Maintenance

I consider this a finished program; it serves my needs, and I don't care to work more on it. I may address significant issues (e.g. major bugs, vulnerabilities, or if the API routes change), but if you want smaller changes made, feel free to make a fork.

Performance

It's written in Rust for performance; I include it in my .zshrc file, so I want it to be pretty fast. It caches the verse-of-the-day for 6 hours; this should mean it always returns a current one (most people need at least that much sleep between days), but the cache can be manually refreshed with -r, or disabled altogether with -n if it isn't wanted.

To avoid using too much filesystem space, it doesn't cache any verses other than the verse-of-the-day. If you want an app to look-up local copies of any verse, you'd be better off downloading an actual Bible app anyways.

License

The code is released under the MIT license.

Dependencies

~8–21MB
~311K SLoC