Added support for explicit configuration elements

1 files changed, 23 insertions, 0 deletions

diff --git a/paste/docsupport/metadata.py b/paste/docsupport/metadata.py
index 2677a0a..b3e2bc2 100644
--- a/paste/docsupport/metadata.py
+++ b/paste/docsupport/metadata.py
@@ -68,6 +68,29 @@ class WSGIKey(DocItem):
         self.writeobj(self.interface, context)
         context.endkey()
 
+class NoDefault: pass
+
+class Config(DocItem):
+
+    def __init__(self, doc, name=None, default=NoDefault):
+        self.doc = doc
+        self.name = name
+        self.default = default
+
+    def writeto(self, context):
+        name = self.name
+        if not self.name:
+            name = context.last_name
+            if name.startswith('_config_'):
+                name = name[len('_config_'):]
+        name = "``%s``" % name
+        if self.default is not NoDefault:
+            name += ' (default: ``%r``)' % self.default
+        context.writekey(name, type='Paste Configuration',
+                         monospace=False)
+        context.writedoc(self.doc)
+        context.endkey()
+
 class Attribute(DocItem):
 
     def __init__(self, doc, name=None, interface=None):