Metadata-Version: 2.4
Name: atunnel
Version: 1.0.0
Summary: A-tunnel is a tool to expose localhost to the public internet using Cloudflare Quick Tunnels
Author-email: Abodx9 <abodx@gmx.de>
License-Expression: MIT
Project-URL: Repository, https://github.com/Abodx9/A-tunnel
Keywords: cloudflare,tunnel,localhost,expose,public
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# A-tunnel
A minimal Python package to expose localhost to the public internet using [Cloudflare Quick Tunnels](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/).

No Cloudflare account required  generates a temporary `*.trycloudflare.com` URL.

## Installation

```bash
# Using pip
pip install atunnel

# Or using uv
uv add atunnel
```

## Usage

### CLI

```bash
# Expose local port 8080
atunnel --port 8080

# With uv
uv run atunnel --port 8080
```

The public URL is printed to stdout. Press Ctrl+C to stop.

### Python API

```python
from atunnel.tunnel import Tunnel

with Tunnel(port=8080) as t:
    print(f"Public URL: {t.public_url}")
    input("Press Enter to stop...")
