workedon

CLI utility for daily work logging.

Installation

pip install workedon

Requirements

• Python 3.7+

Features

• Log or save work with human-readable dates/time.
• Fetch saved work with human-readable dates/times.
• Familiar Git-like interface.
• Filter, sort, delete, format and display logged work on your shell.

$ workedon --help
Usage: workedon [OPTIONS] COMMAND [ARGS]...

  CLI utility for daily work logging.

  Example usages:
  1. Saving work:
  workedon studying for the SAT @ June 2010
  workedon pissing my wife off @ 2pm yesterday
  workedon painting the garage

  2. Fetching work:
  workedon what
  workedon what --from "2pm yesterday" --to "9am today"
  workedon what --today
  workedon what --past-month

Options:
  -v, --version  Show the version and exit.
  -h, --help     Show this message and exit.

Commands:
  work*  Work log with optional date to save - see examples.
  what   Fetch your saved work.

$ workedon what --help
Usage: what [OPTIONS]

  Fetch your saved work.

Options:
  -r, --reverse        Reverse order while sorting.
  -n, --count INTEGER  Number of entries to return.
  -s, --last           Fetch the last thing you worked on
  -i, --id TEXT        id to fetch with.
  -f, --from TEXT      Start date-time to filter with.
  -t, --to TEXT        End date-time to filter with.
  --since TEXT         Fetch work done since a specified date-time in the past.
  -d, --past-day       Fetch work done in the past 24 hours.
  -w, --past-week      Fetch work done in the past week.
  -m, --past-month     Fetch work done in the past month.
  -y, --past-year      Fetch work done in the past year.
  -e, --yesterday      Fetch work done yesterday.
  -o, --today          Fetch work done today.
  --on TEXT            Fetch work done on a particular date/day.
  --at TEXT            Fetch work done at a particular time on a particular
                       date/day.
  --delete             Delete fetched work.
  -g, --no-page        Don't page the output.
  -l, --text-only      Output the work log text only.
  --help               Show this message and exit.

Credits

• dateparser, for an amazing date parser. This project would not be possible without it.
• Click, for making writing CLI tools a complete pleasure.
• jrnl, fck and Simon Willison for some inspiration.

History

0.6.0 (2023-02-05)

• add fetching by id using --id/-i

0.5.9 (2023-02-05)

• make --count work with all other options

0.5.8 (2023-01-27)

• fix hash generation

0.5.7 (2023-01-26)

• fix deletion

0.5.6 (2023-01-25)

• add --since as alternative for --from
• fix formatting in shell

0.5.5 (2023-01-23)

• add -l/--text-only for text-only output
• remove -d used as alternative for --delete

0.5.4 (2023-01-22)

• add -g as alternative for no-page
• fix help text
• update README
• hashlib: set usedforsecurity

0.5.3 (2023-01-18)

• allow reverse sorting using -r/--reverse

0.5.2 (2023-01-18)

• remove recording seconds for simple querying
• add --no-page to avoid paging
• improve deleting

0.5.1 (2023-01-18)

• fix start > end check
• add --at to fetch work done at a particular time on a particular date/day

0.5.0 (2023-01-14)

• Breaking: rename database to won.db

0.4.5 (2023-01-13)

• fix error message

0.4.4 (2023-01-13)

• raise if start date is greater than end date

0.4.3 (2023-01-12)

• don't force color when paging

0.4.2 (2023-01-12)

• Python 3.11 support

0.4.1 (2023-01-12)

• ask for deletion only if there's something
• use tz aware now() for comparison

0.4.0 (2023-01-11)

• Breaking: rename database to wondb.sqlite3
• force colored output on windows
• use tz aware RELATIVE_BASE

0.3.3 (2023-01-09)

• add --delete/-d for deletion
• add --on to fetch work done on a particular date/day
• add --last/-s to fetch the last entered work log

0.3.2 (2023-01-08)

• make dependency versions flexible

0.3.1 (2023-01-08)

• Fixed README

0.3.0 (2023-01-08)

• First release on PyPI.