Using ServeStatic with ASGI apps¶

To enable ServeStatic you need to wrap your existing ASGI application in a ServeStaticASGI instance and tell it where to find your static files. For example:

1
2
3
4
5
6
7

from servestatic import ServeStaticASGI

from my_project import MyASGIApp

application = MyASGIApp()
application = ServeStaticASGI(application, root="/path/to/static/files")
application.add_files("/path/to/more/static/files", prefix="more-files/")

Alternatively, you can use ServeStatic as a standalone file server by not providing a WSGI app. For example:

1
2
3

from servestatic import ServeStaticASGI

application = ServeStaticASGI(None, root="/path/to/static/files")

On initialization, ServeStatic walks over all the files in the directories that have been added (descending into sub-directories) and builds a list of available static files. Any requests which match a static file get served by ServeStatic, all others are passed through to the original application.

After configuring ServeStatic, you can use your favourite ASGI server (such as uvicorn or hypercorn) to run your application.

uvicorn my_project:application

See the API reference documentation for detailed usage and features.