--- a/req.py Wed Oct 07 12:38:30 2009 +0200
+++ b/req.py Fri Oct 09 16:39:26 2009 +0200
@@ -108,7 +108,13 @@
# XXX move to CWEntityManager or even better as factory method (unclear
# where yet...)
def create_entity(self, etype, *args, **kwargs):
- """add a new entity of the given type"""
+ """add a new entity of the given type
+
+ Example (in a shell session):
+
+ c = create_entity('Company', name='Logilab')
+ create_entity('Person', ('works_for', 'Y'), Y=c.eid, firstname='John', lastname='Doe')
+ """
rql = 'INSERT %s X' % etype
relations = []
restrictions = []