rodo/README.md

rodo

An easy-to-use todo list program for people who live on the command line written in Racket

Table of Contents

• Legend
• Platforms
• Requirements
• Download
  • Via Browser
  • Via Git
• Setup
  • GNU/Linux
    • Setup a $PATH
    • Using the binary
    • Creating a wrapper
  • Windows
  • Mac
• Usage
• Examples
• Configuration

Legend

Items marked like this are instructions for running on the command line

Items marked like this are keywords, buttons, variables or specific files/folders

Platforms

• GNU/Linux
• Microsoft Windows
• OS X

Requirements

• Racket 6.x
• Git (Optional)

Download

Via Browser

Download this repository by clicking the Clone or download button at the top right and then choosing Download ZIP from the drop-down list

Via Git

Run git clone https://github.com/m455/rodo at the command line if you use Git

Setup

GNU/Linux

Setup a $PATH

1. Create a directory for your $PATH by running mkdir ~/bin/

2. Associate your $PATH with the ~/bin/ folder you created by running echo "export PATH=~/bin:\$PATH" >> .bashrc

Using the binary

1. Copy the rodo binary file to your $PATH folder by running cp /path/to/rodo ~/bin/

2. Make sure the rodo binary file is executable by running chmod u+x ~/bin/rodo

Creating a wrapper

1. Create an empty wrapper file by running touch ~/bin/rodo and then add the following contents to it and save:

#!/usr/bin/env bash
racket ~/path/to/rodo.rkt "$@"

Example: if you downloaded the project to your ~/downloads/ folder you would change the line racket ~/path/to/rodo.rkt "@"** to **racket ~/downloads/rodo/rodo.rkt "@"

2. Make the rodo wrapper file executable by runningchmod u+x ~/bin/rodo

Windows

To do

Mac

To do

Usage

init - Initializes a file in ~/.rodo/todo-list by default

ls - Lists items from the list

add - Adds an entry to the list

rm - Removes an item from the list

Note: You may have to run rodo ls to see which number corresponds to which item to remove it

Examples

The below examples assume that you have rodo set up in your $PATH folder

init - rodo init

ls - rodo ls

add (Single-word entry) - rodo add bread

add (Multi-word entry) - rodo add "go to the bank"

rm - rodo rm 1

Configuring rodo

Right now, the configurations can be found in the config.rkt file. Settings such at program name, path and directory can be set here.