Using ServeStatic with ASGI apps¶

To enable ServeStatic you need to wrap your existing ASGI application in a ServeStatic 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/")

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.

See the API reference documentation for detailed usage and features.