Μετατροπή curl σε Clojure

Το clj-http είναι η πιο δημοφιλής βιβλιοθήκη HTTP client για την Clojure, που περιβάλλει το Apache HttpComponents. Παρέχει ένα ιδιωματικό, data-driven API με αυτόματο parsing JSON/EDN, διαχείριση cookies και connection pooling. Προσθέστε στο project.clj: [clj-http "3.x"]. Το curl2code χρησιμοποιεί το clj-http για όλες τις μετατροπές Clojure.

Το clj-http είναι σύγχρονο, πλούσιο σε χαρακτηριστικά και το πιο ευρέως χρησιμοποιούμενο. Το http-kit είναι ελαφρύ με υποστήριξη async, εξαιρετικό για servers που κάνουν επίσης κλήσεις HTTP. Το aleph είναι χτισμένο στο Netty για async I/O υψηλής απόδοσης. Για παρόμοιες συναρτησιακές γλώσσες, δείτε τον μετατροπέα curl σε Elixir ή curl σε OCaml.

Για Bearer auth, προσθέστε κεφαλίδες: (client/get url {:headers {"Authorization" "Bearer token"}'}). Για Basic auth, χρησιμοποιήστε την ενσωματωμένη επιλογή: {:basic-auth ["user" "pass"]}. Το clj-http υποστηρίζει επίσης OAuth και digest auth. Το curl2code μετατρέπει τα flags -u και τις κεφαλίδες σε ιδιωματικούς χάρτες (maps) της Clojure.

Χρησιμοποιήστε την επιλογή :multipart: (client/post url {:multipart [{:name "file" :content (clojure.java.io/file "doc.pdf")} {:name "desc" :content "My file"}]}). Το clj-http διαχειρίζεται αυτόματα τη δημιουργία boundary και το Content-Type. Το curl2code μετατρέπει τα flags -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 εκτελούνται στο thread pool του JVM. Για παρόμοιο concurrency, δείτε το curl σε Java.

Περάστε επιλογές timeout: (client/get url {:connection-timeout 10000 :socket-timeout 30000}). Οι τιμές είναι σε χιλιοστά του δευτερολέπτου. Για επαναλήψεις, χρησιμοποιήστε την επιλογή :retry-handler ή περιβάλλετε σε μια προσαρμοσμένη συνάρτηση επανάληψης με exponential backoff. Αυτά αντιστοιχούν στα --connect-timeout και --max-time του curl.

Ορίστε τον proxy στον χάρτη επιλογών: (client/get url {:proxy-host "proxy" :proxy-port 8080}). Για proxies με authentication: προσθέστε :proxy-user και :proxy-pass. Το clj-http υποστηρίζει επίσης SOCKS proxies. Το curl2code μετατρέπει τα flags -x και --proxy στις σωστές επιλογές proxy του clj-http.

Μετατρέψτε μια 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 flags με JSON περιεχόμενο και ορίζει την κατάλληλη Content-Type κεφαλίδα στον κώδικα clj-http.

Περάστε το curl -H "Authorization: Bearer YOUR_TOKEN" URL στο curl2code και αυτό θα δημιουργήσει κώδικα clj-http με την κεφαλίδα εξουσιοδότησης: :headers {'Authorization' 'Bearer YOUR_TOKEN'}. Το curl2code εντοπίζει τα Bearer tokens τόσο από τα -H "Authorization: Bearer ..." όσο και από τα --oauth2-bearer flags. Για 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.