تغليف استدعاء R قائم على httr بإعداد وكيل

لعملية R تستخدم httr، ابنِ إعداد الوكيل الخاص بها باستعمال use_proxy وطبّقه على التعبير الذي تريد تشغيله:

route <- httr::use_proxy('proxy.example', 8080)
result <- httr::with_config(route, {
  httr::GET('https://www.example.com/')
})

لحساب وكيل، يقبل use_proxy أيضًا الوسائط username وpassword وauth. وفّرها من إعداد بيانات الاعتماد القائم في التطبيق عند الحاجة.

يمكن أن يحتوي التعبير على استدعاء مكتبة أعلى مستوى عندما تكون تلك المكتبة تجري طلباتها فعليًا عبر httr. المكتبة المبنية على RCurl أو على عميل HTTP آخر لها واجهة إعداد خاصة بها؛ فحدّد تلك الخلفية قبل اختيار الكائن الذي ستمرّره.

يجمع with_config الإعداد المقدَّم مع إعدادات httr القائمة افتراضيًا. ولاختبار مسموح لعنوان عام، يمكن لعنوان من قائمة وكلاء HTTP أن يملأ host وport في use_proxy فقط عندما لا تحتوي الإعدادات المدمجة على بيانات اعتماد وكيل. وتحدّد وسيطة override ما إذا كان ينبغي بدلًا من ذلك تجاهل الإعدادات القائمة لذلك التعبير.

هذا نطاق إعداد للشيفرة المحددة. set_config هي الواجهة لتغيير الإعداد الافتراضي الأوسع في httr، لذا استخدم الغلاف عندما يُقصد أن يرافق الوكيل عملية واحدة.