Metadata-Version: 2.4
Name: eggserve
Version: 0.2.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Programming Language :: Rust
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: System :: Filesystems
Summary: A hardened, Rust-backed static file server with native Python bindings
License: MIT
Requires-Python: >=3.11
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Documentation, https://github.com/eggstack/eggserve/tree/main/docs
Project-URL: Homepage, https://github.com/eggstack/eggserve
Project-URL: Repository, https://github.com/eggstack/eggserve

# eggserve

A hardened, Rust-backed static file server, packaged as a Python wheel.

Release wheels support CPython 3.11+ with abi3 stable ABI (`>=3.11`) and
include an extension-backed `eggserve` CLI entry point. They do not bundle a
second standalone executable.

## Installation

```bash
pip install eggserve
```

## Usage

```bash
eggserve
eggserve 8000
eggserve --directory public
python -m eggserve --directory public 8000
```

## Safe defaults

- Binds to 127.0.0.1 (loopback only)
- No symlink following
- No dotfile serving
- No directory listing
- GET and HEAD only
- Request bodies rejected

## Building from source

```bash
pip install maturin
cd crates/eggserve-python
maturin build --release --interpreter python3.11 -o dist
```

