io_tools
Extracted modules from the Posterous Blog Importer. A way to structure the code needed to connect to various APIs and conform the results to your liking. At it's core is a very simple module that tries to keep things sane when communicating with a multitude of platforms.
Installation
gem install io_tools
Usage
Include the Importer.
class PosterousImporter
include IoTools::Importer
end
The Importer gives you a way to structure your import code. Moving data from one API to another consists of two basic steps, Collecting and Conforming. The rest of the work usually ends up being specific to the API that you are dealing with. So look in the lib/server/importers
directory for how to deal with more complicated APIs that require helper methods.
The collect
method.
class PosterousImporter
include IoTools::Importer
collect :feed_items
def feed_items
[{:title => "Fancy Post", :body => "Is fancy."}]
end
end
The collect
method accepts a method name as a symbol
or a block that will provide an Array
of results from the API or feed. This method does not have to do all the work, all it needs to do is return an Array
.
Hey wait, what format do the results have to be in?
It doesn't matter. This is where our friend the conform
method comes in.
class PosterousImporter
include IoTools::Importer
collect :feed_items
conform do |incoming, conformed|
conformed.title = incoming[:title]
conformed.body = incoming[:body]
conformed
end
def feed_items
[{:title => "Fancy Post", :body => "Is fancy."}]
end
end
The conform method is called for every entry in the Array
that is created by the collect
method. This is where you turn crazy camelcase field names from weird APIs into nice clean attributes that suit your systems needs. conform
is passed the incoming item from the Array
produced by the collect
method. Along with an empty Openstruct
to hold whatever values your system needs. These in turn will populate the final conformed_collection
.
Note on Patches/Pull Requests
- Fork the project.
- Make your feature addition or bug fix.
- Add tests for it. This is important so I don't break it in a future version unintentionally.
- Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
- Send me a pull request. Bonus points for topic branches.
Copyright
Copyright (c) 2010 Posterous Inc. See LICENSE for details.