shrs

Crates.ioshrs
lib.rsshrs
version0.0.6
sourcesrc
created_at2023-06-03 09:12:07.488553
updated_at2024-06-01 04:53:15.515038
descriptionmodular library to build your own shell in rust
homepagehttps://mrpicklepinosaur.github.io/shrs/
repositoryhttps://github.com/MrPicklePinosaur/shrs
max_upload_size
id881493
size70,475
Daniel Liu (MrPicklePinosaur)

documentation

README

sh.rs

The rusty shell toolkit for hackers

crates.io Doc book MIT/Apache 2.0 Discord

PROJECT GOALS

  • hackable: almost every aspect of the shell should be easily customizable and extendable
  • developer friendly: well documented and easy to contribute to
  • rusty: implemented in and configurable in rust

FEATURES

DISCLAIMER: shrs is currently very much a work in progress, the API is subject to change frequently and things are prone to breaking. It currently may not be suitable for daily use, but is great for prototyping any experimental shell features you dream up with!

Here are what makes shrs special:

  • Completely configurable in rust (including your prompt, completions and more!)
  • Plugin system (community maintained plugins that add unique features)

GETTING STARTED

To get a taste of what shrs is capable of, without any configuration, you can run the example shrs_example shell that is bundled by running:

git clone https://github.com/MrPicklePinosaur/shrs.git
cd ./shrs/shrs_example
cargo run

To get started with building your own shell, it's as easy as creating a new cargo project with:

use shrs::prelude::*;

fn main() {
    let myshell = ShellBuilder::default()
        .build()
        .unwrap();

    myshell.run();
}

See the developer documentation for more in depth information.

CONTRIBUTING

If you encounter and bugs are have any feature requests, please don't hesitate to leave an issue! Also take a look at the section for contributors in the documentation.

COMMUNITY PLUGINS

List of cool 3rd part plugins and community built shells can be found in awesome_shrs. Some notable examples includes

Commit count: 440

cargo fmt