curl komutunu OCaml diline dönüştür

Cohttp, OCaml için standart HTTP istemci ve sunucu kütüphanesidir. Eşzamanlı G/Ç için hem Lwt (hafif iş parçacıkları) hem de Async arka uçlarını destekler. opam install cohttp-lwt-unix ile kurulur. HTTP istekleri için tip güvenli, fonksiyonel bir API sağlar. curl2code, tüm OCaml dönüşümleri için Cohttp kullanır.

Cohttp, Lwt/Async desteğine sahip standart OCaml HTTP kütüphanesidir. ocurl, libcurl'ü sarmalayarak tüm curl özelliklerine OCaml'den erişim sağlar. piaf daha yenidir ve HTTP/2 yerel desteğine sahiptir. İdiyomatik OCaml için Cohttp'yi, curl'e özgü özelliklere ihtiyaç duyduğunuzda ocurl'ü kullanın. Benzer fonksiyonel diller için curl'den Elixir'e veya curl'den Clojure'a bakabilirsiniz.

İsteğe bir Authorization başlığı ekleyin: Header.add headers "Authorization" ("Bearer " ^ token). Basic auth için, base64 paketini kullanarak kimlik bilgilerini base64 ile kodlayın. Cohttp başlıkları sabittir (immutable) — bunları Header.of_list ile oluşturun veya Header.add çağrılarını zincirleyin.

Multipart gövdesini sınır dizeleriyle (boundary) manuel olarak oluşturun veya multipart_form gibi bir kütüphane kullanın. Content-Type başlığını sınır dizesiyle birlikte ayarlayın. Cohttp'nin gövdesi basit bir dize veya akıştır — multipart yükünü RFC 2046'ya göre formatlayın. curl2code, -F bayrağı dönüşümünü yönetir.

Lwt ile Cohttp vaatler (promises) döndürür — hata yönetimi için Lwt.catch veya try%lwt ... with sözdizimini kullanın. Yanıt durum kodunu Response.status response ile kontrol edin. OCaml'in tip sistemi, hata durumlarını ele almanızı sağlar. Kapsamlı yönetim için durum kodları üzerinde desen eşleştirme (pattern matching) kullanın.

Lwt arka ucu ile: paralel yürütme için Lwt.all [request1; request2] veya URL'ler üzerinde eşleme yapmak için Lwt_list.map_p kullanın. Async ile: Deferred.all kullanın. OCaml'in Lwt veya Async aracılığıyla sunduğu işbirlikçi eşzamanlılık (cooperative concurrency), iş parçacığı güvenliği endişesi olmadan güvenli ve verimli eşzamanlı G/Ç sağlar.

Lwt ile, bir isteği bir zamanlayıcıya karşı yarıştırmak için Lwt.pick [request; Lwt_unix.sleep timeout >>= fun () -> Lwt.fail Timeout] kullanın. Cohttp'nin yerleşik zaman aşımı seçenekleri yoktur — Lwt vaadini bir zaman aşımı birleştiricisi (combinator) ile sarmalayın. Yeniden denemeler için, azalan deneme sayısına sahip özyinelemeli bir fonksiyon uygulayın.

Cohttp'nin yerleşik proxy desteği yoktur. Proxy ihtiyaçları için ocurl (libcurl bağlamaları) kullanın: CURLOPT_PROXY seçeneğini ayarlayın. Alternatif olarak, HTTP_PROXY ortam değişkenini ayarlayın ve bağlantıyı proxy ana makinesi ve bağlantı noktası üzerinden manuel olarak yönlendirilecek şekilde yapılandırın.

curl2code kullanarak curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL gibi bir curl POST komutunu OCaml koduna dönüştürün. Üretilen kod Client.post ~body:(Cohttp_lwt.Body.of_string json) uri kullanır. curl2code, JSON içeriğine sahip -d/--data bayraklarını otomatik olarak algılar ve Cohttp kodunda uygun Content-Type başlığını ayarlar.

curl2code aracına curl -H "Authorization: Bearer YOUR_TOKEN" URL komutunu iletin; araç, yetkilendirme başlığı içeren Cohttp kodunu üretecektir: Header.add headers 'Authorization' 'Bearer YOUR_TOKEN'. curl2code, hem -H "Authorization: Bearer ..." hem de --oauth2-bearer bayraklarından Bearer token değerlerini algılar. Basic auth için -u user:pass kullanın.

curl2code, curl -H "Content-Type: application/json" URL komutunu uygun başlığa sahip Cohttp koduna dönüştürür: Header.add headers 'Content-Type' 'application/json'. -d verisi için curl varsayılan olarak application/x-www-form-urlencoded kullanır; -F form yüklemeleri için multipart/form-data kullanır. curl2code her birini doğru Cohttp API eşlemesine aktarır.