Skip to content

README.md

Latest commit

 

History

History
45 lines (34 loc) · 1.5 KB

README.md

File metadata and controls

45 lines (34 loc) · 1.5 KB

ru-sh

ru-sh is a custom shell implementation written in Rust. It provides basic shell functionalities such as navigating directories, managing files, and executing commands. The shell is designed to mimic the behavior of traditional Unix shells while offering a simple and extensible codebase.

Features

  • Command Execution: Supports built-in commands like ls, cd, pwd, echo, cat, mkdir, rm, cp, mv, and clear.
  • Directory Navigation: Navigate directories using cd and view the current directory with pwd.
  • File Operations: Perform file and directory operations such as copying (cp), moving (mv), creating (mkdir), and removing (rm).
  • File Viewing: Display file contents using cat.
  • Command History: Maintains a history of executed commands, saved in ~/.rushistory.

Installation & Usage

  1. Ensure you have Rust installed.
  2. Clone the repository: 
    git clone https://github.com/heshamalmosawi/ru-sh.git
cd ru-shell

Method 1: Local Installation

  1. Build the project: 
    cargo build --release
  2. Start ru-shell locally: 
    target/release/ru-shell

Method 2: Global Installation

  1. Install the shell globally: 
    cargo install --path .
  2. Start ru-shell globally: 
    ru-shell

Once inside the shell, you can start typing commands. For example, to list files in the current directory, simply type ls and press Enter.