Skip to content

Commit 5ebd23a

Browse files
Usage examples of the new API.
1 parent 2f0a0f9 commit 5ebd23a

1 file changed

Lines changed: 50 additions & 10 deletions

File tree

README

Lines changed: 50 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,6 @@
22
python-uinput - Simple Python API to the Linux uinput-system
33
==============================================================
44

5-
:date: 2010-01-16
6-
75
.. contents::
86

97
Description
@@ -18,7 +16,7 @@ General information
1816
- **Author**: `Tuomas Räsänen <http://tuos.codegrove.org/>`_ <tuos@codegrove.org>
1917
- **Homepage**: http://codegrove.org/python-uinput/
2018
- **License**: LGPLv3+ (see COPYING for details)
21-
- **Version**: 0.2
19+
- **Version**: 0.3
2220

2321
Requirements
2422
============
@@ -29,22 +27,64 @@ Requirements
2927

3028
sudo apt-get install python2.6-dev
3129

32-
- `libsuinput-0.2 <http://codegrove.org/libsuinput/0.2/>`_
33-
3430
Example usage
3531
=============
3632

37-
To create and use an uinput driver::
33+
Create and use a new uinput device with key-capabilities::
34+
35+
import uinput
36+
37+
device = uinput.Device()
38+
39+
keys = uinput.KeyCapabilities(device)
40+
keys.add(uinput.KEY_A)
41+
keys.add(uinput.KEY_B)
42+
43+
keys.click(uinput.KEY_A)
44+
keys.click(uinput.KEY_B)
45+
keys.click(uinput.KEY_B)
46+
keys.press(uinput.KEY_A)
47+
keys.release(uinput.KEY_A)
48+
49+
Use built-in mouse-device::
50+
51+
import uinput.devices
52+
53+
mouse = uinput.devices.Mouse()
54+
55+
mouse.move(100, 100)
56+
57+
Use built-in keyboard-device::
58+
59+
import uinput.devices
60+
61+
keyboard = uinput.devices.Keyboard()
62+
63+
keyboard.click(uinput.KEY_H)
64+
keyboard.click(uinput.KEY_E)
65+
keyboard.click(uinput.KEY_L)
66+
keyboard.click(uinput.KEY_L)
67+
keyboard.click(uinput.KEY_O)
68+
69+
Create and use a new device with key and absolute-axis capability::
3870

3971
import uinput
40-
driver = uinput.Driver()
41-
driver.move_pointer(100, 100)
42-
driver.click(uinput.keycodes.BTN_LEFT)
72+
73+
device = uinput.Device()
74+
75+
abs_axes = uinput.AbsoluteAxisCapabilities(device)
76+
abs_axes.add(uinput.ABS_X, abs_min=-50, abs_max=50)
77+
78+
keys = uinput.KeyCapabilities(device)
79+
keys.add(uinput.BTN_GAMEPAD)
80+
81+
abs_axes.move_to(uinput.ABS_X, 15)
82+
keys.click(uinput.BTN_GAMEPAD)
4383

4484
Downloading
4585
===========
4686

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

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

0 commit comments

Comments
 (0)