========
gpiozero

A simple interface to everyday GPIO components used with Raspberry Pi.

Created by Ben Nuttall_ of the Raspberry Pi Foundation, Dave Jones, and
other contributors.

Latest release

The latest release is 1.0 released on 16th November 2015.

About

Component interfaces are provided to allow a frictionless way to get started
with physical computing::

from gpiozero import LED
from time import sleep

led = LED(2)

while True:
    led.on()
    sleep(1)
    led.off()
    sleep(1)

With very little code, you can quickly get going connecting your components
together::

from gpiozero import LED, Button
from signal import pause

led = LED(2)
button = Button(3)

button.when_pressed = led.on
button.when_released = led.off

pause()

The library includes interfaces to many simple everyday components, as well as
some more complex things like sensors, analogue-to-digital converters, full
colour LEDs, robotics kits and more.

Install

First, update your repositories list::

sudo apt-get update

Then install the package of your choice. Both Python 3 and Python 2 are
supported. Python 3 is recommended::

sudo apt-get install python3-gpiozero

or::

sudo apt-get install python-gpiozero

Documentation

Comprehensive documentation is available at pythonhosted.org/gpiozero_.

Development

This project is being developed on GitHub_. Join in:

• Provide suggestions, report bugs and ask questions as Issues_
• Provide examples we can use as recipes_
• Contribute to the code

Alternatively, email suggestions and feedback to ben@raspberrypi.org or add to
the Google Doc_.

Contributors

• Ben Nuttall_ (project maintainer)
• Dave Jones_
• Martin O'Hanlon_

.. _Ben Nuttall: https://github.com/bennuttall
.. _Raspberry Pi Foundation: https://www.raspberrypi.org/
.. _Dave Jones: https://github.com/waveform80
.. _pythonhosted.org/gpiozero: http://pythonhosted.org/gpiozero
.. _GitHub: https://github.com/RPi-Distro/python-gpiozero
.. _Issues: https://github.com/RPi-Distro/python-gpiozero/issues
.. _recipes: http://pythonhosted.org/gpiozero/recipes/
.. _Google Doc: https://goo.gl/8zJLif
.. _Ben Nuttall: https://github.com/bennuttall
.. _Dave Jones: https://github.com/waveform80
.. _Martin O'Hanlon: https://github.com/martinohanlon