Struct WebDevServer 

pub struct WebDevServer { /* private fields */ }

A running <pm> run <script> process group whose printed dev-server URL has been captured.

The child leads its own process tree — a process group on Unix, a job object on Windows — so dropping the guard terminates the whole tree: bun run dev re-execs node vite, which a lone kill_on_drop on the direct child would orphan. water run holds the guard across the app’s lifetime, so a normal exit, an app exit, and the Ctrl-C future-drop path all stop the dev server.

Implementations

impl WebDevServer

pub async fn spawn( package_manager: PackageManager, root: &Path, script: &str, expose_on_lan: bool, ) -> Result<Self>

Spawn <pm> run <script> inside root and read its stdout until the listening URL appears.

stdout is piped so the URL can be parsed; every line is echoed to the terminal as it arrives and a background task keeps draining after the URL is found so the bundler never blocks on a full pipe. stderr is inherited — the bundler’s diagnostics reach the user verbatim.

Errors

Fails when the process cannot be spawned or its stdout ends without a loopback dev-server URL ever appearing.

expose_on_lan appends --host 0.0.0.0 to the dev script so the bundler listens beyond loopback — required when the target is a physical device, for which localhost is the device itself.

Panics

Panics if the spawned child has no piped stdout — impossible, since the spawn configures it above.

pub const fn url(&self) -> &Url

The dev-server URL the app should open.

Trait Implementations

impl Debug for WebDevServer

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

Formats the value using the given formatter.

impl Drop for WebDevServer

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.