curlify

`

Utilitys for generating curl commands. Use the builder api, convert a gleam_http request or parse a curl command line string.

Checkout the companion lib called curlify_wisp if you are a wisp user.

gleam add curlify@1

Usage

URL → curl string

import curlify
import gleam/http

pub fn main() {
  curlify.from_url("https://api.example.com/users")
  |> curlify.set_method(http.Post)
  |> curlify.set_body(curlify.Json("{\"name\": \"test\"}"))
  |> curlify.to_string()

  // → curl -X POST --json '{"name": "test"}' 'https://api.example.com/users'
}

Request → curl string

import curlify
import gleam/http/request

pub fn main() {
  let assert Ok(req) = request.to("https://api.example.com/users")
  let req = req
    |> request.set_method(http.Post)
    |> request.set_header("Content-Type", "application/json")
    |> request.set_body("{\"name\": \"test\"}")

  curlify.from_request(req)
  |> curlify.set_follow_redirects()
  |> curlify.set_timeout(30)
  |> curlify.to_string()

  // → curl -X POST --json '{"name": "test"}' --max-time 30 -L 'https://api.example.com/users'
}

Multi-line output

curlify.from_request(req)
|> curlify.to_pretty_string()
// → curl -X POST \
//     --json '{"name": "test"}' \
//     'https://api.example.com/users'

Curl string → Request

// Parse a curl command
let assert Ok(curl) = curlify.parse(
  "curl -X POST --json '{\"name\": \"test\"}' 'https://api.example.com/data'",
)

// Parse and convert directly to a request
let assert Ok(req) = curlify.curl_to_request(
  "curl -X POST -H 'content-type: application/json' --data '{\"name\": \"test\"}' 'https://api.example.com/data'",
)

Raw argument list (no shell escaping)

curlify.from_request(req)
|> curlify.to_args()
// → ["-X", "POST", "--json", "{\"name\": \"test\"}", "https://api.example.com/users"]

Gleam source code

curlify.from_request(req)
|> curlify.to_gleam()
// → let assert Ok(req) = request.to("https://api.example.com/data")
//    let req = req
//      |> request.set_method(http.Post)
//      |> request.set_header("accept", "application/json")
//      |> request.set_body("{\"name\": \"test\"}")

(yes, I'm just gluing strings together and hoping for the bests.)

Supported curl flags for parsing

-X/--request, -H/--header, -d/--data, --data-raw, --data-binary, --json, --data-urlencode, -L/--location, -v/--verbose, -k/--insecure, --compressed, --max-time, -u/--user, -A/--user-agent.

Unsupported flags are silently dropped.

Notes on behavior:

• Multiple -d/--data flags use last-wins (real curl concatenates with &).
• --max-time with a non-integer value returns Error(BadTimeoutValue).
• from_request automatically detects Content-Type: application/json and stores the body as the Json(...) variant, so it renders as --json.

Development

gleam test     # Run the tests
gleam format   # Format code