Metadata-Version: 2.0
Name: pda
Version: 0.1.5
Summary: A command line tool managing all sorts of TODO lists
Home-page: https://github.com/keenhenry/pda
Author: Henry Huang
Author-email: UNKNOWN
License: BSD
Keywords: command line todo list TODO todolist
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: BSD License
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Requires-Dist: requests

================================
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
-------

.. code-block:: bash

    $ sudo pip install pda

Or (but not recommended):

.. code-block:: bash

    $ sudo easy_install pda


Synopsis
--------

List names can be any string you want, personally I have **todo**, **tolearn** and **toread**
as available list names. List data is always stored locally. And, depends on the configuration 
setting in your configuration file (``~/.pdaconfig``), list data can also be synced to 
`Github Issue <http://bit.ly/18YAS2p>`_ and accessed through ``pda``; that is how you 
make your todo list(s) portable via web interface.

If no configuration file is provided, ``pda`` assumes it is to be used in local mode; in other 
words, list data only stored locally.

For more detailed usage:

CREATE tasks
++++++++++++

To add (``-a`` option) a task in a list. If list with **listname** has not yet created, 
this command will automatically create such list in database. See example below:

.. code-block:: bash

    # Command format:
    #
    # $ pda -a <task summary text> <-t PERIOD> <-p PRIORITY> <listname>
    #
    # ===> 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 (urgmust)

    $ pda -a 'wash dishes' -t d -p 4 todo


UPDATE tasks
++++++++++++

All the attributes of a task can be changed to the specified values in the options. If
a value with an option is not specified in the command, then the corresponding attribute 
in list will stay unchanged.

.. code-block:: bash

    # Command format:
    #
    # $ pda -r <N> 
    #
    # ===> delete a task numbered <N>

    $ pda -r 5

    # Command format:
    #
    # $ pda -e <N> -s <task summary text> <-t PERIOD> <-p PRIORITY> <listname>
    #
    # ===> update a task numbered <N> in a list named <listname>
    #
    # <-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 (urgmust)
    #
    # <lisname> specifies the NEW list this task belongs to

    $ pda -e 3 -s 'vacuum floor this week' -t w


QUERY lists
+++++++++++

To list ALL the tasks stored in the database:

.. code-block:: bash

    $ pda

To list ALL the tasks belongs to the list named **todo**:

.. code-block:: bash

    $ pda todo

To list ALL the tasks belongs to time frame **month**:

.. code-block:: bash

    $ pda -tm

To list ALL the tasks which have priority **urgmust** (urgent must):

.. code-block:: bash

    $ pda -p5

To list ALL the tasks which belongs to time frame **week** and 
have priority **high** and belongs to the list named **toread**:

.. code-block:: bash

    $ pda -tw -p3 toread


.. :changelog:

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

0.1.4 (2014-04-01)
++++++++++++++++++

* Fixed broken reStructuredText.

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!


