docs: Move log.rst code into a script in the examples folder.

Author: microbit-carlos

docs/log.rst

@@ -108,37 +108,7 @@ A minimal example::
     def log_temp():
         log.add(temp=temperature())
 
-An example that runs through some of the functions of the log module API::
+An example that runs through some of the functions of the log module API:
 
-    from microbit import *
-    import log
-
-    # Configure the labels and select a time unit for the timestamp
-    log.set_labels('temp', 'brightness', timestamp=log.SECONDS)
-
-    # Send each data row to the serial output
-    log.set_mirroring(True)
-
-    # This decorator schedules this function to run every 10s 50ms
-    @run_every(s=10, ms=50)
-    def log_data():
-        """Log the temperature and light level, and display an icon."""
-        log.add(temp=temperature(), brightness=display.read_light_level())
-        display.show(Image.SURPRISED)
-        sleep(500)
-
-    while True:
-        if button_a.is_pressed() and button_b.is_pressed():
-            display.show(Image.MEH)
-            # Delete the log file using the "full" options, which takes
-            # longer but ensures the data is wiped from the device
-            log.delete(full=True)
-        elif button_a.is_pressed():
-            display.show(Image.HAPPY)
-            # Log only the light level, the temp entry will be empty
-            log.add({
-                "brightness": display.read_light_level()
-            })
-        else:
-            display.show(Image.CONFUSED)
-        sleep(500)
+.. include:: ../examples/data-logging.py
+    :code: python

examples/data-logging.py

@@ -0,0 +1,32 @@
+from microbit import *
+import log
+
+# Configure the labels and select a time unit for the timestamp
+log.set_labels('temp', 'brightness', timestamp=log.SECONDS)
+
+# Send each data row to the serial output
+log.set_mirroring(True)
+
+# This decorator schedules this function to run every 10s 50ms
+@run_every(s=10, ms=50)
+def log_data():
+    """Log the temperature and light level, and display an icon."""
+    log.add(temp=temperature(), brightness=display.read_light_level())
+    display.show(Image.SURPRISED)
+    sleep(500)
+
+while True:
+    if button_a.is_pressed() and button_b.is_pressed():
+        display.show(Image.MEH)
+        # Delete the log file using the "full" options, which takes
+        # longer but ensures the data is wiped from the device
+        log.delete(full=True)
+    elif button_a.is_pressed():
+        display.show(Image.HAPPY)
+        # Log only the light level, the temp entry will be empty
+        log.add({
+            "brightness": display.read_light_level()
+        })
+    else:
+        display.show(Image.CONFUSED)
+    sleep(500)