Moved emulator code to rm-hull/luma.emulator github repo

CHANGES.rst

@@ -5,6 +5,7 @@ ChangeLog
 | Version    | Description                                                         | Date       |
 +============+=====================================================================+============+
 | *Upcoming* | * Fix bug in seven_segment transform (display correct char)         |            |
+|            | * Moved emulator code to ``rm-hull/luma.emulator`` github repo      |            |
 +------------+---------------------------------------------------------------------+------------+
 | **0.1.15** | * Require at least Pillow 4.0.0                                     | 2017/02/11 |
 |            | * Configurable ``transfer_size`` on SPI writes                      |            |

doc/api-documentation.rst

@@ -8,63 +8,48 @@ API Documentation
     :undoc-members:
     :show-inheritance:
 
-
 :mod:`luma.core.device`
 """""""""""""""""""""""
 .. automodule:: luma.core.device
     :members:
     :undoc-members:
     :show-inheritance:
 
-
-:mod:`luma.core.emulator`
-"""""""""""""""""""""""""
-.. automodule:: luma.core.emulator
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-
 :mod:`luma.core.error`
 """"""""""""""""""""""
 .. automodule:: luma.core.error
     :members:
     :undoc-members:
     :show-inheritance:
 
-
 :mod:`luma.core.mixin`
 """"""""""""""""""""""
 .. automodule:: luma.core.mixin
     :members:
     :undoc-members:
     :show-inheritance:
 
-
 :mod:`luma.core.render`
 """""""""""""""""""""""
 .. automodule:: luma.core.render
     :members:
     :undoc-members:
     :show-inheritance:
 
-
 :mod:`luma.core.serial`
 """""""""""""""""""""""
 .. automodule:: luma.core.serial
     :members:
     :undoc-members:
     :show-inheritance:
 
-
 :mod:`luma.core.threadpool`
 """""""""""""""""""""""""""
 .. automodule:: luma.core.threadpool
     :members:
     :undoc-members:
     :show-inheritance:
 
-
 :mod:`luma.core.virtual`
 """"""""""""""""""""""""
 .. automodule:: luma.core.virtual

luma/core/device.py

@@ -4,7 +4,7 @@
 
 import atexit
 
-from luma.core.serial import i2c
+from luma.core.serial import i2c, noop
 from luma.core import mixin
 import luma.core.const
 
@@ -85,3 +85,24 @@ def cleanup(self):
         self.hide()
         self.clear()
         self._serial_interface.cleanup()
+
+
+class dummy(device):
+    """
+    Pseudo-device that acts like a physical display, except that it does nothing
+    other than retain a copy of the displayed image. It is mostly useful for
+    testing. Supports 24-bit color depth.
+    """
+    def __init__(self, width=128, height=64, rotate=0, mode="RGB", **kwargs):
+        super(dummy, self).__init__(serial_interface=noop())
+        self.capabilities(width, height, rotate, mode)
+        self.image = None
+
+    def display(self, image):
+        """
+        Takes a :py:mod:`PIL.Image` and makes a copy of it for later
+        use/inspection.
+        """
+        assert(image.size == self.size)
+
+        self.image = self.preprocess(image).copy()