python tutorial, part 1: Creating a service

This is the first part in a four part series on  In this part, we will:

  • Install the reference implementation.
  • Create a simple example service.
  • Use "curl" to experiment using the service.

What is is an open specification for a way to design RESTful web services.  I've described earlier why this is desirable, but to summarize:

  • Shared expectations: RESTful web services can be just about anything, so long as they follow a few design principles.  So, when someone says a service is RESTful, you will still need to read its documentation and learn how specifically that service works.  If a service conforms to, however, this means it conforms to a specific design.


Over the past several months, I've been thinking about how to make a really strong RESTful API for Lingwo.flashcards.  At my straight job, there has also been lots of talk about building a RESTful API (although, unfortunately, no actual work!  I'm bursting at the seams to start it!).  This and the fact that all the other Lingwo Projects will need APIs, has compelled me to take the API design I've come up with and release it as an open specification.

So, to start over... is an open specification for a pattern by which one can design RESTful web-services.

But why do we need such a specification?

Well, being RESTful means that you adhere to some rather abstract concepts.  Two APIs can be designed in drastically different ways and still be perfectly RESTful.  We can gain alot by having a standard:

Ash Wednesday Update!

I haven't posted in awhile, I apologize! Today is Ash Wednesday, the beginning of Lent, however, I didn't make it to mass because we were hit with a massive blizzard. I walked home from work, partly because the buses stopped running and partly because I'm bad-ass. ;-) It was good exercise.

Here are my projects as of late:

  • Released POE::Component::MessageQueue version 0.1.8! I have to give most of the credit to Paul Driver who really did all the work this release. But its still exciting!
Syndicate content