clock.sh

#!/bin/bash

function clock() {
    read -r -d '' USAGE <<EOF
clock task timer v0.0.1
usage: clock <command> [<task>] [<options>]

Track your working times using file system directories as
task identifiers.

commands:
  help          show this help
  in            clock in, will clock out any running task
  out           clock out
  log           show all log entries, or log entries for <task>
  list          show sums for all tasks
  completion    print completion script

task:
  if no task is specified, the current working directory
  will be used as task specifier

options:
  -m|--message=MSG  record additional message when clocking in/out
  -f|--file=FILE    where to save the clocks, defaults to $HOME/.clocks
     --by-task      sort log entries by task for clock log
     --gt=DATE      show only log entries after DATE
                    summarize only entries after DATE for list view
     --lt=DATE      show only log entries before DATE
                    summarize only entries before DATE for list view

EOF

    read -r -d '' COMPLETION <<EOF
_clock()
{
    local cur prev opts
    COMPREPLY=()
    cur="\$COMP_WORDS[COMP_CWORD]"
    prev="\$COMP_WORDS[COMP_CWORD-1]"

    case "\$prev" in
        "in")
            local opts=\$(clock tasks)
            COMPREPLY=( \$(compgen -W "\$opts" -- \$cur) )
            return 0 
            ;;
        *)
            local opts="in out help log list completion"
            COMPREPLY=( \$(compgen -W "\$opts" -- \$cur) )
            return 0
        ;;
    esac
    return 0 
}
complete -F _clock clock
EOF


    # set defaults
    now="$(date +%s)"
    file="$HOME/.clock"
    command=""
    task=""
    message=""
    before=""
    after=""
    taskSet=false

    # parse command line parameters
    while [[ $# -gt 0 ]]
    do
        key="$1"
        case $key in
            --by-task)
                sortByTask=true
                shift
                ;;
            -m|--message)      # set clock in/out message
                message="$2"
                shift
                shift
                ;;
            -f|--file)         # set logfile location
                file="$2"
                shift
                shift
                ;;
            --gt)              # set min date
                after=$(eval "date --date='$2' +%s")
                shift
                shift
                ;;
            --lt)
                before=$(eval "date --date='$2' +%s")
                shift
                shift
                ;;
            *)                 # set command or task
                if [[ -z $command ]]
                then
                    command="$1"
                    shift
                elif [[ -z $task ]]
                then
                    task=$(readlink -e "$1")
                    if [[ -z $task ]]
                    then
                        task="$1"
                    fi
                    taskSet=true
                    shift
                else
                    echo "Don't know what to do with the argument $1"
                    exit 1
                fi
                ;;
        esac
    done

    # default task is current working directory
    if [[ -z $task ]]
    then
        task="$(pwd)"
    fi

    function clockOut() {
        # find currently clocked in task
        if [[ -f $file ]]
        then
            cur=$(eval "tail -n1 $file | awk '\$2==\"in\" {print \$3}'")
            if [[ -n $cur ]]
            then
                echo -e "$now\tout\t$cur\t$message" >> "$file"
                echo "clocked out $cur"
            fi
        fi
    }

    function clockIn() {
        echo -e "$now\tin\t$task\t$message" >> "$file"
        echo "clocked in $task"
    }

    # clock in
    if [[ $command = "in" ]]
    then
        # first, try to clock out
        clockOut
        # now clock in
        clockIn
        exit 0
    fi

    # clock out
    if [[ $command = "out" ]]
    then
        clockOut "$task"
        exit 0
    fi

    # show log
    if [[ $command = "log" ]]
    then
        if [[ -f $file ]]
        then

            # start awk command
            cmd="awk -F $'\t' "

            # filter lines of clock-outs
            cmd="$cmd '/out.*"

            # if taskname has been set manually,
            # add a filter for the task name
            if [[ $taskSet = true ]]
            then
                cmd="$cmd${task//\//\\\/}"
            fi

            cmd="$cmd/{"

            # if "gt" is set, skip dates after that date
            if [[ -n "$after" ]]
            then
                cmd="$cmd if(\$1<$after){next;}"
            fi

            # if "lt" is set, skip dates before that date
            if [[ -n "$before" ]]
            then
                cmd="$cmd if (\$1>$before){next;}"
            fi

            # calc hours minutes and seconds
            cmd="$cmd s=\$1-a; h=int(s/60/60); s=s-h*60*60; m=int(s/60); s=s-m*60;"
            # print hours minutes and seconds
            cmd="$cmd print strftime(\"%c\", a) \"\t\" sprintf(\"%02d\", h) \":\" sprintf(\"%02d\", m) \":\" sprintf(\"%02d\", s) \"\t\" \$3 FS \$4"

            # finish awk command
            cmd="$cmd} {a=\$1}' $file"

            # if sorted output is requested
            if [[ $sortByTask = true ]]
            then
                # because of the formatted time and date, the task is now in the 8th column
                cmd="$cmd | sort -k8"
                echo "$cmd"
            fi

            eval "$cmd"

        else
            echo "No tasks recorded yet"
        fi
        exit 0
    fi

    # show tasks
    if [[ $command = "tasks" ]]
    then
        if [[ -f $file ]]
        then
            eval "cut -f3 $file | sort | uniq" 
        else
            echo "No tasks recorded yet."
        fi
        exit 0
    fi

    # show sums
    if [[ $command = "list" ]]
    then
        if [[ -f $file ]]
        then
            # start first awk command
            cmd="awk -F $'\t' "

            # filter lines of clock-outs
            cmd="$cmd '/out.*"

            # if taskname has been set manually,
            # add a filter for the task name
            if [[ $taskSet = true ]]
            then
                cmd="$cmd${task//\//\\\/}"
            fi

            cmd="$cmd/{"

            # if "gt" is set, skip dates after that date
            if [[ -n "$after" ]]
            then
                cmd="$cmd if(\$1<$after){next;}"
            fi

            # if "lt" is set, skip dates before that date
            if [[ -n "$before" ]]
            then
                cmd="$cmd if (\$1>$before){next;}"
            fi

            # calculate duration and print it
            cmd="$cmd s=\$1-a; print s FS \$3 FS \$4"

            # finish first awk command
            cmd="$cmd} {a=\$1}' $file"

            # sort results by taskname
            cmd="$cmd | sort -k2"

            # do second awk command
            # here we sum up all lines that have he same task
            cmd="$cmd | awk -F $'\t' 'BEGIN{s=0; a=0; b=\"\"; c=\"\"}"
            cmd="$cmd {if (b==\$2) { s=s+ \$1 }"
            cmd="$cmd else { h=int(s/60/60); s=s-h*60*60; m=int(s/60); s=s - m*60;"
            cmd="$cmd print sprintf(\"%02d\", h) \":\" sprintf(\"%02d\", m) \":\" sprintf(\"%02d\", s) FS b FS c; s=\$1}"
            cmd="$cmd a=\$1; b=\$2; c=\$3}"
            cmd="$cmd END{h=int(s/60/60); s=s-h*60*60; m=int(s/60); s=s-m*60;"
            cmd="$cmd print sprintf(\"%02d\", h) \":\" sprintf(\"%02d\", m) \":\" sprintf(\"%02d\", s) FS b FS c"
            cmd="$cmd }'"

            # trim off first line
            cmd="$cmd | tail -n+2"
            eval "$cmd"
        else
            echo "No tasks recorded yet"
        fi
        exit 0
    fi

    # print completion code 
    if [[ $command = "completion" ]]
    then
      echo "$COMPLETION"
      exit 0
    fi

    # show usage info
    echo "$USAGE"
    exit 0
}


if [[ ${BASH_SOURCE[0]} != $0 ]]; then
  export -f clock
else
  clock "${@}"
  exit 0
fi