├── README.md
├── internals
    ├── echo_in_red
    ├── show_todo
    └── to_todo_history_file
├── todo
├── todone
└── todos_completed


/README.md:
--------------------------------------------------------------------------------
 1 | Two tiny programs, `todo` and `todone`. I like to alias them to `t` and `d`.
 2 | 
 3 | One bonus program, `todos_completed`, to see how much you've accomplished!
 4 | 
 5 | # Usage #
 6 | 
 7 | Here's an example usage with the aliases:
 8 | 
 9 | ```bash
10 | $ t feed the plants
11 | 1. feed the plants
12 | $ t water the cat
13 | 1. feed the plants
14 | 2. water the cat
15 | $ t
16 | 1. feed the plants
17 | 2. water the cat
18 | $ t brush the cat
19 | 1. feed the plants
20 | 2. water the cat
21 | 3. brush the cat
22 | $ d cat
23 | !! multiple matches !!
24 | 2. water the cat
25 | 3. brush the cat
26 | $ d brush
27 | 1. feed the plants
28 | 2. water the cat
29 | $ d 1
30 | 1. water the cat
31 | $ tail -5 $TODOHISTORY
32 | + feed the plants; Wed Mar 20 23:49:37 EDT 2013
33 | + water the cat; Wed Mar 20 23:49:39 EDT 2013
34 | + brush the cat; Wed Mar 20 23:49:54 EDT 2013
35 | - brush the cat; Wed Mar 20 23:50:37 EDT 2013
36 | - feed the plants; Wed Mar 20 23:50:39 EDT 2013
37 | $ todos_completed -1hour
38 | √ brush the cat
39 | √ feed the plants
40 | ```
41 | 
42 | The lists are just plain text files, so it's easy to open them up and edit them
43 | by hand whenever that's necessary.
44 | 
45 | # Installation #
46 | 
47 | Clone the repo somewhere on your `$PATH`, like maybe `~/bin` if you use that:
48 | 
49 | ```bash
50 | git clone git@github.com:mattjj/todo-bash.git ~/bin/todo
51 | ```
52 | 
53 | These programs require an environment variable `TODOFILE` be set to a path at
54 | which the todo list will be stored as a plain text file. There are also a
55 | couple optional variables. You might add something like this to your `.bashrc`
56 | or `.zshrc`:
57 | 
58 | ```bash
59 | export TODOFILE=~/Dropbox/todo/todo
60 | export TODOHISTORY=~/Dropbox/todo/todo-history
61 | alias t=todo
62 | alias d=todone
63 | ```
64 | 
65 | or this to your `config.fish`:
66 | 
67 | ```csh
68 | set -x TODOFILE ~/Dropbox/todo/todo
69 | set -x TODOHISTORY ~/Dropbox/todo/todo-history
70 | alias t=todo
71 | alias d=todone
72 | ```
73 | 


--------------------------------------------------------------------------------
/internals/echo_in_red:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 | 
3 | echo -en "\033[1;31m"
4 | echo "$@"
5 | echo -en "\033[m"
6 | 


--------------------------------------------------------------------------------
/internals/show_todo:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | if [ -z "$TODOFILE" ]
 4 | then
 5 |     echo_in_red "environment variable TODOFILE not set"
 6 |     exit 1
 7 | else
 8 |     awk '{print NR". " $0}' <$TODOFILE
 9 | fi
10 | 


--------------------------------------------------------------------------------
/internals/to_todo_history_file:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 | 
3 | if [ -n "$TODOHISTORY" ]
4 | then
5 |     cat >> $TODOHISTORY # is this 'cat' avoidable? exec doesn't work...
6 | fi
7 | 


--------------------------------------------------------------------------------
/todo:
--------------------------------------------------------------------------------
 1 | #!/bin/bash -e
 2 | 
 3 | codedir="$( cd "$( dirname $( readlink "${BASH_SOURCE[0]}" ) )" && pwd )"
 4 | PATH="$codedir/internals/:$PATH"
 5 | 
 6 | usage()
 7 | {
 8 | command=${0##*/}
 9 | cat <<EOF
10 | usage: $command [a] [task] [name]
11 | Examples:
12 |     $command
13 |     $command feed the cat
14 | EOF
15 | }
16 | 
17 | if [[ -z "$TODOFILE" ]]
18 | then
19 |     echo_in_red "environment variable TODOFILE must be set"
20 |     exit 1
21 | elif [[ $# -eq 1 && ( "$1" = '-h' || "$1" = '--help' ) ]]
22 | then
23 |     usage
24 |     exit 0
25 | else
26 |     touch "$TODOFILE"
27 |     if [[ $# -eq 0 ]]
28 |     then
29 |         show_todo
30 |     else
31 |         if grep "$*$" "$TODOFILE"
32 |         then
33 |             echo_in_red '!! exact duplicate !!'
34 |             show_todo | grep --color=always "$*"
35 |         else
36 |             echo "$*" >> "$TODOFILE"
37 |             echo "+ $*; $(date)" | to_todo_history_file
38 |             show_todo
39 |         fi
40 |     fi
41 | fi
42 | 


--------------------------------------------------------------------------------
/todone:
--------------------------------------------------------------------------------
 1 | #!/bin/bash -e
 2 | 
 3 | codedir="$(cd "$(dirname $(readlink "${BASH_SOURCE[0]}"))" && pwd)"
 4 | PATH="$codedir/internals/:$PATH"
 5 | 
 6 | usage()
 7 | {
 8 | command=${0##*/}
 9 | cat <<EOF
10 | usage: $command number-or-pattern
11 | Examples:
12 |     $command 3
13 |     $command do math
14 | EOF
15 | }
16 | 
17 | if [ -z "$TODOFILE" ]
18 | then
19 |     echo_in_red "environment variable TODOFILE not set"
20 |     exit 1
21 | elif [[ $# -eq 0 || "$1" = '--help' ]]
22 | then
23 |     usage
24 |     exit 0
25 | else
26 |     touch "$TODOFILE"
27 |     if [[ "$*" =~ ^[0-9]+$ ]]
28 |     then
29 |         match=$(sed -n "${1}p" $TODOFILE)
30 |         line_number=${1}
31 |     else
32 |         match=$(grep --color=never "$*" $TODOFILE)
33 |         num_matches=$(echo "$match" | wc -l)
34 |         if [[ $num_matches -eq 0 ]]
35 |         then
36 |             echo_in_red "!! no matches !!"
37 |             exit 1
38 |         elif [[ $num_matches -gt 1 ]]
39 |         then
40 |             echo_in_red "!! multiple matches !!"
41 |             show_todo | grep --color=always "$*"
42 |             exit 1
43 |         else
44 |             line_number=$(grep --color=never -n "$*" $TODOFILE | cut -d: -f1)
45 |         fi
46 |     fi
47 | 
48 |     echo "- $match; $(date)" | to_todo_history_file
49 |     sed -i "${line_number}d" $TODOFILE
50 | 
51 |     show_todo
52 | fi
53 | 


--------------------------------------------------------------------------------
/todos_completed:
--------------------------------------------------------------------------------
 1 | #!/bin/bash -e
 2 | 
 3 | usage() {
 4 | command=${0##*/}
 5 | cat <<EOF
 6 | usage: $command [since-datestring]
 7 | Examples:
 8 |     $command
 9 |     $command -1day
10 |     $command -6hours
11 | EOF
12 | }
13 | 
14 | if [[ -z "$TODOHISTORY" || ! -f "$TODOHISTORY" ]]
15 | then
16 |     echo_in_red "${0##*/} requires a TODOHISTORY file"
17 |     exit 1
18 | elif [[ $# -gt 1 || "$1" = '--help' ]]
19 | then
20 |     usage
21 |     exit 0
22 | else
23 |     if [[ $# -eq 1 ]]
24 |     then
25 |         since=$1
26 |     else
27 |         since='-1day'
28 |     fi
29 | 
30 |     sincefile=$(mktemp)
31 |     testfile=$(mktemp)
32 | 
33 |     touch -d "$since" $sincefile
34 |     (IFS=$'\n'; for l in $(tail -n 25 "$TODOHISTORY" | grep '^-')
35 |     do
36 |         touch -d "$(echo $l | cut -d";" -f2)" $testfile
37 |         if [[ $testfile -nt $sincefile ]]
38 |         then
39 |             echo "$l" | cut -d";" -f1 | sed 's/^- /√ /'
40 |         fi
41 |     done)
42 | 
43 |     rm -f $sincefile $testfile
44 | fi
45 | 


--------------------------------------------------------------------------------