Changeset 4372 for waeup/branches/ulif-rewrite

Timestamp:

27 Jun 2009, 11:25:05 (15 years ago)

Author:

uli

Message:

Document/test department factory.

File:

• waeup/branches/ulif-rewrite/src/waeup/university/department.txt (modified) (1 diff)

waeup/branches/ulif-rewrite/src/waeup/university/department.txt

@@ -105 +105 @@
         <waeup...certificatecontainer.CertificateContainer object at 0x...>
 
+Utilities
+=========
+
+:class:`DepartmentFactory`
+--------------------------
+
+.. class:: DepartmentFactory()
+
+   .. attribute:: grok.name(u'waeup.Department')
+
+   .. attribute:: grok.implements(IFactory)
+
+   A named utility to deliver new instances of :class:`Department`
+   without the need to import the implementation before:
+
+     >>> from zope.component import createObject
+     >>> mydepartment = createObject(u'waeup.Department')
+     >>> mydepartment
+     <waeup.university.department.Department object at 0x...>
+
+   The factory complies with the specifications from the
+   :class:`IFactory` insterface:
+
+     >>> from zope.interface.verify import verifyClass
+     >>> from zope.component.interfaces import IFactory
+     >>> from waeup.university.department import DepartmentFactory
+     >>> verifyClass(IFactory, DepartmentFactory)
+     True
+
+   This means also, that we can get the interfaces of the created
+   object from the factory:
+
+     >>> department_factory = DepartmentFactory()
+     >>> department_factory.getInterfaces()
+     <implementedBy waeup.university.department.Department>