saddle

Hey nerd! Wrangle your SOA!

Saddle makes writing service clients as easy as giving high fives.©™®℗☃✓

It's a full-featured generic consumer layer for you to build API client implementations on top of.

about

Ok, I love high fives, but what does Saddle do for me?

I'm glad you asked fellow nerd! Do you like automatic retries? Automatic multi-part file posting? I know I sure do!

Do you like sending your POSTs url-encoded? That's okay, I still love you anyways and Saddle has your back. Does your rampant OCD refuse to let you post in anything less structured than JSON? High five nerd, Saddle bleeds OCD. Just set your :post_style flag and fuhgedaboutit!

For an example of a concrete implementation, see saddle-example

features

set default connection settings for your implementation
post urlencoded or JSON
auto-parse JSON responses
automatic retries and exception throwing

guide

Inherit your endpoint from BaseEndpoint and call .get or .post within its action methods
Place those endpoints in the endpoints directory at the root of your client. Nest them if you like.
Inherit your client from Saddle
Call client.endpoint.action()

todo

xml posting
xml parsing
clean up custom middleware loading interface