Skip to main content

Command-line application to show the next action to work on from a todo.txt file

Project description

Next-action

PyPI Updates Python 3 Build Status Codacy Badge Codacy Badge

Determine the next action to work on from a list of actions in a todo.txt file. Next-action is currently beta-stage so, although it should work pretty well, it may be a bit rough around the edges.

Don't know what Todo.txt is? See https://github.com/todotxt/todo.txt for the Todo.txt specification.

Next-action is not a tool for editing todo.txt files, see http://todotxt.org for available options.

Demo

gif

Installation

Next-action requires Python 3.6 or newer.

pip install next-action

Usage

$ next-action --help
usage: next-action [-h] [--version] [-c <config.cfg> | -C] [-f <todo.txt>] [-n <number> | -a] [-o] [<context|project> ...]

Show the next action in your todo.txt. The next action is selected from the tasks in the todo.txt file based on task
properties such as priority, due date, and creation date. Limit the tasks from which the next action is selected by
specifying contexts the tasks must have and/or projects the tasks must belong to.

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --write-config-file   generate a sample configuration file and exit
  -c <config.cfg>, --config-file <config.cfg>
                        filename of configuration file to read (default: ~/.next-action.cfg)
  -C, --no-config-file  don't read the configuration file
  -f <todo.txt>, --file <todo.txt>
                        filename of todo.txt file to read; can be '-' to read from standard input; argument can be
                        repeated to read tasks from multiple todo.txt files (default: ~/todo.txt)
  -n <number>, --number <number>
                        number of next actions to show (default: 1)
  -a, --all             show all next actions
  -o, --overdue         show only overdue next actions
  -s <style>, --style <style>
                        colorize the output; available styles: abap, algol, algol_nu, arduino, autumn, borland, bw,
                        colorful, default, emacs, friendly, fruity, igor, lovelace, manni, monokai, murphy, native,
                        paraiso-dark, paraiso-light, pastie, perldoc, rainbow_dash, rrt, tango, trac, vim, vs, xcode
                        (default: None)

optional context and project arguments; these can be repeated:
  @<context>            context the next action must have
  +<project>            project the next action must be part of
  -@<context>           context the next action must not have
  -+<project>           project the next action must not be part of

Assuming your todo.txt file is your home folder, running Next-action without arguments will show the next action you should do. Given this todo.txt, calling mom would be the next action:

$ next-action
(A) Call mom @phone

The next action is determined using priority. Due date is considered after priority, with tasks due earlier getting precedence over tasks due later. Creation date is considered after due date, with older tasks getting precedence over newer tasks. FInally, tasks that belong to more projects get precedence over tasks that belong to fewer projects.

Completed tasks (x This is a completed task) and tasks with a creation date in the future (9999-01-01 Start preparing for five-digit years) are not considered when determining the next action.

Limiting the tasks from which next actions are selected

You can limit the tasks from which Next-action picks the next action by passing contexts and/or projects:

$ next-action @work
(C) Finish proposal for important client @work
$ next-action +DogHouse
(G) Buy wood for new +DogHouse @store
$ next-action +DogHouse @home
Get rid of old +DogHouse @home

When you supply multiple contexts and/or projects, the next action belongs to all of the contexts and at least one of the projects:

$ next-action +DogHouse +PaintHouse @store @weekend
(B) Buy paint to +PaintHouse @store @weekend

It is also possible to exclude contexts, which means the next action will not have the specified contexts:

$ next-action +PaintHouse -@store
Borrow ladder from the neighbors +PaintHouse @home

And of course, in a similar vein, projects can be excluded:

$ next-action -+PaintHouse @store
(G) Buy wood for new +DogHouse @store

To make sure you have no overdue actions, or work on overdue actions first, limit the tasks from which the next action is selected to overdue actions:

$ next-action --overdue
Buy flowers due:2018-02-14

Showing more than one next action

To show more than one next action, supply the number you think you can handle:

$ next-action --number 3
(A) Call mom @phone
(B) Buy paint to +PaintHouse @store @weekend
(C) Finish proposal for important client @work

Or show all next actions, e.g. for a specific context:

$ next-action --all @store
(B) Buy paint to +PaintHouse @store @weekend
(G) Buy wood for new +DogHouse @store

Note again that completed tasks and task with a future creation date are never shown since they can't be a next action.

Styling the output

The next actions can be colorized using the --style argument. Run next-action --help to see the list of possible styles.

When you've decided on a style you prefer, it makes sense to configure the style in the configuration file. See the section below on how to configure Next-action.

Configuring Next-action

In addition to specifying options on the command-line, you can also configure options in a configuration file. By default, Next-action tries to read a file called .next-action.cfg in your home folder.

To get started, you can tell Next-action to generate a configuration file with the default options:

$ next-action --write-config-file
# Configuration file for Next-action. Edit the settings below as you like.
file: ~/todo.txt
number: 1
style: default

To make this the configuration that Next-action reads by default, redirect the output to ~/.next-action.cfg like this: next-action --write-config-file > ~/.next-action.cfg.

If you want to use a configuration file that is not in the default location (~/.next-action.cfg), you'll need to explicitly tell Next-action its location:

$ next-action --config-file docs/.next-action.cfg
(A) Call mom @phone

The configuration file format is YAML. The options currently supported are which todo.txt files must be read, how many next actions should be shown, and the styling.

Configuring a default todo.txt

A default todo.txt file to use can be specified like this:

file: ~/Dropbox/todo.txt

Multiple todo.txt files can be listed, if needed:

file:
  - personal-todo.txt
  - work-todo.txt
  - big-project/tasks.txt

Configuring the number of next actions to show

The number of next actions to show can be specified like this:

number: 3

Or you can have Next-action show all next actions:

all: True

Configuring the style to use

The style can be configured using the style keyword:

style: colorful

Run next-action --help to see the list of possible styles.

Precedence of options

Options in the configuration file override the default options. Command-line options in turn override options in the configuration file.

If you have a configuration file with default options that you occasionally want to ignore, you can skip reading the configuration file entirely with the --no-config-file option.

Develop

Clone the repository, create a virtual environment, install the dependencies with pip install -r requirements-dev.txt -r requirements.txt, and install Next-action in development mode using python setup.py develop.

To run the unit tests:

$ python -m unittest
...............................................................................................................................
----------------------------------------------------------------------
Ran 127 tests in 0.389s

OK

Running python setup.py test should give the same results.

To create the unit test coverage report run the unit tests under coverage with coverage run --branch -m unittest; coverage html --fail-under=100 --directory=build/htmlcov.

Quality checks can be run with pylint next_action and pycodestyle next_action.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for next-action, version 0.10.1
Filename, size File type Python version Upload date Hashes
Filename, size next_action-0.10.1-py3-none-any.whl (22.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size next-action-0.10.1.tar.gz (19.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page