Skip to content

Commit

Permalink
(master) update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
MrPicklePinosaur committed Mar 2, 2023
1 parent 227c17a commit ae7ce85
Show file tree
Hide file tree
Showing 3 changed files with 28 additions and 20 deletions.
39 changes: 19 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,34 +5,33 @@

rust library to build your own shell

[![book](https://img.shields.io/badge/book-website-orange)](#)
[![MIT/Apache 2.0](https://img.shields.io/badge/license-MIT%2FApache-blue.svg)](#)

</div>
<!-- [![build](https://github.com/MrPicklePinosaur/shrs/workflows/Deploy/badge.svg)](https://github.com/MrPicklePinosaur/shrs/actions) -->

## PROJECT GOALS

- **hackable**: almost every aspect of the shell should be easily customizable and extendable
- **productive**: shell should encourage and facilitate an efficient workflow
- **rusty**: implemented in rust down to the syscall level (rustix) and configurable in rust

## TOOD

- [x] pipes
- [x] file redirection
- [ ] configuration scheme (config file? builder pattern?)
- [ ] better logging + error reporting (different ways of displaying exit status)
- [x] background process + job control (&)
- [ ] environment variables
- [x] subshells
- [ ] signals (^C, ^\, ^Z etc)
- [ ] completion
- [ ] history
- [ ] alias
- [ ] test suite to ensure posix compliant
- [ ] control flow
- [ ] for
- [ ] case
- [x] if
- [x] while
- [x] until
## FEATURES

Project is currently very much VIP, below lists the current feature statuses:

| Feature | Status |
| --- | --- |
| posix shell | wip |
| history | mvp |
| aliases | mvp |
| completion | mvp |
| readline | using reedline |
| hooks | TODO |
| keybindings | TODO |
| syntax highlighting | TODO |
| shell scripts | TODO |

## RESOURCES

Expand Down
5 changes: 5 additions & 0 deletions design/lang.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@

# Custom Shell Language Design Document

goal 0: investigate if posix shell command language should be kept or if a custom one should be used
goal 1: design a (possibly non-posix) shell grammar
4 changes: 4 additions & 0 deletions design/readline.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@

# Readline implementation design doc

Goal: provide a comprehensive readline implementation that is extensible and configurable

0 comments on commit ae7ce85

Please sign in to comment.