U
|
Þ=®d)% ã @ sF d Z ddlmZ ddlZddlZddlZddlZddlZ ddl
|
m
|
Z
|
ddl
|
m Z ddl m Z ddlmZ ddlmZ d d
|
lmZ d d lmZ d d lmZ d d lmZ d dlmZ d dlmZ e jg e j e j e e
|
e f f Z e je j!e" ge j e j!e" e j!e f f Z#e j$r4ddl%m&Z& ddl%m'Z' ddl%m(Z( G dd dZ)dS )z¤
|
Serve Shared Static Files
|
=========================
|
|
.. autoclass:: SharedDataMiddleware
|
:members: is_allowed
|
|
:copyright: 2007 Pallets
|
:license: BSD-3-Clause
|
é )Ú annotationsN)Údatetime)Útimezone)ÚBytesIO)Útime)Úadler32é )Ú http_date)Úis_resource_modified)Ú safe_join)Úget_content_type)Ú get_path_info)Ú wrap_file)Ú StartResponse)ÚWSGIApplication)ÚWSGIEnvironmentc @ s¤ e Zd ZdZd(dddd d
|
d dd d dZd d dddZd ddddZd ddddZd d ddddZd ddd d Z d d
|
d d d d d!Z
|
d"d#d$d%d&d'Z dS ))ÚSharedDataMiddlewareaé A WSGI middleware which provides static content for development
|
environments or simple server setups. Its usage is quite simple::
|
|
import os
|
from werkzeug.middleware.shared_data import SharedDataMiddleware
|
|
app = SharedDataMiddleware(app, {
|
'/shared': os.path.join(os.path.dirname(__file__), 'shared')
|
})
|
|
The contents of the folder ``./shared`` will now be available on
|
``http://example.com/shared/``. This is pretty useful during development
|
because a standalone media server is not required. Files can also be
|
mounted on the root folder and still continue to use the application because
|
the shared data middleware forwards all unhandled requests to the
|
application, even if the requests are below one of the shared folders.
|
|
If `pkg_resources` is available you can also tell the middleware to serve
|
files from package data::
|
|
app = SharedDataMiddleware(app, {
|
'/static': ('myapplication', 'static')
|
})
|
|
This will then serve the ``static`` folder in the `myapplication`
|
Python package.
|
|
The optional `disallow` parameter can be a list of :func:`~fnmatch.fnmatch`
|
rules for files that are not accessible from the web. If `cache` is set to
|
`False` no caching headers are sent.
|
|
Currently the middleware does not support non-ASCII filenames. If the
|
encoding on the file system happens to match the encoding of the URI it may
|
work but this could also be by accident. We strongly suggest using ASCII
|
only file names for static files.
|
|
The middleware will guess the mimetype using the Python `mimetype`
|
module. If it's unable to figure out the charset it will fall back
|
to `fallback_mimetype`.
|
|
:param app: the application to wrap. If you don't want to wrap an
|
application you can pass it :exc:`NotFound`.
|
:param exports: a list or dict of exported files and folders.
|
:param disallow: a list of :func:`~fnmatch.fnmatch` rules.
|
:param cache: enable or disable caching headers.
|
:param cache_timeout: the cache timeout in seconds for the headers.
|
:param fallback_mimetype: The fallback mimetype for unknown files.
|
|
.. versionchanged:: 1.0
|
The default ``fallback_mimetype`` is
|
``application/octet-stream``. If a filename looks like a text
|
mimetype, the ``utf-8`` charset is added to it.
|
|
.. versionadded:: 0.6
|
Added ``fallback_mimetype``.
|
|
.. versionchanged:: 0.5
|
Added ``cache_timeout``.
|
NTéÀ¨ úapplication/octet-streamr zPdict[str, str | tuple[str, str]] | t.Iterable[tuple[str, str | tuple[str, str]]]ÚNoneÚboolÚintÚstr)ÚappÚexportsÚdisallowÚcacheÚ cache_timeoutÚfallback_mimetypeÚreturnc
|
sÈ || _ g | _|| _|| _t|tr*| ¡ }|D ]j\}}t|trL| j| } n<t|t rzt
|
j |¡rn| |¡} q| |¡} ntd|| j || f¡ q. d k r¾ddlm fdd| _|| _d S )Nz unknown def r )Úfnmatchc s | S ©N© ©Úx©r r r" úVd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\werkzeug/middleware/shared_data.pyÚ<lambda> ó z/SharedDataMiddleware.__init__.<locals>.<lambda>)r r r r Ú
|
isinstanceÚdictÚitemsÚtupleÚget_package_loaderr ÚosÚpathÚisfileÚget_file_loaderÚget_directory_loaderÚ TypeErrorÚappendr Ú
|
is_allowedr )
|
Úselfr r r r r r ÚkeyÚvalueÚloaderr" r% r& Ú__init__f s&
|
|
|
z SharedDataMiddleware.__init__)Úfilenamer c C s dS )zµSubclasses can override this method to disallow the access to
|
certain files. However by providing `disallow` in the constructor
|
this method is overwritten.
|
Tr" ©r6 r; r" r" r& r5 s z SharedDataMiddleware.is_allowedÚ_TOpenerc s fddS )Nc s0 t dtjtj ¡tjdttj ¡fS )NÚrb©Útz)
|
Úopenr Ú fromtimestampr. r/ Úgetmtimer Úutcr Úgetsizer" ©r; r" r& r' s ýz.SharedDataMiddleware._opener.<locals>.<lambda>r" r< r" rF r& Ú_opener s z SharedDataMiddleware._openerÚ_TLoaderc s fddS )Nc s t j ¡ ¡fS r! )r. r/ ÚbasenamerG r# ©r; r6 r" r& r' r( z6SharedDataMiddleware.get_file_loader.<locals>.<lambda>r" r< r" rJ r& r1 s z$SharedDataMiddleware.get_file_loader)ÚpackageÚ package_pathr c s@ t tj¡ tj |¡}|j |¡ddd fdd }|S )Nú
|
str | Noneú"tuple[str | None, _TOpener | None]©r/ r c s~ | d kr dS t | } | d kr"dS t | ¡}z | ¡ W n tk
|
rP Y dS X t trn| fddfS | fddfS )N©NNc s t ¡ fS r! )ÚlenÚgetvaluer" )Ú load_timeÚresourcer" r& r' ¹ r( zISharedDataMiddleware.get_package_loader.<locals>.loader.<locals>.<lambda>c s* t jtj j¡tjdtj j¡fS )Nr? ) r rB r. r/ rC Únamer rD rE r" ©rT r" r& r' ¾ s ÿ û)r Ú posixpathrI Ú open_resourceÚOSErrorr) r )r/ rI ©rS rL ÚreaderrV r& r9 ¤ s"
|
|
|
þ
|
þz7SharedDataMiddleware.get_package_loader.<locals>.loader) r Únowr rD Ú importlibÚutilÚ find_specr9 Úget_resource_reader)r6 rK rL Úspecr9 r" rZ r& r- s
|
#z'SharedDataMiddleware.get_package_loader)Ú directoryr c s ddd fdd }|S )NrM rN rO c sJ | d k r t | } | d kr$dS n } tj | ¡rFtj | ¡ | ¡fS dS )NrP )r r. r/ r0 rI rG )r/ ©rb r6 r" r& r9 Ê s
|
z9SharedDataMiddleware.get_directory_loader.<locals>.loaderr" )r6 rb r9 r" rc r& r2 É s z)SharedDataMiddleware.get_directory_loaderr )ÚmtimeÚ file_sizeÚ real_filenamer c C s4 t |¡}| ¡ }t|d@ }d| d| d| S )Nl ÿÿ zwzsdm-ú-)r. ÚfsencodeÚ timestampr )r6 rd re rf ri Zchecksumr" r" r& Ú generate_etagÜ s
|
z"SharedDataMiddleware.generate_etagr r zt.Iterable[bytes])ÚenvironÚstart_responser c C s t |}d }| jD ]h\}}||kr:|d \}}|d k r: q|| d¡sL|d7 }| |¡r||t|d
\}}|d k r q|q|d ks| |¡s| ||¡S t |¡}t |d p²| j
|
d} | \}
|
} } dt fg} | j rP| j }| | | |¡}| dd| dfdd| d fg7 } t||| d
|
s6|
|
¡ |d | g S | d t t | f¡ n
|
| d ¡ | d| fdt| fdt | ff¡ |d| t||
|
S )Nú/r zutf-8ÚDateZEtagú"ú Cache-Controlzmax-age=z, public)Z last_modifiedz304 Not ModifiedZExpires)rp Úpublicz Content-TypezContent-Lengthz Last-Modifiedz200 OK)r r ÚendswithÚ
|
startswithrQ r5 r Ú mimetypesÚ
|
guess_typer r r r r rj r
|
Úcloser4 r Úextendr r )r6 rk rl r/ Z file_loaderÚ search_pathr9 rf Z guessed_typeZ mime_typeÚfrd re ÚheadersÚtimeoutÚetagr" r" r& Ú__call__â sP
|
|
|
þ
|
|
|
|
ýÿ
|
z SharedDataMiddleware.__call__)NTr r ) Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__r: r5 rG r1 r- r2 rj r} r" r" r" r& r ( s C ö (*r )*r Ú
|
__future__r Úimportlib.utilr] rt r. rW ÚtypingÚtr r Úior r Úzlibr Úhttpr r
|
Úsecurityr Úutilsr Zwsgir r ÚCallableÚTupleÚIOÚbytesr r= ÚOptionalr rH Ú TYPE_CHECKINGZ_typeshed.wsgir r r r r" r" r" r& Ú<module> s0
|
,
|
