Skip to content

Latest commit

 

History

History
78 lines (53 loc) · 2.18 KB

README.rst

File metadata and controls

78 lines (53 loc) · 2.18 KB
https://travis-ci.org/Yelp/swagger-py.png?branch=master

Swagger-py

About

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.

Example Usage

from swaggerpy import client
swagger_client = client.get_client("http://petstore.swagger.wordnik.com/api/api-docs")
swagger_client.pet.getPetById(petId=42).result()

Documentation

More documentation is available at http://swagger-py.readthedocs.org

Installation

$ pip install --upgrade git+git://github.com/Yelp/swagger-py

Development

Code is documented using Sphinx.

virtualenv. is recommended to keep dependencies and libraries isolated.

Setup

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

License

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.