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

app votd

A command-line tool to lookup Bible verses

6 releases (stable)

1.0.4 Oct 23, 2023
1.0.3 Jul 25, 2023
1.0.1 Jul 16, 2023
1.0.0 Jul 11, 2023
0.1.0 Jul 11, 2023

#1040 in Command line utilities

48 downloads per month

MIT license

15KB
178 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

~9–24MB
~370K SLoC