ما الذي تفعله الأداة؟

تحوّل أداة تحويل cURL إلى شيفرة أمر curl إلى شيفرة ترسل طلب HTTP نفسه من برنامجك. وتُنتج ثلاثة أنواع من الشيفرات:

  • JavaScript (fetch): واجهة fetch المضمّنة في المتصفحات وDeno وBun وNode.js.
  • Node.js (Axios): مكتبة Axios الشائعة، مع وحدات Node.js للملفات وإعدادات TLS.
  • Python (Requests): مكتبة Requests.

من الطرق الشائعة للحصول على أمر استخدام أدوات المطوّرين في المتصفح: في لوحة الشبكة، انقر بزر الفأرة الأيمن على طلب واختر «نسخ كـ cURL». وغالبًا ما تعرض وثائق API أمثلتها بصيغة أوامر curl أيضًا.

كيفية الاستخدام

  1. ألصق أمر curl. يمكن أن تمتد الأوامر الطويلة على عدة أسطر، مع وضع شرطة مائلة عكسية في نهاية كل سطر، كما تتوقع shell.
  2. اختر اللغة.
  3. انسخ الشيفرة أو نزّلها كملف (request.mjs لـ JavaScript، وrequest.py لـ Python).

تتحدّث الشيفرة أثناء الكتابة. وإذا احتوى الأمر على خطأ يمنع curl من تنفيذه، مثل علامة اقتباس غير مغلقة أو خيار غير معروف، فستشير الأداة إليه بدلًا من ذلك.

ما الذي يتم تحويله؟

  • الطريقة، بما في ذلك الطرق التي يحددها curl تلقائيًا: الخيار -d والخيار -F يجعلان الطريقة POST، والخيار -I يجعلها HEAD، والخيار -T يجعلها PUT.
  • عنوان URL، بما في ذلك أي استعلام يضيفه الخيار -G أو --url-query.
  • الترويسات من -H، ووكيل المستخدم من -A، والمُحيل من -e، وcookies من -b، والتي تصبح قاموس cookies في Python.
  • المصادقة الأساسية من -u أو من عنوان URL، باستخدام الطريقة الخاصة بكل مكتبة لإرسالها، ورموز Bearer من --oauth2-bearer. كما يتضمن Python مصادقة Digest.
  • محتوى الطلب: يتحول JSON الناتج من --json أو من تعيين نوع المحتوى إلى JSON إلى كائن أو قاموس، وتتحول بيانات النماذج الناتجة من -d إلى URLSearchParams أو قاموس، وتتحول النماذج متعددة الأجزاء الناتجة من -F إلى FormData أو قاموس files، مع تضمين الملفات المرفوعة.
  • المهلة من --max-time (و--connect-timeout في Python)، والخيار -k لتخطي عمليات التحقق من TLS، وشهادات CA وشهادات العميل، والوكيل من -x.

تُستبعد الترويسات التي يضيفها curl بنفسه، مثل User-Agent الخاص به وAccept: */* وContent-Length، لأن المكتبات ترسل ترويساتها الخاصة. كما تُستبعد الخيارات التي لا تغيّر سوى طريقة عرض curl للاستجابة، مثل -s أو -v.

عندما يتعذّر تحويل شيء ما

لا يوجد لبعض العناصر ما يعادلها في مكتبة أو لغة. وتُضاف هذه العناصر كتعليقات في أعلى الشيفرة، حتى لا يُسقط أي شيء دون تنبيه:

  • تُدرج الخيارات التي لا مقابل لها، مثل --retry، ضمن «لم يتم تحويله».
  • لا يمكن لـ fetch تخطي عمليات التحقق من TLS أو استخدام وكيل أو تعيين مهلة اتصال، كما لا تسمح المتصفحات للنصوص البرمجية بتعيين ترويسة Cookie، على عكس Node.js.
  • تُقرأ الملفات التي يقرأها curl، مثل -d @data.json أو -F photo=@cat.jpg، من القرص في Node.js وPython. أما في JavaScript للمتصفح، فتظهر كقيمة مؤقتة عليك استبدالها، مثل ملف من عنصر <input type="file">.
  • عندما يرسل الأمر عدة طلبات، تكون الشيفرة للطلب الأول.

أمثلة

  • يتحول curl https://example.com/ إلى requests.get("https://example.com/") في Python.
  • يتحول curl -u ada:secret https://api.example.com/me إلى auth=("ada", "secret") في Python وإلى خيار auth في Axios.
  • يتحول curl --json '{"item": "sourdough loaf"}' https://api.example.com/orders إلى json={"item": "sourdough loaf"} في Python وإلى JSON.stringify({ item: "sourdough loaf" }) مع fetch.

آلية العمل

تُقرأ الأوامر بالطريقة التي تقرؤها بها shell وcurl، مع علامات الاقتباس ومحارف الهروب ومتابعة الأسطر، باستخدام المحلّل نفسه الذي يستخدمه مدقّق أوامر cURL في الموقع. ثم يُحوّل الطلب الذي كان curl سيرسله إلى شيفرة. تجري جميع العمليات في متصفحك، لذا لا تغادر الأوامر التي تتضمن رموزًا أو كلمات مرور جهازك.

الميزات

  • JavaScript fetch وNode.js Axios وPython Requests
  • الترويسات وcookies ومصادقة Basic وBearer
  • محتوى JSON والنماذج والنماذج متعددة الأجزاء والملفات
  • المهلات وخيارات TLS والشهادات والوكلاء
  • تعليقات لكل ما يتعذّر تحويله
  • رسائل واضحة عند وجود أخطاء في الأمر
  • نسخ الشيفرة أو تنزيلها
  • تعمل في متصفحك