refs #81 w-i-p - build errors

.readthedocs.yml

@@ -0,0 +1,2 @@
+conda:
+   file: environment.yml

docs/source/conf.py

@@ -240,31 +240,3 @@
 
 # If false, no module index is generated.
 #latex_domain_indices = True
-
-
-# -- Mock  ---------------------------------------------
-# substitute calls for packages not used in building documentation
-
-try:
-    from unittest.mock import MagicMock
-except ImportError:
-    try:
-        from mock import MagicMock
-    except ImportError:
-        raise ImportError("No module named mock - you need to install "
-                           "mock to build the documentation")
-
-for mod_name in punx.__sphinx_mock_list__:
-    sys.modules[mod_name] = MagicMock()
-
-
-class MyPyQt4(MagicMock):
-    class QtCore(object):
-        # PyQt4.QtCore public class mocks
-        _QtCore_public_classes = """QSettings QVariant"""
-        for _name in _QtCore_public_classes.split():
-            locals()[_name] = type(_name, (), {})
-        del _name
-
-
-sys.modules['PyQt4'] = MyPyQt4()

docs/source/index.rst

@@ -1,4 +1,24 @@
-.. include:: ../../README.rst
+####
+punx
+####
+
+Python Utilities for NeXus HDF5 files: validation, structure, hierarchy
+
+* Validation of NeXus NXDL files
+* Validation of NeXus HDF5 data files
+* Display of NeXus HDF5 data file structure
+* Display of NeXus base class hierarchy (stretch goal, graphical output)
+
+NOTE: project is under initial construction
+
+:author:    Pete R. Jemian
+:email:     prjemian@gmail.com
+:copyright: 2017, Pete R. Jemian
+:license:   Creative Commons Attribution 4.0 International Public License (see *LICENSE.txt*)
+:URL:       http://punx.readthedocs.io
+:git:       https://github.com/prjemian/punx
+:PyPI:      https://pypi.python.org/pypi/punx
+:TODO list: https://github.com/prjemian/punx/issues
 
 :version:   |version|
 :release:   |release|

environment.yml

@@ -0,0 +1,15 @@
+name: punx
+dependencies:
+  - h5py
+  - lxml
+  - numpy
+  - python=2.7.*
+  - pyqt=4.*
+  - requests
+  - sip
+  - sphinx
+  - pip:
+    - versioneer
+    - pyRestTable
+    - PyGithub
+

src/punx/__init__.py

@@ -59,17 +59,6 @@
     # see: http://stackoverflow.com/questions/4628519/is-it-possible-to-require-pyqt-from-setuptools-setup-py
     'PyGithub',
     ]
-__sphinx_mock_list__ = [
-    'h5py', 
-    'lxml',
-    'lxml.etree',
-    'numpy', 
-    'pyRestTable',
-    #'requests',
-    # 'PyQt4',  
-    # see: http://stackoverflow.com/questions/4628519/is-it-possible-to-require-pyqt-from-setuptools-setup-py
-    'PyGithub',
-    ]
 __classifiers__ = [
      #'Development Status :: 5 - Production/Stable',
      #'Development Status :: 4 - Beta',