package cohttp-lwt-jsoo
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=2f00d14832c1c13427c12007e5b45a8f121e06e46d556a76904359ab26c0cff6
sha512=342034580418d55e7b9657c09cf187c415e562fc041e8f5eaa489cfae08f60b98afcddbc77632b479755cdfb2d30b5653ed5250b5b7dbde01f0be93f4e828bcc
CHANGES.md.html
v6.0.0~alpha2 (2023-08-08)
cohttp-lwt: Do not leak exceptions to
Lwt.async_exception_hook
. (mefyl #992, #995)http.header, cohttp, cohttp-eio: remove "first" and "move_to_first" and the special treatment of the "host" header (mseri #988, #986)
http.header: introduce "iter_ord" to guarantee iteration following the order of the entries in the headers (mseri #986)
do not omit mandatory null Content-Length headers (mefyl #985)
cohttp-async, cohttp-curl-async: compatibility with core/async v0.16.0 (mseri, dkalinichenko-js #976)
cohttp-lwt server: call conn_closed before drainig the body of response on error (pirbo #982)
cohttp-eio: Relax socket interface requirement on
Server.connection_handler
. (mefyl #983)
v6.0.0~alpha1 (2023-04-28)
cohttp,cohttp-async server: correctly close broken streams (reported by Stéphane Glondu, fix by samhot and anuragsoni)
cohttp-eio: remove unused code from tests to work with Eio 0.8 (talex5 #967)
Upgrade dune to v3.0 (bikallem #947)
cohttp-eio: allow client to optionally configure request pipelining (bikallem #949)
cohttp-eio: update to Eio 0.7 (talex5 #952)
cohttp-eio: update examples to use eio 0.7 primitives (bikallem #957)
cohttp-eio: generate Date header in responses (bikallem #955)
cohttp-eio: further improve Cohttp_eio.Client ergonomics (bikallem #?)
cohttp-eio: server api improvements (bikallem #962)
v6.0.0~alpha0 (2022-10-24)
cohttp-eio: ensure "Host" header is the first header in http client requests (bikallem #939)
cohttp-eio: add TE header in client. Check TE header is server (bikallem #941)
cohttp-eio: add User-Agent header to request from Client (bikallem #940)
cohttp-eio: add Content-Length header to request/response (bikallem #929)
cohttp-eio: add cohttp-eio client api - Cohttp_eio.Client (bikallem #879)
http: add requires_content_length function for requests and responses (bikallem #879)
cohttp-eio: use Eio.Buf_write and improve server API (talex5 #887)
cohttp-eio: update to Eio 0.3 (talex5 #886)
cohttp-eio: convert to Eio.Buf_read (talex5 #882)
cohttp lwt client: Connection cache and explicit pipelining (madroach #853)
http: add Http.Request.make and simplify Http.Response.make (bikallem mseri #878)
http: add pretty printer functions (bikallem #880)
New eio based client and server on top of the http library (bikallem #857)
New curl based clients (rgrinberg #813)
cohttp-curl-lwt for an Lwt backend
cohttp-curl-async for an Async backend
Completely new Parsing layers for servers (anuragsoni #819)
Cohttp now uses an optimized parser for requests.
The new parser produces much less temporary buffers during read operations in servers.
Faster header comparison (gasche #818)
Introduce http package containing common signatures and structures useful for compatibility with cohttp - and no dependencies (rgrinberg #812)
async(server): allow reading number of active connections (anuragsoni #809)
Various internal refactors (rgrinberg, mseri, #802, #812, #820, #800, #799, #797)
http (all cohttp server backends): Consider the connection header in response in addition to the request when deciding on whether to keep a connection alive (anuragsoni, #843)
The user provided Response can contain a connection header. That header will also be considered in addition to the connection header in requests when deciding whether to use keep-alive. This allows a handler to decide to close a connection even if the client requested a keep-alive in the request.
async(server): allow creating a server without using conduit (anuragsoni #839)
Add
Cohttp_async.Server.Expert.create
andCohttp_async.Server.Expert.create_with_response_action
that can be used to create a server without going through Conduit. This allows creating an async TCP server using the Tcp module fromAsync_unix
and lets the user have more control over how theReader.t
andWriter.t
are created.
http(header): faster
to_lines
andto_frames
implementation (mseri #847)cohttp(cookies): use case-insensitive comparison to check for
set-cookies
(mseri #858)New lwt based server implementation: cohttp-server-lwt-unix
This new implementation does not depend on conduit and has a simpler and more flexible API
async: Adapt cohttp-curl-async to work with core_unix.
Breaking changes
refactor: move opam metadata to dune-project (rgrinberg #811)
refactor: deprecate Cohttp_async.Io (rgrinberg #807)
fix: move more internals to Private (rgrinberg #806)
fix: deprecate transfer encoding field (rgrinberg #805)
refactor: deprecate Cohttp_async.Body_raw (rgrinberg #804)
fix: deprecate more aliases (rgrinberg #803)
refactor: deprecate connection value(rgrinberg #798)
refactor: deprecate using attributes (rgrinberg #796)
cleanup: remove cohttp-{curl,server}-async (rgrinberg #904)
cleanup: remove cohttp-{curl,server,proxy}-lwt (rgrinberg #904)
fix: all parsers now follow the spec and require
\r\n
endings. Previously, the\r
was optional. (rgrinberg, #921)
cohttp-lwt-jsoo
: do not instantiateXMLHttpRequest
object on boot (mefyl #922)
v5.0.0 (2021-12-15)
Cohttp.Header: performance improvement (mseri, anuragsoni #778) Breaking the headers are no-longer lowercased when parsed, the headers key comparison is case insensitive instead.
cohttp-lwt-unix: Adopt ocaml-conduit 5.0.0 (smorimoto #787) Breaking
Conduit_lwt_unix.connect
'sctx
param type chaged fromctx
toctx Lazy.t
cohttp-mirage: fix deprecated fmt usage (tmcgilchrist #783)
lwt_jsoo: Use logs for the warnings and document it (mseri #776)
lwt: Use logs to warn users about leaked bodies and document it (mseri #771)
lwt, lwt_unix: Improve use of logs and the documentation, fix bug in the Debug.enable_debug function (mseri #772)
lwt_jsoo: Fix exception on connection errors in chrome (mefyl #761)
lwt_jsoo: Fix
Lwt.wakeup_exn
Invalid_arg
exception when a js stack overflow happens in the XHR completion handler (mefyl #762).lwt_jsoo: Add test suite (mefyl #764).
v4.0.0 (2021-03-24)
cohttp.response: fix malformed status header for custom status codes (mseri aalekseyev #752)
remove dependency to base (samoht #745)
add GitHub Actions workflow (smorimoto #739)
cohttp-lwt-jsoo
: Forward exceptions to caller when response is null (mefyl #738)Use implicit executable dependency for generate.exe (TheLortex #735)
cohttp: fix chunked encoding of empty body (mefyl #715)
cohttp-async: fix body not being uploaded with unchunked Async.Pipe (mefyl #706)
cohttp-{async, lwt}: fix suprising behaviours of Body.is_empty (anuragsoni #714 #712 #713)
refactoring of tests (mseri #709, dinosaure #692)
update documentation (dinosaure #716, mseri #720)
fix deadlock in logging (dinosaure #722)
improve media type parsing (seliopou #542, dinosaure #725)
[reverted] breaking changes to client and server API to use conduit 3.0.0 (dinosaure #692). However, as the design discussion did not reach consensus, these changes were reverted to preserve better compatibility with existing cohttp users. (samoht #741)
Potentially breaking changes
remove
wrapped false
from the codebase (rgrinberg #734)cohttp: add Uri.scheme to Request.t (brendanlong #707)
cohttp: update HTTP codes (emillon #711)
cohttp-lwt-jsoo: rename Cohttp_lwt_xhr to Cohttp_lwt_jsoo for consistency (mseri #717)
cohttp: fix transfer-encoding ordering in headers (mseri #721)
lower-level support for long-running cohttp-async connections (brendanlong #704)
add of_form and to_form functions to body (seliopou #440, mseri #723)
cohttp-lwt: partly inline read_response, fix body stream leak (madroach dinosaure #696). Note: there is a new warning that may show up in your logs when bodies are leaked, see also #730.
add comparison functions for Request.t and Response.t via ppx_compare (msaffer-js dinosaure #686)
v3.0.0 - aborted
v2.5.5 (2021-03-15)
Cohttp_async.resolve_local_file
,Cohttp_lwt.resolve_local_file
andCohttp_lwt_unix.resolve_file
are now the same code under the hood (Cohttp.Path.resolve_local_file
). The old names have been preserved for compatibility, but will be marked as deprecated in the next release. This changes the behavior ofCohttp_lwt_unix.resolve_file
: it now percent-decodes the paths and blocks escaping from the docroot correctly. This also fixes and tests the corner cases in these methods when the docroot is empty. (ewanmellor #755)
v2.5.4 (2020-07-21)
cohttp: a change in #694 modified the semantics of Header.replace. The semantics change is reverted, and a new Header.update function is introduced, following the semantics of Map.update. (#702 mseri)
cohttp: reimplement update to support compilers that are older than OCaml 4.06 (#703 mseri)
v2.5.3 (2020-06-27)
cohttp-async: adapt to async >= v0.14 (#699 copy)
v2.5.2 (2020-06-27)
cohttp, cohttp-async: correctly set host header for unix domain sockets, implement Unix domain socket support for cohttp-async (#698 Leonidas-from-XIV)
cohttp: better body encoding management when creating request and response, and correction of Header.replace function (#694 lyrm)
v2.5.1 (2020-02-18)
cohttp-lwt: pass ctx through HEAD client requests (#689 hannesm)
v2.5.0 (2019-12-17)
cohttp-async: support async v0.13.0 (#680 copy)
cohttp-lwt-jsoo: support js_of_ocaml 3.5.0 and higher (avsm)
v2.4.0 (2019-11-08)
mirage: adapt to new mirage interfaces: mirage-flow 2.0.0, mirage-channel 4.0.0, mirage-kv 3.0.0 (#678 hannesm)
async: use Pipe.singleton instead of Pipe.of_list as it is more efficient (#677 smuenzel-js)
v2.3.0 (2019-08-18)
use conduit-mirage instead of mirage-conduit, which was renamed upstream in conduit. The minimum OCaml version supported for conduit-mirage is now OCaml 4.07 and higher. (#672 avsm)
remove deprecation warnings in OCaml 4.08.0 using stdlib-shims (#672 avsm)
async: do not read body if none is present (#671 emillon)
v2.2.0 (2019-07-20)
Previously if the client closed the connection while cohttp was handling a request, the server would crash (by default, unless the user overrode that using
on_exn
or changing Lwt's async exception handler). Now, cohttp will just log this atinfo
level and continue. Exceptions produced by user code are logged as errors, while other exceptions generated by cohttp call back to the conduit exception handler, as before. (#669 talex5)
v2.1.3 (2019-07-12)
support uri.3.0.0 that has optional sexp support (#668 avsm)
use re.1.9.0 api to remove deprecation warnings (#664 vbmithr)
v2.1.2 (2019-04-09)
cohttp: handle empty cookie components gracefully without raising an exception (#663 martinslota)
v2.1.1 (2019-04-05)
cohttp-mirage
: remove dependency on theresult
module (#662 hannesm)Support Async v0.12.0 and higher (#661 copy)
v2.1.0 (2019-03-01)
cohttp-mirage
: update to the newestMirage_kv.RO
API
v2.0.0 (2019-02-04)
Compatibility breaking interface changes:
Async: Expert response action no longer writes empty HTTP body (#647 by andreas)
In cohttp.0.99, a number of subpackages were turned into explicit opam packages to simplify dependency management. To aid migration, some compatability shims were left in place so that the old findlib names would continue to work. They have now been removed as of this release. If you were still using them, then please rename them as follows:
cohttp.lwt-core
->cohttp-lwt
cohttp.lwt
->cohttp-lwt-unix
cohttp.js
->cohttp-lwt-jsoo
cohttp.async
->cohttp-async
cohttp.top
->cohttp-top
Other changes and bugfixes:
Lwt, Mirage: Add log warnings for uncaught exceptions (#592 by ansiwen)
Log invalid client input and do not catch out of memory exceptions (#652 hannesm)
Port opam files to opam2 and add local synopsis and descriptions.
Lwt: Add Expert response action for servers (#647 by andreas)
Use the namespaced
js_of_ocaml
interfaces from 3.3.0 onwards (#654 avsm)Use Base64 3.1.0 interfaces (#655 avsm)
Clean up redundant conflicts in the
opam
files (avsm)
v1.2.0 (2018-10-19)
Support more than a single chunk extension for RFC7320 compliance (#618 by djs55)
Lwt-unix: add a
?backlog
argument to the serve function (samoht)Use the uri.2.0.0 interfaces for sexpression generation of types (avsm)
Switch to
sexplib0
for a more lightweight s-expression library (mseri)Minimum OCaml compiler version requirement is now 4.04.1 (mseri)
Add an example of using custom resolvers to the README (mseri)
v1.1.1 (2018-08-13)
Update to be compatible with new async/core (#607 by rgrinberg)
Remove use of deprecated
Lwt_logs
(#609 by raphael-proust)Do not rely on locale for printing qvalues (#611 by vbmithr)
Ppx dependencies aren't just build time dependencies (#625 by rgrinberg)
v1.1.0 (2018-03-28)
Add an "expert mode" to hand off raw responses to a custom handler, which in turns makes protocols like Websockets easier (#488 by msaffer).
Set the user-agent by default if one is not provided (#586 by TheCBaH).
Fix typo in the
cohttp.js
META file.Refresh use of the Re library to the latest version (#602 by rgrinberg).
Rearrange the ppx dependencies to be more specific (#596 by yomimono).
Explicitly depend on sexplib in the Async backend (#605 by kevinqiu).
v1.0.2 (2018-01-06)
Support Async v0.10.0 and OCaml 4.06.0 (#588 via vbmithr)
Require
ppx_type_conv
>=v0.9.1` due to a bug with duplicate modules present in earlier versions.
v1.0.1 (2018-01-03)
cohttp-mirage: expose the missing IO module (#594, samoht)
cohttp-mirage: catch exceptions when closing channels in mirage client (#589, ansiwen)
v1.0.0 (2017-11-16)
opam: rename
mirage-http
tocohttp
-mirage` (#572)cohttp-lwt{,-unix}: wrap the libraries in top-level modules (#568)
opam: improve dependencies (#574, #566, #575)
cohttp: add the convenience function
Header.is_empty
(#576)fix compatibility with OCaml 4.06 and
-safe-string
(#580, #581)
v0.99.0 (2017-07-12)
Port build to jbuilder, and break up OPAM packages into multiple independent packages instead of being optional dependencies against the main cohttp
package. This makes it significantly easier to depend on precisely the libraries you need, but requires porting applications to use the new ocamlfind
and opam
scheme.
The new package layout is:
cohttp
: the mainCohttp
modulecohttp-lwt
: the portable Lwt implementationcohttp-lwt-unix
: the Lwt/Unix implementationcohttp-lwt-jsoo
: the js-of-ocaml JavaScript implementationcohttp-async
: the Jane Street Async implementationmirage-http
: the MirageOS compatible implementationcohttp-top
: a toplevel printer for the Cohttp types.
In each of these packages, the opam
and ocamlfind
package names are now the same, so you will need to rename the former subpackages such as cohttp.async
to cohttp-async
. The implementation is otherwise the same, so no other code changes should be required.
In return for these breaking changes to the packaging, it is now significantly easier to depend on a particular backend, also for us to rev the interfaces towards a stable 1.0 release. Jbuilder also builds the source tree around 4x faster than it did previously.
A number of deprecation warnings have been added to the source tree as well to mark the interfaces that will be removed in 1.0. These are Cohttp_lwt.{Client,Server,Net}
, and a Cohttp_lwt.Body
alias was added to deprecate the direct use of Cohttp_lwt_body
. This will let us unify the namespaces of all the packages to use a single top-level module for each package in the future.
Most of the release and packaging work here was done by rgrinberg and avsm.
0.22.0 (2017-03-09)
Lwt: ensure conn_closed is cosed once client goes away (#528)
Use the Logs library for logging. (#532)
0.21.1 (2017-02-18)
Remove -principal from type checking temporarily, to workaround a bug in the OCaml 4.03 type checker that causes compilation hangs (http://caml.inria.fr/mantis/view.php?id=7305).
Improve documentation in the
test_xhr.ml
js_of_ocaml test.XHR: Allow setting withCredentials
Async: pass along ?ssl_config when connecting to Uri's (#510)
Lwt: Add on ?on_exn to Server.create (#518)
Add Header.to_frames
0.21.0 (2016-05-22)
Allow to request paths as strings (#470, #478)
0.20.2 (2016-04-04)
Update META version (#473)
uri.services is only required by cohttp.async
0.20.1 (2016-04-01)
Switch cohttp to use ppx (#457)
Lwt: Fix leak on HEAD client requests (#467)
0.20.0 (2016-03-25)
Switch to pa_fields_conv and pa_sexp_conv for camlp4 extensions (#465)
Compatibility with latest async (#468)
Async: Add support for SSL parameters in client (#466)
Lwt: ignore Sig.sigpipe under Windows (#456)
Lwt: Fix FD leak (#447)
Lwt: Log uncaught user exceptions
Async: Close non-persistent async connections (#442)
0.19.3 (2015-09-28):
Support Async 113.00 by explicitly using the blocking Core
printf
(#431)cohttp_curl_async: add
-data-binary
to send POST data. (#425)
0.19.2 (2015-08-20):
Improve Cohttp_async.Client error handling. When a Uri.t fails to resolve it is now included in the error. (#420)
0.19.1 (2015-08-08):
Bring make_body_writer and write_header in Cohttp.S.Http_io. Needed by ocaml-git
0.19.0 (2015-08-05): Compatibility breaking interface changes:
Remove
read_form
from theRequest/Response/Header
interfaces as this should be done inBody
handling instead (#401).
New features and bug fixes:
Remove
IO.write_line
as it was unused in any interfaces.Do not use the
lwt
camlp4 extension. No observable external difference.Do not return a code stacktrace in the default 500 handler.
Add
Cohttp.Header.compare
(#411)Fix typos in CLI documentation (#413 via moonlightdrive)
Use the Lwt 2.5.0 buffer API.
Cohttp_lwt.read_response
now has a non-optionalclosefn
parameter (#400).Add a
Cohttp_lwt_s
module that contains all the Lwt module types in one convenient place (#397).
0.18.3 (2015-07-12):
Allow
DELETE
requests to have request bodies (#383).Improve the Lwt client
callv
for HTTP/1.1 pipelined requests (#379 via Török Edwin).
0.18.2 (2015-06-19):
Do not add content encoding for 204's (#375)
0.18.1 (2015-06-05):
Remove trailing whitespace from headers (#372)
Don't reverse order of list valued headers (#372)
0.18.0 (2015-06-02):
Add Cohttp_async.Client.callv. Allows for making requests while reusing an HTTP connection (#344)
Responses of status 1xx/204/304 have no bodies and cohttp should not attempt to read them (#355)
Add top level printers. See cohttp.top findlib package (#363)
Add
Header.to_string
(#362)Fix chunk truncation in chunked transfer encoding (#360)
Compatibility breaking interface changes:
Remove
Request
/Response
modules outside of Cohttp pack (#349)
0.17.2 (2015-05-24):
Remove dependency on the Lwt Camlp4 syntax extension (#334).
Add
make github
target to push documentation to GitHub Pages (#338 from Jyotsna Prakash).Add Async integration tests and consolidate Lwt tests using the new framework (#337).
Fix allocation of massive buffer when handling fixed size http bodies (#345)
0.17.1 (2015-04-24):
[async] Limit buffer size to a maximum of 32K in the Async backend (#330 from Stanislav Artemkin).
Add
Cohttp.Conf.version
with the library version number included.Remove debug output from
cohttp-curl-async
.Add the beginning of a
DESIGN.md
document to explain the library structure.
0.17.0 (2015-04-17):
Compatibility breaking interface changes:
CONNECT
andTRACE
methods added toCode
.Exhaustive matches will need updating.
New features and bug fixes:
Link
header parsing has been added asCohttp.Link
,Header.get_links
andHeader.add_links
cohttp_server_*
now obeysHEAD
requests and responds 405 to unknown methodsCohttp_async.Server.response
type is now exposed as aresponse * body
pairFailure to read a body in a pipelined response no longer terminates the stream
Fix
cohttp_curl_lwt -X HEAD
sending empty chunked body (#313)Fix a bug which left extra
\r\n
in buffer at end of chunked readsFix handling of request URI for query strings and
CONNECT
proxies (#308, #318)Fix precedence of
Host
header when request-URI is absolute URIFix request URI path to be non-empty except for * requests (e.g.
OPTIONS *
)
0.16.1 (2015-04-09): New features and bug fixes:
Fix handling of request paths starting with multiple slashes (#308)
0.16.0 (2015-03-23):
Compatibility breaking interface changes:
Response.t and Request.t fields are no longer mutable
[lwt] Fix types in
post_form
to be astring * string list
instead of aHeader.t
(#257)Simplify the
Net
signature which needs to be provided for Lwt servers to not be required. Only the Lwt client needs aNet
functor argument to make outgoing connections. (#274)The
Request
andResponse
records are no longer mutable, so use functional updates instead viaFieldslib.Field.fset Request.Fields.<field>
. (#296)Request.has_body
does not permit a body to be set for methods that RFC7231 forbids from having one (HEAD
,GET
andDELETE
).
New features and bug fixes:
Fix linking problem caused by sub-libraries using cohttp modules outside the cohttp pack.
Added async client for S3. (#304)
Fix String_io.read_line to trim '\r' from end of string (#300)
Fix
cohttp-server-lwt
to correctly bind to a specific interface (#298).Add
Cohttp_async.request
to send raw, unmodified requests.Supplying a
content-range
orcontent-range
header in any client request will always override any other encoding preference (#281).Add a
cohttp-lwt-proxy
to act as an HTTP proxy. (#248)Extend
cohttp-server-async
file server to work with HTTPS (#277).Copy basic auth from
Uri.userinfo
into the Authorization header for HTTP requests. (#255)Install binaries via an OPAM
.install
file to ensure that they are reliably uninstalled. (#252)Use the
magic-mime
library to add a MIME type by probing filename during static serving in the Lwt/Async backends. (#260)Add
Cohttp.Header.add_opt_unless_exists
to set a header only if an override wasn't supplied, and to initialise a fresh Header value if none is present.Do not override user-supplied headers in
post_form
orredirect
.Request.make
does not inject atransfer-encoding
header if there is no body present in the request (#246).Server.respond
no longer overrides user-supplied headers that specify thecontent-length
ortransfer-encoding
headers (#268).cohttp_server_lwt
andcohttp_server_async
now include sizes in directory listing titlesAdd
Header.add_multi
to initialise a header structure with multiple fields more efficiently (#272).Expose
IO.ic
andIO.oc
types forCohttp_async
(#271).Skip empty body chunks in
Transfer_io.write
(#270).With the Lwt backend,
read
hangs if trying to fetch more thanSys.max_string_length
(which can be triggered on 32-bit platforms). Read only a maximum that fits into a string (#282).cohttp-curl-lwt
now takes http method as parameter (#288)Fix installation of server binaries in OPAM metadata. (#295)
0.15.2 (2015-02-15):
When transfer encoding is unknown, read until EOF when body size is unknown. (#241)
Add some missing documentation to
Cohttp.S.IO
signature. (#233)Add
Cohttp.Header.mem
to check if a header exists.Add
Cohttp.Conf
module to expose the library version number. (#259)Add
Cohttp.Header.add_unless_exists
to update a key if it doesn't already exist. (#244)Add
Cohttp.Header.get_location
to retrieve redirection information. (#254)[async] Clean up the
Net.lookup
function to useOr_error.t
instead of raising. (#247)[tests] Add more tests for
content-range
handling. (#249)
0.15.1 (2015-01-10):
Lwt 2.4.7 renamed
blit_bytes_string
toblit_to_bytes
, so depend on the newer API now. (#230)Use
cmdliner
in all of the Lwt client and server binaries. This givescohttp-lwt-server
a nice Unix-like command-line interface now that can be viewed with the--help
option. (#218 via Runhang Li)Improve
oasis
constraints and regenerateopam
file (#229 via Christophe Troestler).
0.15.0 (2014-12-24):
Compatibility breaking interface changes:
Change
Cohttp_lwt_body.map
to use a non-labelled type to fit the Lwt style better (#200).Depend on Base64 version 2, which uses
B64
as the toplevel module name (#220).
New features and bug fixes:
Remove use of deprecated
Lwt_unix.run
and replace it withLwt_main.run
. Should be no observable external change (#217).Improve ocamldoc of
Cohttp.S
signature (#221).
0.14.0 (2014-12-18):
Compatibility breaking interface changes:
Simplify the Lwt server signature, so that manual construction of a
callback
is no longer required (#210). Code that previous looked like:
let conn_closed (_,conn_id) () = <...>
let config = { Server.callback; conn_closed } in
should now be:
let conn_closed (_,conn_id) = <...>
let config = Server.make ~callback ~conn_closed () in
Remove the
Cohttp.Base64
module in favour of the externalbase64
library (which is now a new dependency).
New features and bug fixes:
Lwt
respond_error
now defaults to an internal server error if no status code is specified (#212).Modernise the
opam
file using the OPAM 1.2 workflow (#211).Flush the response body to the network by default, rather than buffering by default. The
?flush
optional parameter can still be explicitly set to false if flushing is not desired (#205).
0.13.0 (2014-12-05):
Compatibility breaking interface changes:
Add sexp converters for Conduit contexts and
Lwt
client and server modules and module types.
New features and bug fixes:
Can use the Conduit 0.7+
CONDUIT_TLS=native
environment variable to make HTTPS requests using the pure OCaml TLS stack instead of depending on OpenSSL bindings. All of the installed binaries (client and server) can work in this mode.Add
Cohttp_lwt_unix_debug
which lets libraries control the debugging output from Cohttp. Previously the only way to do this was to set theCOHTTP_DEBUG
environment variable at the program start.Add
cohttp-curl-lwt
as a lightweight URI fetcher from the command-line. It uses thecmdliner
as a new dependency.Remove build dependency check on
lwt.ssl
forcohttp.lwt
. This has been moved to conduit, so onlylwt.unix
is needed here now.
0.12.0 (2014-11-07):
Compatibility breaking interface changes:
Rename
Cohttp.Auth.t
toCohttp.Auth.credential
andCohttp.Auth.req
toCohttp.Auth.challenge
. Also expose anOther
variant to make it more extensible for unknown authentication types. TheCohttp.Auth
functions using these types have also been renamed accordingly.Rename
Cohttp.Transfer.encoding_to_string
tostring_of_encoding
for consistency with the rest of Cohttp's APIs.The
has_body
function in the Request and Response modules now explicitly signals when the body size is unknown.Move all the module type signatures into
Cohttp.S
.If users have percent-encoded file names, their resolution is changed:
resolve_local_file
inCohttp_async
andCohttp_lwt
now always percent-decode paths (#157)Remove the
Cohttp_lwt.Server.server
type synonym tot
.When reading data from a HTTP body stream using the
Fixed
encoding, we need to maintain state (bytes remaining) so we know when to finish. TheCohttp.Request
andCohttp.Response
interfaces now expose areader
andwriter
types to track this safely.Add
is_empty
function to theCohttp.S.Body
module type.Add
Strings
representation toCohttp.Body
to efficiently hold a list of body chunks.Move flushing logic for HTTP bodies into the portable
Request
andResponse
modules instead of individual Lwt and Async backends.Port module interfaces to the latest Conduit (0.6.0+) API.
Cohttp requires OCaml 4.01.0 or higher now.
New features and bugfixes:
Add a
Cohttp_lwt_xhr
JavaScript backend that enables Cohttp logic to be mapped toXMLHTTPRequest
in browsers viajs_of_ocaml
(via Andy Ray).Add a
Cohttp.String_io
andString_io_lwt
module that uses OCamlstring
orBuffer.t
to read and write HTTP requests and responses instead of network connections.cohttp_server_lwt
andcohttp_server_async
now return better errors (#158)cohttp_server_lwt
andcohttp_server_async
now serve indexes directly (#162)[lwt] Add
stop
thread to terminate a running server if it finishes (#147).Add
Cohttp.Connection.compare
to make ordering of connections possible.Add
Body.map
andBody.as_pipe
to work with HTTP bodies more easily.Remove link-time dependency on camlp4 via META fixes (#127).
Support HTTP methods and versions other than the standard ones. (#142).
Improve
cohttp_server_lwt
andcohttp_server_async
directory listings (#158)Fix
Cohttp_async.resolve_local_file
directory traversal vulnerability (#158)[async] In the Async server, do not close the Reader too early.
[async] Close file descriptors more eagerly in the HTTP client (#167).
Reduce thread allocation by replacing
return <const>
withreturn_none
,return_unit
orreturn_nil
.
0.11.2 (2014-04-21)
Fix build by add a missing build-deps in _oasis.
0.11.1 (2014-04-17):
Remove an errant async_ssl reference left in the _oasis file that is now handled by the Conduit library (#116).
Add an Lwt-based SimpleHTTPServer equivalent as
cohttp-server-lwt
(#108).Cohttp.Connection.t
now exposes sexp accessor functions (#117).
0.11.0 (2014-04-01):
Remove dependency on
ocaml-re
in order to make library POSIX thread-safe.Shift most of the connection handling logic out to a Conduit library that worries about which SSL library to use, and fails if SSL is not available.
Add Async-SSL support for both client and server (#102).
Add Lwt-SSL support for the server side (the client side existed before).
Fix buggy Async chunked POST handling.
0.10.0 (2014-03-02):
Interface change: The
Request
andResponse
module types now explicitly signalEof
andInvalid
(for errors), to help the backend distinguish them.Interface change: Unify HTTP body handling across backends into a
Cohttp.Body
module. This is extended by Async/Lwt implementations with their specific ways of handling bodies (Pipes for Async, or Lwt_stream for Lwt).[lwt] Interface change: HTTP client calls now raise Lwt exceptions rather than return an option type. This permits better error handling in Lwt.
[lwt] Interface change: The
Server
callback now always provides abody
argument, sinceCohttp_lwt_body
now explicitly supports empty bodys.Add
Cohttp.Header.is_keep_alive
to test if a connection should be reused.[lwt] Respect the
keep-alive
header in the server request handling.[async] Add a
Body
that takes aPipe
or astring
, similarly to Lwt.Install
cohttp-server
binary even if tests are disabled.Begin an
examples
directory with some simple uses of the library.
0.9.16 (2014-01-30):
Add some module type equalities in
Cohttp_lwt_unix
so thatCohttp_lwt_unix.Server.Request.IO.ic
can be equivalen toLwt_io.input_channel
.Add sexp converters to most Cohttp types (#83).
Improve Travis tests to cover more upstream users of Cohttp.
Refactor build flags to let the portable Lwt-core be built independently of Lwt.unix.
0.9.15 (2014-01-11):
Remove
Cohttp_mirage
libraries, which have now moved tomirage/mirage-http-*
on GitHub.Add an "HTTP only"
Cookie
attribute (#69).Fix parsing of cookies with
=
in the values (#71).Add
Max-age
support for cookies (#70).Make the
Response
record fields mutable to match theRequest
(#67).Fix compilation with Async 109.58.00 (#77).
Make Header handling case-insensitive (by forcing lowercase) (#75).
Remove the
>>
operator as it was unused and had incorrect precedence (#79).
0.9.14 (2013-12-15):
Install a
cohttp-server
binary that serves local directory contents via a web server (#54).Add a
flush
function to theIO
module type and implement in Lwt/Async/Mirage.Add option
flush
support in the Async and Lwt responders (#52).Autogenerate HTTP codes from citricsquid's JSON representation of the HTTP RFCs.
Always set
TCP_NODELAY
for Lwt/Unix server sockets for low-latency responses (#58).Added a Server-Side Events test-case from the HTML5 Doctor. See
lib_test/README.md
.Async.Server response now takes an optional
body
rather than a mandatorybody option
(#62).Regenerate build system using OASIS 0.4.0.
0.9.13 (2013-12-10):
The
cohttp.lwt-core
is now installed as an OS-independent Lwt library.Add support for Mirage 1.0, via
cohttp.mirage-unix
andcohttp.mirage-xen
.Add a new
Cohttp.Connection
module to manage server's connections identifiers.Share the same configuration type for the different server implementations.
Add
Accept_types
module to theCohttp
pack.
0.9.12 (2013-11-28):
Improve documentation for
Cohttp.Header
.Expose Fieldslib setters and getters for most of the
Cohttp
types (#38).Cohttp.Set_cookie.t
is no longer an abstract type to make it easier to update (#38).[Lwt] ignore SIGPIPE unconditionally if using the Lwt/Unix module (#37).
Rename
Cookie
creation parameters for consistency (interface breaking, see #44).Fix transfer-length detection (regression from 0.9.11 in #42).
Add Merin editor file (#41).
0.9.11 (2013-10-27):
Request module: When sending a request, add the port information in the host header field if available.
Request module: When parsing a request, add scheme, host and port information in the uri.
TCP server: When creating the socket for the server, do not force PF_INET6 but take the sockaddr value.
Add HTTP OPTIONS method.
Use getaddrinfo instead of gethostbyname for DNS resolution.
Async: improve HTTP/1.0 support (#35).
Build with debug symbols, binary annotations by default.
Add Travis CI test scripts.
0.9.10 (2013-06-21):
Add
set-cookie
header extraction functions for clients that read cookies.Explicitly flush the debug output when the
COHTTP_DEBUG
env variable is set.[async] Add client head/post/patch/delete methods.
[lwt] Client.head no longer returns a response body, just the metadata.
[lwt] Do not send chunked encoding headers with GET/DELETE requests that have no body.
0.9.9 (2013-06-12):
Disable the mirage executable test as it was building too aggressively and breaking builds.
0.9.8 (2013-05-24):
Lwt interface change: Rewrite Lwt backends to share code, and remove duplicate function calls from Uri.
Depend on
Uri
1.3.8+ as it exposes the parameter query functions now removed fromRequest
.Do not depend on Cstruct in core library, as only Mirage needs it.
Remove
Cohttp_async.body
type alias and just usestring Pipe.Reader.t
for more explicit types.
0.9.7 (2013-05-10):
Attach a GC finaliser to the Lwt client to ensure that even an HTTP body isn't consumed, the socket will eventually be closed (#11).
Add an Async.Server interface, and revise the Client interface to be more in line with Core standards.
Add 422 Unprocessable Entity code.
Refactor modules better across Lwt/Async, but incompatible with earlier releases for Async (Lwt is unchanged at present).
Add user agent string and User-Agent header helper function
The git history of this release is full of adventures in parameterised monads and refactoring, but this isn't in the actual release. Yet.
0.9.6 (2013-03-18):
Depend on Async (>= 109.12.00), which has an incompatible API with earlier versions.
Rearrange core library files for
obuild
support.
0.9.5 (2012-12-29):
Fix cookie parsing to retrieve the correct header.
Update to
mirage-net
0.5.0 API (based on cstruct 0.6.0).
0.9.4 (2012-12-19):
Add Lwt
respond_redirect
andrespond_need_auth
helpers.Add enough Basic authorization support to serve a password-protected website.
Fix Lwt file serving to not throw exception on trying to serve a directory.
Port Async interface to 108.07.00 or higher (incompatible with earlier versions).
0.9.3 (2012-10-27):
Add basic cookie support back to the portable library.
Cohttp_lwt.Client.post_form
now uses non-chunked encoding for the POST instead of chunked.Various improvements and tests for the pipelined Lwt Client.callv
If an Lwt callback does not consume a body, ensure it has been drained by the API to prevent future pipelines from stalls.
Fix handling of Lwt server non-empty POST bodies.
Map the
put
functions to HTTP PUT instead of POST.
0.9.2 (2012-09-20):
Add Request.get_param to extract a singleton key from queries.
Fix chunked encoding handling when short reads occur.
Install HTML documentation for all enabled drivers.
Use ocaml-uri-1.3.2 interface for query parsing.
Lwt: Add Server.respond_file and resolve_file for the Unix library to make it easier to serve static files.
Lwt: Server.respond_not_found takes an optional Uri.t now.
0.9.1 (2012-09-11):
Functorise for Async, Lwt_unix and Mirage.
Use URI and Re libraries to not need Str any more.
More robust parsing for various HTTP headers.
0.9.0 (2012-08-01):
Initial public release.