Lib.rs

› Science | Command line utilities
#hungarian #client #kreta

app rsfilc

An E-Kréta console client: cli and todo!("TUI"), written entirely in Rust from the ground up

Owned by JeromeSchmied.

23 releases

0.9.44 Mar 17, 2025
0.9.30 Feb 24, 2025
0.8.14 Jun 12, 2024

#4 in Science

Download history 122/week @ 2024-12-04 127/week @ 2024-12-11 15/week @ 2024-12-18 3/week @ 2024-12-25 28/week @ 2025-01-01 19/week @ 2025-01-08 114/week @ 2025-01-29 10/week @ 2025-02-05 124/week @ 2025-02-12 104/week @ 2025-02-19 52/week @ 2025-02-26 221/week @ 2025-03-12 41/week @ 2025-03-19

351 downloads per month

MIT license

1MB
2.5K SLoC

RozsdásFilc: E-Kréta console client in Rust

E-Kréta is an awful Hungarian electronic school administration system

Magyar leírás

dependency status

Installation

  • EZ mode: grab a prebuilt binary from releases

if not available for your platform (file an issue), not a preferred method or feels a bit outdated:

  • Rust
  • cargo install --locked rsfilc

for latest, beta builds: cargo install --locked --git "https://codeberg.org/jark/rsfilc"

Shell completions:

Bash

Add this to the end of your config file (usually ~/.bashrc):

eval "$(rsfilc completions bash)"
Zsh

Add this to the end of your config file (usually ~/.zshrc):

eval "$(rsfilc completions zsh)"

For completions to work, the above line must be added after compcompletions is called. You may have to rebuild your completions cache by running rm ~/.zcompdump*; compcompletions.

Fish

Add this to the end of your config file (usually ~/.config/fish/config.fish):

rsfilc completions fish | source
PowerShell

Add this to the end of your config file (find it by running echo $profile in PowerShell):

Invoke-Expression (& { (rsfilc completions powershell | Out-String) })
Elvish

Add this to the end of your config file (usually ~/.elvish/rc.elv):

eval (rsfilc completions elvish | slurp)

Note RsFilc only supports elvish v0.18.0 and above.

Usage

general help: rsfilc --help
creating a new user: rsfilc user --create <USER_ID>

useful stuff

  • when in doubt, be sure to check rsfilc --help first
  • if you'd like to have instant replies, only loading cached data, not caring about latest changes on the server, you shall try setting the environment variable NO_NET to 1, eg. on linux: NO_NET=1 rsfilc timetable
  • if you feel like refreshing your cache, you'd do (again on linux): NO_CACHE=1 rsfilc absences, but don't forget rsfilc user --cache-dir either

demo

Features

cross-platform: not tested thoroughly but should run on

  • linux
  • windows
  • macOS
  • android via Termux
  • everything else that Rust supports

CLI

  • basic usage of API
  • filtering what to show
  • multi-user feature
  • somehow rendering html that messages return
  • render html messages with w3m or lynx if possible
  • shell completions: [bash, zsh, fish, elvish, powershell]
  • logger: fern maybe
  • helpful crashes
  • caching everything so that life remains enjoyable
    • token
    • timetable
    • evals
    • user info
    • absences
    • announced tests
    • messages
    • note messages
  • encoding passwords
  • sending messages
  • class averages
  • fetching administrational processes
  • starting new administrational processes

TUI

  • multiple pages

    • evaluations
    • timetable
    • ...

  • beautifully displaying data

    • timetable in nice table
    • plotting evaluations
    • ...

Acknowledgements

  • dependencies used (although many of them wouldn't be necessary with a proper API, this is not the case with e-kréta.)
  • See ekreta-rs, which provides the API client for E-Kréta
  • Shell completions section got from zoxide

Dependencies

~9–21MB
~231K SLoC