ClothRed is in dire need of help. Your help.

I simply don’t have the time, or will–truth be told–to begin work on ClothRed again. The code’s become foreign to me, way too foreign, and I have to get back into the thick of things, to write any useful developments for ClothRed.

So, what is ClothRed? In theory, it’s an HTML to Textile parser, for example to filter user input, so it goes well with RedCloth (see what I did there? Boy, did I think I was clever).

However, the architecture of this thing is rather stupid, if not braindead, working off of hardcoded Arrays of HTML tags and entities, and #gsub’ing those tags. Embarassing, really.

However, it has a complete set of tests from my TDD (it even passes them, except the one I left off, natch). Still kinda proud of this, since ClothRed was my first project to make use of TDD, and the Unit::Test framework).

If you don’t know where to start: I’d get a rewrite off the ground, using Nokogiri, it seems simple enough (and allows to extract innerHTML, and attributes, and all kinds of neat stuff. Would’ve been nice to have that available when I worked on ClothRed).

The Rakefile needs clean up, too.

So, head on over to http://github.com/CynicalRyan/ClothRed, and take a look if you’d be willing to take up the work from there.

Update: Fixed link.

The article, which is un-surprising good in the technical aspect, claimed that the testing framework is able to process your testing scenario in plain text, from the user’s perspective. Without having looked at Cucumber: This is wrong.

“But wait,” you say, “you haven’t looked at Cucumber.” True. However, I bet you dollars to donoughts, that, just as with RSpec, Shoulda, and any other testing frame work, you’ll have to learn a vocabulary to express your thoughts, so that the tool understands what you want. Just because computers can’t do natural language processing. Yet, anyway.

Let’s stop misleading ourselves, in implying that “plain text” means “natural and intuitive”. It isn’t. If I wouldn’t know that Cucumber is doing Behavior Driven Development, I’d have no idea what “Given a…” meant in this context.

For us humans, text needs context, and that has to be provided somehow. This is even worse with computers: We can derive context from content, computers are too stupid to do that. Accordingly, Cucumber needs you to write the test parser (judging by the most curious look I gave it. It’s probably just fine tuning the actual testing and mock ups). Using Regular Expressions, too (just to add insult to injury )

How about we call “plain text” and similar things “understandable”, instead? After all, while these tools don’t live up to what is implied, they are able to make a key point of (agile) development accessible to the most important stakeholder: The customer, while giving us, the developers, a basic template for sanity checks. This is more than important, it is an absolute necessity for our survival as business entities, and in part even as hobbyists! Cucumber’s BDD tests probably don’t need an understanding of the programming language you happen to use, but abstract this away, since it is, in general, not needed at this stage.

Just remember The Law of Leaky Abstractions