Not Logged In

pda 0.1.7

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

Or (but not recommended):

$ 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 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 only locally; in other
words, no data will be put on Github Issues.

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:

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
of that task will stay unchanged.

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

$ pda -tw -p3 toread

Syncing Data With Github Issues

When pda is in remote mode, it can communicate with Github Issues to
upload/download list data.

Once pda is in remote mode, you can only start using pda by downloading data
from Github Issues to local data store first:

$ pda --start

Once you have finished using pda and want to upload all the data created during
current section (between --start and --stop) to Github Issues, try:

$ pda --stop

Configuration Setting

pda can be configured by a configuration file named .pdaconfig reside in your
home directory. If no such file is present, then pda simply use some default settings
internally, and behave only in local mode; meaning data is only stored locally.

To make pda operate in remote mode (meaning the data is stored both locally and
remotely on Github Issues), you need to set several parameters in the configuration file.

See an example configuration file below:

# a typical configuration file contains two sections: [pda] and [github][pda]; the local database where pda will store its datadatabase-path=/tmp/.pdastore[github]; username on githubusername=your_github_username; the name of the repository where you want to store your list datarepo-name=your_github_reponame; authentication token for a Github application which pda will use; to communitcate with Github Issues API, see link below:; https://help.github.com/articles/creating-an-access-token-for-command-line-useauth-token=your_github_app_token

Release History

0.1.7 (2014-04-08)

Completed syncing data section in README.rst.

0.1.6 (2014-04-05)

Refined README.rst to provide instructions for .pdaconfig file.

0.1.5 (2014-04-04)

Refined README.rst.

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.