Add extras_require to setup.py for optional dependencies

README.rst

@@ -37,14 +37,46 @@ All packages in apptools require:
 
 * `traits <https://github.com/enthought/traits>`_
 
+Certain sub-packages within apptools have their own specific dependencies,
+which are optional for apptools overall.
+
 The `apptools.preferences` package requires:
 
 * `configobj <http://pypi.python.org/pypi/configobj>`_
 
+The `apptools.io.h5` package requires:
+
+* `numpy <https://pypi.org/project/numpy/>`_
+* `pandas <https://pypi.org/project/pandas/>`_
+* `tables <https://pypi.org/project/tables/>`_
+
+The `apptools.persistence` package requires:
+
+* `numpy <https://pypi.org/project/numpy/>`_
+
 Many of the packages provide optional user interfaces using Pyface and
 Traitsui. In additon, many of the packages are designed to work with the
 Envisage plug-in system, althought most can be used independently:
 
 * `envisage <https://github.com/enthought/envisage>`_
 * `pyface <https://github.com/enthought/pyface>`_
 * `traitsui <https://github.com/enthought/traitsui>`_
+
+Installation
+------------
+
+To install with `apptools.preferences` dependencies::
+
+    $ pip install apptools[preferences]
+
+To install with `apptools.io.h5` dependencies::
+
+    $ pip install apptools[h5]
+
+To install with `apptools.persistence` dependencies::
+
+    $ pip install apptools[persistence]
+
+To install with additional test dependencies::
+
+    $ pip install apptools[test]

apptools/logger/log_point.py

@@ -15,8 +15,6 @@
 
 # Standard library imports.
 import inspect
-
-# Third-party library imports.
 from io import StringIO
 
 

apptools/logger/plugin/logger_service.py

@@ -8,13 +8,11 @@
 #
 # Thanks for using Enthought open source!
 # Standard library imports
+from io import BytesIO
 import logging
 import os
 import zipfile
 
-# Third-party library imports
-from io import BytesIO
-
 # Enthought library imports
 from pyface.workbench.api import View as WorkbenchView
 from traits.api import (

docs/releases/upcoming/257.build.rst

@@ -0,0 +1 @@
+Add extras_require to setup.py for optional dependencies (#257)

setup.py

@@ -310,6 +310,17 @@ def get_long_description():
             "test": [
                 "importlib-resources>=1.1.0",
             ],
+            "h5": [
+                "numpy",
+                "pandas",
+                "tables",
+            ],
+            "persistence": [
+                "numpy",
+            ],
+            "preferences": [
+                "configobj",
+            ],
         },
         license='BSD',
         packages=find_packages(),