skip to navigation
skip to content

Not Logged In

metrique 0.2.5-3a

Metrique - Client Libraries

Latest Version: 0.3.0-6a

.. image:: ../metriqued/metriqued/static/img/metrique_logo.png

Metrique Client
===============

**Author:** "Chris Ward" <cward@redhat.com>

**Sources:** https://github.com/drpoovilleorg/metrique


Install
~~~~~~~

**Make sure you have read the `General Install Guide <https://github.com/drpoovilleorg/metrique/tree/master/README.rst>`_.**

Install hdf5 *OS* dependencies::

    sudo yum install hdf5-devel  # Fedora
    # sudo apt-get install libhdf5-serial-dev  # Ubuntu

Install metrique::

    pip install metrique

To start using `metrique`, in ipython notebook, for example::

    $> ipython notebook --pylab=inline
    ...
    >>> from metrique import pyclient

Then, to load a new pyclient instance for querying::

    >>> m = pyclient(host='http://127.0.0.1')

Ping the server to ensure your connected. If all
is well, metriqe server should pong your ping!::

    >>> m.ping()
        PONG ($METRIQUED_HOSTNAME)

Now you can start exploring what data already exists
on the host::

    >>> m.list_cubes()
    ...
    >>> m.list_cube_fields('cube_name_here')
    ...

And assuming you have a metriqued host to connect to,
with data in already, you can get to work!::

    >>> q = m.find('gitrepo_commit', 'author, committer_ts')
    >>> q.groupby(['author']).size().plot(kind='barh')
        <matplotlib.axes.AxesSubplot at 0x6f77ad0>


**If you plan to extract data (optional)**, see
`metriquec <https://github.com/drpoovilleorg/metrique/tree/master/src/metriquec>`_ to install metriques default cubes.


Known Issues
------------

Import Warnings
~~~~~~~~~~~~~~~
When running (eg) `from metrique import pyclient` for the
first time in a session, you might see a warning like::

    Module bson was already imported from ...

This warning can be safely **ignored**. It's only a warning.

Configuration
~~~~~~~~~~~~~
When loading a server instance, if you get an error about loading
`http_api.json`, run `metrique-setup`
 
File Type Py Version Uploaded on Size
metrique-0.2.5-3a.tar.gz (md5) Source 2013-12-06 22KB
  • Downloads (All Versions):
  • 108 downloads in the last day
  • 615 downloads in the last week
  • 4288 downloads in the last month