Metadata-Version: 2.4
Name: srve
Version: 0.3.0
Summary: Srve the current directory over HTTP using Python's standard library.
Author: Doehyun Baek
Author-email: Doehyun Baek <doehyunbaek@gmail.com>
License-Expression: MIT
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# srve

A tiny command-line HTTP server built on Python's standard library. It can srve a directory or expose a single file.

## Usage

Srve the current directory on port 8000:

```bash
uvx srve
```

Use a different port:

```bash
uvx srve 8080
```

Srve a single file:

```bash
uvx srve ./document.pdf
```

Srve a single file on a different port:

```bash
uvx srve ./document.pdf 8080
```

Bind to a specific address or srve another directory:

```bash
uvx srve --bind 127.0.0.1 --directory ./public 8080
```

Expose the served file or directory with a temporary Cloudflare Quick Tunnel:

```bash
uvx srve -t
uvx srve -t ./document.pdf
```

This prints a public `trycloudflare.com` URL. If `cloudflared` is missing, srve
prompts to install it with Homebrew on macOS or winget on Windows. No Cloudflare
account is required.

Run a local checkout:

```bash
uvx --from ~/serve srve
```

## License

MIT
