
Инструмент безопасности для отслеживания переходов URL по rel-ссылкам для получения конечного URL.
Hoper показывает каждый переход (редирект), через который проходит URL, пока не достигнет конечного пункта назначения — полезно для сокращателей 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 Release с примечаниями из CHANGELOG.
Сообщения об ошибках и pull-запросы приветствуются на GitHub по адресу https://github.com/gabamnml/hoper. Этот проект задуман как безопасное и дружелюбное пространство для сотрудничества, и от участников ожидается соблюдение Кодекса поведения Contributor Covenant.
Gem доступен как открытое программное обеспечение на условиях лицензии MIT.
Откройте для себя самые используемые инструменты нашего сообщества.
Данных о популярности пока нет.