The Lupaxa Developers Toolbox
Part of The Lupaxa Project

lupaxa-real-url

Follow HTTP redirects and report the URL that actually serves the page. The hop list is kept from the URL you started with through to the last response.

Built for scripts and tools used by The Lupaxa Project.

The PyPI name is lupaxa-real-url. The import path is lupaxa.real_url. The CLI is installed as real-url.

Features

• Follows HTTP 3xx redirects, including relative Location values
• Default return is the final URL that served the page
• full=True / --full returns every URL in the chain
• status=True / --status returns each hop with its HTTP status code
• Detects redirect loops and stops after a hop limit
• Fails with typed errors for bad URLs and network problems
• Thin CLI plus a small library API

Installation

From PyPI

pip install lupaxa-real-url

From source (development mode)

pip install -e ".[dev]"

Requires Python 3.10+ and httpx. lupaxa is a namespace package — there is no lupaxa/__init__.py.

Usage

from lupaxa.real_url import resolve

resolve("https://example.com")
resolve("https://example.com", full=True)
resolve("https://example.com", status=True)

real-url https://example.com
real-url --full https://example.com
real-url --status https://example.com
real-url --full --status https://example.com
real-url --version
real-url --help

Default output is one final URL. --full prints one URL per hop. --status prints STATUS URL for each hop.

Development

make init
make python-install-dev
make python-check
make mkdocs-serve

Documentation lives in mkdocs/.