Deprecated and remove the Color class

Author: waveform80

docs/deprecated.rst

@@ -600,6 +600,42 @@ as::
     camera = picamera.PiCamera(resolution='720p')
 
 
+Color module
+------------
+
+The :mod:`picamera.color` module has now been split off into the `colorzero`_
+library and as such is deprecated in its entirety. The `colorzero`_ library
+contains everything that the color module used, along with a few enhancements
+and several bug fixes and as such the transition is expected to be trivial.
+Look for any imports of the :class:`~picamera.color.Color` class::
+
+    from picamera import Color
+
+    c = Color('green')
+
+Replace these with references to :class:`colorzero.Color` instead::
+
+    from colorzero import Color
+
+    c = Color('green')
+
+Alternatively, if the :class:`~picamera.color.Color` class is being used
+directly from picamera itself::
+
+    import picamera
+
+    camera = picamera.PiCamera()
+    c = picamera.Color('red')
+
+In this case add an import for colorzero, and reference the class from there::
+
+    import picamera
+    import colorzero
+
+    camera = picamera.PiCamera()
+    c = colorzero.Color('red')
+
+
 .. _semantic versioning: http://semver.org/
 .. _PEP-8: http://legacy.python.org/dev/peps/pep-0008/
-
+.. _colorzero: https://colorzero.readthedocs.io/

picamera/__init__.py

@@ -112,4 +112,3 @@
     )
 from picamera.streams import PiCameraCircularIO, CircularIO, BufferIO
 from picamera.color import Color, Red, Green, Blue, Hue, Lightness, Saturation
-