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

clj-http — найпопулярніша бібліотека HTTP-клієнта для Clojure, що є обгорткою над Apache HttpComponents. Вона надає ідіоматичний API, орієнтований на дані, з автоматичним парсингом JSON/EDN, керуванням файлами cookie та пулом з'єднань. Додайте в project.clj: [clj-http "3.x"]. curl2code використовує clj-http для всіх перетворень у Clojure.

clj-http — синхронна, багатофункціональна та найбільш вживана. http-kit — легка, з підтримкою асинхронності, чудова для серверів, які також роблять HTTP-виклики. aleph побудована на Netty для високоефективного асинхронного введення/виведення. Для подібних функціональних мов дивіться наш конвертер curl в Elixir або curl в OCaml.

Для Bearer-автентифікації додайте заголовки: (client/get url {:headers {"Authorization" "Bearer token"}'}). Для Basic-автентифікації використовуйте вбудовану опцію: {:basic-auth ["user" "pass"]}. clj-http також підтримує OAuth та digest-автентифікацію. curl2code перетворює -u та прапорці заголовків в ідіоматичні мапи Clojure.

Використовуйте опцію :multipart: (client/post url {:multipart [{:name "file" :content (clojure.java.io/file "doc.pdf")} {:name "desc" :content "My file"}]}). clj-http автоматично обробляє генерацію меж та Content-Type. curl2code перетворює прапорці -F у цей патерн Clojure.

За замовчуванням clj-http викидає ExceptionInfo при відповідях, відмінних від 2xx. Вимкніть це за допомогою {:throw-exceptions false}, щоб замість цього отримати мапу відповіді. Перевіряйте (:status response). Використовуйте try/catch з ex-data, щоб витягти відповідь із винятків.

Використовуйте clj-http з {:async? true}, що повертає future. Або використовуйте http-kit: (http/get url callback). Для паралельних запитів використовуйте pmap або канали core.async. Clojure futures працюють у пулі потоків JVM. Для подібної конкурентності дивіться curl у Java.

Передайте опції таймауту: (client/get url {:connection-timeout 10000 :socket-timeout 30000}). Значення вказані в мілісекундах. Для повторів використовуйте опцію :retry-handler або огорніть у власну функцію повтору з експоненціальною затримкою. Вони відповідають опціям curl --connect-timeout та --max-time.

Встановіть проксі в мапі опцій: (client/get url {:proxy-host "proxy" :proxy-port 8080}). Для проксі з автентифікацією додайте :proxy-user та :proxy-pass. clj-http також підтримує SOCKS-проксі. curl2code перетворює прапорці -x та --proxy у відповідні опції проксі Clojure.

Конвертуйте команду curl POST, таку як curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL, у Clojure за допомогою curl2code. Згенерований код використовує (client/post url {:content-type :json :body (json/generate-string data)}). curl2code автоматично виявляє прапорці -d/--data із вмістом JSON і встановлює відповідний заголовок Content-Type у коді clj-http.

Передайте curl -H "Authorization: Bearer YOUR_TOKEN" URL у curl2code, і він згенерує код clj-http із заголовком авторизації: :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 у код clj-http із відповідним заголовком: :content-type :json. Для даних -d curl за замовчуванням використовує application/x-www-form-urlencoded; для завантаження форм -F використовується multipart/form-data. curl2code зіставляє кожен варіант із правильним clj-http API.