rlrn

CLI tool for learning Rust effectively


Keywords
cli, quiz, learning, spaced-repetition, srs
License
MIT

Documentation

Contributors Forks Stargazers Issues MIT License

rlrn

An awesome CLI tool for effectively learning Rust and more

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License

About The Project

ReLeaRN or rlrn is a CLI tool, allowing Rustaceans to learn, improve and maintain their Rust skills! rlrn uses simple quizzes combined with a Spaced Repitition engine to help you find and overcome with Rust weakspots and improve your software engineering skills.

rlrn gamifies learning Rust and brings your friends and colleagues together in your daily learning, with badges (as NFTs), progress bars, and leaderboards (both public and company/clan) among other features.

Built With

ReLeaRN is built with Rust end-to-end, and uses Open Source Rust libraries to create an interface to the engine.

Getting Started

Prerequisites

  • You should have a Unix-like OS (Linux, macOS, Windows with WSL only)
  • You should have rust and cargo installed on your computer
  • rlrn CLI currently only supports bash and zsh. Please make sure you use one of these
  • For building server crate you might need install pkg-config (sudo apt install pkg-config)

Installation

  1. Install cargo crate
    cargo install rlrn
  2. Initialize app to see quiz when you open new terminal
    rlrn init
  3. Set your daily goal and reminder interval Settings

Usage

According to the set daily goals and reminder interval, you will see the question of the quiz the next time you open a new tab of the terminal.

Quiz question example

If you want to participate in the quiz without waiting for the next reminder, you can call the quiz question at any time with a simple command:

rlrn

Roadmap

rlrn can be used as engine with any kind of learning, including non-programming topics such medical exams, driving exams and tests etc.

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.