https://github.com/dckt/rescript-ky-promise
ReScript bindings for ky HTTP client with rescript-promise
https://github.com/dckt/rescript-ky-promise
Last synced: 4 months ago
JSON representation
ReScript bindings for ky HTTP client with rescript-promise
- Host: GitHub
- URL: https://github.com/dckt/rescript-ky-promise
- Owner: DCKT
- Created: 2024-02-19T07:48:57.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-19T08:15:29.000Z (over 2 years ago)
- Last Synced: 2025-04-05T16:35:05.793Z (about 1 year ago)
- Language: ReScript
- Size: 7.81 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# rescript-ky-promise
ReScript bindings for [ky HTTP client](https://github.com/sindresorhus/ky) (targeted version : `~1.2.0`) with [rescript-promise](https://github.com/DCKT/rescript-promise) module.
## Setup
1. Install the module
```bash
bun install @dck/rescript-ky-promise
# or
yarn install @dck/rescript-ky-promise
# or
npm install @dck/rescript-ky-promise
```
2. Add it to your `rescript.json` config
```json
{
"bsc-dependencies": ["@dck/rescript-ky-promise"]
}
```
## Usage
The functions can be accessed through `Ky` module.
```rescript
type data = {anything: string}
let fetchSomething = async () => {
try {
let response: data = await Ky.fetch("test", {prefixUrl: "https://fake.com", method: GET}).json()
// handle response data
} catch {
| JsError(err) => {
// handle err
Js.log(err)
}
}
}
```
Use shortcut method :
```rescript
type data = {anything: string}
let fetchSomething = async () => {
try {
let response: data = await Ky.get("test", {prefixUrl: "https://fake.com"}).json()
// handle response data
} catch {
| JsError(err) => {
// handle err
Js.log(err)
}
}
}
```
### Instance
```rescript
let instance = Ky.Instance.create({prefixUrl: "https://fake.com"})
type data = {anything: string}
let fetchSomething = async () => {
try {
let response: data = await (instance->Ky.Instance.get("test")).json()
// handle response data
} catch {
| JsError(err) => {
// handle err
Js.log(err)
}
}
}
```
### Extend
```rescript
let instance = Ky.Instance.create({prefixUrl: "https://fake.com"})
let extendedInstance = instance->Ky.Instance.extend({
prefixUrl: `${mockBasePath}/extend`,
headers: Ky.Headers.fromObj({
"custom-header": "test",
}),
})
type data = {anything: string}
let fetchSomething = async () => {
try {
let response: data = await (extendedInstance->Ky.Instance.get("test")).json()
// handle response data
} catch {
| JsError(err) => {
// handle err
Js.log(err)
}
}
}
```