Changes between Version 2 and Version 3 of ApplicationObject

Timestamp:

Jul 9, 2008, 2:47:41 PM (16 years ago)

Author:

cmlenz

Comment:

--

ApplicationObject

@@ -26 +26 @@
 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.
 
+== Initialization with a Configuration File ==
+
+The `Application` provides a convenience factory function that lets you instantiate an application using an INI-style configuration file.
+
+For example, assume the following configuration is stored in `conf/myapp.ini`:
+
+{{{
+#!ini
+[app]
+locale = en_US
+timezone = UTC
+doctype = html-strict
+debug = true
+}}}
+
+Now you can easily instantiate your application using the `configure()` class method:
+
+{{{
+#!pycon
+>>> from mypkg import MyApp
+>>> myapp = MyApp.configure('conf/myapp.ini')
+}}}
+
+See ConfigOptions for information on the configuration options that are available by default, although you can of course always add your own.
+
 == API Documentation ==