hyper

KO | EN

gitlite — search

#hacktoberfest #typescript #machine-learning #deep-learning #linux #nodejs #macos #windows #cli #vue #pytorch #ios #mcp #openai

(★ 71)

OCaml Web client, composable with Dream [unannounced]

hyper 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Hyper</h1>

Straightforward, full-featured Web client that composes with Dream.

```ocaml
Lwt_main.run begin
  let%lwt response = Hyper.get "http://google.com" in
  print_string response;
  Lwt.return_unit
end
```

*Note: the client is not actually full-featured yet :) This README is also an
extremely rough sketch :) This repository is a work in progress*

Hyper is the client counterpart to [Dream][dream], the Web server framework.
Hyper uses the same types and the same programming model. Like Dream, Hyper
offers one module, which features a bunch of easy-to-use functions. Also like
Dream, Hyper still exposes the underlying highly composable functions, for full
customization.

## Documentation

At the moment, Hyper offers only three main "stable" values:

```ocaml
Hyper.get : string -> string promise
Hyper.post : string -> string -> string promise
Hyper.websocket : string -> websocket promise
```

These support all the same Web protocols as Dream: HTTP/1, HTTP/2, TLS, and
WebSocket, and they follow redirects. The protocols are selected using URI
schemes:

```ocaml
Hyper.get "http://google.com"
Hyper.post "https://some.app/endpoint" "{}"
Hyper.websocket "ws://some.site/socket"
```

You can see early usage in the [examples][examples].

These are actually wrappers around a "stack" of `request -> response promise`
handlers and client-side middlewares, but the elements of that stack are not
mature enough to expose yet. They will eventually be exposed to quickly build
custom clients with any desired behavior.

For testing WebSockets, Hyper offers an interface similar to
[the one in Dream](https://aantron.github.io/dream/#websockets):

```ocaml
Hyper.send : websocket -> string -> unit promise
Hyper.receive : websocket -> string option promise
Hyper.close_websocket : websocket -> unit promise
```

[dream]: https://github.com/aantron/dream
[examples]: https://github.com/aantron/hyper/tree/master/example

## Composability

A Hyper client and a Dream server have exactly the same type,
`request -> response promise`.

This means that the client's lowest layer can be implemented by swapping out
connecting over the network by a direct call to an in-process Dream server,
which can be useful for no-network testing.

Conversely, a Dream server can pass the requests it receives to a Hyper client,
thus acting as a proxy. Responses received from the proxy client can be directly
returned by the server to *its* client.

In all cases, all body streams and WebSockets get forwarded automatically as a
side effect of the conventions followed by Hyper and Dream.

## Roadmap

- [ ] Restore [connection pooling and multiplexing](https://github.com/aantron/dream/blob/f69b95644a237be0aa3c9d3c6e29a7be32a5dbdb/src/hyper.ml#L76).
- [ ] 🛑 Server certificate validation.
- [ ] File uploads (multipart streams).
- [ ] Cookie store.
- [ ] Redirect cache.
- [ ] Automatic decompression.
- [ ] `wss://` (WebSockets over TLS).
- [ ] Many miscellania.

## Contact

Open an [issue](https://github.com/aantron/dream/issues), or visit...

- #dream on the [Reason Discord](https://discord.gg/2JTYRq2rYh).
- #webdev on the [OCaml Discord](https://discord.gg/sx45hPkkWV)
- The [OCaml Discuss forum](https://discuss.ocaml.org/).

Highlight `@antron` to poke @aantron specifically.

## Contributing

To work on Hyper, clone Dream and Hyper into a single Dune workspace:

```
mkdir my-directory
cd my-directory
touch dune-workspace
git clone --recursive https://github.com/aantron/dream.git
git clone https://github.com/aantron/hyper.git
cd hyper
```

## Acknowledgements

As with Dream, Hyper makes extensive use of the http/af-like Web protocol stack
by [Antonio Nuno Monteiro](https://github.com/anmonteiro).

hyper

hyper 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

hyper

hyper 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README