Metadata-Version: 2.4
Name: flask-directory-listing
Version: 0.0.1
Summary: Flask app that replicates Apache-style directory listings. Supports file uploads and folder downloads as ZIP archives.
Author-email: Phoenixthrush UwU <contact@phoenixthrush.com>
Maintainer-email: Phoenixthrush UwU <contact@phoenixthrush.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/phoenixthrush/flask-directory-listing
Project-URL: Documentation, https://github.com/phoenixthrush/flask-directory-listing/blob/main/README.md
Project-URL: Repository, https://github.com/phoenixthrush/flask-directory-listing.git
Project-URL: Bug Tracker, https://github.com/phoenixthrush/flask-directory-listing/issues
Project-URL: Changelog, https://github.com/phoenixthrush/flask-directory-listing/commits
Project-URL: Source Code, https://github.com/phoenixthrush/flask-directory-listing
Project-URL: Download, https://github.com/phoenixthrush/flask-directory-listing/archive/refs/heads/main.zip
Project-URL: Funding, https://github.com/sponsors/phoenixthrush
Keywords: flask,directory,listing
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Flask
Dynamic: license-file

# flask-directory-listing

Flask app that replicates Apache-style directory listings. Supports file uploads and folder downloads as ZIP archives.

## Installation

```bash
pip install flask-directory-listing
```

## Usage

```bash
flask-directory-listing \
  --root /path/to/serve \
  --host 0.0.0.0 \
  --port 8080 \
  --apache-style \
  --debug
```

Flags:

- `--root` directory to serve (default: `src/flask_directory_listing/apache/share`)
- `--host` listen address (default: `0.0.0.0`)
- `--port` listen port (default: `8080`)
- `--apache-style` enable mixed sorting like Apache (otherwise directories first)
- `--debug` enable Flask debug mode

Alternate invocation:

```bash
flask_directory_listing [flags]
```

Features:

- Apache-like index table with sorting links and icons
- Directory download as ZIP (`?download=<folder>`) links beside folders
- Drag-and-drop uploads, including nested folders
- Hidden files are ignored; path traversal is blocked
