Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/finchers-rs/finchers
A combinator library for building asynchronous HTTP services
https://github.com/finchers-rs/finchers
combinators finch hyper
Last synced: 3 months ago
JSON representation
A combinator library for building asynchronous HTTP services
- Host: GitHub
- URL: https://github.com/finchers-rs/finchers
- Owner: finchers-rs
- License: apache-2.0
- Archived: true
- Created: 2017-08-17T11:49:40.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-03-29T13:40:48.000Z (over 5 years ago)
- Last Synced: 2024-07-07T11:24:09.772Z (4 months ago)
- Topics: combinators, finch, hyper
- Language: Rust
- Homepage: https://finchers-rs.github.io/finchers
- Size: 2.99 MB
- Stars: 57
- Watchers: 4
- Forks: 2
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Changelog: changelog/0.12.x.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# `finchers`
[![Crates.io][crates-io-badge]][crates-io]
[![Crates.io (Downloads)][downloads-badge]][crates-io]
[![Docs.rs][docs-rs-badge]][docs-rs]
[![Master doc][master-doc-badge]][master-doc]
[![Rustc Version][rustc-version-badge]][rustc-version]
[![dependency status][dependencies-badge]][dependencies]
[![Gitter][gitter-badge]][gitter]
`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.14.0-dev"
```
# Example
```rust,no_run
use finchers::{
prelude::*,
endpoint::syntax::path,
};
fn main() -> izanami::Result<()> {
let endpoint = path!(@get "/greeting/")
.map(|name: String| {
format!("Hello, {}!\n", name)
});
izanami::Server::build()
.start(endpoint.into_service())
}
```
# Resources
* [API documentation (docs.rs)][docs-rs]
* [API documentation (master)][master-doc]
* [Examples][examples]
* [Gitter chat][gitter]
# 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 | Codecov |
|:---------:|:-------:|
| [![Travis CI][travis-badge]][travis] | [![Codecov][codecov-badge]][codecov] |
# License
This project is licensed under either of
* MIT license, ([LICENSE-MIT](./LICENSE-MIT) or http://opensource.org/licenses/MIT)
* Apache License, Version 2.0 ([LICENSE-APACHE](./LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
at your option.
[crates-io]: https://crates.io/crates/finchers
[docs-rs]: https://docs.rs/finchers
[master-doc]: https://finchers-rs.github.io/finchers
[examples]: https://github.com/finchers-rs/examples
[user-guide]: https://finchers-rs.github.io/finchers/guide/index.html
[gitter]: https://gitter.im/finchers-rs/finchers
[travis]: https://travis-ci.org/finchers-rs/finchers
[circleci]: https://circleci.com/gh/finchers-rs/finchers/tree/master
[codecov]: https://codecov.io/gh/finchers-rs/finchers
[dependencies]: https://deps.rs/crate/finchers/0.13.5
[rustc-version]: https://rust-lang.org
[crates-io-badge]: https://img.shields.io/crates/v/finchers.svg
[downloads-badge]: https://img.shields.io/crates/d/finchers.svg
[docs-rs-badge]: https://docs.rs/finchers/badge.svg
[master-doc-badge]: https://img.shields.io/badge/docs-master-blue.svg
[gitter-badge]: https://badges.gitter.im/finchers-rs/finchers.svg
[travis-badge]: https://travis-ci.org/finchers-rs/finchers.svg?branch=master
[circleci-badge]: https://circleci.com/gh/finchers-rs/finchers/tree/master.svg?style=svg
[codecov-badge]: https://codecov.io/gh/finchers-rs/finchers/branch/master/graph/badge.svg
[dependencies-badge]: https://deps.rs/crate/finchers/0.13.5/status.svg
[rustc-version-badge]: https://img.shields.io/badge/rustc-1.29+-yellow.svg
[`finchers-juniper`]: https://github.com/finchers-rs/finchers-juniper
[`finchers-tungstenite`]: https://github.com/finchers-rs/finchers-tungstenite
[`finchers-session`]: https://github.com/finchers-rs/finchers-session
[`finchers-template`]: https://github.com/finchers-rs/finchers-template
[`finch`]: https://github.com/finagle/finch
[`juniper`]: https://github.com/graphql-rust/juniper.git
[`tungstenite`]: https://github.com/snapview/tungstenite-rs