o NK&h9@s>ddlmZddlmZddlmZmZddlmZddl m Z m Z ddl m Z mZddlmZmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZmZmZddl m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-m.Z.m/Z/m0Z0Gddde'edZ1GdddedZ2dS))Sequence) formatdate)partialwraps) guess_type)PathLikepath)PathPurePath)OptionalUnion)unquote)Route) SanicMeta) stat_async)DEFAULT_HTTP_CONTENT_TYPE) FileNotFoundHeaderNotFoundRangeNotSatisfiable)ContentRangeHandler)DirectoryHandler) error_logger) BaseMixin) FutureStatic)Request) HTTPResponsefile file_stream validate_filec @seZdZdddZdedefddZ        dd ed ee efd ede de dee e fdede ede e de ede de ede eee efde de efddZdS) StaticMixinreturnNcOs t|_dSN)set_future_statics)selfargskwargsr'F/var/www/html/venv/lib/python3.10/site-packages/sanic/mixins/static.py__init__s zStaticMixin.__init__staticcCstr!)NotImplementedErrorr$r*r'r'r( _apply_staticszStaticMixin._apply_static/?.+TFurifile_or_directorypatternuse_modified_sinceuse_content_rangestream_large_filesnamehoststrict_slashes content_typeapply resource_typeindexdirectory_viewdirectory_handlerc Cs||}| dur|jdur|j} t|tttfs td|zt|}Wn t y3t dw|r>|s:| r>td|sHt |||| d}t ||||||||| | | | }|j || rf||dSdS)a$ Register a root to serve files from. The input can either be a file or a directory. This method provides an easy and simple way to set up the route necessary to serve static files. Args: uri (str): URL path to be used for serving static content. file_or_directory (Union[PathLike, str]): Path to the static file or directory with static files. pattern (str, optional): Regex pattern identifying the valid static files. Defaults to `r"/?.+"`. use_modified_since (bool, optional): If true, send file modified time, and return not modified if the browser's matches the server's. Defaults to `True`. use_content_range (bool, optional): If true, process header for range requests and sends the file part that is requested. Defaults to `False`. stream_large_files (Union[bool, int], optional): If `True`, use the `StreamingHTTPResponse.file_stream` handler rather than the `HTTPResponse.file handler` to send the file. If this is an integer, it represents the threshold size to switch to `StreamingHTTPResponse.file_stream`. Defaults to `False`, which means that the response will not be streamed. name (str, optional): User-defined name used for url_for. Defaults to `"static"`. host (Optional[str], optional): Host IP or FQDN for the service to use. strict_slashes (Optional[bool], optional): Instruct Sanic to check if the request URLs need to terminate with a slash. content_type (Optional[str], optional): User-defined content type for header. apply (bool, optional): If true, will register the route immediately. Defaults to `True`. resource_type (Optional[str], optional): Explicitly declare a resource to be a `"file"` or a `"dir"`. index (Optional[Union[str, Sequence[str]]], optional): When exposing against a directory, index is the name that will be served as the default file. When multiple file names are passed, then they will be tried in order. directory_view (bool, optional): Whether to fallback to showing the directory viewer when exposing a directory. Defaults to `False`. directory_handler (Optional[DirectoryHandler], optional): An instance of DirectoryHandler that can be used for explicitly controlling and subclassing the behavior of the default directory handler. Returns: List[sanic.router.Route]: Routes registered on the router. Examples: Serving a single file: ```python app.static('/foo', 'path/to/static/file.txt') ``` Serving all files from a directory: ```python app.static('/static', 'path/to/static/directory') ``` Serving large files with a specific threshold: ```python app.static('/static', 'path/to/large/files', stream_large_files=1000000) ``` Nz'Static route must be a valid path, not z=Static file or directory must be a path-like object or stringzWhen explicitly setting directory_handler, you cannot set either directory_view or index. Instead, pass these arguments to your DirectoryHandler instance.)r/ directoryr<r;) generate_namer7 isinstancestrbytesr ValueErrorr resolve TypeErrorrrr#addr-)r$r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r*r'r'r(r* sV T   zStaticMixin.static)r N) r.TFFr*NNNTNNFN)__name__ __module__ __qualname__r)rrr-rAr rboolintr rrr*r'r'r'r(rs^        r) metaclassc@sveZdZdedefddZdefddZdddd ed ed e d e d e e e fde de ede efddZddZdS)StaticHandleMixinr*r cCs ||Sr!)_register_staticr,r'r'r(r-s zStaticHandleMixin._apply_staticc CsJt|jtrt|jd}nt|jtr|j}nt|jtr%t|j}ntd|j}|j }|j sAt |s@| d}|d7}n7|j dkr]t |rStd|d| d}|d7}n|j dkrot |sotd |d|j dkrxtd t|jt|jt||j|j|j|j|jd }|j|d d g||j|jdd|\}}|S)z Register a static directory handler with Sanic by adding a route to the router and registering a handler. zutf-8zInvalid file path string./z/<__file_uri__:path>dirz3Resource type improperly identified as directory. ''rz.Resource type improperly identified as file. 'z2The resource_type should be set to 'file' or 'dir')r0r2r3r4r8r=GETHEADT)r/methodsr5r6r7r*)r@r0rBr decoder rArCr/r5r:risfilerstriprEr_static_request_handlerrr2r3r4r8r=router6r7)r$r*r0r/r5_handlerrY_r'r'r(rNsr             z"StaticHandleMixin._register_staticN)r8 __file_uri__requestr0r2r3r4r=r8r\c stdt||d} |||| IdH} zi} d} |r;t| IdH} | j} t|j| IdH}|r3|WSt| dd| d<d}|rtd}| sJt| IdH} d| d<t| j | d<|j d krtzt || }Wn t yjYn w| d=| |jd | vr|pt| d pt}d |vr|d s|dkr|d7}|| d<|j d krt| dWS|rt|trd}n|}| st| IdH} | j |krt| | |dIdHWSt| | |dIdHWSttfy|||jIdHYStyty| tytd|d|w)NzFile not found)r relative_urlT)usegmtz Last-ModifiedrBz Accept-RangeszContent-LengthrSz content-typerzcharset=ztext/zapplication/javascriptz; charset=utf-8z Content-Type)headersi)r`_rangez*Exception in static request handler: path=, relative_url=)rr _get_file_pathrst_mtimerr`rrAst_sizemethodrrupdaterr startswithrr@rJrrIsADirectoryErrorPermissionErrorhandlerrFileNotFoundError Exceptionr exception)r$r]r0r2r3r4r=r8r\ not_found file_pathr`statsmodified_sinceresponsera thresholdr'r'r(rXs             z)StaticHandleMixin._static_request_handlerc stt|}|}}|r9t|d}t||}|}||kr'|r,d|jvr9td|d||z||W|St y\|sYtd|d||Y|Sw)NrOz..zFile not found: path=rb) r r rDlstrip is_symlinkpartsrrn relative_torC)r$r0r\ro file_path_raw root_pathrpunquoted_file_urir'r'r(rc[s:      z StaticHandleMixin._get_file_path)rGrHrIrrr-rNrrArJr rKrr rXrcr'r'r'r(rMs2 V   brMN)3collections.abcr email.utilsr functoolsrr mimetypesrosrrpathlibr r typingr r urllib.parser sanic_routing.routersanic.base.metar sanic.compatrsanic.constantsrsanic.exceptionsrrrsanic.handlersrsanic.handlers.directoryr sanic.logrsanic.mixins.basersanic.models.futuresr sanic.requestrsanic.responserrrrrrMr'r'r'r(s.