docs: update conf.py

Author: alexfikl

docs/conf.py

@@ -5,48 +5,35 @@
 import os
 import sys
 
+try:
+    from importlib import metadata
+except ImportError:
+    import importlib_metadata as metadata
+
 # path to autogen'ed modules
 sys.path.append(os.path.abspath('..'))
-
-# mock out some extension modules
-class Mock:
-    def __init__(self, *args, **kwargs):
-        pass
-
-    def __call__(self, *args, **kwargs):
-        return Mock()
-
-    @classmethod
-    def __getattr__(self, name):
-        if name in ('__file__', '__path__'):
-            return '/dev/null'
-        elif name[0] == name[0].upper():
-            return type(name, (), {})
-        else:
-            return Mock()
-
-for mod_name in [ 'sympy', 'numpy', 'pyweno.codeprinters', 'pyweno.ccoeffs', 'pyweno.cweno' ]:
-    sys.modules[mod_name] = Mock()
+m = metadata.metadata('PyWENO')
 
 # extentions
-extensions = ['sphinx.ext.autodoc', 'sphinx.ext.mathjax']
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.mathjax',
+    ]
 
 # general configuration
 source_suffix  = '.rst'
 master_doc     = 'index'
 
 # html configuration
 pygments_style = 'sphinx'
-html_theme     = 'default'
+html_theme     = 'sphinx_rtd_theme'
 
 html_sidebars = {
     '**': ['globaltoc.html', 'searchbox.html'],
     }
 
 # project information
-project   = 'PyWENO'
-copyright = '2009, 2010, 2011, Matthew Emmett'
-
-with open('../version.py') as f:
-    exec(f.read())  # this sets 'version'
-release = version
+project   = m['Name']
+author = m['Author-email']
+copyright = f'2009, 2010, 2011 {author}'
+release = m['Version']

docs/reference.rst

@@ -46,9 +46,3 @@ Non-uniform reconstructions
 
 .. automodule:: pyweno.nonuniform
    :members:
-
-
-Version
--------
-
-.. automodule:: pyweno.version

docs/tutorial.rst

@@ -47,11 +47,12 @@ The code to generate the above is in
 Version information
 -------------------
 
-Here we obtain the version of PyWENO::
+PyWENO uses standard Python packaging, so its version information can be obtained
+through ``importlib``. However, you can also get it from the module itself::
 
-  >>> import pyweno.version
-  >>> pyweno.version.version()
-  >>> pyweno.version.git_version()
+  >>> from pyweno import __version__
+  >>> __version__
+  '0.11.2'