# ngrok-api-python

**Repository Path**: noctua/ngrok-api-python

## Basic Information

- **Project Name**: ngrok-api-python
- **Description**: Forked from: https://github.com/ngrok/ngrok-api-python
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-03-26
- **Last Updated**: 2022-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ngrok API client library for Python

This library wraps the [ngrok HTTP API](https://ngrok.com/docs/api) to make it
easier to consume in Python.

## Installation

This library is published on [PyPi](https://pypi.org/project/ngrok-api/)

    pip install ngrok-api

## Documentation

A quickstart guide and a full API reference are included in the [ngrok python API documentation](https://python-api.docs.ngrok.com)

## Quickstart

Please consult the [documentation](https://python-api.docs.ngrok.com) for additional examples.

    import ngrok

    # construct the api client
    ng = ngrok.Client("<API KEY>")

    # list all online tunnels
    for t in ng.tunnels.list():
        print(t)

    # create an ip policy the allows traffic from some subnets
    policy = ng.ip_policies.create(action="allow")
    for cidr in ["24.0.0.0/8", "12.0.0.0/8"]:
        ng.ip_policy_rules.create(cidr=cidr, ip_policy_id=policy.id)