Changes between Version 4 and Version 5 of Specification/AsynchronousFileInputOutput


Ignore:
Timestamp:
08/04/2007 09:10:21 PM (13 years ago)
Author:
radix
Comment:

open -> openStream (?), give openStream a mode parameter, add some open issues

Legend:

Unmodified
Added
Removed
Modified
  • Specification/AsynchronousFileInputOutput

    v4 v5  
    1313#!html
    1414<pre class="wiki">
    15 def FilePath.openAsynchronously()
     15def FilePath.openStream(mode)
    1616    """
    17     @return: AsynchronousFileIOLayer.
     17    @param mode: As per C{file.__init__}'s C{mode} parameter.
     18    @return: A L{Deferred} which results in an L{AsynchronousFileIOLayer}.
    1819    """
    1920<br/>
     
    3132    @param producer: IFilePathProducer provider. Its produceTo method
    3233        will be called.
    33     @param start: The byte offset into the file at which to start writing. [what about appending?]
     34    @param start: The byte offset into the file at which to start
     35        writing. If the file was opened in append mode, then this
     36        parameter must not be specified.
    3437    @return: None.
    3538    """
     
    124127these are called in should perhaps be well-defined.
    125128
    126 What about appending to a file? Should there be a special value passable as the 'start' parameter to write to indicate that the file should be appended to?
     129What about duplicating filepath.create()'s behavior asynchronously?
    127130
     131openStream is kind of a strange name, given web2.streams.
    128132
    129133=== Punchline ===