
Outil de sécurité pour tracer les sauts d'URL à travers les liens rel afin d'obtenir la dernière URL
Hoper affiche chaque saut (redirection) par lequel passe une URL jusqu'à sa destination finale — utile pour les raccourcisseurs d'URL, les liens de suivi dans les e-mails, les flux SSO ou le débogage des règles de redirection.
$ 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 par défaut (aucun téléchargement de corps) avec repli automatique sur GET pour les serveurs qui le rejettent.HTTP_PROXY / HTTPS_PROXY / NO_PROXY et NO_COLOR.Nécessite Ruby 3.1 ou une version plus récente.
gem install hoper
Sous Windows, installez Ruby avec RubyInstaller puis exécutez la même commande.
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
Si le schéma est omis, https:// est supposé (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 }
]
}
Avec plusieurs URL, la sortie est un tableau.
| Code | Signification |
|---|---|
| 0 | Chaque URL a abouti à une réponse finale sans erreur (< 400) |
| 1 | Au moins une URL a échoué (erreur réseau, boucle, trop de sauts, 4xx/5xx) |
| 2 | Utilisation / options invalides |
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
La CI exécute la suite de tests sur Ubuntu, macOS et Windows (Ruby 4.0), ainsi que sur la plus ancienne version de Ruby prise en charge (3.1) sur Ubuntu. Les tests utilisent un serveur HTTP local en cours de processus, ils n'ont donc pas besoin d'accès réseau.
Les versions sont automatisées avec GitHub Actions et RubyGems Trusted Publishing :
Incrémentez lib/hoper/version.rb et ajoutez une section à CHANGELOG.md ; fusionnez vers master.
Taguez et poussez :
git tag v1.2.3 && git push origin v1.2.3
Le workflow Release vérifie que le tag correspond à la version, exécute les tests, publie la gem sur RubyGems.org et crée une GitHub Release avec les notes du CHANGELOG.
Les rapports de bugs et les pull requests sont les bienvenus sur GitHub à l'adresse https://github.com/gabamnml/hoper. Ce projet se veut un espace sûr et accueillant pour la collaboration, et les contributeurs sont tenus de respecter le code de conduite Contributor Covenant.
La gem est disponible en open source selon les termes de la MIT License.