Merge pull request #557 from librosa/show-versions

added show_versions. fixes #543

librosa/__init__.py

@@ -5,6 +5,7 @@
 import warnings
 import re
 from .version import version as __version__
+from .version import show_versions
 
 # And all the librosa sub-modules
 from . import cache

librosa/version.py

@@ -2,5 +2,55 @@
 # -*- coding: utf-8 -*-
 """Version info"""
 
+import sys
+import importlib
+
 short_version = '0.5'
 version = '0.5.0'
+
+
+def __get_mod_version(modname):
+
+    try:
+        if modname in sys.modules:
+            mod = sys.modules[modname]
+        else:
+            mod = importlib.import_module(modname)
+        try:
+            return mod.__version__
+        except AttributeError:
+            return 'installed, no version number available'
+
+    except ImportError:
+        return None
+
+
+def show_versions():
+    '''Return the version information for all librosa dependencies.'''
+
+    core_deps = ['audioread',
+                 'numpy',
+                 'scipy',
+                 'scikit-learn',
+                 'joblib',
+                 'decorator',
+                 'six',
+                 'resampy']
+
+    extra_deps = ['numpydoc',
+                  'sphinx',
+                  'sphinx_rtd_theme',
+                  'sphinxcontrib-versioning',
+                  'matplotlib',
+                  'numba']
+
+    print('INSTALLED VERSIONS')
+    print('------------------')
+    print('python: {}\n'.format(sys.version))
+    print('librosa: {}\n'.format(version))
+    for dep in core_deps:
+        print('{}: {}'.format(dep, __get_mod_version(dep)))
+    print('')
+    for dep in extra_deps:
+        print('{}: {}'.format(dep, __get_mod_version(dep)))
+    pass

tests/test_core.py

@@ -1202,3 +1202,8 @@ def test_harmonics_2d_varying():
             step = h[i]
             vals = y[::step]
             assert np.allclose(vals, yh[i, :len(vals)])
+
+
+def test_show_versions():
+    # Nothing to test here, except that everything passes.
+    librosa.show_versions()