ocs-client-cli: add docs and move it into library to be a console-script

docs/user/cli_tools.rst

@@ -153,3 +153,18 @@ For information on how to run::
     is meant to only avoid reuploading already pushed data, particularly valuable
     if you need to restart a large upload job. This will be ``.g32influx.db`` in
     the directory you run the script from.
+
+
+ocs-client-cli
+==============
+
+(The output from ``ocs-client-cli --help`` should be rendered here.
+In addition to the options discussed, the script supports the same
+"Site Config Options" that Agents usually support, such as
+``--site-file=...``.  If there are some stray instances of
+``%(prog)s``, imagine ``ocs-client-cli`` in their place.)
+
+.. argparse::
+   :module: ocs.client_cli
+   :func: get_parser
+   :prog: ocs-client-cli

bin/ocs-client-cli → ocs/client_cli.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python3
-
 import argparse
 import sys
 import code
@@ -28,7 +26,6 @@
 
   %(prog)s scan
 
-----
 """
 
 
@@ -135,6 +132,3 @@ def main(args=None):
         shell(parser, args)
     else:
         parser.error(f"Unknown command '{args.command}'")
-
-if __name__ == '__main__':
-    main()

setup.py

@@ -6,7 +6,12 @@
        description='Observatory Control System',
        package_dir={'ocs': 'ocs'},
        packages=find_packages(include=['ocs', 'ocs.*']),
-       scripts=['bin/ocsbow', 'bin/ocs-client-cli'],
+       scripts=['bin/ocsbow'],
+       entry_points={
+           'console_scripts': [
+               'ocs-client-cli=ocs.client_cli:main',
+               ],
+       },
        package_data={'': ['support/*json']}, 
        version=versioneer.get_version(),
        cmdclass=versioneer.get_cmdclass())