/ngrok

A minimal ngrok library for Rust

Primary LanguageRust

ngrok   Build Crate Docs

A minimal and concise ngrok wrapper for Rust. The main use case for the library is the ability to open public HTTP tunnels to your development server(s) for integrations tests. TCP support, while not available, should be trivial to support.

This has been tested with Linux and assume that it does not work on Windows (contributions welcome!).

Getting Started

[dependencies]
ngrok = "0.5.0"

Usage

use ngrok;

fn main() -> std::io::Result<()> {
    let tunnel = ngrok::builder()
        .http()
        .port(3030)
        .run()?;

    let public_url: url::Url = tunnel.http()?;

    println!("Tunnel is open at {:?}", public_url);

    Ok(())
}

This assumes that ngrok is on your path. To change this, use the .executable() method in the builder when creating your tunnel.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

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