tokusumi / webbrowser-rs

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

webbrowser

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

Inspired by the webbrowser python library

Documentation

• API Reference
• Release Notes

Examples

use webbrowser;

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

Currently state of platform support is:

• macos => default, as well as browsers listed under Browser. UTF-8 tests currently fail on Github Runner, but run fine on local, so YMMV.
• windows => default browser only
• linux/*bsd => default browser only (uses $BROWSER env var, failing back to xdg-open, gvfs-open, gnome-open, whichever works first)
• android => default browser only
• haiku => untested and experimental
• wasm -> untested and experimental
• ios => not supported right now

Important note:

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

PRs invited for

• Fixing macos tests for UTF-8 URLs
• Support for other platforms, e.g. iOS

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

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.