Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fsprojects/FsHttp
A lightweight F# HTTP library by @SchlenkR and @dawedawe
https://github.com/fsprojects/FsHttp
fsharp http http-client rest rest-client
Last synced: 4 months ago
JSON representation
A lightweight F# HTTP library by @SchlenkR and @dawedawe
- Host: GitHub
- URL: https://github.com/fsprojects/FsHttp
- Owner: fsprojects
- License: apache-2.0
- Created: 2018-08-22T18:53:00.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-03-05T15:11:48.000Z (4 months ago)
- Last Synced: 2024-03-10T20:14:21.487Z (4 months ago)
- Topics: fsharp, http, http-client, rest, rest-client
- Language: F#
- Homepage: https://fsprojects.github.io/FsHttp/
- Size: 3.71 MB
- Stars: 402
- Watchers: 14
- Forks: 42
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-fsharp - FsHttp - A convenient library for consuming HTTP/REST endpoints via F#. [Apache 2.0] (HTTP Clients / Performance analysis)
- awesome-stars - fsprojects/FsHttp - A lightweight F# HTTP library by @SchlenkR and @dawedawe (F# #)
README
# FsHttp [](https://github.com/fsprojects/FsHttp/actions/workflows/build-and-test.yml) [](https://www.nuget.org/packages/FsHttp)
FsHttp ("Full Stack HTTP") is a "hackable HTTP client" that offers a legible style for the basics while still affording full access to the underlying HTTP representations for covering unusual cases. It's the best of both worlds: **Convenience and Flexibility**.
* Use it as a replacement for `.http` files, *VSCode's REST client*, *Postman*, and other tools as an **interactive and programmable playground** for HTTP requests.
* Usable as a **production-ready HTTP client** for applications powered by .NET (C#, VB, F#).
👍 Postman? ❤️ FsHttp! https://youtu.be/F508wQu7ET0
Developed and maintained by [@SchlenkR](https://github.com/schlenkr) and [@dawedawe](https://github.com/dawedawe). Feel free to leave us a message.
## Documentation
* 📖 Please see [FsHttp Documentation](https://fsprojects.github.io/FsHttp) site for detailed documentation.
* 🧪 In addition, have a look at the [Integration Tests](https://github.com/fsprojects/FsHttp/tree/master/src/Tests) that show various library details.
### F# syntax example
```fsharp
#r "nuget: FsHttp"
open FsHttp
http {
POST "https://reqres.in/api/users"
CacheControl "no-cache"
body
jsonSerialize
{|
name = "morpheus"
job = "leader"
|}
}
|> Request.send
```
### C# syntax example
```csharp
#r "nuget: FsHttp"
using FsHttp;
await Http
.Post("https://reqres.in/api/users")
.CacheControl("no-cache")
.Body()
.JsonSerialize(new
{
name = "morpheus",
job = "leader"
}
)
.SendAsync();
```
### Release Notes / Migrating to new versions
* See https://www.nuget.org/packages/FsHttp#release-body-tab
* For different upgrade paths, please read the [Migrations docs section](https://fsprojects.github.io/FsHttp/Release_Notes.html).
## Building
**.Net SDK:**
You need to have a recent .NET SDK installed, which is specified in `./global.json`.
**Build Tasks**
There is a F# build script (`./build.fsx`) that can be used to perform several build tasks from command line.
For common tasks, there are powershell files located in the repo root:
* `./test.ps1`: Runs all tests (sources in `./src/Tests`).
* You can pass args to this task. E.g. for executing only some tests:
`./test.ps1 --filter Name~'Response Decompression'`
* `./docu.ps1`: Rebuilds the FsHttp documentation site (sources in `./src/docs`).
* `./docu-watch.ps1`: Run it if you are working on the documentation sources, and want to see the result in a browser.
* `./publish.ps1`: Publishes all packages (FsHttp and it's integration packages for Newtonsoft and FSharp.Data) to NuGet.
* Always have a look at `./src/Directory.Build.props` and keep the file up-to-date.
## Credits
* Parts of the code were taken from the [HTTP utilities of FSharp.Data](https://fsprojects.github.io/FSharp.Data/library/Http.html).
* Credits to all critics, supporters, contributors, promoters, users, and friends.