pda 0.1.3

A command line tool managing all sorts of TODO lists

================================
Personal Desktop Assistant - pda
================================

``pda`` is a command line tool used to manage useful lists in your daily ife - such as TODO,
TOLEARN and TOREAD lists, etc. You can use it to create as many lists as you want.

Install
-------
::

$ sudo pip install pda


Synopsis
--------

List names can be any string you want, personally I have **todo**, **tolearn** and **toread**
as available list names. Lists data is stored on `Github Issue <http://bit.ly/18YAS2p>`_ and
accessed through ``pda`` command line interface, which is explained below:


CREATE tasks
^^^^^^^^^^^^

::

# add a task in a list named <listname>:
#
# <-t> specifies the time frame this task is scheduled to
# allowed values are => d (day), w (week), m (month), s (season), y (year)
# <-p> specifies the priority of this task
# allowed values are => 1 (low), 2 (medium), 3 (high), 4 (must), 5 (urgent must)
#
# if list <listname> has not yet created in database (Github Issue)
# this command will automatically create such list in the database
$ pda -a <task summary text> <-t PERIOD> <-p PRIORITY> <listname>


UPDATE tasks
^^^^^^^^^^^^

::

# delete a task numbered <N>
$ pda -r <N>

# update a task numbered <N> in a list named <listname>
#
# all the attributes of a task can be changed to the specified values:
#
# <-s> specifies the NEW task summary
# <-t> specifies the NEW time frame this task is scheduled to
# allowed values are => d (day), w (week), m (month), s (season), y (year)
# <-p> specifies the NEW priority of this task
# allowed values are => 1 (low), 2 (medium), 3 (high), 4 (must), 5 (urgent must)
# <lisname> specifies the NEW list this task belongs to
$ pda -e <N> -s <task summary text> <-t PERIOD> <-p PRIORITY> <listname>


QUERY lists
^^^^^^^^^^^

::

# list ALL the tasks stored in the database (Github Issue)
$ pda

# list ALL the tasks belongs to the list named <listname>
$ pda <listname>

# list ALL the tasks belongs to time frame PERIOD
$ pda <-t PERIOD>

# list ALL the tasks which have priority PRIORITY
$ pda <-p PRIORITY>

# list ALL the tasks which belongs to time frame PERIOD
# and have priority PRIORITY
# and belongs to the list named <listname>
$ pda <-t PERIOD> <-p PRIORITY> <listname>


Release History
---------------

0.1.3 (2014-04-01)
++++++++++++++++++

* Removed unused import PdaConfig.
* Fixed sync_remote_dbstore method bug for transition between local mode and remote mode.
* Fixed max_task_number attribute getter for shelve is empty.

0.1.2 (2014-03-31)
++++++++++++++++++

* Fixed format string bug (#50) to be compatible with python 2.6.

0.1.1 (2014-03-30)
++++++++++++++++++

* Removed debugging assert statements.

0.1.0 (2014-03-30)
++++++++++++++++++

* Birth!