[CalendarServer-changes] [848]
CalendarServer/trunk/twistedcaldav/directory/resource.py
source_changes at macosforge.org
source_changes at macosforge.org
Fri Dec 15 20:29:28 PST 2006
Revision: 848
http://trac.macosforge.org/projects/calendarserver/changeset/848
Author: wsanchez at apple.com
Date: 2006-12-15 20:29:28 -0800 (Fri, 15 Dec 2006)
Log Message:
-----------
Docs
Modified Paths:
--------------
CalendarServer/trunk/twistedcaldav/directory/resource.py
Modified: CalendarServer/trunk/twistedcaldav/directory/resource.py
===================================================================
--- CalendarServer/trunk/twistedcaldav/directory/resource.py 2006-12-16 04:22:41 UTC (rev 847)
+++ CalendarServer/trunk/twistedcaldav/directory/resource.py 2006-12-16 04:29:28 UTC (rev 848)
@@ -31,11 +31,8 @@
def provision(self):
"""
Provision this resource by creating any required backing store, etc. that
- must be set up before the resource can be accessed normally.
- FIXME: More description of what that means would be helpful here. Basically,
- RenderMixIn methods should work (perhaps returning None) without having to
- call this first, so that dirlist can happen, but it is expected that this will
- have been called before anything that involves I/O happens.
+ must be set up before the resource can be accessed normally. Specifically,
+ this must have been called before anything that involves I/O happens.
This method may be called multiple times; provisioning code should ensure that
it handles this properly, typically by returning immediately if the resource is
already provisioned (eg. the backing store exists).
@@ -44,7 +41,16 @@
return None
def provisionChild(self, name):
- pass
+ """
+ Creates the child object with the given name.
+ This is basically akin to L{File.createSimilarFile}, but here we know we're
+ creating a child of this resource, and take take certain actions to ensure that
+ it's prepared appropriately.
+ @param name: the name of the child resource.
+ @return: the newly created (optionally deferred) child, or None of no resource
+ is bound as a child of this resource with the given C{name}.
+ """
+ return None
def locateChild(self, request, segments):
"""
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/calendarserver-changes/attachments/20061215/99a7b784/attachment.html
More information about the calendarserver-changes
mailing list