Metadata-Version: 2.1
Name: amplitude-tracker
Version: 0.0.6
Summary: The hassle-free way to integrate amplitude into any python application.
Home-page: https://github.com/RandomCoffee/amplitude
Author: RandomCoffee
Author-email: tech@random-coffee.com
Maintainer: RandomCoffee
Maintainer-email: tech@random-coffee.com
License: MIT License
Description: 
        Amplitude Tracker
        =================
        
        Amplitude Tracker library lets you record analytics data from your
        Python code to `Amplitude`_
        
        Getting Started
        ---------------
        
        Install ``amplitude-tracker`` using pip:
        
        ::
        
           pip install amplitude-tracker
        
        Inside your app, you’ll want to *set your* ``write_key`` before making
        any analytics calls:
        
        .. code:: python
        
           import amplitude_tracker as amplitude
        
           amplitude.write_key = 'xxxxxxxxxxxxxxx'
        
        *Note:* If you need to send data to multiple Segment sources, you can
        initialize a new Client for each write_key.
        
        Development Settings
        --------------------
        
        The default initialization settings are production-ready and queue
        messages to be processed by a background thread.
        
        In development you might want to enable some settings to make it easier
        to spot problems. Enabling amplitude.debug will log debugging info to
        the Python logger. You can also add an on_error handler to specifically
        print out the response you’re seeing from the Amplitude’s API.
        
        .. code:: python
        
           def on_error(error, items):
               print("An error occurred:", error)
        
        
           analytics.debug = True
           analytics.on_error = on_error
        
        Track
        -----
        
        ``track`` lets you record the actions your users perform. Every action
        triggers what we call an “event”, which can also have associated
        properties.
        
        .. code:: python
        
           import amplitude_tracker as amplitude
           amplitude.write_key = 'xxxxxxxxxxxxxxx'
        
           amplitude.track(
               user_id="xxx",
               event_type="xxx",
               user_properties={"trait": "xxx"},
               event_properties={"attribute": "xxx"})
        
        Batching
        --------
        
        This library is built to support high performance environments. That
        means it is safe to use amplitude-tracker on a web server that’s serving
        hundreds of requests per second.
        
        Every call ``track`` method *does not* result in an HTTP request, but is
        queued in memory instead. Messages are flushed in batch in the
        background, which allows for much faster operation.
        
        By default, this library will flush:
        
        -  every ``100`` messages (control with ``upload_size``)
        -  if ``0.5`` seconds has passed since the last flush (control with
           ``upload_interval``)
        
        There is a maximum of ``500KB`` per batch request and ``32KB`` per call.
        
        .. _Amplitude: https://amplitude.com
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
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.2
Classifier: Programming Language :: Python :: 3.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
Classifier: Programming Language :: Python :: 3.8
Provides-Extra: test
