{ "info": { "author": "Jeff Jia", "author_email": "jeffjia@outlook.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: Science/Research", "Intended Audience :: System Administrators", "License :: OSI Approved :: Apache Software License", "Topic :: Office/Business :: Scheduling", "Topic :: Utilities" ], "description": "# TodoQ\n\nThe simplest command-line todo list to help you focused better at work.\n\n## Introduction\n\nTodoQ is a single-task-display, priority-based, command-line todo list (I don't\nknow whether someone has come up with such a concept as single-task display).\n\n\"Single-task-display\" means that usually it only displays the top task, and you\ncan \"finish\", \"drop\" or \"postpone\" it.\n\n\"Priority-based\" means the order of tasks is totally based on priority, which is\nan unsigned int (whichever python int type supports).\n\n\"Command-line\" means it is run by linux / unix (mac included) terminal.\n\nTodoQ also supports multiple queues, in case you want to work in multiple\nthreads at the same time in a period.\n\nWe also support the sync of tasks, and dropbox account is required if you want to use the feature.\n\n## The story behind the design of TodoQ\n\nWe hope to design the world's simplest command-line todo list, and we have two\nbasic goals for it:\n\n1. The todo list should help users focus on work.\n2. The task management overhead should be minimized.\n\nPersonally I am a todo list enthusiast. Starting from paper and pencil when I\nwas in high school, I have been trying to use todo list to help me schedule my\nlife. I explored and used different methods and tools to help me track the\nstatus of daily tasks. Some of the tools are pretty cool, and I actually used\nthem for quite while. But from my experience, I found that I never kept using a\nsingle tool for more than two weeks. At first, I might be attracted to a tool\nand make up my mind for a resolution to make my life well-planed. But soon I\nfound that the tool does not actually help me much on focus and getting things\ndone, but the overhead to manage the todo list itself is pretty high.\n\nNow as a research assistant, a side-project developer and a student at the same\ntime. I use command-line tools quite a lot every day. Sometimes I use web-based\ntodo list to help me track problems to solve, features to implement, or bugs to\nfix. But switching between command line and browser can be a pain sometimes, and\nlooks less professional. Such a switching could also be distracting sometimes.\n\nThen my friends and I decide to write a todo list tool for developers like us,\nbasically command-line everything guys =). We hope it could be really\nlight-wight, \"prevent\" over-managing task list, and help focus on work. So we\ncome up with the idea of single-task display todo list. Instead of displaying\nall the tasks, we simply show the top one, the one with the highest priority.\nOperations, like \"finish\", \"drop\", \"postpone\", are only limited to the top one\nto minimize the todo list management overhead. Tasks can still be listed with\nthe command \"peek\", which is highly not recommended. We hope users could just\nfocus on the top task at the moment, and thinking about other tasks only when\nabsolutely necessary.\n\nYou may find such a design may be inconvenient sometimes. You may want to\narrange the order of tasks, set a deadline for it, or simply drop some of them.\nThese operations are almost unsupported in TodoQ. Instead, for the order, we use\npriority (basically any unsigned int number between 0 and whatever python int\ntype supports). The tasks are ordered based on priority completely. We don't use\ndeadline for tasks. We believe that human mind should be able to transform\nurgency to priority easily, and for work, a good way to meet a deadline is to do\nit as early as possible. You may want to drop some of tasks since you have\nfinished them, or they are not necessary any more, but why not do it later,\ncause managing todo list itself could also be \"viewed\" as a task with\nnot-the-highest priority.\n\nWe hope you could enjoy using TodoQ, and make it help you improve your valuable\nproductivity.\n\n## Install\n\nFirst-time install:\n\n sudo pip install todoq\n\nUpdate:\n\n sudo pip install todoq -U\n\nUninstall:\n\n sudo pip uninstall todoq\n\n## Usage\n\n### Add a new task\n\n todoq add task_name [priority]\n\nAdd a task into the current queue with the specified priority.\n\nExample #1\n\n todoq add \"finish the front page UI design\" 999\n\ntask name - finish the front page UI design\npriority - 999\n\nExample #2\n\n todoq add \"check email\"\n\ntask name - check email\npriority - 17 (default priority value)\n\n### Show the top task\n\n todoq top\n\nDisplay the top task. Yes, you are right, just the top one task.\n\n### Finish the top task\n\n todoq finish\n\nMark the top task as \"finished\".\n\n### Postpone the top task\n\n todoq postpone [priority]\n\nIf `priority` is specified, the top task is postponed with the new priority.\nOtherwise, the top task is postponed after the second task.\n\n### Drop the top task\n\n todoq drop\n\nMark the top task as \"dropped\".\n\n### Show the complete task list\n\n todoq ls\n\nList all the tasks in the current queue. The sub-command should be used rarely\nto avoid distraction.\n\nOptions\n\n -u: list all the unfinished tasks\n -a: list all the tasks\n -f: list all the finished tasks\n -d: list all the dropped tasks\n -n count: specifiy the number of tasks to be displayed\n\n### Show all the task queues\n\n todoq showq\n\nList all the queues. Single queue is recommended. Multiple queues are provided\nin case you have multiple projects at hand.\n\n### Select a task queue\n\n todoq selectq queue_name\n\nSelect the queue as the current queue.\n\n### Create a new task queue\n\n todoq createq queue_name\n\nCreate a new queue.\n\n### Delete a task queue\n\n todoq deleteq queue_name\n\nDelete an existing queue.\n\n### Show usage\n\n todoq --help, todoq -h, todoq help\n\nShow help. Any \"unexpected\" command will also lead to help.\n\n## License\n\nApache license is applied if you want to use the source code.\n[http://www.apache.org/licenses/LICENSE-2.0](\nhttp://www.apache.org/licenses/LICENSE-2.0)", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://jeffjia.github.com/todoq/", "keywords": null, "license": "LICENSE.txt", "maintainer": null, "maintainer_email": null, "name": "todoq", "package_url": "https://pypi.org/project/todoq/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/todoq/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://jeffjia.github.com/todoq/" }, "release_url": "https://pypi.org/project/todoq/1.0.12/", "requires_dist": null, "requires_python": null, "summary": "Simplest command-line TODO list", "version": "1.0.12" }, "last_serial": 842543, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "1a2c2e4ce2e9d8322948efa5dfa13d9f", "sha256": "5ef9d9d11a482bf70cd9ee502400a7c3ad4dbc85458f0eb3a10f0920b76edba6" }, "downloads": -1, "filename": "todoq-1.0.0.tar.gz", "has_sig": false, "md5_digest": "1a2c2e4ce2e9d8322948efa5dfa13d9f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4080, "upload_time": "2013-02-04T01:44:54", "url": "https://files.pythonhosted.org/packages/a2/00/a485461646f19875740c3d43afdb24f8d127fb4a0422c48b0c10c257c10f/todoq-1.0.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "49d612d31498f2dd46c6feb4f4395468", "sha256": "bf12971c1b72b3624df65f2eb33a3657f331f04fff9039835b092aaeb2f885fe" }, "downloads": -1, "filename": "todoq-1.0.1.tar.gz", "has_sig": false, "md5_digest": "49d612d31498f2dd46c6feb4f4395468", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4929, "upload_time": "2013-02-04T03:49:44", "url": "https://files.pythonhosted.org/packages/1e/38/5f27b48ed39498a1ebe71c6bf81ab4a21584cf280cd92a7bfca4312591ee/todoq-1.0.1.tar.gz" } ], "1.0.10": [ { "comment_text": "", "digests": { "md5": "caffa75b2ead712143c1bc87116ecd1c", "sha256": "68d38459937ff1bcd4e8bfb399001eba0330f44bca11cfa6ade5261eb5ef58c3" }, "downloads": -1, "filename": "todoq-1.0.10.tar.gz", "has_sig": false, "md5_digest": "caffa75b2ead712143c1bc87116ecd1c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9092, "upload_time": "2013-04-05T16:19:11", "url": "https://files.pythonhosted.org/packages/6d/70/48533f13cbf9335cd7cdd8803b8fd42fec0f29c96361d99dd037c32311c2/todoq-1.0.10.tar.gz" } ], "1.0.11": [ { "comment_text": "", "digests": { "md5": "6bc9df1abb002d9b3b7855ec771cf5a4", "sha256": "478266044d08888d27550d4a8db6ecf03cd8dcbd4df2ca6695bb66a064bf8b90" }, "downloads": -1, "filename": "todoq-1.0.11.tar.gz", "has_sig": false, "md5_digest": "6bc9df1abb002d9b3b7855ec771cf5a4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8899, "upload_time": "2013-04-06T17:52:03", "url": "https://files.pythonhosted.org/packages/ff/12/df86a1245fc9a8d3408a68b3e2787ceb86d4b37249c73648706179612fa8/todoq-1.0.11.tar.gz" } ], "1.0.12": [ { "comment_text": "", "digests": { "md5": "4dd60ad11d9d379c512d550e99d3da20", "sha256": "1ee7b5677eb6caaec6cd61ea03e9a054a0bc99efc92d531f9d03cc74d462ea67" }, "downloads": -1, "filename": "todoq-1.0.12.tar.gz", "has_sig": false, "md5_digest": "4dd60ad11d9d379c512d550e99d3da20", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8834, "upload_time": "2013-08-18T06:26:11", "url": "https://files.pythonhosted.org/packages/18/c2/9127ba3f8dcf7711c34c862c6938703728308ef8694b1d853e2d73b57e93/todoq-1.0.12.tar.gz" } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "60ac75974cb4cf04369217378c180874", "sha256": "cae0279ccbffe1eae672672a352ef07363ff4cc4122f8c430c375797cce855bb" }, "downloads": -1, "filename": "todoq-1.0.2.tar.gz", "has_sig": false, "md5_digest": "60ac75974cb4cf04369217378c180874", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6358, "upload_time": "2013-02-04T18:53:21", "url": "https://files.pythonhosted.org/packages/1b/4c/d4ccb9e2f37d3651e3775bcbd37a43bdc4f0edef75563e9a7aa1b7f15d24/todoq-1.0.2.tar.gz" } ], "1.0.3": [ { "comment_text": "", "digests": { "md5": "6666639a2b68aece3e8d812f98cf9765", "sha256": "3783578bf92e9a96fa179bcf0d57d4bf4240e7fae7d3e7c200e26ac67b1d14af" }, "downloads": -1, "filename": "todoq-1.0.3.tar.gz", "has_sig": false, "md5_digest": "6666639a2b68aece3e8d812f98cf9765", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7105, "upload_time": "2013-02-05T17:45:54", "url": "https://files.pythonhosted.org/packages/5b/17/d149311bf7d243916e860b2ad0165a1474b4a630179ac6157a31c004f6a6/todoq-1.0.3.tar.gz" } ], "1.0.4": [ { "comment_text": "", "digests": { "md5": "5a4d74557558fcfc9b58ddb255a5f6d3", "sha256": "daa9328e33ea554877eba748f16259ead9e937245e2d62ea30eaaaf31117c5dd" }, "downloads": -1, "filename": "todoq-1.0.4.tar.gz", "has_sig": false, "md5_digest": "5a4d74557558fcfc9b58ddb255a5f6d3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7966, "upload_time": "2013-02-05T19:09:35", "url": "https://files.pythonhosted.org/packages/68/e6/4dc9fd8861fff5b21c200661648bbdea6d6998ab7cdedec595c3f63cb2dc/todoq-1.0.4.tar.gz" } ], "1.0.5": [ { "comment_text": "", "digests": { "md5": "20874e5f71941d2bc318ee19ca4dbd12", "sha256": "55d9459b2b6af38ff4075f8dfaa4e764e8a8a7dcc73e0189f872501068827a4e" }, "downloads": -1, "filename": "todoq-1.0.5.tar.gz", "has_sig": false, "md5_digest": "20874e5f71941d2bc318ee19ca4dbd12", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8090, "upload_time": "2013-02-07T02:08:43", "url": "https://files.pythonhosted.org/packages/fa/18/4f8d3587c9408bb089dc2ad24d329ebe0afeb8696311fb080f58d1c51d63/todoq-1.0.5.tar.gz" } ], "1.0.6": [ { "comment_text": "", "digests": { "md5": "47f1fac5135afb407d3d0a26323a22af", "sha256": "963c9ed7cdd55f81722ff0a0294bfaae81d49cea614e3da41fac48cfac6d5e6f" }, "downloads": -1, "filename": "todoq-1.0.6.tar.gz", "has_sig": false, "md5_digest": "47f1fac5135afb407d3d0a26323a22af", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8096, "upload_time": "2013-02-07T02:16:11", "url": "https://files.pythonhosted.org/packages/f0/a8/760d3de253aeac7f49661d39a1fe29853d91a3f883b93007c60a13b0c77e/todoq-1.0.6.tar.gz" } ], "1.0.7": [ { "comment_text": "", "digests": { "md5": "2079c133cbe69ee79ff50554196005fc", "sha256": "070750eb3763de7845e2bae6086f4269bfa264890985ba850140b0f295cad52a" }, "downloads": -1, "filename": "todoq-1.0.7.tar.gz", "has_sig": false, "md5_digest": "2079c133cbe69ee79ff50554196005fc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8534, "upload_time": "2013-02-07T03:08:19", "url": "https://files.pythonhosted.org/packages/61/bd/6bd79e2580daa0d5fbeeb1403fd73339775e05ce83c8f723c59297c56d96/todoq-1.0.7.tar.gz" } ], "1.0.8": [ { "comment_text": "", "digests": { "md5": "a28277440bd7b8b15e879bf83828f652", "sha256": "0a6cd1bc89467ce7859e0de003424f4cf379cc5efea870e6353e849a3a4e964a" }, "downloads": -1, "filename": "todoq-1.0.8.tar.gz", "has_sig": false, "md5_digest": "a28277440bd7b8b15e879bf83828f652", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8964, "upload_time": "2013-02-07T05:48:16", "url": "https://files.pythonhosted.org/packages/48/1f/384bd4ddccf430d001115537577c8b9b0253377ebaca6acd0c4b00896211/todoq-1.0.8.tar.gz" } ], "1.0.9": [ { "comment_text": "", "digests": { "md5": "928bc91791803cf4f44a05070adc2fc1", "sha256": "a39b9aec0fda58ccc80046340f44db0c497dede683cf8821efe79ae4af119ebe" }, "downloads": -1, "filename": "todoq-1.0.9.tar.gz", "has_sig": false, "md5_digest": "928bc91791803cf4f44a05070adc2fc1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8774, "upload_time": "2013-04-05T16:01:25", "url": "https://files.pythonhosted.org/packages/66/5f/8cea2cde1884dd31739368175efb96deeb0c6f7ad7be12fc6098df29134e/todoq-1.0.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "4dd60ad11d9d379c512d550e99d3da20", "sha256": "1ee7b5677eb6caaec6cd61ea03e9a054a0bc99efc92d531f9d03cc74d462ea67" }, "downloads": -1, "filename": "todoq-1.0.12.tar.gz", "has_sig": false, "md5_digest": "4dd60ad11d9d379c512d550e99d3da20", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8834, "upload_time": "2013-08-18T06:26:11", "url": "https://files.pythonhosted.org/packages/18/c2/9127ba3f8dcf7711c34c862c6938703728308ef8694b1d853e2d73b57e93/todoq-1.0.12.tar.gz" } ] }