So, yeah. Taskomaly 0.1.0 (now 0.1.1 to deal with some things) is released, but I’m not too happy about it. It’s a very confining release. Here’s what you need to know, things that are implicit in the code, but not in the documentation.

• Project names are converted into symbols for no real reason, but they lose their formatting in the process. “My IBM Project” will become :my_ibm_project, which will then get transformed into “My ibm project:” when the project name is formatted for a task file.
• Comments are ignored and not parsed, and not brought into a formatted task file.

I think that’s it, but those are constricting things nonetheless. Tests pass, but only because I use special cases for these things. I know. I’m ashamed. I’m going to add better criteria for all the tests, and stick it out until the next release.

But basically anything that you want to do with papers, projects, and tasks is available for you. The README explains how to integrate it with Tasko.

Right. The whole thing needs an overhaul API wise. Already. I’m not sure if that’s a function of my using TDD naively, or if I’m just a bad programmer. Let’s say a little bit of both.

In any event, what there is, is well-documented. On top of that, if you have any issues or test cases you want to provide, throw them to me at my Lighthouse project for Taskomaly. Things like that would be wonderfully appreciated, since this is the sort of project that builds itself based on the most common habits of the people who use it.

Enjoy!

$ gem sources -a http://gems.github.com
$ sudo gem install ardekantur-taskomaly

If you get any version from GitHub that’s not 0.1.1, wait a couple minutes and try again. GitHub says it takes up to ten minutes to propagate a gem change, and I haven’t been keeping track of time.

Straight from the readme:

you need to clean your room

make it a project

 proj = Taskomaly::Project.new 'Room Cleaning'

add some tasks to it

 proj.add 'put away clean laundry'
 proj.add 'wash dirty dishes'

tag those suckas up

 proj.add 'file taxes @april @15'
 proj.tasks.last.tags                   # [:april, :"15"]
 
 proj.add 'organize shelf'
 proj.tasks.last.tag :knickknacks, 1000, 'september'
 proj.tasks.last.tags                   # [:knickknacks, :"1000", :september]

EDIT As usual, I omit all the pertinent information. You can see the code here and attempt to install the gem with instructions from my previous blog entry.

GitHub is awesome:

$ gem sources -a http://gems.github.com
$ sudo gem install ardekantur-taskomaly

Please to be enjoying.

This is the first release of an evolving library that interacts with the online todo-list thingie Tasko. If you’ve never heard of it, or its brother-in-spirit TaskPaper, you’re in for a treat.

Plain text files, converted to To Do lists with simple formatting rules. Lines that end with a colon are project names. Lines with a hyphen starting them are tasks. Use tags on lines to categorize them. @today, @home, whatever. Tag a line @done to cross it out. Simple!

So now we have Taskomaly, which works on your local machine, interacts with task lists, and can upload them to Tasko using its API. Tasko provides both an API key and a user ID when you register. You need both of these things. Register, then go to your settings page to retrieve them. I suggest placing them in a file in YAML format, like so:

  user: 9999
  key: d9cca721a735dac4efe709e0f3518373

Then, off to irb!

  t = Taskomaly::From '~/.tasks.yml'

Now, get the information you want. Your papers! Make a change, then save them back to the website.

  t.request :papers # ['Paper One', 'Paper Two']
  p = t.papers.first
 
  puts p.name # 'Paper One'
  puts p.body # duh
 
  p.body["@today"] = "@tomorrow"
  p.save # true if groovy, false if failed

This is the first real project I’ve put a huge emphasis on TDD, guided along by the simple principles espoused by Adam Wiggins during his work with the rush shell.

So, yeah. That’s that. Work (and specs) are coming along soon to help you with individual projects inside task papers, searching and using tags, and all kinds of other fun stuff.

EDIT Jesus I forgot to put a link to the project. Here it is. On GitHub. Duh.