Fix documentation issue. Documents gets generated locally.

docs/source/SKAAlarmHandler.rst

+.. LMC Base Classes documentation master file, created by
+   sphinx-quickstart on Fri Jan 11 10:03:42 2019.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+SKA AlarmHandler
+============================================
+
+.. toctree::
+   :maxdepth: 2
+
+
+.. automodule:: SKAAlarmHandler.SKAAlarmHandler
+   :members:

docs/source/SKABaseDevice.rst

+.. LMC Base Classes documentation master file, created by
+   sphinx-quickstart on Fri Jan 11 10:03:42 2019.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+SKA BaseDevice
+============================================
+
+.. toctree::
+   :maxdepth: 2
+
+
+.. automodule:: SKABaseDevice.SKABaseDevice
+   :members:

docs/source/SKACapability.rst

+.. LMC Base Classes documentation master file, created by
+   sphinx-quickstart on Fri Jan 11 10:03:42 2019.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+SKA Capability
+============================================
+
+.. toctree::
+   :maxdepth: 2
+
+.. automodule:: SKACapability.SKACapability
+   :members: SKACapability
+

docs/source/SKALogger.rst

+.. LMC Base Classes documentation master file, created by
+   sphinx-quickstart on Fri Jan 11 10:03:42 2019.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+SKA Logger
+============================================
+
+.. toctree::
+   :maxdepth: 2
+
+.. automodule:: SKALogger.SKALogger
+   :members: SKALogger
+

docs/source/SKAMaster.rst

+.. LMC Base Classes documentation master file, created by
+   sphinx-quickstart on Fri Jan 11 10:03:42 2019.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+SKA Master
+============================================
+
+.. toctree::
+   :maxdepth: 2
+
+.. automodule:: SKAMaster.SKAMaster
+   :members: SKAMaster
+

docs/source/SKAObsDevice.rst

+.. LMC Base Classes documentation master file, created by
+   sphinx-quickstart on Fri Jan 11 10:03:42 2019.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+SKA ObsDevice
+============================================
+
+.. toctree::
+   :maxdepth: 2
+
+.. automodule:: SKAObsDevice.SKAObsDevice
+   :members:
+

docs/source/SKASubarray.rst

+.. LMC Base Classes documentation master file, created by
+   sphinx-quickstart on Fri Jan 11 10:03:42 2019.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+SKA Subarray
+============================================
+
+.. toctree::
+   :maxdepth: 2
+
+.. automodule:: SKASubarray.SKASubarray
+   :members: SKASubarray
+

docs/source/SKATelState.rst

+.. LMC Base Classes documentation master file, created by
+   sphinx-quickstart on Fri Jan 11 10:03:42 2019.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+SKA TelState
+============================================
+
+.. toctree::
+   :maxdepth: 2
+
+.. automodule:: SKATelState.SKATelState
+   :members: SKATelState
+

docs/source/conf.py

@@ -12,20 +12,25 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
-import sys
-import os
-from mock import Mock as MagicMock
-
-class Mock(MagicMock):
-    @classmethod
-    def __getattr__(cls, name):
-        return MagicMock()
+# import sys
+# import os
+# from mock import Mock as MagicMock
+#
+# class Mock(MagicMock):
+#     @classmethod
+#     def __getattr__(cls, name):
+#         return MagicMock()
+#
+# # Mock tango modules
+# MOCK_MODULES = ['PyTango', 'tango', 'tango.server', 'run', 'DeviceMeta', 'command',
+#                 'future', 'future.utils', 'logging', 'logging.handlers']
+# sys.modules.update((mod_name, Mock()) for mod_name in MOCK_MODULES)
 
-# Mock tango modules
-MOCK_MODULES = ['PyTango', 'tango', 'tango.server', 'run', 'DeviceMeta', 'command',
+autodoc_mock_imports = ['PyTango', 'tango', 'tango.server', 'run', 'DeviceMeta', 'command',
                         'future', 'future.utils', 'logging', 'logging.handlers']
-sys.modules.update((mod_name, Mock()) for mod_name in MOCK_MODULES)
 
+import sys
+import os
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.

docs/source/index.rst

@@ -10,10 +10,14 @@ Welcome to LMC Base Classes documentation!
   :caption: Table of Contents
   :maxdepth: 2
 
-.. automodule:: SKABaseDevice.SKABaseDeviceModule
-
-.. autoclass:: SKABaseDevice
-   :members:
+   SKA Alarm Handler<SKAAlarmHandler>
+   SKA Base Device<SKABaseDevice>
+   SKA Capability<SKACapability>
+   SKA Logger<SKALogger>
+   SKA Master<SKAMaster>
+   SKA ObsDevice<SKAObsDevice>
+   SKA Subarray<SKASubarray>
+   SKA TelState<SKATelState>
 
 Indices and tables
 ==================

skabase/SKABaseDevice/SKABaseDevice.py

@@ -5,7 +5,7 @@
 #
 #
 
-"""skabasedevice.py: A generic base device for SKA. It exposes the generic attributes,
+"""A generic base device for SKA. It exposes the generic attributes,
 properties and commands of an SKA device.
 """
 from __future__ import print_function
@@ -642,6 +642,11 @@ class SKABaseDevice(with_metaclass(DeviceMeta, Device)):
     @DebugIt()
     def ToJson(self, argin):
         # PROTECTED REGION ID(SKABaseDevice.ToJson) ENABLED START #
+        """
+        ToJson method. Not used. To be deleted.
+        :param argin:
+        :return:
+        """
 
         # TBD - see how to use fandango's export_device_to_dict
         with exception_manager(self):

skabase/SKABaseDevice/__init__.py

@@ -6,14 +6,13 @@
 #
 
 """SKABASE
-
-__init__.py: A generic base device for SKA. It exposes the generic attributes, properties and commands of an SKA device.
+A generic base device for SKA. It exposes the generic attributes, properties and commands of an SKA device.
 """
-# __all__ = ["SKABaseDevice", "main"]
-#
-# from skabase import release
-# from .SKABaseDevice import SKABaseDevice, main
-#
-# __version__ = release.version
-# __version_info__ = release.version_info
-# __author__ = release.author
+__all__ = ["SKABaseDevice", "main"]
+
+from skabase import release
+from .SKABaseDevice import SKABaseDevice, main
+
+__version__ = release.version
+__version_info__ = release.version_info
+__author__ = release.author
\ No newline at end of file

skabase/__init__.py

-# __all__ = ["auxiliary",
-#            "SKAAlarmHandler",
-#            "SKABaseDevice",
-#            "SKACapability",
-#            "SKALogger",
-#            "SKAMaster",
-#            "SKAObsDevice",
-#            "SKASubarray",
-#            "SKATelState"
-#            ]
-
-# from pkgutil import extend_path
-# __path__ = extend_path(__path__, __name__)
+__all__ = ["auxiliary",
+           "SKAAlarmHandler",
+           "SKABaseDevice",
+           "SKACapability",
+           "SKALogger",
+           "SKAMaster",
+           "SKAObsDevice",
+           "SKASubarray",
+           "SKATelState"
+            ]
\ No newline at end of file

skabase/release.py

@@ -7,7 +7,7 @@
 
 """Release information for lmc-base-classes Python Package"""
 
-name = """lmc-base-classes"""
+name = """lmcbaseclasses"""
 version = "1.0.0"
 version_info = version.split(".")
 description = """A set of generic base devices for SKA Telescope."""