
Herramienta de seguridad para rastrear saltos de URL a través de los enlaces rel para obtener la última URL.
Hoper muestra cada salto (redirección) por el que pasa una URL hasta llegar a su destino final: útil para acortadores de URL, enlaces de seguimiento en correos electrónicos, flujos de SSO o para depurar reglas de redirección.
$ 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 por defecto (sin descargas del cuerpo) con fallback automático a GET para servidores que lo rechazan.HTTP_PROXY / HTTPS_PROXY / NO_PROXY y NO_COLOR.Requiere Ruby 3.1 o superior.
gem install hoper
En Windows, instala Ruby con RubyInstaller y luego ejecuta el mismo comando.
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 se omite el esquema, se asume 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 }
]
}
Con varias URL, la salida es un array.
| Código | Significado |
|---|---|
| 0 | Todas las URL se resolvieron a una respuesta final sin error (< 400) |
| 1 | Al menos una URL falló (error de red, bucle, demasiados saltos, 4xx/5xx) |
| 2 | Uso / opciones no válidos |
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 ejecuta la suite de pruebas en Ubuntu, macOS y Windows (Ruby 4.0), además de la versión más antigua de Ruby compatible (3.1) en Ubuntu. Las pruebas utilizan un servidor HTTP local en proceso, por lo que no necesitan acceso a la red.
Las versiones se publican de forma automatizada con GitHub Actions y RubyGems Trusted Publishing:
Actualiza lib/hoper/version.rb y añade una sección a CHANGELOG.md; fusiona en master.
Etiqueta y sube:
git tag v1.2.3 && git push origin v1.2.3
El flujo de trabajo Release verifica que la etiqueta coincida con la versión, ejecuta las pruebas, publica la gema en RubyGems.org y crea un GitHub Release con las notas del CHANGELOG.
Los informes de errores y las solicitudes de extracción son bienvenidos en GitHub en https://github.com/gabamnml/hoper. Este proyecto tiene la intención de ser un espacio seguro y acogedor para la colaboración, y se espera que los colaboradores cumplan con el Código de Conducta del Contribuyente.
La gema está disponible como código abierto bajo los términos de la Licencia MIT.