= 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 ApplicationObject), 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

}}}

== Automatic Reloading ==

TBW

== API Documentation ==

[[PythonDoc(trunk, diva.server)]]