tower/tower-service
Carl Lerche f42338934a
Require `poll_ready` to be called before `call` (#161)
This updates the `Service` contract requiring `poll_ready` to be called
before `call`. This allows `Service::call` to panic in the event the
user of the service omits `poll_ready` or does not wait until `Ready` is
observed.
2019-02-21 12:18:56 -08:00
..
src Require `poll_ready` to be called before `call` (#161) 2019-02-21 12:18:56 -08:00
CHANGELOG.md tower-service v0.2.0 (#135) 2018-12-12 16:14:05 -05:00
Cargo.toml tower-service v0.2.0 (#135) 2018-12-12 16:14:05 -05:00
LICENSE Minor documentation improvements (#93) 2018-08-09 10:08:57 -07:00
README.md Update link to Service trait docs in tower-service README (#146) 2019-01-14 10:08:43 -08:00

README.md

Tower Service

The foundational Service trait that Tower is based on.

Overview

The Service trait provides the foundation upon which Tower is built. It is a simple, but powerful trait. At its heart, Service is just an asynchronous function of request to response.

fn(Request) -> Future<Item = Response>

Implementations of Service take a request, the type of which varies per protocol, and returns a future representing the eventual completion or failure of the response.

Services are used to represent both clients and servers. An instance of Service is used through a client; a server implements Service.

By using standardizing the interface, middleware can be created. Middleware implement Service by passing the request to another Service. The middleware may take actions such as modify the request.

License

This project is licensed under the MIT license.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Tower by you, shall be licensed as MIT, without any additional terms or conditions.