ASGI Middleware for serving static file.
ASGIMiddlewareStaticFile is a solution when we need to distribute the whole project with static files in Docker; or when the deployment environment has very limited resources; or Internal network(Unable to reach CDN).
- Standard ASGI middleware implement
- Async file IO
- Support ETag, base on md5(file_size + last_modified)
pip3 install -U ASGIMiddlewareStaticFilegit clone https://github.com/rexzhang/asgi-middleware-static-file.git
cd asgi-middleware-static-file/example(venv) ➜ example git:(main) ✗ wget http://127.0.0.1:8000/static/DEMO
--2022-02-10 16:02:07-- http://127.0.0.1:8000/static/DEMO
正在连接 127.0.0.1:8000... 已连接。
已发出 HTTP 请求，正在等待回应... 200 OK
长度：26 []
正在保存至: “DEMO”
DEMO 100%[===========================================================================>] 26 --.-KB/s 用时 0s
2022-02-10 16:02:08 (529 KB/s) - 已保存 “DEMO” [26/26])
(venv) ➜ example git:(main) ✗ uvicorn example_pure_asgi:app
INFO: Started server process [7965]
INFO: Waiting for application startup.
INFO: ASGI 'lifespan' protocol appears unsupported.
INFO: Application startup complete.
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO: 127.0.0.1:54529 - "GET /static/DEMO HTTP/1.1" 200 OK
Django 3.0+
(venv) ➜ example git:(main) cd example_django
(venv) ➜ example_django git:(main) ✗ python manage.py collectstatic
129 static files copied to '/Users/rex/p/asgi-middleware-static-file/example/example_django/staticfiles'.
(venv) ➜ example_django git:(main) ✗ uvicorn example_django.asgi:application
INFO: Started server process [9107]
INFO: Waiting for application startup.
INFO: ASGI 'lifespan' protocol appears unsupported.
INFO: Application startup complete.
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO: 127.0.0.1:61925 - "GET /static/DEMO.txt HTTP/1.1" 200 OK
Quart (Flask like)
(venv) ➜ example git:(main) ✗ uvicorn example_quart:app
INFO: Started server process [7989]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO: 127.0.0.1:56191 - "GET / HTTP/1.1" 200 OK
INFO: 127.0.0.1:56212 - "GET /static/DEMO HTTP/1.1" 200 OK
WSGI app eg: Flask, Django on WSGI mode
(venv) ➜ example git:(main) ✗ uvicorn example_wsgi_app:app
INFO: Started server process [8020]
INFO: Waiting for application startup.
INFO: ASGI 'lifespan' protocol appears unsupported.
INFO: Application startup complete.
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO: 127.0.0.1:63924 - "GET /static/DEMO HTTP/1.1" 200 OK
- Update aiofiles to 23.1.0
- Use more async API
- Use more aiofiles api
- Dropped Python 3.6 support. If you require it, use version 0.4.0
- Update package for pep517/pep621
- Rewrite some code
- Fix bug #3(Cannot serve files from root (static_url="/" becomes "//"))
- Maintenance release
- Drop Py35
- Compatible Py37-
- Check cross border access
- Add more type hints
- Fix bug
- Update for aiofiles
- Fix bug
- First release
-
ASGI Middleware
- django.contrib.staticfiles.handlers.ASGIStaticFilesHandler
-
WSGI Middleware
-
View
- starlette.staticfiles.StaticFiles
- zero copy
- file extension filter,
- Cache Control
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
![pre-commit-ci[bot] avatar](https://avatars.githubusercontent.com/in/68672?v=4 "pre-commit-ci[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent