renamed client to instance; re-build schema/README.txt

git-svn-id: svn://svn.cy55.de/Zope3/src/cybertools/trunk@1744 fd906abe-77d9-0310-91a1-e0d9ade77398

composer/README.txt

@@ -48,7 +48,8 @@ with the template.
   ...         for c in self.template.components:
   ...             print c, self.context.parts.get(c.name, '-')
 
-  >>> inst = ConfigurationAdapter(c001, desktop)
+  >>> inst = ConfigurationAdapter(c001)
+  >>> inst.template = desktop
   >>> inst.applyTemplate()
   case -
   mainboard -

composer/instance.py

@@ -30,10 +30,10 @@ from cybertools.composer.interfaces import IInstance
 class Instance(object):
 
     implements(IInstance)
+    template = None
 
-    def __init__(self, context, template):
+    def __init__(self, context):
         self.context = context
-        self.template = template
         self.instances = []
 
     def applyTemplate(self, *args, **kw):

composer/interfaces.py

@@ -62,7 +62,7 @@ class IInstance(Interface):
     """
 
     context = Attribute('Object this instance adapter has been created for')
-    template = Attribute('The template to be used for this client')
+    template = Attribute('The template to be used for this instance')
 
     def applyTemplate(*args, **kw):
         """ Apply the template using the instance's context. Note that this

composer/schema/README.txt

@@ -5,6 +5,35 @@ Schema and Field Management
   ($Id$)
 
   >>> from cybertools.composer.schema.schema import Schema
-  >>> from cybertools.composer.schema.instance import Instance
   >>> from cybertools.composer.schema.field import Field
 
+We start with setting up a schema with fields.
+
+  >>> serviceSchema = Schema()
+  >>> serviceSchema.components.append(Field('title'))
+  >>> serviceSchema.components.append(Field('description'))
+  >>> serviceSchema.components.append(Field('start'))
+  >>> serviceSchema.components.append(Field('end'))
+  >>> serviceSchema.components.append(Field('capacity'))
+
+For using a schema we need some class that we can use for creating
+objects.
+
+  >>> class Service(object):
+  ...     pass
+
+The schema will be connected with an object via an instance adapter.
+
+  >>> from cybertools.composer.schema.instance import Editor
+  >>> from zope import component
+  >>> component.provideAdapter(Editor, (Service,), name="service.edit")
+
+  >>> srv = Service()
+  >>> inst = component.getAdapter(srv, name='service.edit')
+  >>> inst.template = serviceSchema
+  >>> inst.applyTemplate()
+  title -
+  description -
+  start -
+  end -
+  capacity -