From 8392d7094c96f777f6d1d5f0c62051702191d106 Mon Sep 17 00:00:00 2001
From: Chris McDonough <chrism@agendaless.com>
Date: Tue, 22 Jul 2008 11:02:28 +0000
Subject: Add url-based dispatch.

---
 docs/api/urldispatch.rst | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 docs/api/urldispatch.rst

(limited to 'docs/api')

diff --git a/docs/api/urldispatch.rst b/docs/api/urldispatch.rst
new file mode 100644
index 000000000..81b28cebb
--- /dev/null
+++ b/docs/api/urldispatch.rst
@@ -0,0 +1,30 @@
+.. _urldispatch_module:
+
+:mod:`repoze.bfg.urldispatch`
+=============================
+
+.. automodule:: repoze.bfg.urldispatch
+
+  .. autoclass:: RoutesMapper
+     :members:
+
+You can configure the ``RoutesModelTraverser`` into your application's
+configure.zcml like so::
+
+  <adapter
+      factory="repoze.bfg.urldispatch.RoutesModelTraverser"
+      provides=".interfaces.ITraverserFactory"
+      for="repoze.bfg.interfaces.IURLDispatchModel repoze.bfg.interfaces.IRequest"
+  />
+
+An example of configuring a view that is willing to handle this sort
+of dispatch::
+
+  <bfg:view
+      for="repoze.bfg.interfaces.IURLDispatchModel"
+      view=".views.url_dispatch_view"
+      name="url_dispatch_controller"
+      />
+
+This view will be called with its context as a model with attributes
+matching the Routes routing dictionary associated with the request.
-- 
cgit v1.2.3