ngrok


Namengrok JSON
Version 1.2.0 PyPI version JSON
download
home_pageNone
SummaryThe ngrok Agent SDK for Python
upload_time2024-03-12 16:21:10
maintainerNone
docs_urlNone
authorNone
requires_python>=3.7
licenseMIT OR Apache-2.0
keywords ngrok python pypi pyo3 ingress networking
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Python SDK for ngrok

[![PyPI][pypi-badge]][pypi-url]
[![Supported Versions][ver-badge]][ver-url]
[![MIT licensed][mit-badge]][mit-url]
[![Apache-2.0 licensed][apache-badge]][apache-url]
[![Continuous integration][ci-badge]][ci-url]

[pypi-badge]: https://img.shields.io/pypi/v/ngrok
[pypi-url]: https://pypi.org/project/ngrok
[ver-badge]: https://img.shields.io/pypi/pyversions/ngrok.svg
[ver-url]: https://pypi.org/project/ngrok
[mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg
[mit-url]: https://github.com/ngrok/ngrok-rust/blob/main/LICENSE-MIT
[apache-badge]: https://img.shields.io/badge/license-Apache_2.0-blue.svg
[apache-url]: https://github.com/ngrok/ngrok-rust/blob/main/LICENSE-APACHE
[ci-badge]: https://github.com/ngrok/ngrok-python/actions/workflows/ci.yml/badge.svg
[ci-url]: https://github.com/ngrok/ngrok-python/actions/workflows/ci.yml

`ngrok-python` is the official Python SDK for ngrok that requires no binaries. Quickly enable secure production-ready connectivity to your applications and services directly from your code.

[ngrok](https://ngrok.com) is a globally distributed gateway that provides secure connectivity for applications and services running in any environment.

# Installation

The `ngrok-python` SDK can be installed from [PyPI](https://pypi.org/project/ngrok) via `pip`:

```shell
pip install ngrok
```

# Quickstart

1. [Install `ngrok-python`](#installation)
2. Export your [authtoken from the ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken) as `NGROK_AUTHTOKEN` in your terminal
3. Add the following code to your application to establish connectivity via the [forward method](https://github.com/ngrok/ngrok-python/blob/main/examples/ngrok-forward-minimal.py) through port `9000` on `localhost`:

    ```python
    # import ngrok python sdk
    import ngrok
    
    # Establish connectivity
    listener = ngrok.forward(9000, authtoken_from_env=True)
    
    # Output ngrok url to console
    print(f"Ingress established at {listener.url()}")
    ```

That's it! Your application should now be available through the url output in your terminal. 

> **Note**
> You can find more examples in [the examples directory](https://github.com/ngrok/ngrok-python/tree/main/examples).

# Documentation

A full quickstart guide and API reference can be found in the [ngrok-python documentation](https://ngrok.github.io/ngrok-python/).

### Authentication

To use most of ngrok's features, you'll need an authtoken. To obtain one, sign up for free at [ngrok.com](https://dashboard.ngrok.com/signup) and retrieve it from the [authtoken page in your ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). Once you have copied your authtoken, you can reference it in several ways.

You can set it in the `NGROK_AUTHTOKEN` environment variable and pass `authtoken_from_env=True` to the [forward](https://ngrok.github.io/ngrok-python/module.html) method:

```python
ngrok.forward(authtoken_from_env=True, ...)
```

Or pass the authtoken directly to the [forward](https://ngrok.github.io/ngrok-python/module.html) method:

```python
ngrok.forward(authtoken=token, ...)
```

Or set it for all connections with the [set_auth_token](https://ngrok.github.io/ngrok-python/module.html) method:

```python
ngrok.set_auth_token(token)
```

### Connection

The [forward](https://ngrok.github.io/ngrok-python/module.html) method is the easiest way to start an ngrok session and establish a listener to a specified address. If an asynchronous runtime is running, the [forward](https://ngrok.github.io/ngrok-python/module.html) method returns a promise that resolves to the public listener object.

With no arguments, the [forward](https://ngrok.github.io/ngrok-python/module.html) method will start an HTTP listener to `localhost` port `80`:

```python
listener = ngrok.forward()
```

You can pass the port number to forward on `localhost`:

```python
listener = ngrok.forward(4242)
```

Or you can specify the host and port via a string:

```python
listener = ngrok.forward("localhost:4242")
```

More options can be passed to the `forward` method to customize the connection:

```python
listener = ngrok.forward(8080, basic_auth="ngrok:online1line"})
listener = ngrok.forward(8080, oauth_provider="google", oauth_allow_domains="example.com")
```

The second (optional) argument is the listener type, which defaults to `http`. To create a TCP listener:

```python
listener = ngrok.forward(25565, "tcp")
```

Since the options are kwargs, you can also use the `**` operator to pass a dictionary for configuration:

```python
options = {"authtoken_from_env":True, "response_header_add":"X-Awesome:yes"}
listener = ngrok.forward(8080, **options)
```

See [Full Configuration](#full-configuration) for the list of possible configuration options.

### Disconnection

To close a listener use the [disconnect](https://ngrok.github.io/ngrok-python/module.html) method with the `url` of the listener to close. If there is an asynchronous runtime running the [disconnect](https://ngrok.github.io/ngrok-python/module.html) method returns a promise that resolves when the call is complete.

```python
ngrok.disconnect(url)
```

Or omit the `url` to close all listeners:

```python
ngrok.disconnect()
```

The [close](https://ngrok.github.io/ngrok-python/ngrok_listener.html) method on a listener will shut it down, and also stop the ngrok session if it is no longer needed. This method returns a promise that resolves when the listener is closed.

```python
await listener.close()
```

### List all Listeners

To list all current non-closed listeners use the [get_listeners](https://ngrok.github.io/ngrok-python/module.html) method. If there is an asynchronous runtime running the [get_listeners](https://ngrok.github.io/ngrok-python/module.html) method returns a promise that resolves to the list of listener objects.

```python
listeners = ngrok.get_listeners()
```

### TLS Backends

As of version `0.10.0` there is backend TLS connection support, validated by a filepath specified in the `SSL_CERT_FILE` environment variable, or falling back to the host OS installed trusted certificate authorities. So it is now possible to do this to connect:

```python
ngrok.forward("https://127.0.0.1:3000", authtoken_from_env=True)
```

If the service is using certs not trusted by the OS, such as self-signed certificates, add an environment variable like this before running: `SSL_CERT_FILE=/path/to/ca.crt`.

### Unix Sockets

You may also choose to use Unix Sockets instead of TCP. You can view an example of this [here](https://github.com/ngrok/ngrok-python/blob/main/examples/ngrok-http-full.py).

A socket address may be passed directly into the listener `forward()` call as well by prefixing the address with `unix:`, for example `unix:/tmp/socket-123`.

### Builders

For more control over Sessions and Listeners, the builder classes can be used.

A minimal example using the builder class looks like [the following](https://github.com/ngrok/ngrok-python/blob/main/examples/ngrok-http-minimal.py):

```python
async def create_listener():
    session = await ngrok.NgrokSessionBuilder().authtoken_from_env().connect()
    listener = await session.http_endpoint().listen()
    print (f"Ingress established at {listener.url()}")
    listener.forward("localhost:9000")
```

See here for a [Full Configuration Example](https://github.com/ngrok/ngrok-python/blob/main/examples/ngrok-http-full.py)

### Full Configuration

This example shows [all the possible configuration items of ngrok.forward](https://github.com/ngrok/ngrok-python/blob/main/examples/ngrok-forward-full.py):

```python
listener = ngrok.forward(
    # session configuration
    addr="localhost:8080",
    authtoken="<authtoken>",
    authtoken_from_env=True,
    app_protocol="http2",
    session_metadata="Online in One Line",
    # listener configuration
    metadata="example listener metadata from python",
    domain="<domain>",
    schemes=["HTTPS"],
    proto="http",
    proxy_proto="",  # One of: "", "1", "2"
    labels="edge:edghts_2G...",  # Along with proto="labeled"
    # module configuration
    basic_auth=["ngrok:online1line"],
    circuit_breaker=0.1,
    compression=True,
    allow_user_agent="^mozilla.*",
    deny_user_agent="^curl.*",
    allow_cidr="0.0.0.0/0",
    deny_cidr="10.1.1.1/32",
    crt=load_file("crt.pem"),
    key=load_file("key.pem"),
    mutual_tls_cas=load_file("ca.crt"),
    oauth_provider="google",
    oauth_allow_domains=["<domain>"],
    oauth_allow_emails=["<email>"],
    oauth_scopes=["<scope>"],
    oauth_client_id="<id>",
    oauth_client_secret="<id>",
    oidc_issuer_url="<url>",
    oidc_client_id="<id>",
    oidc_client_secret="<secret>",
    oidc_allow_domains=["<domain>"],
    oidc_allow_emails=["<email>"],
    oidc_scopes=["<scope>"],
    policy="<policy_json>",
    request_header_remove="X-Req-Nope",
    response_header_remove="X-Res-Nope",
    request_header_add="X-Req-Yup:true",
    response_header_add="X-Res-Yup:true",
    verify_webhook_provider="twilio",
    verify_webhook_secret="asdf",
    websocket_tcp_converter=True,
)
```

# ASGI Runner

`ngrok-python` comes bundled with an ASGI (Asynchronous Server Gateway Interface) runner `ngrok-asgi` that can be used for Uvicorn, Gunicorn, Django and more, with no code. 

To use prefix your start up command for a Uvicorn or Gunicorn web server with either `ngrok-asgi` or `python -m ngrok`. 

Any TCP or Unix Domain Socket arguments will be used to establish connectivity automatically. The ngrok listener can be configured using command flags, for instance adding `--basic-auth ngrok online1line` will introduce basic authentication to the ingress listener.

### Uvicorn

```shell
# Basic Usage
ngrok-asgi uvicorn mysite.asgi:application

# With custom host and port
ngrok-asgi uvicorn mysite.asgi:application \
    --host localhost \
    --port 1234

# Using basic auth
ngrok-asgi uvicorn mysite.asgi:application \
    --host localhost \
    --port 1234 \
    --basic-auth ngrok online1line

# Using custom sock file
ngrok-asgi uvicorn mysite.asgi:application \
    --uds /tmp/uvicorn.sock

# Using module name
python -m ngrok uvicorn mysite.asgi:application \
    --oauth-provider google \
    --allow-emails bob@example.com
```

### Gunicorn

```shell
# Basic Usage
ngrok-asgi gunicorn mysite.asgi:application -k uvicorn.workers.UvicornWorker

# With custom host and port
ngrok-asgi gunicorn mysite.asgi:application -k uvicorn.workers.UvicornWorker \
    --bind localhost:1234

# Using webhook verifications
ngrok-asgi gunicorn mysite.asgi:application -k uvicorn.workers.UvicornWorker \
    --webhook-verification twilio s3cr3t

# Using custom sock file
ngrok-asgi gunicorn mysite.asgi:application -k uvicorn.workers.UvicornWorker \
    --bind unix:/tmp/gunicorn.sock

# Using module name
python -m ngrok gunicorn mysite.asgi:application -k uvicorn.workers.UvicornWorker --response-header X-Awesome True
```

# Examples

#### Listeners
  - [HTTP](https://github.com/ngrok/ngrok-python/tree/main/examples/ngrok-http-minimal.py)
    - [Full Configuration Example](https://github.com/ngrok/ngrok-python/tree/main/examples/ngrok-http-full.py)
  - [Labeled](https://github.com/ngrok/ngrok-python/tree/main/examples/ngrok-labeled.py)
  - [TCP](https://github.com/ngrok/ngrok-python/tree/main/examples/ngrok-tcp.py)
  - [TLS](https://github.com/ngrok/ngrok-python/tree/main/examples/ngrok-tls.py)

#### Frameworks
  - [AIOHTTP](https://github.com/ngrok/ngrok-python/tree/main/examples/aiohttp-ngrok.py)
  - [AWS APP Runner](https://github.com/ngrok/ngrok-sdk-serverless-example)
    - with [changes for Python](https://docs.aws.amazon.com/apprunner/latest/dg/service-source-code-python.html)
  - Django
    - [Single File Example](https://github.com/ngrok/ngrok-python/tree/main/examples/django-single-file.py)
    - [Modify manage.py Example](https://github.com/ngrok/ngrok-python/tree/main/examples/djangosite/manage.py)
    - [Modify asgi.py Example](https://github.com/ngrok/ngrok-python/tree/main/examples/djangosite/djangosite/ngrok-asgi.py)
    - or [via `ngrok-asgi`](#asgi-runner)
  - [Flask](https://github.com/ngrok/ngrok-python/tree/main/examples/flask-ngrok.py)
  - [Gunicorn](#gunicorn)
  - [Hypercorn](https://github.com/ngrok/ngrok-python/tree/main/examples/hypercorn-http2-ngrok.py)
  - [Streamlit](https://github.com/ngrok/ngrok-python/tree/main/examples/streamlit/streamlit-ngrok.py)
  - [Tornado](https://github.com/ngrok/ngrok-python/tree/main/examples/tornado-ngrok.py)
  - [Uvicorn](https://github.com/ngrok/ngrok-python/tree/main/examples/uvicorn-ngrok.py)

#### Machine Learning
  - Gradio
    - [ngrok-asgi Example](https://github.com/ngrok/ngrok-python/tree/main/examples/gradio/gradio-asgi.py)
    - [gradio CLI Example](https://github.com/ngrok/ngrok-python/tree/main/examples/gradio/gradio-ngrok.py)
  - [OpenPlayground](https://github.com/ngrok/ngrok-python/tree/main/examples/openplayground/run.py)
  - [GPT4ALL](https://github.com/ngrok/ngrok-python/tree/main/examples/gpt4all/run.py)
  - [Stable Diffusion WebUI](https://github.com/AUTOMATIC1111/stable-diffusion-webui/) by AUTOMATIC1111
    - `ngrok-python` is now built-in, see the `--ngrok` and `--ngrok-options` arguments.
  - [Text Generation WebUI](https://github.com/oobabooga/text-generation-webui) by oobabooga
    - `ngrok-python` is now built-in, see the `--extension ngrok` argument.

# Platform Support

Pre-built binaries are provided on PyPI for the following platforms:

| OS         | i686 | x64 | aarch64 | arm |
| ---------- | -----|-----|---------|-----|
| Windows    |   ✓  |  ✓  |    *    |     |
| MacOS      |      |  ✓  |    ✓    |     |
| Linux      |      |  ✓  |    ✓    |  ✓  |
| Linux musl |      |  ✓  |    ✓    |     |
| FreeBSD    |      |  *  |         |     |

> **Note**
> `ngrok-python`, and [ngrok-rust](https://github.com/ngrok/ngrok-rust/) which it depends on, are open source, so it may be possible to build them for other platforms.
> - Windows-aarch64 will be supported after the next release of [Ring](https://github.com/briansmith/ring/issues/1167).
> - FreeBSD-x64 is built by the release process, but PyPI won't accept BSD flavors.

# Dependencies

- This project relies on [PyO3](https://pyo3.rs/), an excellent system to ease development and building of Rust plugins for Python.
- Thank you to [OpenIoTHub](https://github.com/OpenIoTHub/ngrok) for handing over the ngrok name on PyPI.

# Changelog

Changes to `ngrok-python` are tracked under [CHANGELOG.md](https://github.com/ngrok/ngrok-python/blob/main/CHANGELOG.md).

# Join the ngrok Community

- Check out [our official docs](https://docs.ngrok.com)
- Read about updates on [our blog](https://blog.ngrok.com)
- Open an [issue](https://github.com/ngrok/ngrok-python/issues) or [pull request](https://github.com/ngrok/ngrok-python/pulls)
- Join our [Slack community](https://ngrok.com/slack)
- Follow us on [X / Twitter (@ngrokHQ)](https://twitter.com/ngrokhq)
- Subscribe to our [Youtube channel (@ngrokHQ)](https://www.youtube.com/@ngrokhq)

# License

This project is dual-licensed under [Apache, Version 2.0](LICENSE-APACHE) and [MIT](LICENSE-MIT).
You can choose between one of them if you use this work.

### Contributions

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

# Development: Getting Started

**Prerequisites:**
- a valid Ngrok `authtoken`
-  `make` available in your PATH

1. Update [Cargo.toml](./Cargo.toml) with the _latest supported_ ```ngrok = { version = "=VERSION_HERE" }``` from [ngrok-rust](https://github.com/ngrok/ngrok-rust/blob/main/ngrok/Cargo.toml#L3). `ngrok-rust` is used for the bindings in [src/rust_files_here.rs](./src)

2. Run `make build` (builds the `rust` bindings / `python` dependencies)

3. Happy developing!

<br/>

**Example Commands**:

_building the project_
```shell
make develop
```

_running the entire test suite_
```shell
# running the entire test suite
export NGROK_AUTHTOKEN="YOUR_AUTHTOKEN_HERE"; make test
```

_running an individual test_
```shell
# running an individual test
export NGROK_AUTHTOKEN="YOUR_AUTHTOKEN_HERE"; make test="-k TEST_CLASS.NAME_OF_TEST" test
```

[See the MakeFile for more examples](./Makefile)

### HTTP2 

The examples include a minimal `hypercorn` HTTP/2 example if you run `make http2`. You can curl the endpoint logged with `INFO:ngrok.listener:Created` and verify the HTTP/2 response from `hypercorn`.

```bash
curl --http2 -v https://<YOUR_LISTENER_URL>
*   Trying <YOUR_IP>:443...
* Connected to a6278d6c07ce.ngrok.app (<YOUR_IP>) port 443 (#0)
* ALPN, offering h2
* ALPN, offering http/1.1
...
> GET / HTTP/2
> Host: a6278d6c07ce.ngrok.app
> user-agent: curl/7.81.0
> accept: */*
>
...
< HTTP/2 200
< content-type: text/plain
< date: Fri, 01 Mar 2024 18:50:23 GMT
< ngrok-agent-ips: <YOUR_AGENT_IP>
< ngrok-trace-id: ed038ace04876818149cf0769bd43e38
< server: hypercorn-h2
<
* TLSv1.2 (IN), TLS header, Supplemental data (23):
* TLSv1.2 (IN), TLS header, Supplemental data (23):
* Connection #0 to host <YOUR_LISTENER_URL> left intact
hello
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "ngrok",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": "ngrok,python,pypi,pyo3,ingress,networking",
    "author": null,
    "author_email": null,
    "download_url": null,
    "platform": null,
    "description": "# Python SDK for ngrok\n\n[![PyPI][pypi-badge]][pypi-url]\n[![Supported Versions][ver-badge]][ver-url]\n[![MIT licensed][mit-badge]][mit-url]\n[![Apache-2.0 licensed][apache-badge]][apache-url]\n[![Continuous integration][ci-badge]][ci-url]\n\n[pypi-badge]: https://img.shields.io/pypi/v/ngrok\n[pypi-url]: https://pypi.org/project/ngrok\n[ver-badge]: https://img.shields.io/pypi/pyversions/ngrok.svg\n[ver-url]: https://pypi.org/project/ngrok\n[mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg\n[mit-url]: https://github.com/ngrok/ngrok-rust/blob/main/LICENSE-MIT\n[apache-badge]: https://img.shields.io/badge/license-Apache_2.0-blue.svg\n[apache-url]: https://github.com/ngrok/ngrok-rust/blob/main/LICENSE-APACHE\n[ci-badge]: https://github.com/ngrok/ngrok-python/actions/workflows/ci.yml/badge.svg\n[ci-url]: https://github.com/ngrok/ngrok-python/actions/workflows/ci.yml\n\n`ngrok-python` is the official Python SDK for ngrok that requires no binaries. Quickly enable secure production-ready connectivity to your applications and services directly from your code.\n\n[ngrok](https://ngrok.com) is a globally distributed gateway that provides secure connectivity for applications and services running in any environment.\n\n# Installation\n\nThe `ngrok-python` SDK can be installed from [PyPI](https://pypi.org/project/ngrok) via `pip`:\n\n```shell\npip install ngrok\n```\n\n# Quickstart\n\n1. [Install `ngrok-python`](#installation)\n2. Export your [authtoken from the ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken) as `NGROK_AUTHTOKEN` in your terminal\n3. Add the following code to your application to establish connectivity via the [forward method](https://github.com/ngrok/ngrok-python/blob/main/examples/ngrok-forward-minimal.py) through port `9000` on `localhost`:\n\n    ```python\n    # import ngrok python sdk\n    import ngrok\n    \n    # Establish connectivity\n    listener = ngrok.forward(9000, authtoken_from_env=True)\n    \n    # Output ngrok url to console\n    print(f\"Ingress established at {listener.url()}\")\n    ```\n\nThat's it! Your application should now be available through the url output in your terminal. \n\n> **Note**\n> You can find more examples in [the examples directory](https://github.com/ngrok/ngrok-python/tree/main/examples).\n\n# Documentation\n\nA full quickstart guide and API reference can be found in the [ngrok-python documentation](https://ngrok.github.io/ngrok-python/).\n\n### Authentication\n\nTo use most of ngrok's features, you'll need an authtoken. To obtain one, sign up for free at [ngrok.com](https://dashboard.ngrok.com/signup) and retrieve it from the [authtoken page in your ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). Once you have copied your authtoken, you can reference it in several ways.\n\nYou can set it in the `NGROK_AUTHTOKEN` environment variable and pass `authtoken_from_env=True` to the [forward](https://ngrok.github.io/ngrok-python/module.html) method:\n\n```python\nngrok.forward(authtoken_from_env=True, ...)\n```\n\nOr pass the authtoken directly to the [forward](https://ngrok.github.io/ngrok-python/module.html) method:\n\n```python\nngrok.forward(authtoken=token, ...)\n```\n\nOr set it for all connections with the [set_auth_token](https://ngrok.github.io/ngrok-python/module.html) method:\n\n```python\nngrok.set_auth_token(token)\n```\n\n### Connection\n\nThe [forward](https://ngrok.github.io/ngrok-python/module.html) method is the easiest way to start an ngrok session and establish a listener to a specified address. If an asynchronous runtime is running, the [forward](https://ngrok.github.io/ngrok-python/module.html) method returns a promise that resolves to the public listener object.\n\nWith no arguments, the [forward](https://ngrok.github.io/ngrok-python/module.html) method will start an HTTP listener to `localhost` port `80`:\n\n```python\nlistener = ngrok.forward()\n```\n\nYou can pass the port number to forward on `localhost`:\n\n```python\nlistener = ngrok.forward(4242)\n```\n\nOr you can specify the host and port via a string:\n\n```python\nlistener = ngrok.forward(\"localhost:4242\")\n```\n\nMore options can be passed to the `forward` method to customize the connection:\n\n```python\nlistener = ngrok.forward(8080, basic_auth=\"ngrok:online1line\"})\nlistener = ngrok.forward(8080, oauth_provider=\"google\", oauth_allow_domains=\"example.com\")\n```\n\nThe second (optional) argument is the listener type, which defaults to `http`. To create a TCP listener:\n\n```python\nlistener = ngrok.forward(25565, \"tcp\")\n```\n\nSince the options are kwargs, you can also use the `**` operator to pass a dictionary for configuration:\n\n```python\noptions = {\"authtoken_from_env\":True, \"response_header_add\":\"X-Awesome:yes\"}\nlistener = ngrok.forward(8080, **options)\n```\n\nSee [Full Configuration](#full-configuration) for the list of possible configuration options.\n\n### Disconnection\n\nTo close a listener use the [disconnect](https://ngrok.github.io/ngrok-python/module.html) method with the `url` of the listener to close. If there is an asynchronous runtime running the [disconnect](https://ngrok.github.io/ngrok-python/module.html) method returns a promise that resolves when the call is complete.\n\n```python\nngrok.disconnect(url)\n```\n\nOr omit the `url` to close all listeners:\n\n```python\nngrok.disconnect()\n```\n\nThe [close](https://ngrok.github.io/ngrok-python/ngrok_listener.html) method on a listener will shut it down, and also stop the ngrok session if it is no longer needed. This method returns a promise that resolves when the listener is closed.\n\n```python\nawait listener.close()\n```\n\n### List all Listeners\n\nTo list all current non-closed listeners use the [get_listeners](https://ngrok.github.io/ngrok-python/module.html) method. If there is an asynchronous runtime running the [get_listeners](https://ngrok.github.io/ngrok-python/module.html) method returns a promise that resolves to the list of listener objects.\n\n```python\nlisteners = ngrok.get_listeners()\n```\n\n### TLS Backends\n\nAs of version `0.10.0` there is backend TLS connection support, validated by a filepath specified in the `SSL_CERT_FILE` environment variable, or falling back to the host OS installed trusted certificate authorities. So it is now possible to do this to connect:\n\n```python\nngrok.forward(\"https://127.0.0.1:3000\", authtoken_from_env=True)\n```\n\nIf the service is using certs not trusted by the OS, such as self-signed certificates, add an environment variable like this before running: `SSL_CERT_FILE=/path/to/ca.crt`.\n\n### Unix Sockets\n\nYou may also choose to use Unix Sockets instead of TCP. You can view an example of this [here](https://github.com/ngrok/ngrok-python/blob/main/examples/ngrok-http-full.py).\n\nA socket address may be passed directly into the listener `forward()` call as well by prefixing the address with `unix:`, for example `unix:/tmp/socket-123`.\n\n### Builders\n\nFor more control over Sessions and Listeners, the builder classes can be used.\n\nA minimal example using the builder class looks like [the following](https://github.com/ngrok/ngrok-python/blob/main/examples/ngrok-http-minimal.py):\n\n```python\nasync def create_listener():\n    session = await ngrok.NgrokSessionBuilder().authtoken_from_env().connect()\n    listener = await session.http_endpoint().listen()\n    print (f\"Ingress established at {listener.url()}\")\n    listener.forward(\"localhost:9000\")\n```\n\nSee here for a [Full Configuration Example](https://github.com/ngrok/ngrok-python/blob/main/examples/ngrok-http-full.py)\n\n### Full Configuration\n\nThis example shows [all the possible configuration items of ngrok.forward](https://github.com/ngrok/ngrok-python/blob/main/examples/ngrok-forward-full.py):\n\n```python\nlistener = ngrok.forward(\n    # session configuration\n    addr=\"localhost:8080\",\n    authtoken=\"<authtoken>\",\n    authtoken_from_env=True,\n    app_protocol=\"http2\",\n    session_metadata=\"Online in One Line\",\n    # listener configuration\n    metadata=\"example listener metadata from python\",\n    domain=\"<domain>\",\n    schemes=[\"HTTPS\"],\n    proto=\"http\",\n    proxy_proto=\"\",  # One of: \"\", \"1\", \"2\"\n    labels=\"edge:edghts_2G...\",  # Along with proto=\"labeled\"\n    # module configuration\n    basic_auth=[\"ngrok:online1line\"],\n    circuit_breaker=0.1,\n    compression=True,\n    allow_user_agent=\"^mozilla.*\",\n    deny_user_agent=\"^curl.*\",\n    allow_cidr=\"0.0.0.0/0\",\n    deny_cidr=\"10.1.1.1/32\",\n    crt=load_file(\"crt.pem\"),\n    key=load_file(\"key.pem\"),\n    mutual_tls_cas=load_file(\"ca.crt\"),\n    oauth_provider=\"google\",\n    oauth_allow_domains=[\"<domain>\"],\n    oauth_allow_emails=[\"<email>\"],\n    oauth_scopes=[\"<scope>\"],\n    oauth_client_id=\"<id>\",\n    oauth_client_secret=\"<id>\",\n    oidc_issuer_url=\"<url>\",\n    oidc_client_id=\"<id>\",\n    oidc_client_secret=\"<secret>\",\n    oidc_allow_domains=[\"<domain>\"],\n    oidc_allow_emails=[\"<email>\"],\n    oidc_scopes=[\"<scope>\"],\n    policy=\"<policy_json>\",\n    request_header_remove=\"X-Req-Nope\",\n    response_header_remove=\"X-Res-Nope\",\n    request_header_add=\"X-Req-Yup:true\",\n    response_header_add=\"X-Res-Yup:true\",\n    verify_webhook_provider=\"twilio\",\n    verify_webhook_secret=\"asdf\",\n    websocket_tcp_converter=True,\n)\n```\n\n# ASGI Runner\n\n`ngrok-python` comes bundled with an ASGI (Asynchronous Server Gateway Interface) runner `ngrok-asgi` that can be used for Uvicorn, Gunicorn, Django and more, with no code. \n\nTo use prefix your start up command for a Uvicorn or Gunicorn web server with either `ngrok-asgi` or `python -m ngrok`. \n\nAny TCP or Unix Domain Socket arguments will be used to establish connectivity automatically. The ngrok listener can be configured using command flags, for instance adding `--basic-auth ngrok online1line` will introduce basic authentication to the ingress listener.\n\n### Uvicorn\n\n```shell\n# Basic Usage\nngrok-asgi uvicorn mysite.asgi:application\n\n# With custom host and port\nngrok-asgi uvicorn mysite.asgi:application \\\n    --host localhost \\\n    --port 1234\n\n# Using basic auth\nngrok-asgi uvicorn mysite.asgi:application \\\n    --host localhost \\\n    --port 1234 \\\n    --basic-auth ngrok online1line\n\n# Using custom sock file\nngrok-asgi uvicorn mysite.asgi:application \\\n    --uds /tmp/uvicorn.sock\n\n# Using module name\npython -m ngrok uvicorn mysite.asgi:application \\\n    --oauth-provider google \\\n    --allow-emails bob@example.com\n```\n\n### Gunicorn\n\n```shell\n# Basic Usage\nngrok-asgi gunicorn mysite.asgi:application -k uvicorn.workers.UvicornWorker\n\n# With custom host and port\nngrok-asgi gunicorn mysite.asgi:application -k uvicorn.workers.UvicornWorker \\\n    --bind localhost:1234\n\n# Using webhook verifications\nngrok-asgi gunicorn mysite.asgi:application -k uvicorn.workers.UvicornWorker \\\n    --webhook-verification twilio s3cr3t\n\n# Using custom sock file\nngrok-asgi gunicorn mysite.asgi:application -k uvicorn.workers.UvicornWorker \\\n    --bind unix:/tmp/gunicorn.sock\n\n# Using module name\npython -m ngrok gunicorn mysite.asgi:application -k uvicorn.workers.UvicornWorker --response-header X-Awesome True\n```\n\n# Examples\n\n#### Listeners\n  - [HTTP](https://github.com/ngrok/ngrok-python/tree/main/examples/ngrok-http-minimal.py)\n    - [Full Configuration Example](https://github.com/ngrok/ngrok-python/tree/main/examples/ngrok-http-full.py)\n  - [Labeled](https://github.com/ngrok/ngrok-python/tree/main/examples/ngrok-labeled.py)\n  - [TCP](https://github.com/ngrok/ngrok-python/tree/main/examples/ngrok-tcp.py)\n  - [TLS](https://github.com/ngrok/ngrok-python/tree/main/examples/ngrok-tls.py)\n\n#### Frameworks\n  - [AIOHTTP](https://github.com/ngrok/ngrok-python/tree/main/examples/aiohttp-ngrok.py)\n  - [AWS APP Runner](https://github.com/ngrok/ngrok-sdk-serverless-example)\n    - with [changes for Python](https://docs.aws.amazon.com/apprunner/latest/dg/service-source-code-python.html)\n  - Django\n    - [Single File Example](https://github.com/ngrok/ngrok-python/tree/main/examples/django-single-file.py)\n    - [Modify manage.py Example](https://github.com/ngrok/ngrok-python/tree/main/examples/djangosite/manage.py)\n    - [Modify asgi.py Example](https://github.com/ngrok/ngrok-python/tree/main/examples/djangosite/djangosite/ngrok-asgi.py)\n    - or [via `ngrok-asgi`](#asgi-runner)\n  - [Flask](https://github.com/ngrok/ngrok-python/tree/main/examples/flask-ngrok.py)\n  - [Gunicorn](#gunicorn)\n  - [Hypercorn](https://github.com/ngrok/ngrok-python/tree/main/examples/hypercorn-http2-ngrok.py)\n  - [Streamlit](https://github.com/ngrok/ngrok-python/tree/main/examples/streamlit/streamlit-ngrok.py)\n  - [Tornado](https://github.com/ngrok/ngrok-python/tree/main/examples/tornado-ngrok.py)\n  - [Uvicorn](https://github.com/ngrok/ngrok-python/tree/main/examples/uvicorn-ngrok.py)\n\n#### Machine Learning\n  - Gradio\n    - [ngrok-asgi Example](https://github.com/ngrok/ngrok-python/tree/main/examples/gradio/gradio-asgi.py)\n    - [gradio CLI Example](https://github.com/ngrok/ngrok-python/tree/main/examples/gradio/gradio-ngrok.py)\n  - [OpenPlayground](https://github.com/ngrok/ngrok-python/tree/main/examples/openplayground/run.py)\n  - [GPT4ALL](https://github.com/ngrok/ngrok-python/tree/main/examples/gpt4all/run.py)\n  - [Stable Diffusion WebUI](https://github.com/AUTOMATIC1111/stable-diffusion-webui/) by AUTOMATIC1111\n    - `ngrok-python` is now built-in, see the `--ngrok` and `--ngrok-options` arguments.\n  - [Text Generation WebUI](https://github.com/oobabooga/text-generation-webui) by oobabooga\n    - `ngrok-python` is now built-in, see the `--extension ngrok` argument.\n\n# Platform Support\n\nPre-built binaries are provided on PyPI for the following platforms:\n\n| OS         | i686 | x64 | aarch64 | arm |\n| ---------- | -----|-----|---------|-----|\n| Windows    |   \u2713  |  \u2713  |    *    |     |\n| MacOS      |      |  \u2713  |    \u2713    |     |\n| Linux      |      |  \u2713  |    \u2713    |  \u2713  |\n| Linux musl |      |  \u2713  |    \u2713    |     |\n| FreeBSD    |      |  *  |         |     |\n\n> **Note**\n> `ngrok-python`, and [ngrok-rust](https://github.com/ngrok/ngrok-rust/) which it depends on, are open source, so it may be possible to build them for other platforms.\n> - Windows-aarch64 will be supported after the next release of [Ring](https://github.com/briansmith/ring/issues/1167).\n> - FreeBSD-x64 is built by the release process, but PyPI won't accept BSD flavors.\n\n# Dependencies\n\n- This project relies on [PyO3](https://pyo3.rs/), an excellent system to ease development and building of Rust plugins for Python.\n- Thank you to [OpenIoTHub](https://github.com/OpenIoTHub/ngrok) for handing over the ngrok name on PyPI.\n\n# Changelog\n\nChanges to `ngrok-python` are tracked under [CHANGELOG.md](https://github.com/ngrok/ngrok-python/blob/main/CHANGELOG.md).\n\n# Join the ngrok Community\n\n- Check out [our official docs](https://docs.ngrok.com)\n- Read about updates on [our blog](https://blog.ngrok.com)\n- Open an [issue](https://github.com/ngrok/ngrok-python/issues) or [pull request](https://github.com/ngrok/ngrok-python/pulls)\n- Join our [Slack community](https://ngrok.com/slack)\n- Follow us on [X / Twitter (@ngrokHQ)](https://twitter.com/ngrokhq)\n- Subscribe to our [Youtube channel (@ngrokHQ)](https://www.youtube.com/@ngrokhq)\n\n# License\n\nThis project is dual-licensed under [Apache, Version 2.0](LICENSE-APACHE) and [MIT](LICENSE-MIT).\nYou can choose between one of them if you use this work.\n\n### Contributions\n\nUnless you explicitly state otherwise, any contribution intentionally submitted\nfor inclusion in `ngrok-python` by you, as defined in the Apache-2.0 license, shall be\ndual licensed as above, without any additional terms or conditions.\n\n# Development: Getting Started\n\n**Prerequisites:**\n- a valid Ngrok `authtoken`\n-  `make` available in your PATH\n\n1. Update [Cargo.toml](./Cargo.toml) with the _latest supported_ ```ngrok = { version = \"=VERSION_HERE\" }``` from [ngrok-rust](https://github.com/ngrok/ngrok-rust/blob/main/ngrok/Cargo.toml#L3). `ngrok-rust` is used for the bindings in [src/rust_files_here.rs](./src)\n\n2. Run `make build` (builds the `rust` bindings / `python` dependencies)\n\n3. Happy developing!\n\n<br/>\n\n**Example Commands**:\n\n_building the project_\n```shell\nmake develop\n```\n\n_running the entire test suite_\n```shell\n# running the entire test suite\nexport NGROK_AUTHTOKEN=\"YOUR_AUTHTOKEN_HERE\"; make test\n```\n\n_running an individual test_\n```shell\n# running an individual test\nexport NGROK_AUTHTOKEN=\"YOUR_AUTHTOKEN_HERE\"; make test=\"-k TEST_CLASS.NAME_OF_TEST\" test\n```\n\n[See the MakeFile for more examples](./Makefile)\n\n### HTTP2 \n\nThe examples include a minimal `hypercorn` HTTP/2 example if you run `make http2`. You can curl the endpoint logged with `INFO:ngrok.listener:Created` and verify the HTTP/2 response from `hypercorn`.\n\n```bash\ncurl --http2 -v https://<YOUR_LISTENER_URL>\n*   Trying <YOUR_IP>:443...\n* Connected to a6278d6c07ce.ngrok.app (<YOUR_IP>) port 443 (#0)\n* ALPN, offering h2\n* ALPN, offering http/1.1\n...\n> GET / HTTP/2\n> Host: a6278d6c07ce.ngrok.app\n> user-agent: curl/7.81.0\n> accept: */*\n>\n...\n< HTTP/2 200\n< content-type: text/plain\n< date: Fri, 01 Mar 2024 18:50:23 GMT\n< ngrok-agent-ips: <YOUR_AGENT_IP>\n< ngrok-trace-id: ed038ace04876818149cf0769bd43e38\n< server: hypercorn-h2\n<\n* TLSv1.2 (IN), TLS header, Supplemental data (23):\n* TLSv1.2 (IN), TLS header, Supplemental data (23):\n* Connection #0 to host <YOUR_LISTENER_URL> left intact\nhello\n```\n",
    "bugtrack_url": null,
    "license": "MIT OR Apache-2.0",
    "summary": "The ngrok Agent SDK for Python",
    "version": "1.2.0",
    "project_urls": {
        "changelog": "https://github.com/ngrok/ngrok-python/blob/main/CHANGELOG.md",
        "homepage": "https://ngrok.com",
        "repository": "https://github.com/ngrok/ngrok-python"
    },
    "split_keywords": [
        "ngrok",
        "python",
        "pypi",
        "pyo3",
        "ingress",
        "networking"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "7951d9696bf1211efa9586c76c751d43bb9264756c40139d46a7b449713943b3",
                "md5": "ba2b03fb39c65547382bc69604230990",
                "sha256": "be379cde4deab4e0b407dc445d093c77bfa7569b1b0e7fb1b0fa08e8c1ad9046"
            },
            "downloads": -1,
            "filename": "ngrok-1.2.0-cp37-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl",
            "has_sig": false,
            "md5_digest": "ba2b03fb39c65547382bc69604230990",
            "packagetype": "bdist_wheel",
            "python_version": "cp37",
            "requires_python": ">=3.7",
            "size": 5384471,
            "upload_time": "2024-03-12T16:21:10",
            "upload_time_iso_8601": "2024-03-12T16:21:10.660766Z",
            "url": "https://files.pythonhosted.org/packages/79/51/d9696bf1211efa9586c76c751d43bb9264756c40139d46a7b449713943b3/ngrok-1.2.0-cp37-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "21f5a9febfde7dc9e0386e98bdcd6b334377b466cc3780671cd73bda59efb439",
                "md5": "111eeb0810aec6731c1d85ccfdafb398",
                "sha256": "072b5a2aebd36ef200422f4eb17d84dc772eb019dab1cc72d9706893b55bb033"
            },
            "downloads": -1,
            "filename": "ngrok-1.2.0-cp37-abi3-macosx_10_12_x86_64.whl",
            "has_sig": false,
            "md5_digest": "111eeb0810aec6731c1d85ccfdafb398",
            "packagetype": "bdist_wheel",
            "python_version": "cp37",
            "requires_python": ">=3.7",
            "size": 2796752,
            "upload_time": "2024-03-12T16:20:31",
            "upload_time_iso_8601": "2024-03-12T16:20:31.986470Z",
            "url": "https://files.pythonhosted.org/packages/21/f5/a9febfde7dc9e0386e98bdcd6b334377b466cc3780671cd73bda59efb439/ngrok-1.2.0-cp37-abi3-macosx_10_12_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "a2d6641ca6be82fa0c79d82693f65ed70de6849eec2b57e7b7c22099a7889340",
                "md5": "29d251d2cfd0cb38b127668ab55d8f00",
                "sha256": "898b71747e8b6edead0413c7c009bf278e4fa607c5f075ac36409325685c6633"
            },
            "downloads": -1,
            "filename": "ngrok-1.2.0-cp37-abi3-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "29d251d2cfd0cb38b127668ab55d8f00",
            "packagetype": "bdist_wheel",
            "python_version": "cp37",
            "requires_python": ">=3.7",
            "size": 2607215,
            "upload_time": "2024-03-12T16:20:15",
            "upload_time_iso_8601": "2024-03-12T16:20:15.730179Z",
            "url": "https://files.pythonhosted.org/packages/a2/d6/641ca6be82fa0c79d82693f65ed70de6849eec2b57e7b7c22099a7889340/ngrok-1.2.0-cp37-abi3-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "cb0687ec379bef6e6d8121dfc9fe1693a82c3297f56df2530e494562d9fca084",
                "md5": "c34e67dea2e66276b7c4fc7d16152dc7",
                "sha256": "3c7668542bd7cbe0b368c9f6a7fcfcd77813d9cd9334a948b17f90c16d62336f"
            },
            "downloads": -1,
            "filename": "ngrok-1.2.0-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
            "has_sig": false,
            "md5_digest": "c34e67dea2e66276b7c4fc7d16152dc7",
            "packagetype": "bdist_wheel",
            "python_version": "cp37",
            "requires_python": ">=3.7",
            "size": 4442240,
            "upload_time": "2024-03-12T16:17:48",
            "upload_time_iso_8601": "2024-03-12T16:17:48.394599Z",
            "url": "https://files.pythonhosted.org/packages/cb/06/87ec379bef6e6d8121dfc9fe1693a82c3297f56df2530e494562d9fca084/ngrok-1.2.0-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "4be05980d4c812b796886d7c03472b0f59334dbb95265392a07cfdb09471cbcd",
                "md5": "99c58c8b0bfd6ad03540eb15fecd28ba",
                "sha256": "696bd52fc654de30e19a022afd14435917c3af03f3695b6490847e3652926ca1"
            },
            "downloads": -1,
            "filename": "ngrok-1.2.0-cp37-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl",
            "has_sig": false,
            "md5_digest": "99c58c8b0bfd6ad03540eb15fecd28ba",
            "packagetype": "bdist_wheel",
            "python_version": "cp37",
            "requires_python": ">=3.7",
            "size": 2620432,
            "upload_time": "2024-03-12T16:19:23",
            "upload_time_iso_8601": "2024-03-12T16:19:23.131510Z",
            "url": "https://files.pythonhosted.org/packages/4b/e0/5980d4c812b796886d7c03472b0f59334dbb95265392a07cfdb09471cbcd/ngrok-1.2.0-cp37-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "cc30b70619eb6c112f680719eaba3e3c01ba09def2050adf76ffebff987af839",
                "md5": "eef52cced670b7b7da08178d0231d836",
                "sha256": "252dee1faf145c27d09f607f583e048b1338b93d95aa6336dd6742233bd53de6"
            },
            "downloads": -1,
            "filename": "ngrok-1.2.0-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "eef52cced670b7b7da08178d0231d836",
            "packagetype": "bdist_wheel",
            "python_version": "cp37",
            "requires_python": ">=3.7",
            "size": 2906813,
            "upload_time": "2024-03-12T16:18:12",
            "upload_time_iso_8601": "2024-03-12T16:18:12.515779Z",
            "url": "https://files.pythonhosted.org/packages/cc/30/b70619eb6c112f680719eaba3e3c01ba09def2050adf76ffebff987af839/ngrok-1.2.0-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "42e8eea6fdd2524adf3c5f90b4809587115cb6eb73c5a1a7ef6deee9e21b309f",
                "md5": "45752ff10218b011e80591ba6940efab",
                "sha256": "1fcffdc0924ecfb345142e91aebb1efac35fdb422ca8e90e2ef9f1e285ef9ed6"
            },
            "downloads": -1,
            "filename": "ngrok-1.2.0-cp37-abi3-musllinux_1_2_aarch64.whl",
            "has_sig": false,
            "md5_digest": "45752ff10218b011e80591ba6940efab",
            "packagetype": "bdist_wheel",
            "python_version": "cp37",
            "requires_python": ">=3.7",
            "size": 2923583,
            "upload_time": "2024-03-12T16:17:56",
            "upload_time_iso_8601": "2024-03-12T16:17:56.225103Z",
            "url": "https://files.pythonhosted.org/packages/42/e8/eea6fdd2524adf3c5f90b4809587115cb6eb73c5a1a7ef6deee9e21b309f/ngrok-1.2.0-cp37-abi3-musllinux_1_2_aarch64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "c6058f15376f1c1c3368c29c6d77b7c92dfb9db3eb3ba038f0a2f1f21f1fd74a",
                "md5": "0c0a06d239616e3f4c182ec1df1494b1",
                "sha256": "40a51a91f564af8646da70f8d57789577090962b4100ef3afcfc64d79e36151b"
            },
            "downloads": -1,
            "filename": "ngrok-1.2.0-cp37-abi3-musllinux_1_2_x86_64.whl",
            "has_sig": false,
            "md5_digest": "0c0a06d239616e3f4c182ec1df1494b1",
            "packagetype": "bdist_wheel",
            "python_version": "cp37",
            "requires_python": ">=3.7",
            "size": 2957287,
            "upload_time": "2024-03-12T16:19:29",
            "upload_time_iso_8601": "2024-03-12T16:19:29.424839Z",
            "url": "https://files.pythonhosted.org/packages/c6/05/8f15376f1c1c3368c29c6d77b7c92dfb9db3eb3ba038f0a2f1f21f1fd74a/ngrok-1.2.0-cp37-abi3-musllinux_1_2_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "4fbeb2c6927ea3ac5246eefebd86c11b9b2636d350240162ae6093ba9a09df67",
                "md5": "0f76b39b05e559ce3416cb434acda992",
                "sha256": "d9df060e202ab56246ed21b005014745e870a5ded66e1a2792cf2abf9c293061"
            },
            "downloads": -1,
            "filename": "ngrok-1.2.0-cp37-abi3-win32.whl",
            "has_sig": false,
            "md5_digest": "0f76b39b05e559ce3416cb434acda992",
            "packagetype": "bdist_wheel",
            "python_version": "cp37",
            "requires_python": ">=3.7",
            "size": 2509587,
            "upload_time": "2024-03-12T16:21:47",
            "upload_time_iso_8601": "2024-03-12T16:21:47.241294Z",
            "url": "https://files.pythonhosted.org/packages/4f/be/b2c6927ea3ac5246eefebd86c11b9b2636d350240162ae6093ba9a09df67/ngrok-1.2.0-cp37-abi3-win32.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "e18958f059b17a28b172aa9ed4d787e6fa91fc6ff0894609983817c24843cb96",
                "md5": "ce1af61fb0023dbd0f62b4b75e1fc447",
                "sha256": "e853cbb1b8d3bd4fc5789f9e5ecbaee94656f7f25895ea7c78b3bb2a14c565de"
            },
            "downloads": -1,
            "filename": "ngrok-1.2.0-cp37-abi3-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "ce1af61fb0023dbd0f62b4b75e1fc447",
            "packagetype": "bdist_wheel",
            "python_version": "cp37",
            "requires_python": ">=3.7",
            "size": 3034048,
            "upload_time": "2024-03-12T16:20:17",
            "upload_time_iso_8601": "2024-03-12T16:20:17.821817Z",
            "url": "https://files.pythonhosted.org/packages/e1/89/58f059b17a28b172aa9ed4d787e6fa91fc6ff0894609983817c24843cb96/ngrok-1.2.0-cp37-abi3-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-12 16:21:10",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ngrok",
    "github_project": "ngrok-python",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "ngrok"
}
        
Elapsed time: 0.20536s