the last byte has been given to it, or because the consumer threw an
exception during write(), possibly because it no longer wants to
receive data). The portion downloaded will start at 'offset' and
- contain 'size' bytes (or the remainder of the file if size==None).
+ contain 'size' bytes (or the remainder of the file if size==None). It
+ is an error to read beyond the end of the file: callers must use
+ get_size() and clip any non-default offset= and size= parameters. It
+ is permissible to read zero bytes.
The consumer will be used in non-streaming mode: an IPullProducer
will be attached to it.
is a file, or if must_be_file is True and the child is a directory,
I raise ChildOfWrongTypeError."""
- def create_subdirectory(name, initial_children={}, overwrite=True, metadata=None):
+ def create_subdirectory(name, initial_children={}, overwrite=True,
+ mutable=True, mutable_version=None, metadata=None):
"""I create and attach a directory at the given name. The new
directory can be empty, or it can be populated with children
according to 'initial_children', which takes a dictionary in the same