summaryrefslogtreecommitdiffstats
path: root/vendor/opener-0.5.2
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-05-30 03:59:24 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-05-30 03:59:24 +0000
commit023939b627b7dc93b01471f7d41fb8553ddb4ffa (patch)
tree60fc59477c605c72b0a1051409062ddecc43f877 /vendor/opener-0.5.2
parentAdding debian version 1.72.1+dfsg1-1. (diff)
downloadrustc-023939b627b7dc93b01471f7d41fb8553ddb4ffa.tar.xz
rustc-023939b627b7dc93b01471f7d41fb8553ddb4ffa.zip
Merging upstream version 1.73.0+dfsg1.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'vendor/opener-0.5.2')
-rw-r--r--vendor/opener-0.5.2/.cargo-checksum.json1
-rw-r--r--vendor/opener-0.5.2/Cargo.toml49
-rw-r--r--vendor/opener-0.5.2/Drakefile.ts79
-rw-r--r--vendor/opener-0.5.2/LICENSE-APACHE199
-rw-r--r--vendor/opener-0.5.2/LICENSE-MIT19
-rw-r--r--vendor/opener-0.5.2/LICENSE-THIRD-PARTY19
-rw-r--r--vendor/opener-0.5.2/README.md28
-rw-r--r--vendor/opener-0.5.2/src/lib.rs220
-rw-r--r--vendor/opener-0.5.2/src/linux_and_more.rs108
-rw-r--r--vendor/opener-0.5.2/src/macos.rs15
-rw-r--r--vendor/opener-0.5.2/src/windows.rs41
-rw-r--r--vendor/opener-0.5.2/src/xdg-open1065
-rw-r--r--vendor/opener-0.5.2/tests/version-numbers.rs4
13 files changed, 1847 insertions, 0 deletions
diff --git a/vendor/opener-0.5.2/.cargo-checksum.json b/vendor/opener-0.5.2/.cargo-checksum.json
new file mode 100644
index 000000000..bffe903f7
--- /dev/null
+++ b/vendor/opener-0.5.2/.cargo-checksum.json
@@ -0,0 +1 @@
+{"files":{"Cargo.toml":"2cfbe75ecb3af9664c3db6ea65f3d70494beea3fd86efc213c306194ed9f037b","Drakefile.ts":"e357716de020b86a99b96b0b345651f3b2654e77dcb5c7fa98edea4a2a374589","LICENSE-APACHE":"8f3c95de851c0acc9d1cbaa95e500e4198408283b853ed3e355ce27112057b44","LICENSE-MIT":"1847e0e0698142ed4347c1441a9fa81c8fbddd44b1d8bbcd5e3647f991759d7f","LICENSE-THIRD-PARTY":"d1bd8c7783bffd68a6207d89d9243eece7e7df0bb6bcb605f76d9684621c2e35","README.md":"1f8d189094fa1b22436dbf98d8c5f6e87178b42224e6f94d21ceefec44b76070","src/lib.rs":"0992c8f29d4776fc8f36623ec810fc1faf602a55321ab321a2c379bdb2dec696","src/linux_and_more.rs":"96912d2099ac0cad116160b9147d46c8c374f191796c2095a1c56519feed4909","src/macos.rs":"38e762e83064c2150a125b6e6c477640652f9dceeeadbeeda64d0edd4936cf01","src/windows.rs":"d0ed2e6ae1deb8ded4eb8cc9204a868290f390aa9078b7cd953b1dfbd2261c25","src/xdg-open":"25c6bf62d29b61696881695a47994d503ee9bbd9402b8256b3a3e87e495be75e","tests/version-numbers.rs":"8069cb08b31531f8eb5e164089b1acbe7dc77e4ba87dcc0a3717205446847795"},"package":"293c15678e37254c15bd2f092314abb4e51d7fdde05c2021279c12631b54f005"} \ No newline at end of file
diff --git a/vendor/opener-0.5.2/Cargo.toml b/vendor/opener-0.5.2/Cargo.toml
new file mode 100644
index 000000000..8d91b5ef3
--- /dev/null
+++ b/vendor/opener-0.5.2/Cargo.toml
@@ -0,0 +1,49 @@
+# THIS FILE IS AUTOMATICALLY GENERATED BY CARGO
+#
+# When uploading crates to the registry Cargo will automatically
+# "normalize" Cargo.toml files for maximal compatibility
+# with all versions of Cargo and also rewrite `path` dependencies
+# to registry (e.g., crates.io) dependencies.
+#
+# If you are reading this file be aware that the original Cargo.toml
+# will likely look very different (and much more reasonable).
+# See Cargo.toml.orig for the original contents.
+
+[package]
+edition = "2018"
+name = "opener"
+version = "0.5.2"
+authors = ["Brian Bowman <seeker14491@gmail.com>"]
+description = "Open a file or link using the system default program."
+readme = "README.md"
+keywords = [
+ "open",
+ "default",
+ "launcher",
+ "browser",
+]
+categories = ["os"]
+license = "MIT OR Apache-2.0"
+repository = "https://github.com/Seeker14491/opener"
+
+[dev-dependencies.version-sync]
+version = "0.9"
+
+[target."cfg(target_os = \"linux\")".dependencies.bstr]
+version = "1"
+
+[target."cfg(windows)".dependencies.winapi]
+version = "0.3"
+features = ["shellapi"]
+
+[badges.appveyor]
+branch = "master"
+repository = "Seeker14491/opener"
+service = "github"
+
+[badges.maintenance]
+status = "passively-maintained"
+
+[badges.travis-ci]
+branch = "master"
+repository = "Seeker14491/opener"
diff --git a/vendor/opener-0.5.2/Drakefile.ts b/vendor/opener-0.5.2/Drakefile.ts
new file mode 100644
index 000000000..476cb23d9
--- /dev/null
+++ b/vendor/opener-0.5.2/Drakefile.ts
@@ -0,0 +1,79 @@
+import {
+ abort,
+ desc,
+ env,
+ run,
+ sh,
+ shCapture,
+ task,
+} from "https://deno.land/x/drake@v1.5.0/mod.ts";
+
+const SHOULD_CARGO_PUBLISH = true;
+const SHOULD_PUSH_DOCS_TO_GITHUB_PAGES = false;
+
+desc("Release a new version of the crate");
+task("release", [], async () => {
+ const version = env("version");
+ if (version == null) {
+ abort("The version to release was not specified");
+ }
+ if (!isValidSemVer(version)) {
+ abort("The given version is not a valid SemVer string");
+ }
+
+ await sh("cargo test --all-features");
+ await sh("cargo fmt -- --check");
+ await sh("git diff HEAD --exit-code --name-only");
+
+ if (SHOULD_CARGO_PUBLISH) {
+ await sh("cargo publish --dry-run");
+ }
+
+ const tagName = `v${version}`;
+ await sh(`git tag -a ${tagName} -m "Release ${tagName}"`);
+ await sh("git push origin master");
+ await sh(`git push origin ${tagName}`);
+
+ if (SHOULD_CARGO_PUBLISH) {
+ await sh("cargo publish");
+ }
+
+ if (SHOULD_PUSH_DOCS_TO_GITHUB_PAGES) {
+ await run("upload-docs");
+ }
+});
+
+desc("Upload docs to GitHub Pages");
+task("upload-docs", [], async () => {
+ let origin_url;
+ {
+ const { code, output, error } = await shCapture(
+ "git remote get-url origin",
+ );
+ if (code == 0) {
+ origin_url = output.trim();
+ } else {
+ abort("Error getting origin's url from git");
+ }
+ }
+
+ await sh("cargo clean --doc");
+ await sh("cargo doc --no-deps");
+
+ {
+ const run = (command: string) => sh(command, { cwd: "target/doc" });
+
+ await run("git init");
+ await run("git add .");
+ await run('git commit -am "(doc upload)"');
+ await run(`git push -f ${origin_url} master:gh-pages`);
+ }
+});
+
+run();
+
+function isValidSemVer(s: string): boolean {
+ return s.match(
+ /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/,
+ ) != null;
+}
diff --git a/vendor/opener-0.5.2/LICENSE-APACHE b/vendor/opener-0.5.2/LICENSE-APACHE
new file mode 100644
index 000000000..4c8c37f5d
--- /dev/null
+++ b/vendor/opener-0.5.2/LICENSE-APACHE
@@ -0,0 +1,199 @@
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License. \ No newline at end of file
diff --git a/vendor/opener-0.5.2/LICENSE-MIT b/vendor/opener-0.5.2/LICENSE-MIT
new file mode 100644
index 000000000..6802bc4b8
--- /dev/null
+++ b/vendor/opener-0.5.2/LICENSE-MIT
@@ -0,0 +1,19 @@
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. \ No newline at end of file
diff --git a/vendor/opener-0.5.2/LICENSE-THIRD-PARTY b/vendor/opener-0.5.2/LICENSE-THIRD-PARTY
new file mode 100644
index 000000000..10307a7b6
--- /dev/null
+++ b/vendor/opener-0.5.2/LICENSE-THIRD-PARTY
@@ -0,0 +1,19 @@
+- xdg-utils: https://cgit.freedesktop.org/xdg/xdg-utils/plain/LICENSE
+
+ Permission is hereby granted, free of charge, to any person obtaining a
+ copy of this software and associated documentation files (the "Software"),
+ to deal in the Software without restriction, including without limitation
+ the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ and/or sell copies of the Software, and to permit persons to whom the
+ Software is furnished to do so, subject to the following conditions:
+ #
+ The above copyright notice and this permission notice shall be included
+ in all copies or substantial portions of the Software.
+ #
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+ THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+ OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ OTHER DEALINGS IN THE SOFTWARE. \ No newline at end of file
diff --git a/vendor/opener-0.5.2/README.md b/vendor/opener-0.5.2/README.md
new file mode 100644
index 000000000..d204ac804
--- /dev/null
+++ b/vendor/opener-0.5.2/README.md
@@ -0,0 +1,28 @@
+# Opener
+
+This crate provides the ability to open a file or link with the default program configured on the system.
+
+See the docs for more details:
+
+### [Docs](https://docs.rs/opener)
+
+## License
+
+Licensed under either of
+
+* Apache License, Version 2.0
+ (http://www.apache.org/licenses/LICENSE-2.0)
+* MIT license
+ (http://opensource.org/licenses/MIT)
+
+at your option.
+
+### Third party software
+
+See LICENSE-THIRD-PARTY
+
+## 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.
diff --git a/vendor/opener-0.5.2/src/lib.rs b/vendor/opener-0.5.2/src/lib.rs
new file mode 100644
index 000000000..ee00d37a2
--- /dev/null
+++ b/vendor/opener-0.5.2/src/lib.rs
@@ -0,0 +1,220 @@
+#![doc(html_root_url = "https://docs.rs/opener/0.5.2")]
+
+//! This crate provides the [`open`] function, which opens a file or link with the default program
+//! configured on the system:
+//!
+//! ```no_run
+//! # fn main() -> Result<(), ::opener::OpenError> {
+//! // open a website
+//! opener::open("https://www.rust-lang.org")?;
+//!
+//! // open a file
+//! opener::open("../Cargo.toml")?;
+//! # Ok(())
+//! # }
+//! ```
+//!
+//! An [`open_browser`] function is also provided, for when you intend on opening a file or link in a
+//! browser, specifically. This function works like the [`open`] function, but explicitly allows
+//! overriding the browser launched by setting the `$BROWSER` environment variable.
+
+#![warn(
+ rust_2018_idioms,
+ deprecated_in_future,
+ macro_use_extern_crate,
+ missing_debug_implementations,
+ unused_qualifications
+)]
+
+#[cfg(not(any(target_os = "windows", target_os = "macos")))]
+mod linux_and_more;
+#[cfg(target_os = "macos")]
+mod macos;
+#[cfg(target_os = "windows")]
+mod windows;
+
+#[cfg(not(any(target_os = "windows", target_os = "macos")))]
+use crate::linux_and_more as sys;
+#[cfg(target_os = "macos")]
+use crate::macos as sys;
+#[cfg(target_os = "windows")]
+use crate::windows as sys;
+
+use std::error::Error;
+use std::ffi::{OsStr, OsString};
+use std::fmt::{self, Display, Formatter};
+use std::process::{Command, ExitStatus, Stdio};
+use std::{env, io};
+
+/// Opens a file or link with the system default program.
+///
+/// Note that a path like "rustup.rs" could potentially refer to either a file or a website. If you
+/// want to open the website, you should add the "http://" prefix, for example.
+///
+/// Also note that a result of `Ok(())` just means a way of opening the path was found, and no error
+/// occurred as a direct result of opening the path. Errors beyond that point aren't caught. For
+/// example, `Ok(())` would be returned even if a file was opened with a program that can't read the
+/// file, or a dead link was opened in a browser.
+///
+/// ## Platform Implementation Details
+///
+/// - On Windows the `ShellExecuteW` Windows API function is used.
+/// - On Mac the system `open` command is used.
+/// - On Windows Subsystem for Linux (WSL), the system `wslview` from [`wslu`] is used if available,
+/// otherwise the system `xdg-open` is used, if available.
+/// - On non-WSL Linux and other platforms,
+/// the system `xdg-open` script is used if available, otherwise an `xdg-open` script embedded in
+/// this library is used.
+///
+/// [`wslu`]: https://github.com/wslutilities/wslu/
+pub fn open<P>(path: P) -> Result<(), OpenError>
+where
+ P: AsRef<OsStr>,
+{
+ sys::open(path.as_ref())
+}
+
+/// Opens a file or link with the system default program, using the `BROWSER` environment variable
+/// when set.
+///
+/// If the `BROWSER` environment variable is set, the program specified by it is used to open the
+/// path. If not, behavior is identical to [`open()`].
+pub fn open_browser<P>(path: P) -> Result<(), OpenError>
+where
+ P: AsRef<OsStr>,
+{
+ let mut path = path.as_ref();
+ if let Ok(browser_var) = env::var("BROWSER") {
+ let windows_path;
+ if is_wsl() && browser_var.ends_with(".exe") {
+ if let Some(windows_path_2) = wsl_to_windows_path(path) {
+ windows_path = windows_path_2;
+ path = &windows_path;
+ }
+ };
+
+ Command::new(&browser_var)
+ .arg(path)
+ .stdin(Stdio::null())
+ .stdout(Stdio::null())
+ .stderr(Stdio::piped())
+ .spawn()
+ .map_err(OpenError::Io)?;
+
+ Ok(())
+ } else {
+ sys::open(path)
+ }
+}
+
+/// An error type representing the failure to open a path. Possibly returned by the [`open`]
+/// function.
+///
+/// The `ExitStatus` variant will never be returned on Windows.
+#[derive(Debug)]
+pub enum OpenError {
+ /// An IO error occurred.
+ Io(io::Error),
+
+ /// A command exited with a non-zero exit status.
+ ExitStatus {
+ /// A string that identifies the command.
+ cmd: &'static str,
+
+ /// The failed process's exit status.
+ status: ExitStatus,
+
+ /// Anything the process wrote to stderr.
+ stderr: String,
+ },
+}
+
+impl Display for OpenError {
+ fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
+ match self {
+ OpenError::Io(_) => {
+ write!(f, "IO error")?;
+ }
+ OpenError::ExitStatus {
+ cmd,
+ status,
+ stderr,
+ } => {
+ write!(f, "command '{cmd}' did not execute successfully; {status}")?;
+
+ let stderr = stderr.trim();
+ if !stderr.is_empty() {
+ write!(f, "\ncommand stderr:\n{stderr}")?;
+ }
+ }
+ }
+
+ Ok(())
+ }
+}
+
+impl Error for OpenError {
+ fn source(&self) -> Option<&(dyn Error + 'static)> {
+ match self {
+ OpenError::Io(inner) => Some(inner),
+ OpenError::ExitStatus { .. } => None,
+ }
+ }
+}
+
+#[cfg(target_os = "linux")]
+fn is_wsl() -> bool {
+ sys::is_wsl()
+}
+
+#[cfg(not(target_os = "linux"))]
+fn is_wsl() -> bool {
+ false
+}
+
+#[cfg(target_os = "linux")]
+fn wsl_to_windows_path(path: &OsStr) -> Option<OsString> {
+ use bstr::ByteSlice;
+ use std::os::unix::ffi::OsStringExt;
+
+ let output = Command::new("wslpath")
+ .arg("-w")
+ .arg(path)
+ .stdin(Stdio::null())
+ .stdout(Stdio::piped())
+ .stderr(Stdio::null())
+ .output()
+ .ok()?;
+
+ if !output.status.success() {
+ return None;
+ }
+
+ Some(OsString::from_vec(output.stdout.trim_end().to_vec()))
+}
+
+#[cfg(not(target_os = "linux"))]
+fn wsl_to_windows_path(_path: &OsStr) -> Option<OsString> {
+ unreachable!()
+}
+
+#[cfg(not(target_os = "windows"))]
+fn wait_child(child: &mut std::process::Child, cmd_name: &'static str) -> Result<(), OpenError> {
+ use std::io::Read;
+
+ let exit_status = child.wait().map_err(OpenError::Io)?;
+ if exit_status.success() {
+ Ok(())
+ } else {
+ let mut stderr_output = String::new();
+ if let Some(stderr) = child.stderr.as_mut() {
+ stderr.read_to_string(&mut stderr_output).ok();
+ }
+
+ Err(OpenError::ExitStatus {
+ cmd: cmd_name,
+ status: exit_status,
+ stderr: stderr_output,
+ })
+ }
+}
diff --git a/vendor/opener-0.5.2/src/linux_and_more.rs b/vendor/opener-0.5.2/src/linux_and_more.rs
new file mode 100644
index 000000000..87be414b4
--- /dev/null
+++ b/vendor/opener-0.5.2/src/linux_and_more.rs
@@ -0,0 +1,108 @@
+use crate::OpenError;
+use std::ffi::OsStr;
+use std::io::Write;
+use std::process::{Child, Command, Stdio};
+use std::{fs, io};
+
+const XDG_OPEN_SCRIPT: &[u8] = include_bytes!("xdg-open");
+
+pub(crate) fn open(path: &OsStr) -> Result<(), OpenError> {
+ if crate::is_wsl() {
+ wsl_open(path)
+ } else {
+ non_wsl_open(path)
+ }
+}
+
+fn wsl_open(path: &OsStr) -> Result<(), OpenError> {
+ let result = open_with_wslview(path);
+ if let Ok(mut child) = result {
+ return crate::wait_child(&mut child, "wslview");
+ }
+
+ open_with_system_xdg_open(path).map_err(OpenError::Io)?;
+
+ Ok(())
+}
+
+fn non_wsl_open(path: &OsStr) -> Result<(), OpenError> {
+ if open_with_system_xdg_open(path).is_err() {
+ open_with_internal_xdg_open(path)?;
+ }
+
+ Ok(())
+}
+
+fn open_with_wslview(path: &OsStr) -> io::Result<Child> {
+ let converted_path = crate::wsl_to_windows_path(path);
+ let converted_path = converted_path.as_deref();
+ let path = match converted_path {
+ None => path,
+ Some(x) => x,
+ };
+
+ Command::new("wslview")
+ .arg(path)
+ .stdin(Stdio::null())
+ .stdout(Stdio::null())
+ .stderr(Stdio::piped())
+ .spawn()
+}
+
+fn open_with_system_xdg_open(path: &OsStr) -> io::Result<Child> {
+ Command::new("xdg-open")
+ .arg(path)
+ .stdin(Stdio::null())
+ .stdout(Stdio::null())
+ .stderr(Stdio::null())
+ .spawn()
+}
+
+fn open_with_internal_xdg_open(path: &OsStr) -> Result<Child, OpenError> {
+ let mut sh = Command::new("sh")
+ .arg("-s")
+ .arg(path)
+ .stdin(Stdio::piped())
+ .stdout(Stdio::null())
+ .stderr(Stdio::null())
+ .spawn()
+ .map_err(OpenError::Io)?;
+
+ sh.stdin
+ .as_mut()
+ .unwrap()
+ .write_all(XDG_OPEN_SCRIPT)
+ .map_err(OpenError::Io)?;
+
+ Ok(sh)
+}
+
+pub(crate) fn is_wsl() -> bool {
+ if is_docker() {
+ return false;
+ }
+
+ if let Ok(true) = fs::read_to_string("/proc/sys/kernel/osrelease")
+ .map(|osrelease| osrelease.to_ascii_lowercase().contains("microsoft"))
+ {
+ return true;
+ }
+
+ if let Ok(true) = fs::read_to_string("/proc/version")
+ .map(|version| version.to_ascii_lowercase().contains("microsoft"))
+ {
+ return true;
+ }
+
+ false
+}
+
+fn is_docker() -> bool {
+ let has_docker_env = fs::metadata("/.dockerenv").is_ok();
+
+ let has_docker_cgroup = fs::read_to_string("/proc/self/cgroup")
+ .map(|cgroup| cgroup.to_ascii_lowercase().contains("docker"))
+ .unwrap_or(false);
+
+ has_docker_env || has_docker_cgroup
+}
diff --git a/vendor/opener-0.5.2/src/macos.rs b/vendor/opener-0.5.2/src/macos.rs
new file mode 100644
index 000000000..0459ae81f
--- /dev/null
+++ b/vendor/opener-0.5.2/src/macos.rs
@@ -0,0 +1,15 @@
+use crate::OpenError;
+use std::ffi::OsStr;
+use std::process::{Command, Stdio};
+
+pub(crate) fn open(path: &OsStr) -> Result<(), OpenError> {
+ let mut open = Command::new("open")
+ .arg(path)
+ .stdin(Stdio::null())
+ .stdout(Stdio::null())
+ .stderr(Stdio::piped())
+ .spawn()
+ .map_err(OpenError::Io)?;
+
+ crate::wait_child(&mut open, "open")
+}
diff --git a/vendor/opener-0.5.2/src/windows.rs b/vendor/opener-0.5.2/src/windows.rs
new file mode 100644
index 000000000..829bdb0c5
--- /dev/null
+++ b/vendor/opener-0.5.2/src/windows.rs
@@ -0,0 +1,41 @@
+use crate::OpenError;
+use std::ffi::OsStr;
+use std::os::windows::ffi::OsStrExt;
+use std::{io, ptr};
+use winapi::ctypes::c_int;
+use winapi::um::shellapi::ShellExecuteW;
+
+pub(crate) fn open(path: &OsStr) -> Result<(), OpenError> {
+ const SW_SHOW: c_int = 5;
+
+ let path = convert_path(path).map_err(OpenError::Io)?;
+ let operation: Vec<u16> = OsStr::new("open\0").encode_wide().collect();
+ let result = unsafe {
+ ShellExecuteW(
+ ptr::null_mut(),
+ operation.as_ptr(),
+ path.as_ptr(),
+ ptr::null(),
+ ptr::null(),
+ SW_SHOW,
+ )
+ };
+ if result as c_int > 32 {
+ Ok(())
+ } else {
+ Err(OpenError::Io(io::Error::last_os_error()))
+ }
+}
+
+fn convert_path(path: &OsStr) -> io::Result<Vec<u16>> {
+ let mut maybe_result: Vec<u16> = path.encode_wide().collect();
+ if maybe_result.iter().any(|&u| u == 0) {
+ return Err(io::Error::new(
+ io::ErrorKind::InvalidInput,
+ "path contains NUL byte(s)",
+ ));
+ }
+
+ maybe_result.push(0);
+ Ok(maybe_result)
+}
diff --git a/vendor/opener-0.5.2/src/xdg-open b/vendor/opener-0.5.2/src/xdg-open
new file mode 100644
index 000000000..cc682437e
--- /dev/null
+++ b/vendor/opener-0.5.2/src/xdg-open
@@ -0,0 +1,1065 @@
+#!/bin/sh
+#---------------------------------------------
+# xdg-open
+#
+# Utility script to open a URL in the registered default application.
+#
+# Refer to the usage() function below for usage.
+#
+# Copyright 2009-2010, Fathi Boudra <fabo@freedesktop.org>
+# Copyright 2009-2016, Rex Dieter <rdieter@fedoraproject.org>
+# Copyright 2006, Kevin Krammer <kevin.krammer@gmx.at>
+# Copyright 2006, Jeremy White <jwhite@codeweavers.com>
+#
+# LICENSE:
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the "Software"),
+# to deal in the Software without restriction, including without limitation
+# the rights to use, copy, modify, merge, publish, distribute, sublicense,
+# and/or sell copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included
+# in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+# OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+# OTHER DEALINGS IN THE SOFTWARE.
+#
+#---------------------------------------------
+
+manualpage()
+{
+cat << _MANUALPAGE
+Name
+
+ xdg-open -- opens a file or URL in the user's preferred
+ application
+
+Synopsis
+
+ xdg-open { file | URL }
+
+ xdg-open { --help | --manual | --version }
+
+Description
+
+ xdg-open opens a file or URL in the user's preferred
+ application. If a URL is provided the URL will be opened in the
+ user's preferred web browser. If a file is provided the file
+ will be opened in the preferred application for files of that
+ type. xdg-open supports file, ftp, http and https URLs.
+
+ xdg-open is for use inside a desktop session only. It is not
+ recommended to use xdg-open as root.
+
+Options
+
+ --help
+ Show command synopsis.
+
+ --manual
+ Show this manual page.
+
+ --version
+ Show the xdg-utils version information.
+
+Exit Codes
+
+ An exit code of 0 indicates success while a non-zero exit code
+ indicates failure. The following failure codes can be returned:
+
+ 1
+ Error in command line syntax.
+
+ 2
+ One of the files passed on the command line did not
+ exist.
+
+ 3
+ A required tool could not be found.
+
+ 4
+ The action failed.
+
+See Also
+
+ xdg-mime(1), xdg-settings(1), MIME applications associations
+ specification
+
+Examples
+
+xdg-open 'http://www.freedesktop.org/'
+
+ Opens the freedesktop.org website in the user's default
+ browser.
+
+xdg-open /tmp/foobar.png
+
+ Opens the PNG image file /tmp/foobar.png in the user's default
+ image viewing application.
+_MANUALPAGE
+}
+
+usage()
+{
+cat << _USAGE
+ xdg-open -- opens a file or URL in the user's preferred
+ application
+
+Synopsis
+
+ xdg-open { file | URL }
+
+ xdg-open { --help | --manual | --version }
+
+_USAGE
+}
+
+#@xdg-utils-common@
+
+#----------------------------------------------------------------------------
+# Common utility functions included in all XDG wrapper scripts
+#----------------------------------------------------------------------------
+
+DEBUG()
+{
+ [ -z "${XDG_UTILS_DEBUG_LEVEL}" ] && return 0;
+ [ ${XDG_UTILS_DEBUG_LEVEL} -lt $1 ] && return 0;
+ shift
+ echo "$@" >&2
+}
+
+# This handles backslashes but not quote marks.
+first_word()
+{
+ read first rest
+ echo "$first"
+}
+
+#-------------------------------------------------------------
+# map a binary to a .desktop file
+binary_to_desktop_file()
+{
+ search="${XDG_DATA_HOME:-$HOME/.local/share}:${XDG_DATA_DIRS:-/usr/local/share:/usr/share}"
+ binary="`command -v "$1"`"
+ binary="`readlink -f "$binary"`"
+ base="`basename "$binary"`"
+ IFS=:
+ for dir in $search; do
+ unset IFS
+ [ "$dir" ] || continue
+ [ -d "$dir/applications" ] || [ -d "$dir/applnk" ] || continue
+ for file in "$dir"/applications/*.desktop "$dir"/applications/*/*.desktop "$dir"/applnk/*.desktop "$dir"/applnk/*/*.desktop; do
+ [ -r "$file" ] || continue
+ # Check to make sure it's worth the processing.
+ grep -q "^Exec.*$base" "$file" || continue
+ # Make sure it's a visible desktop file (e.g. not "preferred-web-browser.desktop").
+ grep -Eq "^(NoDisplay|Hidden)=true" "$file" && continue
+ command="`grep -E "^Exec(\[[^]=]*])?=" "$file" | cut -d= -f 2- | first_word`"
+ command="`command -v "$command"`"
+ if [ x"`readlink -f "$command"`" = x"$binary" ]; then
+ # Fix any double slashes that got added path composition
+ echo "$file" | sed -e 's,//*,/,g'
+ return
+ fi
+ done
+ done
+}
+
+#-------------------------------------------------------------
+# map a .desktop file to a binary
+desktop_file_to_binary()
+{
+ search="${XDG_DATA_HOME:-$HOME/.local/share}:${XDG_DATA_DIRS:-/usr/local/share:/usr/share}"
+ desktop="`basename "$1"`"
+ IFS=:
+ for dir in $search; do
+ unset IFS
+ [ "$dir" ] && [ -d "$dir/applications" ] || [ -d "$dir/applnk" ] || continue
+ # Check if desktop file contains -
+ if [ "${desktop#*-}" != "$desktop" ]; then
+ vendor=${desktop%-*}
+ app=${desktop#*-}
+ if [ -r $dir/applications/$vendor/$app ]; then
+ file_path=$dir/applications/$vendor/$app
+ elif [ -r $dir/applnk/$vendor/$app ]; then
+ file_path=$dir/applnk/$vendor/$app
+ fi
+ fi
+ if test -z "$file_path" ; then
+ for indir in "$dir"/applications/ "$dir"/applications/*/ "$dir"/applnk/ "$dir"/applnk/*/; do
+ file="$indir/$desktop"
+ if [ -r "$file" ]; then
+ file_path=$file
+ break
+ fi
+ done
+ fi
+ if [ -r "$file_path" ]; then
+ # Remove any arguments (%F, %f, %U, %u, etc.).
+ command="`grep -E "^Exec(\[[^]=]*])?=" "$file_path" | cut -d= -f 2- | first_word`"
+ command="`command -v "$command"`"
+ readlink -f "$command"
+ return
+ fi
+ done
+}
+
+#-------------------------------------------------------------
+# Exit script on successfully completing the desired operation
+
+exit_success()
+{
+ if [ $# -gt 0 ]; then
+ echo "$@"
+ echo
+ fi
+
+ exit 0
+}
+
+
+#-----------------------------------------
+# Exit script on malformed arguments, not enough arguments
+# or missing required option.
+# prints usage information
+
+exit_failure_syntax()
+{
+ if [ $# -gt 0 ]; then
+ echo "xdg-open: $@" >&2
+ echo "Try 'xdg-open --help' for more information." >&2
+ else
+ usage
+ echo "Use 'man xdg-open' or 'xdg-open --manual' for additional info."
+ fi
+
+ exit 1
+}
+
+#-------------------------------------------------------------
+# Exit script on missing file specified on command line
+
+exit_failure_file_missing()
+{
+ if [ $# -gt 0 ]; then
+ echo "xdg-open: $@" >&2
+ fi
+
+ exit 2
+}
+
+#-------------------------------------------------------------
+# Exit script on failure to locate necessary tool applications
+
+exit_failure_operation_impossible()
+{
+ if [ $# -gt 0 ]; then
+ echo "xdg-open: $@" >&2
+ fi
+
+ exit 3
+}
+
+#-------------------------------------------------------------
+# Exit script on failure returned by a tool application
+
+exit_failure_operation_failed()
+{
+ if [ $# -gt 0 ]; then
+ echo "xdg-open: $@" >&2
+ fi
+
+ exit 4
+}
+
+#------------------------------------------------------------
+# Exit script on insufficient permission to read a specified file
+
+exit_failure_file_permission_read()
+{
+ if [ $# -gt 0 ]; then
+ echo "xdg-open: $@" >&2
+ fi
+
+ exit 5
+}
+
+#------------------------------------------------------------
+# Exit script on insufficient permission to write a specified file
+
+exit_failure_file_permission_write()
+{
+ if [ $# -gt 0 ]; then
+ echo "xdg-open: $@" >&2
+ fi
+
+ exit 6
+}
+
+check_input_file()
+{
+ if [ ! -e "$1" ]; then
+ exit_failure_file_missing "file '$1' does not exist"
+ fi
+ if [ ! -r "$1" ]; then
+ exit_failure_file_permission_read "no permission to read file '$1'"
+ fi
+}
+
+check_vendor_prefix()
+{
+ file_label="$2"
+ [ -n "$file_label" ] || file_label="filename"
+ file=`basename "$1"`
+ case "$file" in
+ [[:alpha:]]*-*)
+ return
+ ;;
+ esac
+
+ echo "xdg-open: $file_label '$file' does not have a proper vendor prefix" >&2
+ echo 'A vendor prefix consists of alpha characters ([a-zA-Z]) and is terminated' >&2
+ echo 'with a dash ("-"). An example '"$file_label"' is '"'example-$file'" >&2
+ echo "Use --novendor to override or 'xdg-open --manual' for additional info." >&2
+ exit 1
+}
+
+check_output_file()
+{
+ # if the file exists, check if it is writeable
+ # if it does not exists, check if we are allowed to write on the directory
+ if [ -e "$1" ]; then
+ if [ ! -w "$1" ]; then
+ exit_failure_file_permission_write "no permission to write to file '$1'"
+ fi
+ else
+ DIR=`dirname "$1"`
+ if [ ! -w "$DIR" ] || [ ! -x "$DIR" ]; then
+ exit_failure_file_permission_write "no permission to create file '$1'"
+ fi
+ fi
+}
+
+#----------------------------------------
+# Checks for shared commands, e.g. --help
+
+check_common_commands()
+{
+ while [ $# -gt 0 ] ; do
+ parm="$1"
+ shift
+
+ case "$parm" in
+ --help)
+ usage
+ echo "Use 'man xdg-open' or 'xdg-open --manual' for additional info."
+ exit_success
+ ;;
+
+ --manual)
+ manualpage
+ exit_success
+ ;;
+
+ --version)
+ echo "xdg-open 1.1.3+"
+ exit_success
+ ;;
+ esac
+ done
+}
+
+check_common_commands "$@"
+
+[ -z "${XDG_UTILS_DEBUG_LEVEL}" ] && unset XDG_UTILS_DEBUG_LEVEL;
+if [ ${XDG_UTILS_DEBUG_LEVEL-0} -lt 1 ]; then
+ # Be silent
+ xdg_redirect_output=" > /dev/null 2> /dev/null"
+else
+ # All output to stderr
+ xdg_redirect_output=" >&2"
+fi
+
+#--------------------------------------
+# Checks for known desktop environments
+# set variable DE to the desktop environments name, lowercase
+
+detectDE()
+{
+ # see https://bugs.freedesktop.org/show_bug.cgi?id=34164
+ unset GREP_OPTIONS
+
+ if [ -n "${XDG_CURRENT_DESKTOP}" ]; then
+ case "${XDG_CURRENT_DESKTOP}" in
+ # only recently added to menu-spec, pre-spec X- still in use
+ Cinnamon|X-Cinnamon)
+ DE=cinnamon;
+ ;;
+ ENLIGHTENMENT)
+ DE=enlightenment;
+ ;;
+ # GNOME, GNOME-Classic:GNOME, or GNOME-Flashback:GNOME
+ GNOME*)
+ DE=gnome;
+ ;;
+ KDE)
+ DE=kde;
+ ;;
+ DEEPIN|Deepin|deepin)
+ DE=deepin;
+ ;;
+ LXDE)
+ DE=lxde;
+ ;;
+ LXQt)
+ DE=lxqt;
+ ;;
+ MATE)
+ DE=mate;
+ ;;
+ XFCE)
+ DE=xfce
+ ;;
+ X-Generic)
+ DE=generic
+ ;;
+ esac
+ fi
+
+ if [ x"$DE" = x"" ]; then
+ # classic fallbacks
+ if [ x"$KDE_FULL_SESSION" != x"" ]; then DE=kde;
+ elif [ x"$GNOME_DESKTOP_SESSION_ID" != x"" ]; then DE=gnome;
+ elif [ x"$MATE_DESKTOP_SESSION_ID" != x"" ]; then DE=mate;
+ elif `dbus-send --print-reply --dest=org.freedesktop.DBus /org/freedesktop/DBus org.freedesktop.DBus.GetNameOwner string:org.gnome.SessionManager > /dev/null 2>&1` ; then DE=gnome;
+ elif xprop -root _DT_SAVE_MODE 2> /dev/null | grep ' = \"xfce4\"$' >/dev/null 2>&1; then DE=xfce;
+ elif xprop -root 2> /dev/null | grep -i '^xfce_desktop_window' >/dev/null 2>&1; then DE=xfce
+ elif echo $DESKTOP | grep -q '^Enlightenment'; then DE=enlightenment;
+ elif [ x"$LXQT_SESSION_CONFIG" != x"" ]; then DE=lxqt;
+ fi
+ fi
+
+ if [ x"$DE" = x"" ]; then
+ # fallback to checking $DESKTOP_SESSION
+ case "$DESKTOP_SESSION" in
+ gnome)
+ DE=gnome;
+ ;;
+ LXDE|Lubuntu)
+ DE=lxde;
+ ;;
+ MATE)
+ DE=mate;
+ ;;
+ xfce|xfce4|'Xfce Session')
+ DE=xfce;
+ ;;
+ esac
+ fi
+
+ if [ x"$DE" = x"" ]; then
+ # fallback to uname output for other platforms
+ case "$(uname 2>/dev/null)" in
+ CYGWIN*)
+ DE=cygwin;
+ ;;
+ Darwin)
+ DE=darwin;
+ ;;
+ esac
+ fi
+
+ if [ x"$DE" = x"gnome" ]; then
+ # gnome-default-applications-properties is only available in GNOME 2.x
+ # but not in GNOME 3.x
+ command -v gnome-default-applications-properties > /dev/null || DE="gnome3"
+ fi
+
+ if [ -f "$XDG_RUNTIME_DIR/flatpak-info" ]; then
+ DE="flatpak"
+ fi
+}
+
+#----------------------------------------------------------------------------
+# kfmclient exec/openURL can give bogus exit value in KDE <= 3.5.4
+# It also always returns 1 in KDE 3.4 and earlier
+# Simply return 0 in such case
+
+kfmclient_fix_exit_code()
+{
+ version=`LC_ALL=C.UTF-8 kde-config --version 2>/dev/null | grep '^KDE'`
+ major=`echo $version | sed 's/KDE.*: \([0-9]\).*/\1/'`
+ minor=`echo $version | sed 's/KDE.*: [0-9]*\.\([0-9]\).*/\1/'`
+ release=`echo $version | sed 's/KDE.*: [0-9]*\.[0-9]*\.\([0-9]\).*/\1/'`
+ test "$major" -gt 3 && return $1
+ test "$minor" -gt 5 && return $1
+ test "$release" -gt 4 && return $1
+ return 0
+}
+
+#----------------------------------------------------------------------------
+# Returns true if there is a graphical display attached.
+
+has_display()
+{
+ if [ -n "$DISPLAY" ] || [ -n "$WAYLAND_DISPLAY" ]; then
+ return 0
+ else
+ return 1
+ fi
+}
+
+# This handles backslashes but not quote marks.
+last_word()
+{
+ read first rest
+ echo "$rest"
+}
+
+# Get the value of a key in a desktop file's Desktop Entry group.
+# Example: Use get_key foo.desktop Exec
+# to get the values of the Exec= key for the Desktop Entry group.
+get_key()
+{
+ local file="${1}"
+ local key="${2}"
+ local desktop_entry=""
+
+ IFS_="${IFS}"
+ IFS=""
+ while read line
+ do
+ case "$line" in
+ "[Desktop Entry]")
+ desktop_entry="y"
+ ;;
+ # Reset match flag for other groups
+ "["*)
+ desktop_entry=""
+ ;;
+ "${key}="*)
+ # Only match Desktop Entry group
+ if [ -n "${desktop_entry}" ]
+ then
+ echo "${line}" | cut -d= -f 2-
+ fi
+ esac
+ done < "${file}"
+ IFS="${IFS_}"
+}
+
+# Returns true if argument is a file:// URL or path
+is_file_url_or_path()
+{
+ if echo "$1" | grep -q '^file://' \
+ || ! echo "$1" | grep -Eq '^[[:alpha:]][[:alpha:][:digit:]+\.\-]*:'; then
+ return 0
+ else
+ return 1
+ fi
+}
+
+# If argument is a file URL, convert it to a (percent-decoded) path.
+# If not, leave it as it is.
+file_url_to_path()
+{
+ local file="$1"
+ if echo "$file" | grep -q '^file://\(localhost\)\?/'; then
+ file=${file#file://localhost}
+ file=${file#file://}
+ file=${file%%#*}
+ file=$(echo "$file" | sed -r 's/\?.*$//')
+ local printf=printf
+ if [ -x /usr/bin/printf ]; then
+ printf=/usr/bin/printf
+ fi
+ file=$($printf "$(echo "$file" | sed -e 's@%\([a-f0-9A-F]\{2\}\)@\\x\1@g')")
+ fi
+ echo "$file"
+}
+
+open_cygwin()
+{
+ cygstart "$1"
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ else
+ exit_failure_operation_failed
+ fi
+}
+
+open_darwin()
+{
+ open "$1"
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ else
+ exit_failure_operation_failed
+ fi
+}
+
+open_kde()
+{
+ if [ -n "${KDE_SESSION_VERSION}" ]; then
+ case "${KDE_SESSION_VERSION}" in
+ 4)
+ kde-open "$1"
+ ;;
+ 5)
+ kde-open${KDE_SESSION_VERSION} "$1"
+ ;;
+ esac
+ else
+ kfmclient exec "$1"
+ kfmclient_fix_exit_code $?
+ fi
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ else
+ exit_failure_operation_failed
+ fi
+}
+
+open_deepin()
+{
+ if dde-open -version >/dev/null 2>&1; then
+ dde-open "$1"
+ else
+ open_generic "$1"
+ fi
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ else
+ exit_failure_operation_failed
+ fi
+}
+
+open_gnome3()
+{
+ if gio help open 2>/dev/null 1>&2; then
+ gio open "$1"
+ elif gvfs-open --help 2>/dev/null 1>&2; then
+ gvfs-open "$1"
+ else
+ open_generic "$1"
+ fi
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ else
+ exit_failure_operation_failed
+ fi
+}
+
+open_gnome()
+{
+ if gio help open 2>/dev/null 1>&2; then
+ gio open "$1"
+ elif gvfs-open --help 2>/dev/null 1>&2; then
+ gvfs-open "$1"
+ elif gnome-open --help 2>/dev/null 1>&2; then
+ gnome-open "$1"
+ else
+ open_generic "$1"
+ fi
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ else
+ exit_failure_operation_failed
+ fi
+}
+
+open_mate()
+{
+ if gio help open 2>/dev/null 1>&2; then
+ gio open "$1"
+ elif gvfs-open --help 2>/dev/null 1>&2; then
+ gvfs-open "$1"
+ elif mate-open --help 2>/dev/null 1>&2; then
+ mate-open "$1"
+ else
+ open_generic "$1"
+ fi
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ else
+ exit_failure_operation_failed
+ fi
+}
+
+open_xfce()
+{
+ if exo-open --help 2>/dev/null 1>&2; then
+ exo-open "$1"
+ elif gio help open 2>/dev/null 1>&2; then
+ gio open "$1"
+ elif gvfs-open --help 2>/dev/null 1>&2; then
+ gvfs-open "$1"
+ else
+ open_generic "$1"
+ fi
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ else
+ exit_failure_operation_failed
+ fi
+}
+
+open_enlightenment()
+{
+ if enlightenment_open --help 2>/dev/null 1>&2; then
+ enlightenment_open "$1"
+ else
+ open_generic "$1"
+ fi
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ else
+ exit_failure_operation_failed
+ fi
+}
+
+open_flatpak()
+{
+ gdbus call --session \
+ --dest org.freedesktop.portal.Desktop \
+ --object-path /org/freedesktop/portal/desktop \
+ --method org.freedesktop.portal.OpenURI.OpenURI \
+ "" "$1" {}
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ else
+ exit_failure_operation_failed
+ fi
+}
+
+#-----------------------------------------
+# Recursively search .desktop file
+
+search_desktop_file()
+{
+ local default="$1"
+ local dir="$2"
+ local target="$3"
+
+ local file=""
+ # look for both vendor-app.desktop, vendor/app.desktop
+ if [ -r "$dir/$default" ]; then
+ file="$dir/$default"
+ elif [ -r "$dir/`echo $default | sed -e 's|-|/|'`" ]; then
+ file="$dir/`echo $default | sed -e 's|-|/|'`"
+ fi
+
+ if [ -r "$file" ] ; then
+ command="$(get_key "${file}" "Exec" | first_word)"
+ icon="$(get_key "${file}" "Icon")"
+ # FIXME: Actually LC_MESSAGES should be used as described in
+ # http://standards.freedesktop.org/desktop-entry-spec/latest/ar01s04.html
+ localised_name="$(get_key "${file}" "Name")"
+ set -- $(get_key "${file}" "Exec" | last_word)
+ # We need to replace any occurrence of "%f", "%F" and
+ # the like by the target file. We examine each
+ # argument and append the modified argument to the
+ # end then shift.
+ local args=$#
+ local replaced=0
+ while [ $args -gt 0 ]; do
+ case $1 in
+ %[c])
+ replaced=1
+ arg="${localised_name}"
+ shift
+ set -- "$@" "$arg"
+ ;;
+ %[fFuU])
+ replaced=1
+ arg="$target"
+ shift
+ set -- "$@" "$arg"
+ ;;
+ %[i])
+ replaced=1
+ shift
+ set -- "$@" "--icon" "$icon"
+ ;;
+ *)
+ arg="$1"
+ shift
+ set -- "$@" "$arg"
+ ;;
+ esac
+ args=$(( $args - 1 ))
+ done
+ [ $replaced -eq 1 ] || set -- "$@" "$target"
+ env "$command" "$@"
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ fi
+ fi
+
+ for d in "$dir/"*/; do
+ [ -d "$d" ] && search_desktop_file "$default" "$d" "$target"
+ done
+}
+
+
+open_generic_xdg_mime()
+{
+ filetype="$2"
+ default=`xdg-mime query default "$filetype"`
+ if [ -n "$default" ] ; then
+ xdg_user_dir="$XDG_DATA_HOME"
+ [ -n "$xdg_user_dir" ] || xdg_user_dir="$HOME/.local/share"
+
+ xdg_system_dirs="$XDG_DATA_DIRS"
+ [ -n "$xdg_system_dirs" ] || xdg_system_dirs=/usr/local/share/:/usr/share/
+
+DEBUG 3 "$xdg_user_dir:$xdg_system_dirs"
+ for x in `echo "$xdg_user_dir:$xdg_system_dirs" | sed 's/:/ /g'`; do
+ search_desktop_file "$default" "$x/applications/" "$1"
+ done
+ fi
+}
+
+open_generic_xdg_file_mime()
+{
+ filetype=`xdg-mime query filetype "$1" | sed "s/;.*//"`
+ open_generic_xdg_mime "$1" "$filetype"
+}
+
+open_generic_xdg_x_scheme_handler()
+{
+ scheme="`echo $1 | sed -n 's/\(^[[:alnum:]+\.-]*\):.*$/\1/p'`"
+ if [ -n $scheme ]; then
+ filetype="x-scheme-handler/$scheme"
+ open_generic_xdg_mime "$1" "$filetype"
+ fi
+}
+
+has_single_argument()
+{
+ test $# = 1
+}
+
+open_envvar()
+{
+ local oldifs="$IFS"
+ local browser browser_with_arg
+
+ IFS=":"
+ for browser in $BROWSER; do
+ IFS="$oldifs"
+
+ if [ -z "$browser" ]; then
+ continue
+ fi
+
+ if echo "$browser" | grep -q %s; then
+ # Avoid argument injection.
+ # See https://bugs.freedesktop.org/show_bug.cgi?id=103807
+ # URIs don't have IFS characters spaces anyway.
+ has_single_argument $1 && $(printf "$browser" "$1")
+ else
+ $browser "$1"
+ fi
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ fi
+ done
+}
+
+open_generic()
+{
+ if is_file_url_or_path "$1"; then
+ local file="$(file_url_to_path "$1")"
+
+ check_input_file "$file"
+
+ if has_display; then
+ filetype=`xdg-mime query filetype "$file" | sed "s/;.*//"`
+ open_generic_xdg_mime "$file" "$filetype"
+ fi
+
+ if command -v run-mailcap >/dev/null; then
+ run-mailcap --action=view "$file"
+ if [ $? -eq 0 ]; then
+ exit_success
+ fi
+ fi
+
+ if has_display && mimeopen -v 2>/dev/null 1>&2; then
+ mimeopen -L -n "$file"
+ if [ $? -eq 0 ]; then
+ exit_success
+ fi
+ fi
+ fi
+
+ if has_display; then
+ open_generic_xdg_x_scheme_handler "$1"
+ fi
+
+ if [ -n "$BROWSER" ]; then
+ open_envvar "$1"
+ fi
+
+ # if BROWSER variable is not set, check some well known browsers instead
+ if [ x"$BROWSER" = x"" ]; then
+ BROWSER=www-browser:links2:elinks:links:lynx:w3m
+ if has_display; then
+ BROWSER=x-www-browser:firefox:iceweasel:seamonkey:mozilla:epiphany:konqueror:chromium:chromium-browser:google-chrome:$BROWSER
+ fi
+ fi
+
+ open_envvar "$1"
+
+ exit_failure_operation_impossible "no method available for opening '$1'"
+}
+
+open_lxde()
+{
+
+ # pcmanfm only knows how to handle file:// urls and filepaths, it seems.
+ if pcmanfm --help >/dev/null 2>&1 && is_file_url_or_path "$1"; then
+ local file="$(file_url_to_path "$1")"
+
+ # handle relative paths
+ if ! echo "$file" | grep -q ^/; then
+ file="$(pwd)/$file"
+ fi
+
+ pcmanfm "$file"
+ else
+ open_generic "$1"
+ fi
+
+ if [ $? -eq 0 ]; then
+ exit_success
+ else
+ exit_failure_operation_failed
+ fi
+}
+
+open_lxqt()
+{
+ open_generic "$1"
+}
+
+[ x"$1" != x"" ] || exit_failure_syntax
+
+url=
+while [ $# -gt 0 ] ; do
+ parm="$1"
+ shift
+
+ case "$parm" in
+ -*)
+ exit_failure_syntax "unexpected option '$parm'"
+ ;;
+
+ *)
+ if [ -n "$url" ] ; then
+ exit_failure_syntax "unexpected argument '$parm'"
+ fi
+ url="$parm"
+ ;;
+ esac
+done
+
+if [ -z "${url}" ] ; then
+ exit_failure_syntax "file or URL argument missing"
+fi
+
+detectDE
+
+if [ x"$DE" = x"" ]; then
+ DE=generic
+fi
+
+DEBUG 2 "Selected DE $DE"
+
+# sanitize BROWSER (avoid calling ourselves in particular)
+case "${BROWSER}" in
+ *:"xdg-open"|"xdg-open":*)
+ BROWSER=$(echo $BROWSER | sed -e 's|:xdg-open||g' -e 's|xdg-open:||g')
+ ;;
+ "xdg-open")
+ BROWSER=
+ ;;
+esac
+
+case "$DE" in
+ kde)
+ open_kde "$url"
+ ;;
+
+ deepin)
+ open_deepin "$url"
+ ;;
+
+ gnome3|cinnamon)
+ open_gnome3 "$url"
+ ;;
+
+ gnome)
+ open_gnome "$url"
+ ;;
+
+ mate)
+ open_mate "$url"
+ ;;
+
+ xfce)
+ open_xfce "$url"
+ ;;
+
+ lxde)
+ open_lxde "$url"
+ ;;
+
+ lxqt)
+ open_lxqt "$url"
+ ;;
+
+ enlightenment)
+ open_enlightenment "$url"
+ ;;
+
+ cygwin)
+ open_cygwin "$url"
+ ;;
+
+ darwin)
+ open_darwin "$url"
+ ;;
+
+ flatpak)
+ open_flatpak "$url"
+ ;;
+
+ generic)
+ open_generic "$url"
+ ;;
+
+ *)
+ exit_failure_operation_impossible "no method available for opening '$url'"
+ ;;
+esac
diff --git a/vendor/opener-0.5.2/tests/version-numbers.rs b/vendor/opener-0.5.2/tests/version-numbers.rs
new file mode 100644
index 000000000..cfcb2586f
--- /dev/null
+++ b/vendor/opener-0.5.2/tests/version-numbers.rs
@@ -0,0 +1,4 @@
+#[test]
+fn test_html_root_url() {
+ version_sync::assert_html_root_url_updated!("src/lib.rs");
+}