2018-03-12 14:00:41 +00:00
|
|
|
# rodo
|
2018-04-18 04:12:32 +00:00
|
|
|
|
2018-12-11 13:54:36 +00:00
|
|
|
A simple todo list tool for people who live on the command-line
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2018-12-11 14:12:36 +00:00
|
|
|
By Jesse Laprade
|
|
|
|
|
|
|
|
## Todo
|
|
|
|
|
2018-11-12 02:56:10 +00:00
|
|
|
- [ ] Only allow quoted items to be added
|
2019-02-07 05:45:24 +00:00
|
|
|
- [ ] Add color option to config.rkt file
|
|
|
|
- [ ] Encrypt todo-list file
|
2019-02-22 20:11:18 +00:00
|
|
|
- [ ] Change default permissions of `~/.rodo` folder and `todo-list` file
|
2019-02-14 20:01:33 +00:00
|
|
|
- [ ] Add note on .bash_history about items being added here before going into the todo-list file
|
2018-11-12 02:56:10 +00:00
|
|
|
|
2018-12-11 14:12:36 +00:00
|
|
|
# Screenshot
|
2018-09-08 04:32:10 +00:00
|
|
|
|
2018-09-13 05:17:30 +00:00
|
|
|
![](screenshot.png)
|
|
|
|
|
2018-09-08 01:23:57 +00:00
|
|
|
# Table of Contents
|
|
|
|
|
|
|
|
* [Platforms](https://github.com/m455/rodo#platforms)
|
2019-01-31 14:46:14 +00:00
|
|
|
* [Requirements](https://github.com/m455/rodo#requirements)
|
2018-10-10 13:19:11 +00:00
|
|
|
* [Downloading](https://github.com/m455/rodo#downloading)
|
2018-09-08 04:07:43 +00:00
|
|
|
* [Setup](https://github.com/m455/rodo#setup)
|
2018-12-11 13:57:21 +00:00
|
|
|
* [GNU/Linux](https://github.com/m455/rodo#gnulinux)
|
2018-09-08 01:23:57 +00:00
|
|
|
* [Usage](https://github.com/m455/rodo#usage)
|
2018-12-11 13:58:48 +00:00
|
|
|
* [Usage examples](https://github.com/m455/rodo#usage-examples)
|
2018-09-08 01:23:57 +00:00
|
|
|
* [Configuration](https://github.com/m455/rodo#configuring-rodo)
|
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
# Platforms
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2019-02-14 20:09:47 +00:00
|
|
|
Below is a list of platform(s) that `rodo` is currently available for.
|
|
|
|
|
2018-05-20 02:03:00 +00:00
|
|
|
* GNU/Linux
|
2018-09-08 01:01:00 +00:00
|
|
|
|
2019-01-31 14:46:14 +00:00
|
|
|
# Requirements
|
2018-09-08 01:01:00 +00:00
|
|
|
|
2019-02-14 20:09:47 +00:00
|
|
|
Below is a list of items needed for running `rodo` on your machine.
|
|
|
|
|
2018-09-08 01:30:36 +00:00
|
|
|
* [Racket 6.x](https://racket-lang.org/)
|
2019-02-14 20:01:33 +00:00
|
|
|
* [Git](https://git-scm.com/) (Optional method for downloading using `git clone`)
|
2018-09-08 01:01:00 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
# Downloading
|
2018-07-31 02:33:48 +00:00
|
|
|
|
2019-02-14 20:09:47 +00:00
|
|
|
Currently, there are two ways to download the source code. Please choose one:
|
|
|
|
|
2019-01-24 14:15:37 +00:00
|
|
|
* Via GitHub on a web browser
|
2019-02-14 20:09:47 +00:00
|
|
|
1. Click the *Clone or download* button at the top of this page
|
2018-12-11 13:53:32 +00:00
|
|
|
2. Click *Download ZIP* from the drop-down list
|
2019-01-24 14:15:37 +00:00
|
|
|
|
2018-10-10 13:19:11 +00:00
|
|
|
* Via Git
|
2018-12-11 13:53:32 +00:00
|
|
|
* Run `git clone https://github.com/m455/rodo` on the command line
|
2018-09-08 01:31:43 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
# Setup
|
2018-09-08 01:01:00 +00:00
|
|
|
|
2019-02-14 20:09:47 +00:00
|
|
|
Follow the steps below to set up `rodo` on your platform, if available.
|
2018-10-20 01:36:52 +00:00
|
|
|
|
2018-12-11 13:57:21 +00:00
|
|
|
## GNU/Linux
|
2018-12-11 13:53:32 +00:00
|
|
|
|
2019-02-14 20:09:47 +00:00
|
|
|
Follow the steps below to add `rodo` to your `$PATH`.
|
2018-12-11 13:53:32 +00:00
|
|
|
|
2019-02-14 20:01:33 +00:00
|
|
|
### Set up a `$PATH`
|
2018-12-11 13:53:32 +00:00
|
|
|
|
2019-02-14 20:01:33 +00:00
|
|
|
Follow the steps below if you haven't set up a `$PATH`. If you have set up a `$PATH` already,
|
2019-02-14 20:09:47 +00:00
|
|
|
then skip to the next step, [Adding `rodo` to your `$PATH`](https://github.com/m455/rodo#adding-rodo-to-your-path).
|
2019-01-31 14:46:14 +00:00
|
|
|
|
|
|
|
1. Create a directory for your `$PATH` by running `mkdir ~/bin/`
|
|
|
|
2. Add your newly-created `~/bin/` to your `$PATH` by running `echo "export PATH=~/bin:\$PATH" >> .bashrc`
|
|
|
|
|
2019-02-14 20:01:33 +00:00
|
|
|
### Adding `rodo` to your `$PATH`
|
2019-01-31 14:46:14 +00:00
|
|
|
|
2019-02-14 20:09:47 +00:00
|
|
|
Follow the steps below if you have set up your `$PATH`.
|
|
|
|
|
2019-01-31 14:46:14 +00:00
|
|
|
1. Create a file in your `~/bin/` directory with the following contents in it:
|
|
|
|
|
|
|
|
```
|
|
|
|
#!/usr/bin/env bash
|
|
|
|
racket ~/path/to/rodo.rkt "$@"
|
|
|
|
```
|
|
|
|
|
2019-02-14 20:12:19 +00:00
|
|
|
Note: If you downloaded the project to your `~/downloads/` folder you would change the line
|
2019-02-14 20:01:33 +00:00
|
|
|
`racket ~/path/to/rodo.rkt "$@"` to `racket ~/downloads/rodo/rodo.rkt "$@"`.
|
2018-09-08 01:01:00 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
2. Save the file
|
2018-10-10 13:19:11 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
3. Make the file executable by running `chmod u+x ~/bin/name-of-your-file`
|
2018-11-12 02:56:10 +00:00
|
|
|
|
2019-02-14 20:12:19 +00:00
|
|
|
If you prefer to use an executable, rather than a wrapper,
|
|
|
|
you can create an executable binary file with `raco exe rodo.rkt` when in the same
|
|
|
|
folder as the `rodo.rkt` file. If you are having trouble with this please refer to Racket's documentation
|
|
|
|
regarding the [creation of standalone executables](https://docs.racket-lang.org/raco/exe.html).
|
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
# Usage
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
Type `rodo` plus one of the options below with a space
|
|
|
|
between `rodo` and the option.
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2019-02-14 20:13:32 +00:00
|
|
|
`init` - Initializes a file called `todo-list` in `~/.rodo/` by default
|
2018-09-08 04:07:43 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
`ls` - Lists items from the list
|
2018-04-18 04:04:10 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
`add` - Adds an entry to the list
|
2018-04-10 00:27:01 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
`rm` - Removes an item from the list
|
2018-04-13 06:14:51 +00:00
|
|
|
|
2018-09-15 05:06:48 +00:00
|
|
|
**Note:** You may have to run `rodo ls` to see which number corresponds to which item when removing items.
|
2018-09-08 01:01:00 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
## Usage examples
|
2018-04-10 00:27:01 +00:00
|
|
|
|
2019-02-14 20:01:33 +00:00
|
|
|
The examples below assume that you have `rodo` [set up](https://github.com/m455/rodo#set-up-a-path) in your `$PATH`
|
2018-04-18 04:12:32 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
`rodo init`
|
2018-04-13 06:14:51 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
`rodo ls`
|
2018-09-08 04:30:28 +00:00
|
|
|
|
2019-02-14 20:14:41 +00:00
|
|
|
`rodo add bread` (Single-word entry) (**Soon the use of unquoted items will be depreciated**)
|
2018-09-08 04:30:28 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
`rodo add "go to the bank"` (Multi-word entry)
|
2018-09-08 04:30:28 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
`rodo rm 1`
|
2018-04-18 04:04:10 +00:00
|
|
|
|
2019-02-14 20:09:47 +00:00
|
|
|
# Configuring `rodo`
|
2018-04-18 04:12:32 +00:00
|
|
|
|
2018-12-11 13:53:32 +00:00
|
|
|
Right now, the configurations can be found in the `config.rkt file`. Settings, such as program name, path, and directory can be changed.
|
2018-10-10 19:05:54 +00:00
|
|
|
|