2018-03-12 14:00:41 +00:00
|
|
|
# rodo
|
2018-04-18 04:12:32 +00:00
|
|
|
|
2018-07-30 01:27:21 +00:00
|
|
|
An easy-to-use todo list program for people who live on the command line written in Racket.
|
2018-05-20 02:03:00 +00:00
|
|
|
|
|
|
|
### Requirements
|
|
|
|
|
|
|
|
* GNU/Linux
|
|
|
|
* Racket 6.x
|
|
|
|
|
2018-05-20 02:09:18 +00:00
|
|
|
### Setting up rodo
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2018-07-30 01:27:21 +00:00
|
|
|
Download rodo by running:
|
2018-05-20 02:03:00 +00:00
|
|
|
|
|
|
|
`git clone https://github.com/m455/rodo`
|
|
|
|
|
2018-07-30 01:27:21 +00:00
|
|
|
Create a $PATH if you haven't done so already by running:
|
|
|
|
|
|
|
|
`echo "export PATH=~/bin:\$PATH" >> .bashrc`
|
|
|
|
|
|
|
|
Make the actual directory for your `$PATH`:
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2018-07-30 01:27:21 +00:00
|
|
|
`mkdir ~/bin/`
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2018-07-30 01:27:21 +00:00
|
|
|
Create a file called `rodo` in your $PATH (in your ~/bin/ folder if you followed the instructions above) and add the
|
2018-05-20 02:04:18 +00:00
|
|
|
following contents to it:
|
2018-05-20 02:03:00 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
#!/usr/bin/env bash
|
|
|
|
racket ~/path/to/rodo.rkt "$@"
|
|
|
|
```
|
2018-05-20 02:05:34 +00:00
|
|
|
For example, if you `git clone`d the project to your
|
|
|
|
`~/downloads/` folder you would change the line:
|
|
|
|
|
|
|
|
`racket ~/path/to/rodo.rkt "$@"`
|
|
|
|
|
|
|
|
to
|
|
|
|
|
2018-05-20 02:06:07 +00:00
|
|
|
`racket ~/downloads/rodo/rodo.rkt "$@"`
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2018-07-29 13:55:23 +00:00
|
|
|
Make the `rodo` file executable:
|
2018-05-20 02:03:00 +00:00
|
|
|
|
|
|
|
`chmod u+x rodo`
|
|
|
|
|
2018-05-20 02:09:18 +00:00
|
|
|
## Usage
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2018-05-20 02:17:25 +00:00
|
|
|
The below examples assume that you have rodo set up in your
|
|
|
|
$PATH folder. If you don't, you would simply go to the
|
|
|
|
directory of the `rodo.rkt` file and use `./rodo <command>`
|
|
|
|
instead.
|
|
|
|
|
2018-07-30 18:57:00 +00:00
|
|
|
### init
|
2018-04-18 04:12:32 +00:00
|
|
|
|
2018-05-20 02:17:25 +00:00
|
|
|
Initializes a file in `~/.rodo/todo-list` by default
|
2018-04-18 04:04:10 +00:00
|
|
|
|
2018-05-20 02:17:25 +00:00
|
|
|
**Example:** `rodo init`
|
2018-04-10 00:27:01 +00:00
|
|
|
|
2018-07-30 18:57:00 +00:00
|
|
|
### ls
|
2018-04-18 04:12:32 +00:00
|
|
|
|
2018-04-18 04:04:10 +00:00
|
|
|
Lists items from the list
|
|
|
|
|
2018-05-20 02:17:25 +00:00
|
|
|
**Example:** `rodo rm 1`
|
2018-04-13 06:14:51 +00:00
|
|
|
|
2018-07-30 18:57:00 +00:00
|
|
|
### add
|
2018-04-18 04:12:32 +00:00
|
|
|
|
2018-04-18 04:04:10 +00:00
|
|
|
Adds an item to the list
|
2018-04-13 06:14:51 +00:00
|
|
|
|
2018-05-20 02:17:25 +00:00
|
|
|
**Example:** `rodo add bread`
|
2018-04-17 03:05:18 +00:00
|
|
|
|
2018-04-18 04:12:32 +00:00
|
|
|
**Note:** For multi-word items you will need to surround your item in double quotes like this:
|
2018-04-18 04:04:10 +00:00
|
|
|
`$ rodo add "go to the bank"`
|
2018-04-10 00:27:01 +00:00
|
|
|
|
2018-07-30 18:57:00 +00:00
|
|
|
### rm
|
2018-04-18 04:12:32 +00:00
|
|
|
|
2018-04-18 04:04:10 +00:00
|
|
|
Removes an item from the list
|
2018-04-13 06:14:51 +00:00
|
|
|
|
2018-05-20 02:17:25 +00:00
|
|
|
**Example:** `rodo rm 1`
|
2018-04-13 06:14:51 +00:00
|
|
|
|
2018-04-18 04:12:32 +00:00
|
|
|
**Note:** You may have to run `rodo ls` to see which number corresponds to which item to remove it.
|
2018-04-18 04:04:10 +00:00
|
|
|
|
2018-05-20 02:17:25 +00:00
|
|
|
## Configuring rodo
|
2018-04-18 04:12:32 +00:00
|
|
|
|
2018-04-18 04:04:10 +00:00
|
|
|
Right now, the configurations can be found in the `config.rkt` file. Settings such at program name, path, and directory can be set here.
|