Metadata-Version: 2.1
Name: aws-satella
Version: 1.5
Summary: Integration of Satella's metrics with AWS CloudWatch
Home-page: https://github.com/piotrmaslanka/aws-satella
Author: Piotr Maślanka
Author-email: piotr.maslanka@henrietta.com.pl
License: UNKNOWN
Project-URL: Code, https://github.com/piotrmaslanka/aws-satella
Project-URL: Issue tracker, https://github.com/piotrmaslanka/aws-satella/issues
Description: # aws-satella
        [![PyPI](https://img.shields.io/pypi/pyversions/aws-satella.svg)](https://pypi.python.org/pypi/aws-satella)
        [![PyPI version](https://badge.fury.io/py/aws-satella.svg)](https://badge.fury.io/py/aws-satella)
        [![PyPI](https://img.shields.io/pypi/implementation/aws-satella.svg)](https://pypi.python.org/pypi/aws-satella)
        [![License](https://img.shields.io/pypi/l/aws-satella)](https://github.com/piotrmaslanka/aws-satella)
        [![Build Status](https://app.travis-ci.com/piotrmaslanka/aws-satella.svg?branch=master)](https://travis-ci.com/piotrmaslanka/aws-satella)
        [![Test Coverage](https://api.codeclimate.com/v1/badges/d460105ad44269de543b/test_coverage)](https://codeclimate.com/github/piotrmaslanka/aws-satella/test_coverage)
        [![Maintainability](https://api.codeclimate.com/v1/badges/d460105ad44269de543b/maintainability)](https://codeclimate.com/github/piotrmaslanka/aws-satella/maintainability)
        [![Issue Count](https://codeclimate.com/github/piotrmaslanka/aws-satella/badges/issue_count.svg)](https://codeclimate.com/github/piotrmaslanka/aws-satella)
        
        A library to export Satella's metrics to AWS CloudWatch
        
        # Installation
        
        ```bash
        pip install aws-satella
        ```
        
        # Usage
        
        ```python
        import sys
        from aws_satella import AWSSatellaExporterThread, InitializationError
        
        
        try:
            aws = AWSSatellaExporterThread('AppNamespace')
            aws.start()
        except InitializationError:
            print('Could not initialize the boto3 client')
            sys.exit(1)
        
        ```
        
        This spawns a daemonic thread. For details,
        refer to the [docs](aws_satella/exporter.py).
        
        You can additionally use
        ```python
        from aws_satella import start_if_not_started
        
        start_if_not_started(*args, **kwargs)
        ```
        Both `args` and `kwargs` will be passed to constructor.
        This will initialize such thread, if one does not exist already.
        
        # Change log
        
        ## v1.5 (to be released)
        
        * added Travis and CodeClimate
        
        ## v1.4
        
        * added handler for metric fail uploads
        * removed the boto_client parameter
        * added InitializationError
        * fixed a critical bug
        
        ## v1.3
        
        * fixed exception handling
        
        ## v1.2
        
        * critical bugfix
        
        ## v1.1
        
        * fixed maximum number of metrics uploaded
        * metrics with dimension count above 10 will be discarded
            with a warning
        
        
Keywords: metrics,aws satella
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Libraries
Requires-Python: !=2.7.*,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*
Description-Content-Type: text/markdown; charset=UTF-8
