An open API service indexing awesome lists of open source software.

https://github.com/universe-proton/protoc-gen-swagger

A python package for swagger annotation proto files.
https://github.com/universe-proton/protoc-gen-swagger

grpc grpc-gateway protobuf3 python3 swagger

Last synced: 5 months ago
JSON representation

A python package for swagger annotation proto files.

Awesome Lists containing this project

README

          

protoc-gen-swagger
====================

.. image:: https://travis-ci.org/universe-proton/protoc-gen-swagger.svg?branch=master
:target: https://travis-ci.org/universe-proton/protoc-gen-swagger

A python package for swagger's annotation protobuf files, which are located inside `grpc-gateway `_ repository.

`Swagger `_ is a popular api tool. When you import swagger proto files in your protobuf message file, you may get stuck when using the generated python code.
An import error as the following:

.. code-block::

ModuleNotFoundError: No module named 'protoc_gen_swagger'

With this package, you could forget the error.

Installation
============

We can simply use pip to install, as the following:

.. code-block:: bash

$ pip install protoc-gen-swagger

or installing from git

.. code-block:: bash

$ pip install git+https://github.com/universe-proton/protoc-gen-swagger

Maintain
=========

When the source repository `grpc-gateway `_ is taged, we can use command `bash gen.sh ` to update the package.
Maybe we could do some automated work in the future.

Now, this package version 0.1.0 is the same as grpc-gateway version v1.3.1 .

How to Contribute
=================

Open an `issue `_, join a discussion or make a pull request.