Mirrored: A Del.icio.us and Ma.gnolia API

Ma.gnolia announced quite some time ago that they had a mirrored api that worked identically to the Del.icio.us api in an effort to make it easier for Del.icio.us add-on/tool creators to make things that worked with Ma.gnolia as well. I thought it was a smart move. Last night, I was in the mood to code, so I put together a gem that wraps that mirrored api (even though I already have a gem for magnolia).

Now, it doesn’t matter which of the social bookmarking sites you use. Either way you have a nice, easy to use ruby api. I thought this might help some of those mashup creators out there. Simply, use mirrored and you can support two social bookmarking sites for the price of one. Pretty cool, eh?

Usage

I’m a huge fan of Active Record so most of my gems have a similar feel thought each is written a bit differently internally. First, install the gem:

sudo gem install mirrored

Now you can reap the benefits of my toil like so:

require 'rubygems'
require 'mirrored'
require 'pp'

# you can use :delicious or :magnolia as the service for the first parameter
Mirrored::Base.establish_connection(:magnolia, 'jnunemaker', 'password')

# this would print all my most recent magnolia posts tagged ruby
pp Mirrored::Post.find(:recent, :tag => 'ruby')

There is a lot more you can do with mirrored, so check out the rubyforge page and the documentation.