
أداة أمنية لتتبع القفزات عبر روابط rel للحصول على عنوان URL الأخير
يعرض Hoper كل قفزة (إعادة توجيه) يمر بها عنوان URL حتى يصل إلى وجهته النهائية — وهو مفيد لمختصرات الروابط، وروابط التتبع في رسائل البريد الإلكتروني، وتدفقات SSO، أو تصحيح أخطاء قواعد إعادة التوجيه.
$ hoper http://github.com
Tracing http://github.com
1. → 301 Moved Permanently http://github.com/ 81ms
2. ✔ 200 OK https://github.com/ 50ms
1 redirect → https://github.com/
HEAD افتراضيًا (دون تنزيل النص) مع رجوع تلقائي إلى GET للخوادم التي ترفضه.HTTP_PROXY / HTTPS_PROXY / NO_PROXY وNO_COLOR.يتطلب Ruby 3.1 أو أحدث.
gem install hoper
على Windows، ثبّت Ruby باستخدام RubyInstaller ثم شغّل الأمر نفسه.
hoper [options] URL [URL...]
-m, --max-hops N Maximum redirects to follow (default: 20)
-t, --timeout SECONDS Timeout per request (default: 10)
-X, --method METHOD HTTP method: HEAD or GET (default: HEAD)
-A, --user-agent UA User-Agent header to send
-H, --header 'NAME: VALUE' Extra request header (repeatable)
-k, --insecure Do not verify TLS certificates
-j, --json Output results as JSON
--[no-]color Force/disable colored output
-v, --version Print version and exit
-h, --help Show this help
إذا حُذفت المخطط، يُفترض https:// (hoper example.com).
hoper --json http://github.com
{
"start_url": "http://github.com/",
"final_url": "https://github.com/",
"final_status": 200,
"redirects": 1,
"hops": [
{ "url": "http://github.com/", "status": 301, "reason": "Moved Permanently", "location": "https://github.com/", "duration_ms": 81 },
{ "url": "https://github.com/", "status": 200, "reason": "OK", "duration_ms": 50 }
]
}
مع عدة عناوين URL يكون الناتج مصفوفة.
| الرمز | المعنى |
|---|---|
| 0 | تم حل كل عنوان URL إلى استجابة نهائية غير خطأ (< 400) |
| 1 | فشل عنوان URL واحد على الأقل (خطأ في الشبكة، حلقة، عدد كبير جدًا من القفزات، 4xx/5xx) |
| 2 | استخدام / خيارات غير صالحة |
require "hoper"
result = Hoper.trace("https://bit.ly/example", max_hops: 10)
result.hops.each { |hop| puts "#{hop.status} #{hop.url}" }
result.final_url # => "https://example.com/"
result.success? # => true
bundle install
bundle exec rake test
تعمل CI على تشغيل مجموعة الاختبارات على Ubuntu وmacOS وWindows (Ruby 4.0)، بالإضافة إلى أقدم إصدار مدعوم من Ruby (3.1) على Ubuntu. تستخدم الاختبارات خادم HTTP محليًا داخل العملية، لذا لا تحتاج إلى الوصول إلى الشبكة.
تتم أتمتة الإصدارات باستخدام GitHub Actions وRubyGems Trusted Publishing:
قم بتحديث lib/hoper/version.rb وأضف قسمًا إلى CHANGELOG.md؛ ثم ادمج إلى master.
أنشئ وسمًا وادفعه:
git tag v1.2.3 && git push origin v1.2.3
يتحقق سير عمل Release من تطابق الوسم مع الإصدار، ويشغّل الاختبارات، وينشر الجوهرة (gem)
على RubyGems.org وينشئ إصدارًا على GitHub مع ملاحظات CHANGELOG.
نرحّب بتقارير الأخطاء وطلبات السحب على GitHub عبر https://github.com/gabamnml/hoper. هذا المشروع مُخصّص ليكون مساحة آمنة ومرحّبة للتعاون، ويُتوقّع من المساهمين الالتزام بـميثاق المساهمين (Contributor Covenant) لمدونة قواعد السلوك.
الجوهرة (gem) متاحة كمصدر مفتوح بموجب شروط رخصة MIT.