המרת curl ל-Julia

HTTP.jl היא חבילת הסטנדרט ללקוח ושרת HTTP עבור Julia. היא מספקת API פשוט ברמה גבוהה עם connection pooling, ניהול עוגיות ותמיכה בסטרימינג. התקן עם using Pkg; Pkg.add("HTTP"). היא משתלבת היטב עם מערכת ה-multiple dispatch של Julia. curl2code משתמש ב-HTTP.jl עבור כל המרות ה-Julia.

HTTP.jl הוא לקוח HTTP מלא — השתמש בו עבור ממשקי API ובקשות מותאמות אישית. Downloads.jl הוא מודול בספריית הסטנדרט להורדת קבצים פשוטה. LibCURL.jl עוטף את libcurl עבור תכונות ספציפיות של curl. לרוב המשימות, HTTP.jl הוא הבחירה הנכונה. ללקוחות דומים בחישוב מדעי, ראה curl ל-Python או curl ל-R.

העבר כותרות כווקטור של זוגות: HTTP.get(url, ["Authorization" => "Bearer $token"]). עבור Basic auth: ["Authorization" => "Basic $(base64encode("$user:$pass"))"]. אינטרפולציית המחרוזות של Julia עם $ הופכת את בניית הכותרות לנקיָה. curl2code ממיר דגלי אימות לתחביר Julia.

השתמש ב-HTTP.Form: HTTP.post(url, body=HTTP.Form(["file" => open("doc.pdf"), "desc" => "My file"])). HTTP.jl מטפל בקידוד multipart, ב-boundaries וב-Content-Type באופן אוטומטי. curl2code ממיר דגלי -F לתחביר HTTP.jl Form.

HTTP.jl זורק HTTP.StatusError בתגובות שאינן 2xx כברירת מחדל. בטל זאת עם status_exception=false כדי לקבל את התגובה ישירות. השתמש ב-try ... catch e לטיפול בשגיאות. בדוק את e.status עבור קוד ה-HTTP. שגיאות רשת זורקות HTTP.IOError.

השתמש במשימות @async: tasks = [@async HTTP.get(url) for url in urls], ואז responses = fetch.(tasks). למקביליות אמיתית, השתמש ב-Threads.@threads או ב-Distributed. המשימות מבוססות ה-coroutine של Julia יעילות עבור בקשות מקביליות מוגבלות I/O.

העבר את מילת המפתח readtimeout: HTTP.get(url, readtimeout=30). עבור timeout של חיבור, השתמש ב-connect_timeout. עבור ניסיונות חוזרים, השתמש ב-retry=true עם retries=3. ל-HTTP.jl יש מנגנון retry מובנה עם exponential backoff. אלו ממופים ל---max-time ו---connect-timeout של curl.

העבר את מילת המפתח proxy: HTTP.get(url, proxy="http://proxy:8080"). HTTP.jl מכבד גם את משתני הסביבה HTTP_PROXY ו-HTTPS_PROXY כברירת מחדל. עבור פרוקסים עם אימות, כלול את פרטי האימות ב-URL של הפרוקסי: http://user:pass@proxy:8080.

המירו פקודת curl POST כמו curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL ל-Julia באמצעות curl2code. הקוד שנוצר משתמש ב-HTTP.post(url, ['Content-Type' => 'application/json'], JSON3.write(data)). curl2code מזהה באופן אוטומטי דגלי -d/--data עם תוכן JSON ומגדיר את כותרת Content-Type המתאימה בקוד ה-HTTP.jl.

העבירו את curl -H "Authorization: Bearer YOUR_TOKEN" URL ל-curl2code והוא יפיק קוד HTTP.jl עם כותרת האימות: ['Authorization' => 'Bearer YOUR_TOKEN']. curl2code מזהה Bearer tokens גם מדגלי -H "Authorization: Bearer ..." וגם מדגלי --oauth2-bearer. עבור Basic auth, השתמשו ב--u user:pass.

curl2code ממיר את curl -H "Content-Type: application/json" URL לקוד HTTP.jl עם הכותרת המתאימה: ['Content-Type' => 'application/json']. עבור נתוני -d, curl משתמש כברירת מחדל ב-application/x-www-form-urlencoded; עבור העלאות טפסים עם -F, הוא משתמש ב-multipart/form-data. curl2code ממפה כל אחד מהם ל-API הנכון של HTTP.jl.