Go to file
David Barsky 186a0fb4a3 get building 2019-11-28 15:15:41 -05:00
ci Remove tokio alpha.6 patches (#357) 2019-09-30 21:15:26 -04:00
tower Cleanup unused dependencies (#364) 2019-11-11 09:52:33 -08:00
tower-balance Fix up last few merge issues 2019-11-26 10:32:49 -05:00
tower-buffer Fix up last few merge issues 2019-11-26 10:32:49 -05:00
tower-discover Bumps for 0.3.0-alpha.2 (#355) 2019-09-30 18:56:26 -04:00
tower-filter Bumps for 0.3.0-alpha.2 (#355) 2019-09-30 18:56:26 -04:00
tower-hedge Cleanup unused dependencies (#364) 2019-11-11 09:52:33 -08:00
tower-layer Cleanup unused dependencies (#364) 2019-11-11 09:52:33 -08:00
tower-limit Expect the poll_acquire error, not return (#362) 2019-10-31 14:06:04 -04:00
tower-load Bumps for 0.3.0-alpha.2 (#355) 2019-09-30 18:56:26 -04:00
tower-load-shed Bumps for 0.3.0-alpha.2 (#355) 2019-09-30 18:56:26 -04:00
tower-make make: Add alpha.2a changelog 2019-09-30 20:53:39 -04:00
tower-ready-cache get building 2019-11-28 15:15:41 -05:00
tower-reconnect make: Bump version to alpha.2a (#356) 2019-09-30 20:40:28 -04:00
tower-retry Bumps for 0.3.0-alpha.2 (#355) 2019-09-30 18:56:26 -04:00
tower-service Fix tower-service docs (#361) 2019-10-18 17:18:55 -04:00
tower-spawn-ready Bumps for 0.3.0-alpha.2 (#355) 2019-09-30 18:56:26 -04:00
tower-test Bumps for 0.3.0-alpha.2 (#355) 2019-09-30 18:56:26 -04:00
tower-timeout Bumps for 0.3.0-alpha.2 (#355) 2019-09-30 18:56:26 -04:00
tower-util Bumps for 0.3.0-alpha.2 (#355) 2019-09-30 18:56:26 -04:00
.gitignore Initial commit 2016-08-26 16:26:03 -07:00
Cargo.toml get building 2019-11-28 15:15:41 -05:00
LICENSE Update the license for 2019 and tower contributors (#148) 2019-01-15 17:29:08 -05:00
README.md Add a note about v0.3.x branch to the readme (#312) 2019-08-20 23:20:01 -04:00
azure-pipelines.yml Re-enable all CI (#353) 2019-09-24 18:56:37 -04:00

README.md

Tower

NOTE: Tower's master branch is currently using futures 0.1, please refer to the v0.3.x branch to use any of the new std::future::Future based libraries. This will stay in effect until we have fully upgraded to std::future::Future.

Tower is a library of modular and reusable components for building robust networking clients and servers.

Build Status Gitter

Overview

Tower aims to make it as easy as possible to build robust networking clients and servers. It is protocol agnostic, but is designed around a request / response pattern. If your protocol is entirely stream based, Tower may not be a good fit.

Project Layout

Tower consists of a number of components, each of which live in their own sub crates.

  • tower: The main user facing crate that provides batteries included tower services (docs).

  • tower-service: The foundational traits upon which Tower is built (docs).

  • tower-layer: The foundational trait to compose services together (docs).

  • tower-balance: A load balancer. Load is balanced across a number of services (docs).

  • tower-buffer: A buffering middleware. If the inner service is not ready to handle the next request, tower-buffer stores the request in an internal queue (docs).

  • tower-discover: Service discovery abstraction (docs).

  • tower-filter: Middleware that conditionally dispatch requests to the inner service based on a predicate (docs).

  • tower-limit: Middleware limiting the number of requests that are processed (docs).

  • tower-reconnect: Middleware that automatically reconnects the inner service when it becomes degraded (docs).

  • tower-retry: Middleware that retries requests based on a given Policy (docs).

  • tower-test: Testing utilies (docs).

  • tower-timeout: Middleware that applies a timeout to requests (docs).

  • tower-util: Miscellaneous additional utilities for Tower (docs).

Status

Currently, only tower-service, the foundational trait, has been released to crates.io. The rest of the library will be following shortly.

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.