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

#1176 in Command line utilities

MIT license

175KB
2.5K SLoC

Lectio Diei Crates.io Build Status dependency status

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.

Command Example

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 readings
  • lectio-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

~41–56MB
~1M SLoC