Changes between Initial Version and Version 1 of DevelopmentServer

Timestamp:

Jun 24, 2008, 2:20:21 PM (16 years ago)

Author:

cmlenz

Comment:

--

DevelopmentServer

@@ +1 @@
+= Development Server =
+
+Diva comes with a couple of simple shortcuts for running your application using the `WSGIServer` from the Python standalone library.
+
+Assuming you have an `Application` subclass (see ApplicationArchitecture), for example:
+
+{{{
+#!pycon
+>>> from diva.core import Application
+>>> class MyApp(Application):
+...     pass
+}}}
+
+You can then run that application using the development server as follows, directly from the Python shell:
+
+{{{
+#!pycon
+>>> import logging
+>>> from diva.server import serve
+>>> serve(MyApp(), log_level=logging.DEBUG)
+[INFO] diva.server: Serving <__main__.MyApp object at 0x10f63f0> on 127.0.0.1:8080
+}}}
+
+== Command-Line Interface ==
+
+It's also simple to enable your application to be run from the command-line, as shown in the following script:
+
+{{{
+#!python
+import os
+from diva.core import Application
+from diva.server import main
+
+class MyApp(Application):
+    pass
+
+if __name__ == '__main__':
+    main(app)
+}}}
+
+Now running that script will automatically launch a simple command-line interface complete with options:
+
+{{{
+$ python myapp.py --help
+Usage: myapp.py [options]
+
+Options:
+  -h, --help            show this help message and exit
+  -b HOST, --host=HOST  hostname or IP address to bind to (default 127.0.0.1)
+  -p PORT, --port=PORT  port number to listen to (default 8080)
+  -r, --auto-reload     automatically restart after code changes (default
+                        True)
+  -v, --verbose         print as much as possible
+  -q, --quiet           print as little as possible
+
+}}}