Metadata-Version: 2.1
Name: connexion-plus
Version: 0.5
Summary: Connexion with benefits for microservices
Home-page: https://github.com/Heiss/connexion-plus
Author: Peter Heiss
Author-email: peter.heiss@uni-muenster.de
License: MIT
Download-URL: https://github.com/Heiss/connexion-plus/archive/0.1.tar.gz
Keywords: connexion,microservice,tracing,prometheus,jaeger
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: connexion
Requires-Dist: jaeger-client
Requires-Dist: prometheus-flask-exporter
Requires-Dist: requests
Requires-Dist: opentracing-instrumentation
Requires-Dist: Flask-Opentracing

[Connexion](https://github.com/zalando/connexion) with benefits for microservices.

# Connexion Plus

If you want to use [Connexion](https://github.com/zalando/connexion) for your microservice, you have to add an [opentracing](https://opentracing.io/) or [prometheus](https://prometheus.io/) client on your own. With this library, you instantiate everything before your connexion app starts and this library will take care to put it all together, so you get everything fine.

If you want to know more about the used libraries, please go to the corresponding documentaries.

## Dependencies

```bash
[Connexion](https://github.com/zalando/connexion)
[opentracing-python-instrumentation](https://github.com/uber-common/opentracing-python-instrumentation)
[Flask-Opentracing](https://github.com/opentracing-contrib/python-flask)
[jaeger-client](https://pypi.org/project/jaeger-client/)
[requests](https://pypi.org/project/requests/)
[prometheus-flask-exporter](https://pypi.org/project/prometheus-flask-exporter/)
```

## Importing
```python
import connexion_plus as conn
```

## OpenTracing / Jaeger-Client

Currently, all opentracing implementation (e.g. [jaeger-client](https://pypi.org/project/jaeger-client/)) are supported for tracing. If you want to use it, you have to initialize the client before you start your connexion app and give it via the `tracer`-parameter to the `connexion_plus` Factory, where the magic happens.

The following example uses jaeger-client (`pip install jaeger-client`) implementation.

```python
import connexion_plus as conn
from jaeger_client import Config as jConfig

config = jConfig(
        config={
            'logging': True,
        },
    )
jaeger_tracer = config.initialize_tracer()

app = connexion.App(__name__)
conn.addServices(app, use_tracer=jaeger_tracer)
```

## Prometheus / Metrics

Currently, it is only the [prometheus-flask-exporter](https://pypi.org/project/prometheus-flask-exporter/) supported for connexion, so only for flask connexion. You only have to set the `metrics`-parameter to `True`

```python
import connexion_plus

app = connexion.App(__name__)
conn.addServices(app, use_metric=True)
```

## Example

If you want to use `tracer` and `metrics` together, see here a complete example. This currently works only with flask (see prometheus)

```python
import connexion_plus
from jaeger_client import Config as jConfig
from jaeger_client.metrics.prometheus import PrometheusMetricsFactory

config = jConfig(
        config={
            'logging': True,
        },
        # use this, if you want to track your tracing itself with prometheus
        metrics_factory = PrometheusMetricsFactory(namespace=name),
    )
jaeger_tracer = config.initialize_tracer()

app = connexion.App(__name__)
conn.addServices(app, use_tracer=jaeger_tracer, use_metric=True)
```

If you add the line `metrics_factory=PrometheusMetricsFactory(namespace='yourAppName')` to your jaeger-client-config, you get the metrics out of jaeger to your flask app.



