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

• Platforms
• Requirements
• Download
  • Via Browser
  • Via Git
• Setup
  • GNU/Linux
    • Using the executable binary
    • Using and creating a wrapper
  • Windows
  • Mac
• Usage
  • init
  • ls
  • add
    • Adding a single-word entry
    • Adding a multi-word entry
  • rm
• Configuration

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

Using the executable binary

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 by running mkdir ~/bin/

Add the rodo binary to your $PATH folder (in your ~/bin/ folder if you followed the instructions above) and make sure it's executable by running chmod u+x ~/bin/rodo

Using and creating a wrapper

Create a file called rodo in your $PATH folder (in your ~/bin/ folder if you followed the instructions above) by running touch ~/bin/rodo and then add the following contents to it:

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

For 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 "$@"

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

Windows

Instructions coming soon

Mac

Instructions coming soon

Usage

The below examples assume that you have rodo set up in your $PATH folder. If you don't, you would navigate to the directory of the rodo.rkt file and use ./rodo.rkt <command> if the rodo.rkt is executable or racket rodo.rkt <command> if it is not.

init

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

Example: rodo init

ls

Lists items from the list

Example: rodo ls

add

Adds an entry to the list

Adding a single-word entry

Example: rodo add bread

Adding a multi-word entry

Example: rodo add "go to the bank"

rm

Removes an item from the list

Example: rodo rm 1

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

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.