Package twisted :: Package protocols :: Module basic :: Class FileSender
[frames | no frames]

Class FileSender

Known Subclasses:
DTPFileSender

A producer that sends the contents of a file to a consumer.

This is a helper for protocols that, at some point, will take a file-like object, read its contents, and write them out to the network, optionally performing some transformation on the bytes in between.

This API is unstable.
Method Summary
Deferred beginFileTransfer(self, file, consumer, transform)
Begin transferring a file
  pauseProducing(self)
  resumeProducing(self)
  stopProducing(self)

Class Variable Summary
tuple __implements__ = (<class twisted.internet.interfaces.IPr...
int CHUNK_SIZE = 16384                                                                 
NoneType deferred = None                                                                  
str lastSent = ''

Method Details

beginFileTransfer(self, file, consumer, transform=None)

Begin transferring a file
Parameters:
file - The file object to read data from
           (type=Any file-like object)
consumer - The object to write data to
           (type=Any implementor of IConsumer)
transform - A callable taking one string argument and returning the same. All bytes read from the file are passed through this before being written to the consumer.
Returns:
A deferred whose callback will be invoked when the file has been completely written to the consumer. The last byte written to the consumer is passed to the callback.
           (type=Deferred)

Class Variable Details

__implements__

Type:
tuple
Value:
(<class twisted.internet.interfaces.IProducer at 0x827b064>,)          

CHUNK_SIZE

Type:
int
Value:
16384                                                                 

deferred

Type:
NoneType
Value:
None                                                                  

lastSent

Type:
str
Value:
''                                                                     

Generated by Epydoc 2.0 on Sat May 15 20:08:05 2004 http://epydoc.sf.net