From Swagger's home page:
Swagger is a specification and complete framework implementation for describing, producing, consuming, and visualizing RESTful web services.
Client libraries can automatically be generated from the Swagger specification, however Swagger-py aims to be a compleate replacement for code generation (swagger-codegen).
Swagger.py is a forked from digium/swagger-py for using Swagger defined API's.
from swaggerpy import client
swagger_client = client.get_client("http://petstore.swagger.wordnik.com/api/api-docs")
swagger_client.pet.getPetById(petId=42).result()
More documentation is available at http://swagger-py.readthedocs.org
$ pip install --upgrade git+git://github.com/Yelp/swagger-py
Code is documented using Sphinx.
virtualenv. is recommended to keep dependencies and libraries isolated.
Setuptools is used for
building. Nose is used
for unit testing, with the coverage plugin installed to
generated code coverage reports. Pass --with-coverage
to generate
the code coverage report. HTML versions of the reports are put in
cover/index.html
.
$ make dev # prep for development (install deps, launchers, etc.) $ make test # run unit tests $ make build # build distributable
Copyright (c) 2013, Digium, Inc. All rights reserved. Copyright (c) 2014, Yelp, Inc. All rights reserved.
Swagger.py is licensed with a BSD 3-Clause License.