https://github.com/Byron/open-rs

Open a path or URL with the system-defined program
https://github.com/Byron/open-rs

Last synced: 4 months ago
JSON representation

Open a path or URL with the system-defined program

• Host: GitHub
• URL: https://github.com/Byron/open-rs
• Owner: Byron
• License: mit
• Created: 2015-02-27T15:42:17.000Z (almost 10 years ago)
• Default Branch: main
• Last Pushed: 2024-07-10T05:12:12.000Z (8 months ago)
• Last Synced: 2024-10-30T13:05:52.811Z (4 months ago)
• Language: Rust
• Homepage: http://byron.github.io/open-rs
• Size: 832 KB
• Stars: 320
• Watchers: 4
• Forks: 49
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Changelog: changelog.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
[![Crates.io](https://img.shields.io/crates/v/open.svg)](https://crates.io/crates/open)

[![cross-platform-testing](https://github.com/Byron/open-rs/workflows/cross-platform-testing/badge.svg)](https://github.com/Byron/open-rs/actions?query=workflow%3Across-platform-testing)

Use this library to open a path or URL using the program configured on the system. It is equivalent to running one of the following:

```bash

# macOS

$ open 

# Windows

$ start 

# Linux

$ xdg-open  || gio open  || gnome-open  || kde-open  || wslview 

```

# Library Usage

Add this to your Cargo.toml

```toml

[dependencies]

open = "5"

```

…and open something using…

```Rust

open::that("https://rust-lang.org");

```

…or, open something with an application of your choice

```Rust

open::with("https://rust-lang.org", "firefox");

```

Follow this link for the [API docs](https://docs.rs/open).

# Binary Usage

This crate also implements a binary that acts like an opener itself.

```shell

cargo run 'file to open'

```

# Credits

The implementation is based on the respective functionality of [Cargo](https://github.com/rust-lang/cargo), but was improved to allow some error handling.