Changes between Initial Version and Version 1 of ApplicationObject

Timestamp:

Jun 25, 2008, 3:25:02 PM (16 years ago)

Author:

cmlenz

Comment:

--

ApplicationObject

@@ +1 @@
+= 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.