Metadata-Version: 1.2
Name: nameko-chassis
Version: 0.2.0
Summary: nameko-chassis provides an opinionated base class for building resilient, observable microservices. 
Home-page: https://github.com/Emplocity/nameko-chassis
Author: Emplocity
Author-email: zbigniew.siciarz@emplocity.pl
License: Apache-2.0
Project-URL: Documentation, https://nameko-chassis.readthedocs.io/
Project-URL: Changelog, https://nameko-chassis.readthedocs.io/en/latest/changelog.html
Project-URL: Issue Tracker, https://github.com/Emplocity/nameko-chassis/issues
Description: ========
        Overview
        ========
        
        .. start-badges
        
        .. list-table::
            :stub-columns: 1
        
            * - docs
              - |docs|
            * - tests
              - | |travis|
                | |coveralls|
            * - package
              - | |version| |wheel| |supported-versions| |supported-implementations|
                | |commits-since|
        .. |docs| image:: https://readthedocs.org/projects/nameko-chassis/badge/?style=flat
            :target: https://readthedocs.org/projects/nameko-chassis
            :alt: Documentation Status
        
        .. |travis| image:: https://api.travis-ci.org/Emplocity/nameko-chassis.svg?branch=master
            :alt: Travis-CI Build Status
            :target: https://travis-ci.org/Emplocity/nameko-chassis
        
        .. |coveralls| image:: https://coveralls.io/repos/Emplocity/nameko-chassis/badge.svg?branch=master&service=github
            :alt: Coverage Status
            :target: https://coveralls.io/r/Emplocity/nameko-chassis
        
        .. |version| image:: https://img.shields.io/pypi/v/nameko-chassis.svg
            :alt: PyPI Package latest release
            :target: https://pypi.org/project/nameko-chassis
        
        .. |wheel| image:: https://img.shields.io/pypi/wheel/nameko-chassis.svg
            :alt: PyPI Wheel
            :target: https://pypi.org/project/nameko-chassis
        
        .. |supported-versions| image:: https://img.shields.io/pypi/pyversions/nameko-chassis.svg
            :alt: Supported versions
            :target: https://pypi.org/project/nameko-chassis
        
        .. |supported-implementations| image:: https://img.shields.io/pypi/implementation/nameko-chassis.svg
            :alt: Supported implementations
            :target: https://pypi.org/project/nameko-chassis
        
        .. |commits-since| image:: https://img.shields.io/github/commits-since/Emplocity/nameko-chassis/v0.2.0.svg
            :alt: Commits since latest release
            :target: https://github.com/Emplocity/nameko-chassis/compare/v0.2.0...master
        
        
        
        .. end-badges
        
        nameko-chassis provides an opinionated base class for building resilient,
        observable microservices with the nameko_ framework.
        
        .. _nameko: https://www.nameko.io/
        
        
        Features
        ========
        
        By using ``nameko_chassis.service.Service``, you'll get:
        
         - error reporting using Sentry
         - integrated metrics endpoint for Prometheus
         - request tracing with Zipkin
         - helpers for service discovery (TODO)
        
        
        Installation
        ============
        
        ::
        
            pip install nameko-chassis
        
        You can also install the in-development version with::
        
            pip install https://github.com/Emplocity/nameko-chassis/archive/master.zip
        
        
        Usage
        =====
        
        .. code-block:: python
        
           from nameko.rpc import rpc
           from nameko_chassis.service import Service
        
        
           class MyService(Service):
               name = "my_service"
        
               @rpc
               def my_method(self):
                   try:
                       self.zipkin.update_binary_annotations({
                          "foo": "bar",
                       })
                   except Exception:
                       self.sentry.captureException()
        
        
        .. note::
           If the RPC method raises an unhandled exception, nameko-sentry will
           automatically capture it to Sentry. The example above demonstrates the case
           when one wants to access the client manually.
        
        
        Documentation
        =============
        
        https://nameko-chassis.readthedocs.io/
        
        
        Development
        ===========
        
        To run the all tests run::
        
            tox
        
        
        Authors
        =======
        
        ``nameko-chassis`` is developed and maintained by `Emplocity`_.
        
        .. _Emplocity: https://emplocity.com/
        
        
        License
        =======
        
        This work is released under the Apache 2.0 license.
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Utilities
Requires-Python: >=3.6.*
