Struct BaseUrlContext 

pub struct BaseUrlContext { /* private fields */ }

Context for tracking base URLs during parsing

This struct maintains the current base URL context and provides methods for URL resolution within a parsing context.

Implementations

impl BaseUrlContext

pub const fn new() -> Self

Creates a new context with no base URL

pub fn with_base(base: impl Into<String>) -> Self

Creates a new context with an initial base URL

pub fn base(&self) -> Option<&str>

Gets the current base URL

pub fn update_base(&mut self, xml_base: &str)

Updates the base URL with a new xml:base value

The new base is resolved against the current base if it’s relative.

pub fn resolve(&self, href: &str) -> String

Resolves a URL against the current base

pub fn resolve_safe(&self, href: &str) -> String

Resolves a URL against the current base with SSRF protection

This method performs URL resolution and validates the result to prevent Server-Side Request Forgery (SSRF) attacks via malicious xml:base attributes.

Security

If the resolved URL fails SSRF safety checks (localhost, private IPs, dangerous schemes), the original href is returned unchanged instead of the resolved URL.

Arguments

• href - The URL to resolve (may be relative or absolute)

Returns

The resolved URL if safe, otherwise the original href

Examples

use feedparser_rs::util::base_url::BaseUrlContext;

// Safe URL resolution
let ctx = BaseUrlContext::with_base("http://example.com/");
assert_eq!(ctx.resolve_safe("page.html"), "http://example.com/page.html");

// SSRF blocked - returns original href
let dangerous_ctx = BaseUrlContext::with_base("http://localhost/");
assert_eq!(dangerous_ctx.resolve_safe("admin"), "admin");

pub fn child(&self) -> Self

Creates a child context inheriting this context’s base

pub fn child_with_base(&self, xml_base: &str) -> Self

Creates a child context with an additional xml:base

Trait Implementations

impl Clone for BaseUrlContext

fn clone(&self) -> BaseUrlContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BaseUrlContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BaseUrlContext

fn default() -> BaseUrlContext

Returns the “default value” for a type.