Stream package:HTTP

Transmitting HTTP requests and responses holding String in their payload bodies. This is one of the implementation modules for the Network.HTTP interface, representing request and response content as Strings and transmitting them in non-packed form (cf. Network.HTTP.HandleStream and its use of ByteStrings.) over Stream handles. It is mostly here for backwards compatibility, representing how requests and responses were transmitted up until the 4.x releases of the HTTP package. For more detailed information about what the individual exports do, please consult the documentation for Network.HTTP. Notice however that the functions here do not perform any kind of normalization prior to transmission (or receipt); you are responsible for doing any such yourself, or, if you prefer, just switch to using Network.HTTP function instead.

An library for creating abstract streams. Originally part of Gray's/Bringert's HTTP module.

• Changes by Robin Bate Boerop robin@bateboerop.name:
• Removed unnecessary import statements.
• Moved Debug code to StreamDebugger.hs
• Moved Socket-related code to StreamSocket.hs.
• Changes by Simon Foster:
• Split Network.HTTPmodule up into to separate Network.[Stream,TCP,HTTP] modules

Streams should make layering of TLS protocol easier in future, they allow reading/writing to files etc for debugging, they allow use of protocols other than TCP/IP and they allow customisation. Instances of this class should not trim the input in any way, e.g. leave LF on line endings etc. Unless that is exactly the behaviour you want from your twisted instances ;)

Implements debugging of Streams. Originally part of Gray's/Bringert's HTTP module.

• Changes by Robin Bate Boerop robin@bateboerop.name:
• Created. Made minor formatting changes.

Allows stream logging. Refer to debugStream below.

Socket Stream instance. Originally part of Gray's/Bringert's HTTP module.

• Changes by Robin Bate Boerop robin@bateboerop.name:
• Made dependencies explicit in import statements.
• Removed false dependencies in import statements.
• Created separate module for instance Stream Socket.
• Changes by Simon Foster:
• Split module up into to separate Network.[Stream,TCP,HTTP] modules

A HandleStream-based version of Network.HTTP interface. For more detailed information about what the individual exports do, please consult the documentation for Network.HTTP. Notice however that the functions here do not perform any kind of normalization prior to transmission (or receipt); you are responsible for doing any such yourself, or, if you prefer, just switch to using Network.HTTP function instead.

Wraps a stream with logging I/O. The first argument is a filename which is opened in AppendMode.

HStream overloads the use of HandleStreams, letting you overload the handle operations over the type that is communicated across the handle. It comes in handy for Network.HTTP Request and Responses as the payload representation isn't fixed, but overloaded. The library comes with instances for ByteStrings and String, but should you want to plug in your own payload representation, defining your own HStream instance _should_ be all that it takes.