Metadata-Version: 2.1
Name: opencensus-ext-grpc
Version: 0.7.2
Summary: OpenCensus gRPC Integration
Home-page: https://github.com/census-instrumentation/opencensus-python/tree/master/contrib/opencensus-ext-grpc
Author: OpenCensus Authors
Author-email: census-developers@googlegroups.com
License: Apache-2.0
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: grpcio (<2.0.0,>=1.0.0)
Requires-Dist: opencensus (<1.0.0,>=0.7.12)

OpenCensus gRPC Integration
============================================================================

|pypi|

.. |pypi| image:: https://badge.fury.io/py/opencensus-ext-grpc.svg
   :target: https://pypi.org/project/opencensus-ext-grpc/

OpenCensus provides the implementation of interceptors for both the client side
and server side to instrument the gRPC requests and responses. The client
interceptors are used to create a decorated channel that intercepts client
gRPC calls and server interceptors act as decorators over handlers.

gRPC interceptor is a new feature in the grpcio1.8.0 release, please upgrade
your grpcio to the latest version to use this feature.

For sample usage, please refer to the hello world example in the examples
directory.

More information about the gRPC interceptors please see the `proposal`_.

.. _proposal: https://github.com/mehrdada/proposal/blob/python-interceptors/L13-Python-Interceptors.md

Installation
------------

::

    pip install opencensus-ext-grpc

Usage
-----

Please refer to the `examples <https://github.com/census-instrumentation/opencensus-python/tree/master/contrib/opencensus-ext-grpc/examples>`_.
For more information, read `gRPC Python Interceptors <https://github.com/grpc/proposal/blob/master/L13-python-interceptors.md>`_.

References
----------

* `Examples <https://github.com/census-instrumentation/opencensus-python/tree/master/contrib/opencensus-ext-grpc/examples>`_
* `gRPC <https://grpc.io/>`_
* `OpenCensus Project <https://opencensus.io/>`_


