feat: add support for running via uvicorn; wutta webapp command

docs/api/wuttaweb.cli.rst

@@ -0,0 +1,6 @@
+
+``wuttaweb.cli``
+================
+
+.. automodule:: wuttaweb.cli
+   :members:

docs/api/wuttaweb.cli.webapp.rst

@@ -0,0 +1,6 @@
+
+``wuttaweb.cli.webapp``
+=======================
+
+.. automodule:: wuttaweb.cli.webapp
+   :members:

docs/conf.py

@@ -21,6 +21,7 @@ extensions = [
     'sphinx.ext.intersphinx',
     'sphinx.ext.viewcode',
     'sphinx.ext.todo',
+    'sphinxcontrib.programoutput',
 ]
 
 templates_path = ['_templates']

docs/index.rst

@@ -19,6 +19,7 @@ the narrative docs are pretty scant.  That will eventually change.
    :caption: Documentation:
 
    glossary
+   narr/cli/index
    narr/templates/index
 
 .. toctree::
@@ -28,6 +29,8 @@ the narrative docs are pretty scant.  That will eventually change.
    api/wuttaweb
    api/wuttaweb.app
    api/wuttaweb.auth
+   api/wuttaweb.cli
+   api/wuttaweb.cli.webapp
    api/wuttaweb.conf
    api/wuttaweb.db
    api/wuttaweb.db.continuum

docs/narr/cli/builtin.rst

@@ -0,0 +1,28 @@
+
+===================
+ Built-in Commands
+===================
+
+Below are the :term:`subcommands <subcommand>` which come with
+WuttaWeb.
+
+
+.. _wutta-webapp:
+
+``wutta webapp``
+----------------
+
+Run the web app, according to config file(s).
+
+This command is a convenience only; under the hood it can run `uvicorn
+<https://www.uvicorn.org/#uvicornrun>`_ but by default will run
+whatever :ref:`pserve <pyramid:pserve_script>` is setup to do (which
+usually is `waitress
+<https://docs.pylonsproject.org/projects/waitress/en/latest/index.html>`_).
+
+Ultimately it's all up to config, so run different web apps with
+different config files.
+
+Defined in: :mod:`wuttaweb.cli.webapp`
+
+.. program-output:: wutta webapp --help

docs/narr/cli/index.rst

@@ -0,0 +1,14 @@
+
+==============
+ Command Line
+==============
+
+There isn't much to the command line for WuttaWeb, but here it is.
+
+For more general info about CLI see
+:doc:`wuttjamaican:narr/cli/index`.
+
+.. toctree::
+   :maxdepth: 2
+
+   builtin