t.w.t.flatten(request, root, write) : function documentation

Incrementally write out a string representation of root using write.

In order to create a string representation, root will be decomposed into simpler objects which will themselves be decomposed and so on until strings or objects which can easily be converted to strings are encountered.

Parameters	request	A request object which will be passed to the render method of any IRenderable provider which is encountered.
	root	An object to be made flatter. This may be of type unicode, str, slot, Tag, tuple, list, GeneratorType, Deferred, or something that provides IRenderable.
	write	A callable which will be invoked with each str produced by flattening root.
Returns	A Deferred which will be called back when root has been completely flattened into write or which will be errbacked if an unexpected exception occurs.