Scala combinator library for building Finagle HTTP services
Scala
Latest commit 7b5de3f Jul 28, 2016 @vkostyukov vkostyukov committed on GitHub Merge pull request #620 from omerzach/patch-1
Add Sigma to Finch "Adopters" list in README.md

README.md

Finch is a thin layer of purely functional basic blocks atop of Finagle for building composable HTTP APIs. Its mission is to provide the developers simple and robust HTTP primitives being as close as possible to the bare metal Finagle API.

Badges

Build Status Coverage Status Gitter Maven Central

Modules

Finch uses multi-project structure and contains of the following modules:

Installation

Every Finch module is published at Maven Central. Use the following sbt snippet ...

  • for the stable release:
libraryDependencies ++= Seq(
  "com.github.finagle" %% "[finch-module]" % "0.11.0-M2"
)
  • for the SNAPSHOT version:
resolvers += Resolver.sonatypeRepo("snapshots")

libraryDependencies ++= Seq(
  "com.github.finagle" %% "[finch-module]" % "0.11.0-SNAPSHOT" changing()
)

Hello World!

This "Hello World!" example is built with the 0.11.0-M2 version of finch-core.

import io.finch._
import com.twitter.finagle.Http

val api: Endpoint[String] = get("hello") { Ok("Hello, World!") }

Http.server.serve(":8080", api.toServiceAs[Text.Plain])

See examples sub-project for more complete examples.

Performance

We use wrk to load test Finch+Circe against Finagle+Jackson to get some insight on how much overhead, an idiomatic Finch application written in a purely functional way, involves on top of Finagle/Jackson. The results are quite impressive (for a pre-1.0 version): Finch performs on 85% of Finagle's throughput.

Benchmark Run 1 Run 2 Run 3
Finagle + Jackson 33867.56 req/s 43781.26 req/s 43854.92 req/s
Finch + Circe 27126.25 req/s 36720.75 req/s 37191.58 req/s

Finch is also load tested against a number of Scala HTTP frameworks and libraries as par of the TechEmpower benchmark. The most recent round showed that Finch performs really well there, scoring a second place across all the Scala libraries.

Documentation

Adopters

Contributing

There are plenty of ways to contribute into Finch:

  • Give it a star
  • Join the Gitter room and leave a feedback or help with answering users' questions
  • Submit a PR (there is an issue label "easy" for newcomers)
  • Be cool and wear a Finch T-Shirt

The Finch project supports the Typelevel code of conduct and wants all of its channels (Gitter, GitHub, etc.) to be welcoming environments for everyone.

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.