1 files changed, 51 insertions, 0 deletions
diff --git a/third_party/python/aiohttp/examples/cli_app.py b/third_party/python/aiohttp/examples/cli_app.py
new file mode 100755
index 0000000000..9fbd3b7604
--- /dev/null
+++ b/third_party/python/aiohttp/examples/cli_app.py
@@ -0,0 +1,51 @@
+#!/usr/bin/env python3
+"""
+Example of serving an Application using the `aiohttp.web` CLI.
+
+Serve this app using::
+
+    $ python -m aiohttp.web -H localhost -P 8080 --repeat 10 cli_app:init \
+    > "Hello World"
+
+Here ``--repeat`` & ``"Hello World"`` are application specific command-line
+arguments. `aiohttp.web` only parses & consumes the command-line arguments it
+needs (i.e. ``-H``, ``-P`` & ``entry-func``) and passes on any additional
+arguments to the `cli_app:init` function for processing.
+"""
+
+from argparse import ArgumentParser
+
+from aiohttp import web
+
+
+def display_message(req):
+    args = req.app["args"]
+    text = "\n".join([args.message] * args.repeat)
+    return web.Response(text=text)
+
+
+def init(argv):
+    arg_parser = ArgumentParser(
+        prog="aiohttp.web ...", description="Application CLI", add_help=False
+    )
+
+    # Positional argument
+    arg_parser.add_argument("message", help="message to print")
+
+    # Optional argument
+    arg_parser.add_argument(
+        "--repeat", help="number of times to repeat message", type=int, default="1"
+    )
+
+    # Avoid conflict with -h from `aiohttp.web` CLI parser
+    arg_parser.add_argument(
+        "--app-help", help="show this message and exit", action="help"
+    )
+
+    args = arg_parser.parse_args(argv)
+
+    app = web.Application()
+    app["args"] = args
+    app.router.add_get("/", display_message)
+
+    return app