Struct MemoryExternalUrlOpener

Source

pub struct MemoryExternalUrlOpener { /* private fields */ }

Expand description

Deterministic opener for headless runtimes and tests.

Clones share recorded URLs and the one-shot error slot through Rc<RefCell<_>>. The type is neither Send nor Sync. Successful opens append exact URL strings without a capacity bound; tests should drain them when appropriate.

§Examples

use ailloli_ui_runtime::app::{ExternalUrl, ExternalUrlOpener, MemoryExternalUrlOpener};
let opener = MemoryExternalUrlOpener::new();
let alias = opener.clone();
alias.open(&ExternalUrl::parse("https://example.com")?)?;
assert_eq!(opener.opened_urls(), ["https://example.com"]);

Implementations§

Source §

impl MemoryExternalUrlOpener

Provides the operations defined for MemoryExternalUrlOpener.

Source

pub fn new() -> Self

Creates an opener with an empty log and no scheduled failure.

§Examples

use ailloli_ui_runtime::app::MemoryExternalUrlOpener;
let opener = MemoryExternalUrlOpener::new();
assert!(opener.opened_urls().is_empty());

Source

pub fn opened_urls(&self) -> Vec<String>

Clones and returns all successful URL sources in call order.

This is O(total stored URL bytes) and does not clear the log.

§Panics

Panics on a conflicting borrow through a reentrant alias.

§Examples

use ailloli_ui_runtime::app::{ExternalUrl, ExternalUrlOpener, MemoryExternalUrlOpener};
let opener = MemoryExternalUrlOpener::new();
opener.open(&ExternalUrl::parse("https://example.com/a")?)?;
assert_eq!(opener.opened_urls(), ["https://example.com/a"]);
assert_eq!(opener.opened_urls().len(), 1);

Source

pub fn take_opened_urls(&self) -> Vec<String>

Drains and returns all successful URL sources in call order.

A second call returns an empty vector until another successful open.

§Panics

Panics on a conflicting borrow through a reentrant alias.

§Examples

use ailloli_ui_runtime::app::{ExternalUrl, ExternalUrlOpener, MemoryExternalUrlOpener};
let opener = MemoryExternalUrlOpener::new();
opener.open(&ExternalUrl::parse("https://example.com")?)?;
assert_eq!(opener.take_opened_urls(), ["https://example.com"]);
assert!(opener.take_opened_urls().is_empty());

Source

pub fn fail_next(&self, error: OpenUrlError)

Makes the next open attempt return error without recording its URL.

Calling this again before an attempt replaces the pending error. Clones observe and consume the same one-shot slot.

§Panics

Panics on a conflicting borrow through a reentrant alias.

§Examples

use ailloli_ui_runtime::app::{ExternalUrl, ExternalUrlOpener, MemoryExternalUrlOpener, OpenUrlError};
let opener = MemoryExternalUrlOpener::new();
let url = ExternalUrl::parse("https://example.com")?;
opener.fail_next(OpenUrlError::Unavailable);
assert_eq!(opener.open(&url), Err(OpenUrlError::Unavailable));
assert_eq!(opener.open(&url), Ok(()));