Replace sphinx[...]-autoprogram by sphinx-argparse

Why:

sphinxcontrib-autoprogram's pip version does not support python 3. There
is a more recent version in bitbucket's repository but the installation
is tedious for the few features it gives.
(See comment SMART-Lab#160 (comment)
 for more details on the problem)

How:

sphinxcrontrib-autoprogram was only used to generate automatic
documentation of the script smart-dispatch so the replacement was
trivial. The output is slightly different, arguments being included in
tables for sphinx-argparse while not for sphinxcrontrib-autoprogram.
Overall sphinx-argparse seems good enough.

Author: bouthilx

docs/source/conf.py

@@ -30,7 +30,7 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ['sphinx.ext.autodoc', 'sphinxcontrib.autoprogram']
+extensions = ['sphinx.ext.autodoc', 'sphinxarg.ext']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -151,6 +151,3 @@
      author, 'SmartDispatch', 'One line description of project.',
      'Miscellaneous'),
 ]
-
-
-

docs/source/usage.rst

@@ -2,7 +2,9 @@
 Usage
 =====
 
-.. autoprogram:: scripts/smart-dispatch:get_parser()
+.. argparse:: 
+  :filename: ../scripts/smart-dispatch
+  :func: get_parser
   :prog: smart-dispatch