resolve_redirect_urls: Resolve URLs Through Redirects

In pagerankr: Modular Toolkit for PageRank Calculation

Resolve URLs Through Redirects

Description

Given a character vector of URLs and a redirect data frame, resolves each URL to its final destination by following redirect chains. Unlike resolve_redirects, this function does not require an edge list – it works directly on a list of URLs. This helper is redirect-only; use [resolve_canonical_urls()] for 'rel=canonical' folding or [resolve_folded_urls()] for composed redirect plus canonical folding.

Usage

resolve_redirect_urls(
  urls,
  redirects_df,
  redirect_from_col = "from",
  redirect_to_col = "to",
  duplicate_from_policy = c("strict", "first_wins", "last_wins", "most_frequent",
    "prune_source", "resolve_if_consistent"),
  loop_handling = c("error", "prune_loop", "break_arrow")
)

Arguments

urls	Character vector of URLs to resolve.
redirects_df	A data frame containing redirect rules.
redirect_from_col	Character, name of the source column. Default "from".
redirect_to_col	Character, name of the target column. Default "to".
duplicate_from_policy	How to handle conflicting redirects. Passed through to redirect preprocessing. Default "strict".
loop_handling	How to handle redirect cycles. Default "error". Use "prune_loop" or "break_arrow" to resolve despite loops.

Value

A data frame with columns:

original

The input URL.

resolved

The final destination after following all redirects.

changed

Logical, whether the URL was modified by a redirect.

See Also

Other URL-vector resolvers: resolve_canonical_urls(), resolve_folded_urls()

Examples

redirects <- data.frame(
  from = c("A", "B", "C"),
  to = c("B", "C", "Final")
)

# Resolve specific URLs
resolve_redirect_urls(c("A", "B", "X"), redirects)

# X is not in the redirect map, so it stays as-is

pagerankr documentation built on Oct. 1, 2026, 5:09 p.m.