Metadata-Version: 2.4
Name: prosoon-pf
Version: 0.1.0
Summary: Quick-start a local HTTP server and optionally expose it via a Cloudflare tunnel.
Author: Prasun Banerjee
License: MIT
Keywords: http,server,cloudflare,tunnel,share,cli
Classifier: Environment :: Console
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# prosoon-pf

Quick-start a local HTTP server, and optionally expose it to the internet with a
Cloudflare quick tunnel — in one command. Linux only for now.

## Install

```bash
pip install prosoon-pf
```

## Usage

Serve the current directory locally on port 8000:

```bash
prosoon-pf
```

Pick a port and a directory:

```bash
prosoon-pf 9000 --dir ~/share
```

Expose it publicly (prints a `https://….trycloudflare.com` link):

```bash
prosoon-pf 8000 --public
```

If `cloudflared` isn't installed, `--public` mode will ask before installing it.

## Public mode is public

When you use `--public`, **every file in the served directory becomes
downloadable by anyone with the link** for as long as the command runs. The tool
shows you the directory contents and asks for confirmation first. Don't serve a
folder that contains passwords, keys, `.ovpn` files, or anything private.

## License

MIT
