The producer/consumer howto could really do with some examples

[itamar]

The current version of the producer/consumer howto is more of a reference. Some examples involving transports would make it easier to assimilate. It's a bit problematic though since transports are both most common consumers and most common source of data for producers, which might be confusing. But the examples should at least show some transport integration.

[thijs]

#4171 was a duplicate of this and contains an example.

[thijs]

(In [28001]) Branching to 'streaming-example-3835'

[thijs]

(In [28002]) Add streaming.py example, refs #3835, #4171

[thijs]

(In [30518]) apply coding standard, add to examples listing and news file. refs #3835

[exarkun]

1. cnt is a silly variable name. Please switch to count.
2. There's lots of extra parenthesis where print is used.
3. The example doesn't actually require Python 2.6, it works fine on 2.4. The last sentence of the docstring can probably just go.
4. random.randrange is preferred over random.randint
5. ServeRandom should use sendLine instead of transport.write in connectionMade
6. The pauseProducing docstring is nice. How about some for the other methods?
7. stopProducing should cause the resumeProducing loop to stop, too.
8. The vertical whitespace needs some cleanup.
9. The producer/consumer howto should link to this example.

Thanks!

[thijs]

(In [30760]) address review comments, refs #3835

[thijs]

Up for 500 points.. :)

[mithrandi]

This example only implements a push producer, which is somewhat different from a pull producer. I think the various references to "example of a producer" (or similar wording) should explicitly mention that this is a push producer, to avoid confusion.

Aside from that, everything else looks good; please go ahead and merge once that issue is dealt with.

[thijs]

(In [31631]) add references to push producer, refs #3835

[thijs]

(In [31632]) reference push producer, refs #3835

[thijs]

(In [31633]) Added sample implementation of a Twisted push producer/consumer system.

Author: ruttbe, thijs Reviewer: exarkun, mithrandi Fixes: #3835