Paul Dix wrote a blog post about trying to design an API. Plz go read it, then come back here :)

While

entry.sanitized.content

reads more like spoken language, I don’t think it’s right. What would I do with the result of entry.sanitized itself? It’s not a meaningful method call without the additional content call. Either of these seems more like Ruby, or indeed more like code instead of making things more ‘human’:

entry.sanitized_content  # API 1
santized(entry.content)  # API 2

If Paul really wants his API, a better approach is to mix some sanitize behaviour into all of the string content that an entry might have. Why should the entry care about sanitizing? Cleaning up strings isn’t the job of that object. Instead, the string itself should be responsible for returning a cleaner version of itself:

entry.content.sanitized  # API 3

It seems much more like programming - here’s an entry, now get the content, and now ask that to return a sanitized version of itself.

module Sanitize
  def sanitize
    Dryopteris.sanitize(self)
  end
end

class Entry
  def content
    @content.extend(Sanitize)
  end
  # ditto for title, author, etc
end

I should add that my prefered solution is actually API 2, where ‘sanitized’ is a method on some object whose responsibility is to present an entry. But I do have a soft-spot for extending returned values to add behaviour.

This is my feedburner subscriber list, over time:

So apparently the feed for interblah.net hasn’t been working for a while. I spent an hour or so poking around the guts of Mephisto this morning, and it should be working again.

What I don’t get is why Feedburner didn’t alert me to the sudden disappearance of the feed (it was returning a 500 error). Surely this would be a useful service? There are no “FeedMedic” reports in my account, so I can only presume that they didn’t notice.

Weird.

Anyway, service resumes as normal! In case you missed any of the more recent posts, I’ve been talking about Vanilla.rb, Speaking at RubyFools, and that fact that shared hosting isn’t evil.

(There's something still broken regarding the comments, alas. Perhaps that will motivate me to finish [Vanilla.rb][1]!)

(Update: comments fixed. Probably. But I’m still going to finish Vanilla.)