Skip to content

Commit

Permalink
Version bump and some readme formatting
Browse files Browse the repository at this point in the history
  • Loading branch information
jrobsonchase committed Aug 17, 2023
1 parent 4e67182 commit 9cc7088
Show file tree
Hide file tree
Showing 4 changed files with 59 additions and 50 deletions.
2 changes: 1 addition & 1 deletion cargo-doc-ngrok/Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,6 @@ futures = "0.3.25"
http = "0.2.8"
hyper = { version = "0.14.23", features = ["server"] }
hyper-staticfile = "0.9.2"
ngrok = { path = "../ngrok", version = "0.12", features = ["hyper"] }
ngrok = { path = "../ngrok", version = "0.13", features = ["hyper"] }
tokio = { version = "1.23.0", features = ["full"] }
watchexec = "2.3.0"
71 changes: 39 additions & 32 deletions ngrok/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,83 +1,90 @@
## 0.13.0

- Add the `NgrokError` trait
- Add the `ErrResp` type
- Change the `RpcError::Response` variant to the `ErrResp` type (from `String`)
- Implement `NgrokError` for `ErrResp`, `RpcError`, and `ConnectError`

## 0.12.4

* Add `Win32_Foundation` feature
* Update nix for rust `1.72`
- Add `Win32_Foundation` feature
- Update nix for rust `1.72`

## 0.12.3

* Add `session.id()`
- Add `session.id()`

## 0.12.2

* Updated readme and changelog
- Updated readme and changelog

## 0.12.1

* Add source error on reconnect
* Rename repository to ngrok-rust
- Add source error on reconnect
- Rename repository to ngrok-rust

## 0.12.0

* Add `client_info` to SessionBuilder
* Update UserAgent generation
* Make `circuit_breaker` test more reliable
- Add `client_info` to SessionBuilder
- Update UserAgent generation
- Make `circuit_breaker` test more reliable

## 0.11.3

* Update stream forwarding logic
* Add `ca_cert` option to SessionBuilder
* Unpin `bstr`
- Update stream forwarding logic
- Add `ca_cert` option to SessionBuilder
- Unpin `bstr`

## 0.11.2

* Send UserAgent when authenticating
* Update readme documentation
- Send UserAgent when authenticating
- Update readme documentation

## 0.11.0

* Include a session close method
* Mark errors as non-exhaustive
- Include a session close method
- Mark errors as non-exhaustive

## 0.10.2

* Update default forwards-to
* Expose OAuth Client ID/Secret setters
* Muxado: close method on the opener
- Update default forwards-to
- Expose OAuth Client ID/Secret setters
- Muxado: close method on the opener

## 0.10.1

* Add windows pipe support
* Require tokio rt
- Add windows pipe support
- Require tokio rt

## 0.10.0

* Some api-breaking consistency fixes for the session builder.
* Update the connector to be more in-line with the other handlers and to support
- Some api-breaking consistency fixes for the session builder.
- Update the connector to be more in-line with the other handlers and to support
disconnect/reconnect error reporting.
* Add support for custom heartbeat handlers.
- Add support for custom heartbeat handlers.

## 0.9.0

* Update docs to match ngrok-go
* Update the tls termination configuration methods to match those in ngrok-go
* Remove the `_string` suffix from the cidr restriction methods
- Update docs to match ngrok-go
- Update the tls termination configuration methods to match those in ngrok-go
- Remove the `_string` suffix from the cidr restriction methods

## 0.8.1

* Fix cancellation bugs causing leaked muxado/ngrok sessions.
- Fix cancellation bugs causing leaked muxado/ngrok sessions.

## 0.8.0

* Some breaking changes to builder method naming for consistency.
* Add dashboard command handlers
- Some breaking changes to builder method naming for consistency.
- Add dashboard command handlers

## 0.7.0

* Initial crates.io release.
- Initial crates.io release.

## Pre-0.7.0

* There was originally a crate on crates.io named 'ngrok' that wrapped the agent
- There was originally a crate on crates.io named 'ngrok' that wrapped the agent
binary. It can be found [here](https://github.com/nkconnor/ngrok).

Thanks @nkconnor!
2 changes: 1 addition & 1 deletion ngrok/Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[package]
name = "ngrok"
version = "0.12.4"
version = "0.13.0"
edition = "2021"
license = "MIT OR Apache-2.0"
description = "The ngrok agent SDK"
Expand Down
34 changes: 18 additions & 16 deletions ngrok/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,20 +20,20 @@
[Website](https://ngrok.com) |
[API Docs (main)](https://ngrok.github.io/ngrok-rust/ngrok)

ngrok is a simplified API-first ingress-as-a-service that adds connectivity,
ngrok is a simplified API-first ingress-as-a-service that adds connectivity,
security, and observability to your apps.

ngrok-rust, our native and idiomatic crate for adding a public internet address
with secure ingress traffic directly into your Rust apps 🦀. If you’ve used ngrok in
ngrok-rust, our native and idiomatic crate for adding a public internet address
with secure ingress traffic directly into your Rust apps 🦀. If you’ve used ngrok in
the past, you can think of ngrok-rust as the ngrok agent packaged as a Rust crate.

ngrok-rust lets developers serve Rust services on the internet in a single statement
without setting up low-level network primitives like IPs, NAT, certificates,
load balancers, and even ports! Applications using ngrok-rust listen on ngrok’s global
ingress network for TCP and HTTP traffic. ngrok-rust listeners are usable with
[hyper Servers](https://docs.rs/hyper/latest/hyper/server/index.html), and connections
implement [tokio’s AsyncRead and AsyncWrite traits](https://docs.rs/tokio/latest/tokio/io/index.html).
This makes it easy to add ngrok-rust into any application that’s built on hyper, such
ngrok-rust lets developers serve Rust services on the internet in a single statement
without setting up low-level network primitives like IPs, NAT, certificates,
load balancers, and even ports! Applications using ngrok-rust listen on ngrok’s global
ingress network for TCP and HTTP traffic. ngrok-rust listeners are usable with
[hyper Servers](https://docs.rs/hyper/latest/hyper/server/index.html), and connections
implement [tokio’s AsyncRead and AsyncWrite traits](https://docs.rs/tokio/latest/tokio/io/index.html).
This makes it easy to add ngrok-rust into any application that’s built on hyper, such
as the popular [axum](https://docs.rs/axum/latest/axum/) HTTP framework.

See [`/ngrok/examples/`][examples] for example usage, or the tests in
Expand All @@ -59,7 +59,7 @@ Add `ngrok` to the `[dependencies]` section of your `Cargo.toml`:
...

[dependencies]
ngrok = "0.12"
ngrok = "0.13"

...
```
Expand All @@ -75,20 +75,22 @@ $ cargo add ngrok
Create a simple HTTP server using `ngrok` and `axum`:

`Cargo.toml`:

```toml
[package]
name = "ngrok-axum-example"
version = "0.1.0"
edition = "2021"

[dependencies]
ngrok = { version="0.12", features=["axum"] }
ngrok = { version="0.13", features=["axum"] }
tokio = { version = "1.26", features = ["full"] }
axum = "0.6"
anyhow = "1.0"
```

`src/main.rs`:

```rust
use std::net::SocketAddr;

Expand Down Expand Up @@ -140,10 +142,10 @@ async fn main() -> anyhow::Result<()> {

This project is licensed under either of

* Apache License, Version 2.0, ([LICENSE-APACHE][apache-url] or
<http://www.apache.org/licenses/LICENSE-2.0>)
* MIT license ([LICENSE-MIT][mit-url] or
<http://opensource.org/licenses/MIT>)
- Apache License, Version 2.0, ([LICENSE-APACHE][apache-url] or
<http://www.apache.org/licenses/LICENSE-2.0>)
- MIT license ([LICENSE-MIT][mit-url] or
<http://opensource.org/licenses/MIT>)

at your option.

Expand Down

0 comments on commit 9cc7088

Please sign in to comment.