Static file handling for fresco
Project description
Basic usage
Installation:
pip install fresco-static # If you want brotli compression enabled pip install fresco-static[brotli]
Simple configuration:
from fresco import FrescoApp from fresco_static import serve_directory, serve_file app = FrescoApp() # Serve a directory app.route_all("/static", ALL=serve_directory("path/to/static/files")) # Serve a single file app.route("/favicon.ico"", ALL=serve_file("path/to/favicon.ico")) # Serve a directory that's part of a Python package app.route_all( "/static", ALL=serve_package_directory("mypackage", "static/files") )
Advanced options:
app = FrescoApp() app.route_all( "/static", ALL=serve_directory( "path/to/static/files", # Specify custom headers. These will be set for all files served. headers={"cache-control": "max-age 86400"}, # Compression algorithms to offer, in order of preference compression="brotli,gzip" # Directory to cache compressed copies of files. The same directory may # safely be shared between instances cachedir="/tmp/staticfilecache" ) )
App-wide usage
These instructions are for creating a single StaticFiles object that serves static requests across the entire application.
Create a fresco app:
app = FrescoApp()
Let’s assume this lives in an application that’s structured like this:
mypackage ├── __init__.rst ├── app.py ├── static │ └── photo.jpg └── setup.py
Once you have the app, you can create an instance of StaticFiles:
static = StaticFiles(app)
StaticFiles automatically adds routes for the path /static. Static files will be available under /static/<packagename>/<path> eg /static/mypackage/photo.jpg. You can change these defaults:
static = StaticFiles(app,
prefix='/media',
route_name='media',
cache_max_age=3600)
You can have multiple packages serving files through a single StaticFiles object without fear of conflict.
Now you can start configuring static source directories:
# Mount directory '/www/mysite/htdocs'. The first argument is an arbitrary
# name used to identify this source. You can use whatever string you like.
static.add_directory('site-htdocs', '/site/htdocs', cache_max_age=60)
# Serve files located in a 'subdir' directory within the python package
# 'mypackage'
static.add_package('mypackage', 'subdir', cache_max_age=86400)
The cache_max_age argument specifies for how long (in seconds) browsers and proxies can cache responses. For development you might want to set this to zero, but in production use you should set this to a reasonable value and configure a caching HTTP proxy server. When adding source directories you can omit this argument, and the default (configured when you created the StaticFiles object) will be used instead.
static.pathfor generates URLs for static content. You will probably want to include this in your templating system’s default namespace. How you do that depends on how you’ve integrated the templating system, but it would typically be something like this:
templating.contextprocessor({'static': static.pathfor})
Call this in templates to link to static files, eg:
<!-- Reference a file from the "site-htdocs" source
-->
<img src="{{ static('site-htdocs/photo.jpg') }}" alt="My photo" />
<!-- Reference a file from the "mypackage" source
-->
<img src="{{ static('mypackage/photo.jpg') }}" alt="My photo" />
<!-- Path doesn't begin with a source name — all sources will be
searched for a matching file
-->
<img src="{{ static('cat-pictures/miaow.gif') }}" alt="My photo" />
0.5 (released 2024-10-16)
Added serve_package_directory function
Improved support for HEAD requests
0.4 (released 2024-07-11)
Added view-based integration
0.3 (released 2024-05-02)
Added Python 3.12 support
Dropped support for Python 3.8 and older
0.2 (released 2018-08-01)
Source names are no longer required to be python identifiers
0.1
Initial release
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for fresco_static-0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 475395e8be8b3d4e311a8cd9c69c5f6e26bc8b03b9c23d17ae4f8de1e32eaf79 |
|
MD5 | 72692d61ee993c6e3109955c23bf3afc |
|
BLAKE2b-256 | 8544840379727eff22f55d6ee0de254ee950adc44cb2e82892ca176251597c98 |