Конвертувати curl у OCaml

Cohttp — це стандартна бібліотека HTTP-клієнта та сервера для OCaml. Вона підтримує бекенди Lwt (легковагові потоки) та Async для конкурентного введення-виведення. Встановлюється за допомогою opam install cohttp-lwt-unix. Вона надає типобезпечний функціональний API для HTTP-запитів. curl2code використовує Cohttp для всіх конвертацій OCaml.

Cohttp — це стандартна бібліотека HTTP для OCaml із підтримкою Lwt/Async. ocurl є обгорткою над libcurl, що дає доступ до всіх функцій curl з OCaml. piaf — новіша бібліотека з нативною підтримкою HTTP/2. Використовуйте Cohttp для ідіоматичного OCaml, а ocurl — коли потрібні специфічні функції curl. Для схожих функціональних мов див. curl до Elixir або curl до Clojure.

Додайте заголовок Authorization до запиту: Header.add headers "Authorization" ("Bearer " ^ token). Для Basic auth закодуйте облікові дані у base64 за допомогою пакета base64. Заголовки Cohttp є незмінними — створюйте їх за допомогою Header.of_list або ланцюжка викликів Header.add.

Сформуйте тіло multipart вручну з рядками-розділювачами (boundary) або скористайтеся бібліотекою на кшталт multipart_form. Встановіть заголовок Content-Type із зазначенням boundary. Тіло запиту в Cohttp — це звичайний рядок або потік; форматуйте корисне навантаження multipart відповідно до RFC 2046. curl2code обробляє конвертацію прапорця -F.

Cohttp з Lwt повертає проміси — використовуйте синтаксис Lwt.catch або try%lwt ... with для обробки помилок. Перевіряйте код статусу відповіді за допомогою Response.status response. Система типів OCaml гарантує обробку випадків невдачі. Використовуйте зіставлення зі зразком (pattern matching) для кодів статусів для вичерпної обробки.

З бекендом Lwt: використовуйте Lwt.all [request1; request2] для паралельного виконання або Lwt_list.map_p для відображення списку URL-адрес. З Async: використовуйте Deferred.all. Кооперативна багатозадачність OCaml через Lwt або Async забезпечує безпечне та ефективне конкурентне введення-виведення без проблем із безпекою потоків.

З Lwt використовуйте Lwt.pick [request; Lwt_unix.sleep timeout >>= fun () -> Lwt.fail Timeout], щоб запустити запит наввипередки з таймером. Cohttp не має вбудованих опцій таймауту — оберніть проміс Lwt комбінатором таймауту. Для повторних спроб реалізуйте рекурсивну функцію зі зменшенням кількості спроб.

Cohttp не має вбудованої підтримки проксі. Використовуйте ocurl (бібліотека для libcurl) для потреб проксі: встановіть опцію CURLOPT_PROXY. Альтернативно, встановіть змінну середовища HTTP_PROXY та налаштуйте з'єднання для маршрутизації через хост і порт проксі вручну.

Конвертуйте команду curl POST, таку як curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL, у OCaml за допомогою curl2code. Згенерований код використовує Client.post ~body:(Cohttp_lwt.Body.of_string json) uri. curl2code автоматично виявляє прапорці -d/--data із вмістом JSON і встановлює відповідний заголовок Content-Type у коді Cohttp.

Передайте curl -H "Authorization: Bearer YOUR_TOKEN" URL у curl2code, і він згенерує код Cohttp із заголовком авторизації: Header.add headers 'Authorization' 'Bearer YOUR_TOKEN'. curl2code виявляє Bearer-токени як у прапорцях -H "Authorization: Bearer ...", так і в --oauth2-bearer. Для Basic auth використовуйте -u user:pass.

curl2code конвертує curl -H "Content-Type: application/json" URL у код Cohttp із відповідним заголовком: Header.add headers 'Content-Type' 'application/json'. Для даних -d curl за замовчуванням використовує application/x-www-form-urlencoded; для завантаження форм -F використовується multipart/form-data. curl2code зіставляє кожен варіант із правильним Cohttp API.