= Application Object =

There can only be one instance of a `diva.core.Application` per Python interpreter. That is because the application is in many places accessed via the `app` singleton, which provides thread-local access to the application context.

Usually a specific application will define a subclass of `diva.core.Application` that is explicitly instantiated at startup:

{{{
#!pycon
>>> from diva.core import Application
>>> 
>>> class MyApp(Application):
...    pass
... 
>>> myapp = MyApp()
}}}

After this point, you'll be able to access the singleton instance of the application using a simple import:

{{{
#!pycon
>>> from diva import app
>>> app
<diva.ApplicationProxy object at …>
}}}

This application proxy forwards all operations to the actual application class. The application class has a `ctxt` property that provides access to various thread-local objects, such as the current HTTP request.

== API Documentation ==

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