VO-based todo manager: tkdo 0.7

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
3 messages Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

VO-based todo manager: tkdo 0.7

Scott Scriven-2
I finally released TKDO 0.7, if anyone is interested.  The main
change is a completely new text UI based on curses.  It's faster
than the GUI, uses less memory, allows colorized tasks, and works
well over ssh.  Also, this version has a variety of small new
features and bugfixes.

   http://toykeeper.net/programs/tkdo/files/tkdo-0.7.tar.gz

Changes since 0.6:

  General:
    + Added a curses-based text interface.
    * Updated config library to allow saving only non-default values.
    + Added ability to snooze for units such as 'ddd' (3 days) or 'ww' (2 weeks).
    + Added ability to filter in 'and' or 'or' modes
      (to display a union of contexts instead of an intersection).
    * Made snoozed / completed tasks display as 'Zzz' / '[X]' instead of '0'.
    * Handle missing task files by ignoring them instead of exiting.
    * Added task title to log message for launching the editor.
  CLI:
    + Added an automation facility based on the TUI.
      Basically, any extra parameters will be executed as if the user had
      typed them into the TUI.
  Shared UI:
    * Moved most of the GUI logic into a shared base class,
      so the TUI and GUI can share behavior without writing everything twice.
    + Added a 'zoom' feature to auto-filter into the current branch.
      (bound to the 'enter' key by default)
  TUI:
    + All new curses interface!  Works well over ssh.
  GUI:
    * Changed 'editor' config item to 'editor_gui'.
      The GUI and TUI can use different editors.


-- Scott
_______________________________________________
VimOutliner mailing list
[hidden email]
http://www.lists.vimoutliner.org/mailman/listinfo
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: VO-based todo manager: tkdo 0.7

Steve Litt
On Thursday 12 November 2009 23:53:50 Scott Scriven wrote:
> I finally released TKDO 0.7, if anyone is interested.  The main
> change is a completely new text UI based on curses.

Hi Scott,

You need better documentation. I made a todo list, and then I ran ./todo.py.
Then I tried ./todo.py todo.otl and it told me I had a bad command. There was
no ./tkdo.py at all. Here is the list of files created by unpacking your
package:

slitt@mydesk:~/tdo/tkdo-0.7$ ls -ltr
total 344
-rw-r--r-- 1 slitt slitt   8931 2009-11-06 21:50 README
-rw-r--r-- 1 slitt slitt   5660 2009-11-06 21:50 example.otl
-rwxr-xr-x 1 slitt slitt  14763 2009-11-06 21:50 pycfg.py
-rw-r--r-- 1 slitt slitt   7639 2009-11-06 21:50 COPYING.LESSER
-rw-r--r-- 1 slitt slitt  35147 2009-11-06 21:50 COPYING
drwxr-xr-x 2 slitt slitt   4096 2009-11-06 21:50 contrib
-rwxr-xr-x 1 slitt slitt 127557 2009-11-11 21:45 todo.py
-rw-r--r-- 1 slitt slitt   1663 2009-11-11 21:45 Makefile
-rw-r--r-- 1 slitt slitt   5831 2009-11-11 21:57 ChangeLog.summary
-rw-r--r-- 1 slitt slitt  87144 2009-11-11 21:57 ChangeLog
-rwxr-xr-x 1 slitt slitt  15999 2009-11-13 00:19 pycfg.pyc
slitt@mydesk:~/tdo/tkdo-0.7$

I tried the make command, but it said target "all" had nothing to do. I finally
did make install and now I have a tkdo command, but I have no idea what to do
with it. I performed make todo and it listed what looked like a multilevel
todolist to the screen, but I had no idea what to do with it.

U need a tutorial. You can use me as the giny pig. What's my next step? How do
I do a proof of concept?

SteveT

Steve Litt
Recession Relief Package
http://www.recession-relief.US
Twitter: http://www.twitter.com/stevelitt


_______________________________________________
VimOutliner mailing list
[hidden email]
http://www.lists.vimoutliner.org/mailman/listinfo
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: VO-based todo manager: tkdo 0.7

Scott Scriven-2
* Steve Litt <[hidden email]> wrote:
> You need better documentation.

Thanks for looking at it, and for reminding me!  :)

There are two files with documentation, README and example.otl.  
But neither one really gives a tutorial or quickstart, and both
are probably getting a little old.  So, there are a few things to
update...

> I have no idea what to do with it.  ...
> U need a tutorial. You can use me as the giny pig. What's my
> next step?  How do I do a proof of concept?

Let's see...  the quickstart should probably cover the following:

  - Installation.
    make install  (or: ln -s ~/src/tkdo/todo.py ~/bin/tkdo )
    ln -s `which tkdo` ~/bin/t

  - Configuration.
    # create a config file
    tkdo cfg -o ~/.tkdo/rc
    # change anything you like (add task files)
    vim ~/.tkdo/rc
    # remove settings you haven't changed
    tkdo cfg --non-default -o ~/.tkdo/rc

  - How to use it.
    tkdo help  # list commands
    tkdo help [command]  # details for a command

    The GUI hopefully is mostly self-explanatory, and has
    functions listed in Help -> Show Keybindings.

    The TUI has functions listed if you press '?'.

As for what to actually do with it, that's a more difficult
question.  Perhaps for that I should link to the documentation on
its project site:

    http://toykeeper.net/programs/tkdo/
    http://toykeeper.net/programs/tkdo/gtd

I've found that there are some things I do frequently which
should probably be turned into actual features...  for example, I
keep an item at the top of each file whose title is '...'.  Its
only purpose is to let me easily add tasks to the top of the
file, by moving the cursor to it and pressing 'o' (like in vim).  
It might be better to just have an actual feature which would
either add a task to the top/bottom of the current file.  And
another to make it list each task file.

> I performed make todo and ...

Oh, yeah.  That's just a reminder for developers.  I put comments
in the code with tags of "TODO" or "FIXME" when there's something
I need to remember for later, and then 'make todo' will grep for
those.  I should probably export that to a VO file, but haven't
bothered.

In any case, there is a lot left to do, and I'm finally getting
some of it done again.  :)


-- Scott
_______________________________________________
VimOutliner mailing list
[hidden email]
http://www.lists.vimoutliner.org/mailman/listinfo
Loading...