Package twisted :: Package internet :: Module interfaces :: Class IProducer
[show private | hide private]
[frames | no frames]

Class IProducer

Interface --+
            |
           IProducer


A producer produces data for a consumer.

If this is a streaming producer, it will only be asked to resume producing if it has been previously asked to pause. Also, if this is a streaming producer, it will ask the producer to pause when the buffer has reached a certain size.

In other words, a streaming producer is expected to produce (write to this consumer) data in the main IO thread of some process as the result of a read operation, whereas a non-streaming producer is expected to produce data each time resumeProducing() is called.

If this is a non-streaming producer, resumeProducing will be called immediately, to start the flow of data. Otherwise it is assumed that the producer starts out life unpaused.
Method Summary
  pauseProducing(self)
Pause producing data.
  resumeProducing(self)
Resume producing data.
  stopProducing(self)
Stop producing data.

Method Details

pauseProducing(self)

Pause producing data.

Tells a producer that it has produced too much data to process for the time being, and to stop until resumeProducing() is called.

resumeProducing(self)

Resume producing data.

This tells a producer to re-add itself to the main loop and produce more data for its consumer.

stopProducing(self)

Stop producing data.

This tells a producer that its consumer has died, so it must stop producing data for good.

Generated by Epydoc 1.2 prerelease on Wed Jan 29 06:25:39 2003 http://epydoc.sf.net