Skip to content

Rust library to open URLs in the web browsers available on a platform

License

Notifications You must be signed in to change notification settings

coasys/webbrowser-rs

 
 

Repository files navigation

webbrowser

Current Crates.io Version Crates.io Downloads License

Linux Build Windows Build MacOS Build iOS Build Android Build WASM Build

Rust library to open URLs and local files in the web browsers available on a platform, with guarantees of Consistent Behaviour.

Inspired by the webbrowser python library

Documentation

Examples

use webbrowser;

if webbrowser::open("http://github.com").is_ok() {
    // ...
}

Platform Support

Platform Supported Browsers Test status
macos default + others
windows default only
linux/wsl default only (respects $BROWSER env var, so can be used with other browsers)
android default only
ios/tvOS/visionOS default only
wasm default only
unix (*bsd, aix etc.) default only (respects $BROWSER env var, so can be used with other browsers) Manual

Consistent Behaviour

webbrowser defines consistent behaviour on all platforms as follows:

  • Browser guarantee - This library guarantees that the browser is opened, even for local files - the only crate to make such guarantees at the time of this writing. Alternative libraries rely on existing system commands, which may lead to an editor being opened (instead of the browser) for local html files, leading to an inconsistent behaviour for users.
  • Non-Blocking for GUI based browsers (e.g. Firefox, Chrome etc.), while Blocking for text based browser (e.g. lynx etc.)
  • Suppressed output by default for GUI based browsers, so that their stdout/stderr don't pollute the main program's output. This can be overridden by webbrowser::open_browser_with_options.

Crate Features

webbrowser optionally allows the following features to be configured:

  • hardened - this disables handling of non-http(s) urls (e.g. file:///) as a hard security precaution
  • disable-wsl - this disables WSL file implementation (http still works)
  • wasm-console - this enables logging to wasm console (valid only on wasm platform)

Looking to contribute?

PRs invited for

  • Bugs
  • Supporting non-default browser invocation on any platform

Important note (while testing):

  • This library requires availability of browsers and a graphical environment during runtime
  • cargo test will actually open the browser locally

When contributing, please note that your work will be dual licensed as MIT + Apache-2.0 (see below).

License

SPDX-License-Identifier: Apache-2.0 OR MIT

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

About

Rust library to open URLs in the web browsers available on a platform

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 97.6%
  • Other 2.4%