README
======

A python library to send application metrics using UDP.

.. image:: https://travis-ci.org/globocom/measures.svg?branch=master
   :target: https://travis-ci.org/globocom/measures
   :alt: Build Status


Using
-----

* Installing

.. code-block:: bash

    pip install measures

* Usage

.. code-block:: python

	from measures import Measure
	measure = Measure('myclient', ('localhost', 1984))
	measure.count('mymetric', dimensions={'name': 'john'})


Contributing
------------

* Set up your environment
	
.. code-block:: bash

    git clone https://github.com/globocom/measures.git
    cd measures
	mkvirtualenv measures
	pip install -r test_requirements.txt

* Run the tests

.. code-block:: bash

	make tests

* Write tests for your new feature or bug fix
* Write needed code changes
* Iterate, have fun :)
* Make a pull request with your changes


Who do I talk to?
-----------------

* File an issue at https://github.com/globocom/measure or contact us at
  busca@corp.globo.com
