تحويل curl إلى Julia

HTTP.jl هي الحزمة القياسية لعميل وخادم HTTP للغة Julia. توفر واجهة برمجة تطبيقات بسيطة وعالية المستوى مع تجميع الاتصالات، ومعالجة ملفات تعريف الارتباط (cookies)، ودعم التدفق. يمكن تثبيتها عبر using Pkg; Pkg.add("HTTP"). تتكامل المكتبة بشكل جيد مع نظام الإرسال المتعدد (multiple dispatch) في Julia. يستخدم curl2code مكتبة HTTP.jl لجميع تحويلات Julia.

HTTP.jl هو عميل HTTP كامل الميزات — استخدمه لواجهات البرمجة والطلبات المخصصة. Downloads.jl هي وحدة في المكتبة القياسية لتنزيل الملفات البسيطة. LibCURL.jl تغلف libcurl لميزات curl المحددة. لمعظم المهام، HTTP.jl هو الخيار الصحيح. لعملاء الحوسبة العلمية المماثلة، راجع curl إلى Python أو curl إلى R.

قم بتمرير الترويسات كمتجه من الأزواج: HTTP.get(url, ["Authorization" => "Bearer $token"]). للمصادقة الأساسية: ["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 والحدود و 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. مهام Julia القائمة على الروتينات المساعدة (coroutines) فعالة لطلبات الإدخال والإخراج المتزامنة.

قم بتمرير الكلمة المفتاحية readtimeout: HTTP.get(url, readtimeout=30). لمهلة الاتصال، استخدم connect_timeout. لإعادة المحاولة، استخدم retry=true مع retries=3. تحتوي HTTP.jl على ميزة إعادة محاولة مدمجة مع تراجع أسي. هذه الخيارات تقابل --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 من كل من وسوم -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.