Metadata-Version: 2.1
Name: ASGIWebDAV
Version: 1.4.0
Summary: An asynchronous WebDAV server implementation, support multi-provider.
Author: Rex Zhang
Author-email: rex.zhang@gmail.com
License: MIT
Project-URL: homepage, https://github.com/rexzhang/asgi-webdav
Project-URL: documentation, https://rexzhang.github.io/asgi-webdav/
Project-URL: repository, https://github.com/rexzhang/asgi-webdav
Project-URL: changelog, https://github.com/rexzhang/asgi-webdav/blob/main/docs/changelog.en.md
Keywords: webdav,asgi,asyncio
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiofiles~=23.2.0
Requires-Dist: ASGIMiddlewareStaticFile~=0.6.0
Requires-Dist: xmltodict~=0.13.0
Requires-Dist: pydantic>=2.4
Requires-Dist: arrow
Requires-Dist: chardet
Requires-Dist: click
Provides-Extra: full
Requires-Dist: uvicorn; extra == "full"
Requires-Dist: uvloop; extra == "full"
Requires-Dist: httptools; extra == "full"
Requires-Dist: brotli; extra == "full"
Requires-Dist: bonsai~=1.5.0; extra == "full"
Provides-Extra: ldap
Requires-Dist: bonsai~=1.5.0; extra == "ldap"
Provides-Extra: standalone
Requires-Dist: uvicorn; extra == "standalone"
Requires-Dist: uvloop; extra == "standalone"
Requires-Dist: httptools; extra == "standalone"
Requires-Dist: brotli; extra == "standalone"

# ASGI WebDAV Server

![GitHub](https://img.shields.io/github/license/rexzhang/asgi-webdav)
[![PyPI](https://img.shields.io/pypi/v/ASGIWebDAV)](https://pypi.org/project/ASGIWebDAV)
![Pytest Workflow Status](https://github.com/rexzhang/asgi-webdav/actions/workflows/check-pytest.yml/badge.svg)
[![codecov](https://codecov.io/gh/rexzhang/asgi-webdav/branch/main/graph/badge.svg?token=6D961MCCWN)](https://codecov.io/gh/rexzhang/asgi-webdav)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Docker Pulls](https://img.shields.io/docker/pulls/ray1ex/asgi-webdav)](https://hub.docker.com/r/ray1ex/asgi-webdav)
![[PyPI - Downloads](https://pypi.org/project/ASGIWebDAV/)](https://img.shields.io/pypi/dm/ASGIWebDAV)
[![GitHub Downloads](https://img.shields.io/github/downloads/rexzhang/asgi-webdav/total)](https://github.com/rexzhang/asgi-webdav/releases)

An asynchronous WebDAV server implementation, Support multi-provider, multi-account and permission control.

## Features

- [ASGI](https://asgi.readthedocs.io) standard
- WebDAV standard: [RFC4918](https://www.ietf.org/rfc/rfc4918.txt)
- Support multi-provider: FileSystemProvider, MemoryProvider
- Support multi-account and permission control
- Support optional home directory
- Support store password in raw/hashlib/LDAP(experimental) mode
- Full asyncio file IO
- Passed all [litmus(0.13)](http://www.webdav.org/neon/litmus) test, except 3 warning
- Browse the file directory in the browser
- Support HTTP Basic/Digest authentication
- Support response in Gzip/Brotli
- Compatible with macOS finder and Window10 Explorer

## Python Version

v3.10+

## Quickstart

[中文手册](https://rexzhang.github.io/asgi-webdav/zh/)

```shell
docker pull ray1ex/asgi-webdav
docker run -dit --restart unless-stopped \
  -p 8000:8000 \
  -e UID=1000 -e GID=1000 \
  -v /your/data:/data \
  --name asgi-webdav ray1ex/asgi-webdav
```

## Default Account

|            | value      | description                     |
| ---------- | ---------- | ------------------------------- |
| username   | `username` | -                               |
| password   | `password` | -                               |
| permission | `["+"]`    | Allow access to all directories |

## View in Browser

![View in Browser](docs/web-dir-browser-screenshot.png)

## Documentation

[Documentation at GitHub Page](https://rexzhang.github.io/asgi-webdav/)

## TODO

- Digest auth support neon
- SQL database provider
- Test big(1GB+) file in MemoryProvider
- display server info in page `/_/admin` or `/_/`
- Fail2ban(docker)
- NFSProvider
- logout at the web page
- Fix MemoryProvider with macOS finder(create new file)
- rewrite MemoryProvider with mmap
- generate template URL for share(read only)

## Related Projects

- <https://github.com/bootrino/reactoxide>
