Swagger: A simple, open standard for describing REST APIs with JSON
developers.helloreverb.com/swagger
What Jamie wrote
I've met the CTO at Wordnik and Swagger is something they are pretty proud of. Might be worth implementing a Python version.
Swagger is a specification and complete framework implementation for describing, producing, consuming, and visualizing RESTful web services.