Fix doc build issue with ExtractAs

RTD build was failing due to problems with the
`ExtractAs` class.  Now mocking it.  Possibly
a newer version of Sphinx has pointed out this
old problem.

Added a note on how to do a local doc build
using a Docker container.

Author: ajoubertza

doc/how-to-contribute.rst

@@ -30,9 +30,17 @@ It also uses autodoc_ importing docstrings from tango package.
 Theme is not important, a theme prepared for Tango Community can be also used.
 
 To test the docs locally requires Python >= 3.5:
-      - ``$ pip install sphinx sphinx_rtd_theme``
+      - ``$ python -m pip install sphinx sphinx_rtd_theme``
       - ``$ python setup.py build_doc``
 
+To test the docs locally in a Sphinx Docker container:
+      - ``(host) $ cd /path/to/pytango``
+      - ``(host) $ docker run --rm -ti -v $PWD:/docs sphinxdoc/sphinx bash``
+      - ``(container) $ python -m pip install six numpy sphinx_rtd_theme``
+      - ``(container) $ python -m sphinx doc build/sphinx``
+
+After building, open the ``build/doc/index.html`` page in your browser.
+
 Source code standard
 --------------------
 

doc/mock_tango_extension.py

@@ -115,12 +115,28 @@ def set_device_proxy_implementations(module):
     module.DeviceProxy = type('DeviceProxy', (module.Connection,), attrs)
 
 
+# Create ExtractAs with dummy "methods"
+def set_extract_as_implementation(module):
+    attrs= {
+        '__module__': module.__name__,
+        'ByteArray': None,
+        'Bytes': None,
+        'List': None,
+        'Nothing': None,
+        'Numpy': None,
+        'String': None,
+        'Tuple': None,
+    }
+    module.ExtractAs = type('ExtractAs', (object,), attrs)
+
+
 # Patch the extension module
 _tango = ExtensionMock(name='_tango')
 _tango.constants.TgLibVers = TANGO_VERSION
 _tango._get_tango_lib_release.return_value = TANGO_VERSION_INT
 set_device_implementations(_tango)
 set_device_proxy_implementations(_tango)
+set_extract_as_implementation(_tango)
 
 
 # Patch modules