finchers

finchers is a combinator library for building asynchronous HTTP services.

The concept and design was highly inspired by [finch].

Features

• Asynchronous handling powerd by futures and Tokio
• Building an HTTP service by combining the primitive components
• Type-safe routing without (unstable) procedural macros

Usage

Add this item to Cargo.toml in your project:

toml [dependencies] finchers = "0.13.5"

Example

```rust,no_run

[macro_use]

extern crate finchers; use finchers::prelude::*;

fn main() { let endpoint = path!(@get / "greeting" / String) .map(|name: String| { format!("Hello, {}!\n", name) });

finchers::server::start(endpoint)
    .serve("127.0.0.1:4000")
    .expect("failed to start the server");

} ```

Resources

• API documentation (docs.rs)
• API documentation (master)
• Examples
• Gitter chat

Contributed Features

• [finchers-juniper] - GraphQL integration support, based on [juniper]
• [finchers-tungstenite] - WebSocket support, based on [tungstenite]
• [finchers-session]: Session support
• [finchers-template]: Template engine support

Status

| Travis CI | Appveyor | CircleCI | Codecov | |:---------:|:--------:|:--------:|:-------:| | | | | |

License

This project is licensed under either of

• MIT license, (LICENSE-MIT or http://opensource.org/licenses/MIT)
• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

at your option.