Opened 2 years ago

#8867 enhancement new

The documentation for producers/consumers/backpressure handling could be improved

Reported by: Nathaniel J. Smith Owned by:
Priority: normal Milestone:
Component: core Keywords:
Cc: Branch:
Author:

Description

The docs are here: https://twistedmatrix.com/documents/16.4.1/core/howto/producers.html

But even after reading those carefully and clicking around to all the linked API docs and such, I couldn't figure out how to write a simple port-forwarder without hassling Glyph.

Some suggestions:

  • They should probably mention that transports implement IPushProducer -- that's sorta crucial information :-)
  • They should probably mention that transports implement IConsumer -- also important! This at least can be inferred from the example in docs/core/examples/streaming.py, but it doesn't seem to be mentioned anywhere else
  • Speaking of which, that page should probably link to the streaming.py example :-) (it's mentioned, but not linked)
  • It'd be nice to have an example that's like... "here's an echo server, but now, not trivially DoSable"?

Change History (0)

Note: See TracTickets for help on using tickets.