8 releases
0.3.1 | Aug 10, 2024 |
---|---|
0.3.0 | Jul 28, 2024 |
0.2.2 | Jul 25, 2024 |
0.1.2 | Jul 14, 2024 |
#1136 in Command line utilities
137 downloads per month
175KB
2.5K
SLoC
Lectio Diei
![dependency status](https://img.gs/czjpqfbdkz/full/https://deps.rs/repo/github/Squidroot2/lectio-diei/status.svg)
CLI application for retrieving, storing, and displaying the daily Catholic readings. Retrieved from the United States Conference of Catholic Bishops site. After being retrieved, the readings are stored in a local sqlite database. This way, they can be displayed on-demand with low latency.
While the core functionality is present, this is still pre-release software. Command line interface is subject to change.
Compatibility
For now, only Linux is supported. The current issue is that the paths for the database, log, and config file follows the XDG specification which MacOS and Windows do not follow. I do have plans to address this.
Installation
lectio-diei
can be installed from crates.io using cargo
Prerequisites
- Install the Rust toolchain
- Add ~/.cargo/bin to your PATH environment variable
Install with Cargo
cargo install lectio-diei --locked
After the install command completes, the lectio-diei binary will then be installed at ~/.cargo/bin. Since this is in your PATH, you should be able to execute the application with:
lectio-diei display
Usage
The most basic usage involves two commands:
lectio-diei db refresh
- Updates your database with readings, deleting old readingslectio-diei display
- Displays the readings for today
More options can be seen by simply running lectio-diei
Configuration
After running any valid command at least once, you should have a config file at ~/.config/lectio-diei/config.toml. Edit this file to change number of entries stored, or default display options.
Plans for 1.0
- Colors and formatting options for the Readings
- Configurable line wrapping
- Configurable colors for each reading
- Improved heading formatting
- Adding the Alleluia as an option
- Config options from commandline
- Show
- Change
- Windows support (maybe others?)
- Store single day without displaying
- No database mode
- Database-only mode (Don't retrieve from web if you don't already have it)
- Additional logging options
- Formalized and documented error codes
And maybe more...
License
Licensed under the MIT license LICENSE
Dependencies
~40–55MB
~1M SLoC