==============================================================
 python-uinput - Simple Python API to the Linux uinput-system
==============================================================

:date: 2010-01-16

.. contents::

Description
===========

Uinput allows attaching user-space device drivers into the Linux kernel.
Python-uinput provides a simple and easy to use API to the Linux uinput-system.

General information
===================

- **Author**: `Tuomas Räsänen <http://tuos.codegrove.org/>`_ <tuos@codegrove.org>
- **Homepage**: http://codegrove.org/python-uinput/
- **License**: LGPLv3+ (see COPYING for details)
- **Version**: 0.2

Requirements
============

- Python 2.6. and development files for it:

  - On Ubuntu::

      sudo apt-get install python2.6-dev

- `libsuinput-0.2 <http://codegrove.org/libsuinput/0.2/>`_

Example usage
=============

To create and use an uinput driver::

  import uinput
  driver = uinput.Driver()
  driver.move_pointer(100, 100)
  driver.click(uinput.keycodes.BTN_LEFT)

Downloading
===========

- Tarball is available at: http://codegrove.org/python-uinput/0.2/python-uinput-0.2.tar.gz
- Latest sources from public git-repository: http://github.com/tuos/python-uinput/ ::

    git clone git://github.com/tuos/python-uinput.git

Installing
==========

The install-procedure adheres the "standard"::

  python setup build && sudo python setup install

Bug reporting
=============

Report bugs by sending email to tuos@codegrove.org or by opening an issue
at http://github.com/tuos/python-uinput/issues .
