2018-03-12 14:00:41 +00:00
|
|
|
# rodo
|
2018-04-18 04:12:32 +00:00
|
|
|
|
2018-09-13 05:21:05 +00:00
|
|
|
A simple to-do list tool for people who live on the command-line
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2018-09-08 04:32:10 +00:00
|
|
|
By: Jesse Laprade
|
|
|
|
|
2018-09-13 05:17:30 +00:00
|
|
|
![](screenshot.png)
|
|
|
|
|
2018-09-08 01:23:57 +00:00
|
|
|
# Table of Contents
|
|
|
|
|
2018-09-08 04:07:43 +00:00
|
|
|
* [Legend](https://github.com/m455/rodo#legend)
|
2018-09-08 01:23:57 +00:00
|
|
|
* [Platforms](https://github.com/m455/rodo#platforms)
|
|
|
|
* [Requirements](https://github.com/m455/rodo#requirements)
|
|
|
|
* [Download](https://github.com/m455/rodo#download)
|
|
|
|
* [Via Browser](https://github.com/m455/rodo#via-browser)
|
2018-09-08 01:31:43 +00:00
|
|
|
* [Via Git](https://github.com/m455/rodo#via-git)
|
2018-09-08 04:07:43 +00:00
|
|
|
* [Setup](https://github.com/m455/rodo#setup)
|
2018-09-08 01:23:57 +00:00
|
|
|
* [GNU/Linux](https://github.com/m455/rodo#gnulinux)
|
2018-09-08 04:16:06 +00:00
|
|
|
* [Setup a $PATH](https://github.com/m455/rodo#setup-a-path)
|
2018-09-08 04:07:43 +00:00
|
|
|
* [Using the binary](https://github.com/m455/rodo#using-the-binary)
|
|
|
|
* [Creating a wrapper](https://github.com/m455/rodo#creating-a-wrapper)
|
2018-09-08 01:23:57 +00:00
|
|
|
* [Usage](https://github.com/m455/rodo#usage)
|
2018-09-08 04:30:28 +00:00
|
|
|
* [Examples](https://github.com/m455/rodo#examples)
|
2018-09-08 01:23:57 +00:00
|
|
|
* [Configuration](https://github.com/m455/rodo#configuring-rodo)
|
|
|
|
|
2018-09-08 04:07:43 +00:00
|
|
|
## Legend
|
|
|
|
|
2018-09-15 05:18:16 +00:00
|
|
|
`Items marked like this` are either instructions for running on the command line or code. Do not include the initial `$` when running them.
|
2018-09-08 04:15:21 +00:00
|
|
|
|
2018-09-15 05:18:16 +00:00
|
|
|
**Items marked like this** are important.
|
2018-09-08 04:07:43 +00:00
|
|
|
|
2018-09-08 01:01:00 +00:00
|
|
|
## Platforms
|
2018-05-20 02:03:00 +00:00
|
|
|
|
|
|
|
* GNU/Linux
|
2018-09-08 01:01:00 +00:00
|
|
|
|
|
|
|
## Requirements
|
|
|
|
|
2018-09-08 01:30:36 +00:00
|
|
|
* [Racket 6.x](https://racket-lang.org/)
|
|
|
|
* [Git (Optional)](https://git-scm.com/)
|
2018-09-08 01:01:00 +00:00
|
|
|
|
|
|
|
## Download
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2018-09-08 01:23:57 +00:00
|
|
|
### Via Browser
|
2018-07-31 02:33:48 +00:00
|
|
|
|
2018-09-08 01:34:04 +00:00
|
|
|
Download this repository by clicking the **Clone or download** button at the top right and then choosing **Download ZIP** from the drop-down list
|
2018-07-31 02:33:48 +00:00
|
|
|
|
2018-09-08 01:31:43 +00:00
|
|
|
### Via Git
|
|
|
|
|
|
|
|
Run `git clone https://github.com/m455/rodo` at the command line if you use Git
|
|
|
|
|
2018-09-08 01:23:57 +00:00
|
|
|
## Setup
|
2018-09-08 01:01:00 +00:00
|
|
|
|
|
|
|
### GNU/Linux
|
|
|
|
|
2018-09-08 04:07:43 +00:00
|
|
|
#### Setup a $PATH
|
|
|
|
|
2018-09-15 05:18:16 +00:00
|
|
|
1. Create a directory for your `$PATH` by running `mkdir ~/bin/`
|
2018-09-08 04:07:43 +00:00
|
|
|
|
2018-09-15 05:18:16 +00:00
|
|
|
2. Associate your `$PATH` with the ~/bin/ folder you created by running `echo "export PATH=~/bin:\$PATH" >> .bashrc`
|
2018-07-31 02:33:48 +00:00
|
|
|
|
2018-09-08 04:07:43 +00:00
|
|
|
#### Using the binary
|
2018-07-31 02:33:48 +00:00
|
|
|
|
2018-09-15 05:18:16 +00:00
|
|
|
1. Copy the rodo binary file to your `$PATH` folder by running `cp /path/to/rodo ~/bin/`
|
2018-07-31 02:33:48 +00:00
|
|
|
|
2018-09-15 05:18:16 +00:00
|
|
|
2. Make the rodo binary file executable by running `chmod u+x ~/bin/rodo`
|
2018-07-31 02:33:48 +00:00
|
|
|
|
2018-09-08 04:07:43 +00:00
|
|
|
#### Creating a wrapper
|
|
|
|
|
2018-09-15 05:18:16 +00:00
|
|
|
1. Create an empty wrapper file by running `touch ~/bin/rodo`.
|
2018-09-15 05:06:48 +00:00
|
|
|
|
|
|
|
2. Add the following contents show below to it
|
2018-05-20 02:03:00 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
#!/usr/bin/env bash
|
|
|
|
racket ~/path/to/rodo.rkt "$@"
|
|
|
|
```
|
2018-09-15 05:06:48 +00:00
|
|
|
3. Save the file
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2018-09-15 05:18:16 +00:00
|
|
|
For example, if you downloaded the project to your ~/downloads/ folder you would change the line
|
2018-09-08 04:07:43 +00:00
|
|
|
|
2018-09-15 05:18:16 +00:00
|
|
|
`racket ~/path/to/rodo.rkt "$@"`
|
|
|
|
|
|
|
|
to
|
|
|
|
|
|
|
|
`racket ~/downloads/rodo/rodo.rkt "$@"`
|
|
|
|
|
|
|
|
2. Make the rodo wrapper file executable by running`chmod u+x ~/bin/rodo`
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2018-05-20 02:09:18 +00:00
|
|
|
## Usage
|
2018-05-20 02:03:00 +00:00
|
|
|
|
2018-09-15 05:18:16 +00:00
|
|
|
init - Initializes a file in ~/.rodo/todo-list by default
|
2018-09-08 04:07:43 +00:00
|
|
|
|
2018-09-08 04:30:28 +00:00
|
|
|
ls - Lists items from the list
|
2018-04-18 04:04:10 +00:00
|
|
|
|
2018-09-08 04:30:28 +00:00
|
|
|
add - Adds an entry to the list
|
2018-04-10 00:27:01 +00:00
|
|
|
|
2018-09-08 04:30:28 +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-09-08 04:30:28 +00:00
|
|
|
## Examples
|
2018-04-10 00:27:01 +00:00
|
|
|
|
2018-09-15 05:18:16 +00:00
|
|
|
The examples below assume that you have rodo [set up](https://github.com/m455/rodo#setup-a-path) in your `$PATH`
|
2018-04-18 04:12:32 +00:00
|
|
|
|
2018-09-08 04:30:28 +00:00
|
|
|
init - `rodo init`
|
2018-04-13 06:14:51 +00:00
|
|
|
|
2018-09-08 04:30:28 +00:00
|
|
|
ls - `rodo ls`
|
|
|
|
|
|
|
|
add (Single-word entry) - `rodo add bread`
|
|
|
|
|
|
|
|
add (Multi-word entry) - `rodo add "go to the bank"`
|
|
|
|
|
|
|
|
rm - `rodo rm 1`
|
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-09-15 05:18:16 +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.
|