Gtasks

A command line application to integrate with Google Tasks and perform some common operatations.

Usage

To see usage options run:

$ gtasks -h
usage: gtasks [-h] {authenticate,backup,process,quickadd,lists} ...
positional arguments:
{authenticate,backup,process,quickadd,lists}
authenticate Authenticate the use of your google account for access
to the google task APIs
backup Backup your tasks to a local JSON file
process Search Tasks and perform actions on them
quickadd Quickly add a task to a given list
lists Display all of your Google Tasks Lists.
optional arguments:
-h, --help show this help message and exit

Authenticate your app:

$ gtasks authenticate

Backup tasks:

$ gtasks backup
Backing up!
Including hidden tasks
Adding list to backup: My Tasks
Adding list to backup: Another List
Creating backup in file: backup-2019-11-28T22:22:22.181719.json

or only include visible tasks in your backup:

$ gtasks backup --include visible

Quickly add a task:

$ gtasks quickadd --list "My Tasks" "Buy some milk"

Process through your tasks, it has quite a few options, so see the help for more info:

$ gtasks process -h

Installing from Source

To install and run from source:

Requires and been tested on Python 3+.

Check what version of python you are running.

python --version

If you're system python is Python 2 you will have to use pip3 in the below steps instead of pip.

Clone the repository:

git clone git@github.com:edtechhub/gtasks.git

Install the dependencies (preferably in a virtual environment):

We require a two stage install, as the Gtasks installer itself requires some dependencies.

pip install -r pre-requirements.txt
pip install -r requirements.txt

For convenience you may symlink the gtasks executable to somewhere on your path, so that you can run gtasks.

Installing via PyPi

TBD

Running the tests

There is only one test file right now. To run:

python -m unittest tasks/tests/test_backup.py

If more tests are neccesary in future may expand into a full test runner, using pytest/nose or similar.