Metadata-Version: 2.0
Name: inklevel
Version: 0.1.2
Summary: Python wrapper for libinklevel
Home-page: https://github.com/tom-mi/python-inklevel/
Author: Thomas Reifenberger
Author-email: tom-mi at rfnbrgr.de
License: GPLv2
Platform: any
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
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: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: System :: Monitoring
Requires-Dist: enum34

python-inklevel
===============

|Build Status|

Python wrapper for
`libinklevel <http://libinklevel.sourceforge.net/>`__.

Prerequisites
-------------

Install `libinklevel <http://libinklevel.sourceforge.net/>`__, e.g. on
Debian:

::

    apt-get install libinklevel

Installation
------------

::

    pip install inklevel

Usage
-----

::

    import inklevel

    # libinklevel version
    print(inklevel.get_version_string())

    # Get data from /dev/usb/lp0:
    data = inklevel.get_usb_ink_level(0)

    for cartridge, value in data.levels:
        print('{}: {}'.format(cartridge.description, value))

    # Get data from /dev/parport2
    data = inklevel.get_parport_ink_level(2)

The functions ``get_usb_ink_level`` and ``get_parport_ink_level`` are
convenience functions using the original libinklevel interface. You can
also use that:

::

    data = inklevel.get_ink_level(inklevel.Port.USB, None, 0)
    data = inklevel.get_ink_level(inklevel.Port.CUSTOM_USB, '/dev/usb/lp0', None)

See `libinklevel <http://libinklevel.sourceforge.net/>`__ and
`ink <http://ink.sourceforge.net/>`__ for details.

License
-------

This software is licensed under GPLv2.

.. |Build Status| image:: https://travis-ci.org/tom-mi/python-inklevel.svg?branch=master
   :target: https://travis-ci.org/tom-mi/python-inklevel


