https://github.com/http4s/http4s

A minimal, idiomatic Scala interface for HTTP
https://github.com/http4s/http4s

cats fs2 http http-client http-server scala typelevel

Last synced: about 2 months ago
JSON representation

A minimal, idiomatic Scala interface for HTTP

• Host: GitHub
• URL: https://github.com/http4s/http4s
• Owner: http4s
• License: apache-2.0
• Created: 2012-03-12T04:41:20.000Z (over 12 years ago)
• Default Branch: series/0.23
• Last Pushed: 2024-07-13T18:00:28.000Z (2 months ago)
• Last Synced: 2024-07-14T10:07:51.982Z (2 months ago)
• Topics: cats, fs2, http, http-client, http-server, scala, typelevel
• Language: Scala
• Homepage: https://http4s.org/
• Size: 90.3 MB
• Stars: 2,524
• Watchers: 73
• Forks: 789
• Open Issues: 321
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

• awesome-zio - Http4s ★ 732 ⧗ 3 - A minimal, idiomatic Scala interface for HTTP. (HTTP)

README

        
# Http4s [![Build Status](https://github.com/http4s/http4s/workflows/Continuous%20Integration/badge.svg?branch=series/0.23)](https://github.com/http4s/http4s/actions?query=branch%3Aseries%2F0.23+workflow%3A%22Continuous+Integration%22) [![Maven Central](https://img.shields.io/maven-central/v/org.http4s/http4s-core_2.13?versionPrefix=0.23)](https://img.shields.io/maven-central/v/org.http4s/http4s-core_2.13?versionPrefix=0.23) [![Typelevel library](https://img.shields.io/badge/typelevel-library-green.svg)](https://typelevel.org/projects/#http4s) 

Http4s is a minimal, idiomatic Scala interface for HTTP services.  Http4s is

Scala's answer to Ruby's Rack, Python's WSGI, Haskell's WAI, and Java's

Servlets.

```scala

val http = HttpRoutes.of {

  case GET -> Root / "hello" =>

    Ok("Hello, better world.")

}

```

Learn more at [http4s.org](https://http4s.org/).

If you run into any difficulties please enable partial unification in your `build.sbt` (not needed for Scala 2.13 and beyond, because Scala 2.13.0+ has partial unification switched on by default)

```scala

scalacOptions ++= Seq("-Ypartial-unification")

```

## Requirements

Running the **blaze** backend requires a modern, supported version of the JVM to build and run, as it relies on server

APIs unavailable before JDK8u252. Any JDK newer than JDK8u252, including 9+ is supported.

## Code of Conduct

http4s is proud to be a [Typelevel](https://typelevel.org/)

project.  We are committed to providing a friendly, safe and welcoming

environment for all, and ask that the community adhere to the [Scala

Code of Conduct](https://http4s.org/code-of-conduct/).

## License

This software is licensed under the Apache 2 license, quoted below.

> Copyright 2013-2021 http4s [[https://http4s.org](https://http4s.org/)]

> Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

> [[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)]

> 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.

## Acknowledgments

[![YourKit](https://www.yourkit.com/images/yklogo.png)](https://www.yourkit.com/)

Special thanks to [YourKit](https://www.yourkit.com/) for supporting this project's ongoing performance tuning efforts with licenses to their excellent product.