Convert recipe examples to includes

Makes it much easier to test things - no copying'n'pasting just run the
examples straight from the dir (after wiring stuff up)

Author: waveform80

docs/conf.py

@@ -74,6 +74,7 @@ def __getattr__(cls, name):
 
 intersphinx_mapping = {
     'python': ('http://docs.python.org/3.4', None),
+    'picamera': ('http://picamera.readthedocs.io/en/latest', None),
     }
 
 # -- Options for HTML output ----------------------------------------------

docs/examples/all_on_1.py

@@ -0,0 +1,9 @@
+from gpiozero import FishDish
+from signal import pause
+
+fish = FishDish()
+
+fish.button.when_pressed = fish.on
+fish.button.when_released = fish.off
+
+pause()

docs/examples/all_on_2.py

@@ -0,0 +1,9 @@
+from gpiozero import TrafficHat
+from signal import pause
+
+th = TrafficHat()
+
+th.button.when_pressed = th.on
+th.button.when_released = th.off
+
+pause()

docs/examples/all_on_3.py

@@ -0,0 +1,23 @@
+from gpiozero import LED, Buzzer, Button
+from signal import pause
+
+button = Button(2)
+buzzer = Buzzer(3)
+red = LED(4)
+amber = LED(5)
+green = LED(6)
+
+things = [red, amber, green, buzzer]
+
+def things_on():
+    for thing in things:
+        thing.on()
+
+def things_off():
+    for thing in things:
+        thing.off()
+
+button.when_pressed = things_on
+button.when_released = things_off
+
+pause()

docs/examples/button_1.py

@@ -0,0 +1,9 @@
+from gpiozero import Button
+
+button = Button(2)
+
+while True:
+    if button.is_pressed:
+        print("Button is pressed")
+    else:
+        print("Button is not pressed")

docs/examples/button_2.py

@@ -0,0 +1,6 @@
+from gpiozero import Button
+
+button = Button(2)
+
+button.wait_for_press()
+print("Button was pressed")

docs/examples/button_3.py

@@ -0,0 +1,11 @@
+from gpiozero import Button
+from signal import pause
+
+def say_hello():
+    print("Hello!")
+
+button = Button(2)
+
+button.when_pressed = say_hello
+
+pause()

docs/examples/button_4.py

@@ -0,0 +1,15 @@
+from gpiozero import Button
+from signal import pause
+
+def say_hello():
+    print("Hello!")
+
+def say_goodbye():
+    print("Goodbye!")
+
+button = Button(2)
+
+button.when_pressed = say_hello
+button.when_released = say_goodbye
+
+pause()

docs/examples/button_camera_1.py

@@ -0,0 +1,15 @@
+from gpiozero import Button
+from picamera import PiCamera
+from datetime import datetime
+from signal import pause
+
+button = Button(2)
+camera = PiCamera()
+
+def capture():
+    datetime = datetime.now().isoformat()
+    camera.capture('/home/pi/%s.jpg' % datetime)
+
+button.when_pressed = capture
+
+pause()

docs/examples/button_camera_2.py

@@ -0,0 +1,18 @@
+from gpiozero import Button
+from picamera import PiCamera
+from datetime import datetime
+from signal import pause
+
+left_button = Button(2)
+right_button = Button(3)
+camera = PiCamera()
+
+def capture():
+    datetime = datetime.now().isoformat()
+    camera.capture('/home/pi/%s.jpg' % datetime)
+
+left_button.when_pressed = camera.start_preview
+left_button.when_released = camera.stop_preview
+right_button.when_pressed = capture
+
+pause()