o NK&h66 @sddlmZddlmZmZddlmZmZddlmZddl m Z ddl m Z ddl m Z ddlmZmZmZmZmZdd lmZdd lmZmZmZdd lmZdd lmZmZdd lm Z ddl!m"Z"m#Z#ddl$m%Z%m&Z&m'Z' dSdTddZ(    dUdVd%d&Z)   'dWdXd(d)Z*ddefdYd+d,Z+  dZd[d.d/Z,d\d5d6Z-ddd7dddedddf d]dGdHZ.  I Jd^d_dLdMZ/  N    d`dadQdRZ0dS)b) annotations)datetimetimezone) formatdateparsedate_to_datetime) guess_type)path)PurePath)time)AnyAnyStrCallableOptionalUnion) quote_plus)Header open_async stat_async)DEFAULT_HTTP_CONTENT_TYPE)Default_default)logger) HTMLProtocolRange) HTTPResponse JSONResponseResponseStreamNstatusintheadersOptional[dict[str, str]]returnrcCstd||dS)aReturns an empty response to the client. Args: status (int, optional): HTTP response code. Defaults to `204`. headers ([type], optional): Custom HTTP headers. Defaults to `None`. Returns: HTTPResponse: An empty response to the client. bodyrr!r)rr!r(M/var/www/html/venv/lib/python3.10/site-packages/sanic/response/convenience.pyemptys r*application/jsonr&r content_typestrdumpsOptional[Callable[..., AnyStr]]kwargsrcKst|f||||d|S)aReturns response object with body in json format. Args: body (Any): Response data to be serialized. status (int, optional): HTTP response code. Defaults to `200`. headers (Dict[str, str], optional): Custom HTTP headers. Defaults to `None`. content_type (str, optional): The content type (string) of the response. Defaults to `"application/json"`. dumps (Callable[..., AnyStr], optional): A custom json dumps function. Defaults to `None`. **kwargs (Any): Remaining arguments that are passed to the json encoder. Returns: JSONResponse: A response object with body in json format. )rr!r-r/)r)r&rr!r-r/r1r(r(r)json$sr2text/plain; charset=utf-8cCs0t|tstdt|jdt||||dS)a Returns response object with body in text format. Args: body (str): Response data. status (int, optional): HTTP response code. Defaults to `200`. headers (Dict[str, str], optional): Custom HTTP headers. Defaults to `None`. content_type (str, optional): The content type (string) of the response. Defaults to `"text/plain; charset=utf-8"`. Returns: HTTPResponse: A response object with body in text format. Raises: TypeError: If the body is not a string. z!Bad body type. Expected str, got )rr!r-) isinstancer. TypeErrortype__name__rr&rr!r-r(r(r)textCs r;Optional[AnyStr]cCst||||dS)aReturns response object without encoding the body. Args: body (Optional[AnyStr]): Response data. status (int, optional): HTTP response code. Defaults to `200`. headers (Dict[str, str], optional): Custom HTTP headers. Defaults to `None`. content_type (str, optional): The content type (string) of the response. Defaults to `"application/octet-stream"`. Returns: HTTPResponse: A response object without encoding the body. r:r'r:r(r(r)rawas r=Union[str, bytes, HTMLProtocol]cCsDt|ttfst|dr|}n t|dr|}t|||ddS)aReturns response object with body in html format. Body should be a `str` or `bytes` like object, or an object with `__html__` or `_repr_html_`. Args: body (Union[str, bytes, HTMLProtocol]): Response data. status (int, optional): HTTP response code. Defaults to `200`. headers (Dict[str, str], optional): Custom HTTP headers. Defaults to `None`. Returns: HTTPResponse: A response object with body in html format. __html__ _repr_html_text/html; charset=utf-8r5)r6r.byteshasattrr?r@rr%r(r(r)htmlzs   rDrequest_headersr last_modifiedUnion[datetime, float, int]Optional[HTTPResponse]c sz|d}Wn tyYdSwzt|}Wnttfy+td|YdSwt|ts?tj t |t j dj dd}|durX|durXtd|j t j dn|durp|durptd |j t j d||kr}td d SdS) a=Validate file based on request headers. Args: request_headers (Header): The request headers. last_modified (Union[datetime, float, int]): The last modified date and time of the file. Returns: Optional[HTTPResponse]: A response object with status 304 if the file is not modified. zIf-Modified-SinceNz9Ignorning invalid If-Modified-Since header received: '%s')tzr microsecondzpCannot compare tz-aware and tz-naive datetimes. To avoid this conflict Sanic is converting last_modified to UTC.)tzinfoztCannot compare tz-aware and tz-naive datetimes. To avoid this conflict Sanic is converting if_modified_since to UTC.i0)r)getoneKeyErrorrr7 ValueErrorrwarningr6r fromtimestampfloatrutcreplace utcoffset timestampr)rErFif_modified_sincer(r(r) validate_filesH          rXTlocationUnion[str, PurePath]Optional[Header]validate_when_requestedbool mime_type Optional[str]filename.Optional[Union[datetime, float, int, Default]]max_ageOptional[Union[float, int]]no_storeOptional[bool]_rangeOptional[Range]c  st|tr|jdd}nt|trt|IdH} | j}|r2|dur2|r2t||IdH} | r2| S|p5i}|rB|dt |dd|rN|dd|d | rSd } n|rhd |} |d t t |ddnd } |d| |pxt |d}t |ddIdH4IdH9}| r|| jIdH|| jIdH}d| jd| jd| j|d<d}n|IdH}WdIdHn 1IdHswY|pt|dpd}t||||dS)asReturn a response object with file data. Args: location (Union[str, PurePath]): Location of file on system. status (int, optional): HTTP response code. Won't enforce the passed in status if only a part of the content will be sent (206) or file is being validated (304). Defaults to 200. request_headers (Optional[Header], optional): The request headers. validate_when_requested (bool, optional): If `True`, will validate the file when requested. Defaults to True. mime_type (Optional[str], optional): Specific mime_type. headers (Optional[Dict[str, str]], optional): Custom Headers. filename (Optional[str], optional): Override filename. last_modified (Optional[Union[datetime, float, int, Default]], optional): The last modified date and time of the file. max_age (Optional[Union[float, int]], optional): Max age for cache control. no_store (Optional[bool], optional): Any cache should not store this response. Defaults to None. _range (Optional[Range], optional): Returns: HTTPResponse: The response object with the file data. rrJNz Last-ModifiedT)usegmtContent-Dispositionattachment; filename=""zno-storezpublic, max-age=expireszno-cachez cache-controlrbmodebytes -/ Content-Range text/plainr:)r6rrTrVrrst_mtimerX setdefaultrr rsplitrseekstartreadsizeendtotalrr)rYrrEr\r^r!r`rFrbrdrfstatresponse cache_controlf out_streamr(r(r)filesj      ( r.rAtocCs*|pi}t|dd}||d<t|||dS)a;Cause a HTTP redirect (302 by default) by setting a Location header. Args: to (str): path or fully qualified URL to redirect to headers (Optional[Dict[str, str]], optional): optional dict of headers to include in the new request. Defaults to None. status (int, optional): status code (int) of the new request, defaults to 302. Defaults to 302. content_type (str, optional): the content type (string) of the response. Defaults to "text/html; charset=utf-8". Returns: HTTPResponse: A response object with the redirect. z:/%#?&=@[]!$&'()*+,;)safeLocationr5)rr)rr!rr-safe_tor(r(r)redirect.s  r chunk_sizerc s|pi}|r|dd|d|ptd}|p#t|dp#d}r>j}j}j} d|d|d | |d <d }fd d } t| |||dS)aReturn a streaming response object with file data. :param location: Location of file on system. :param chunk_size: The size of each chunk in the stream (in bytes) :param mime_type: Specific mime_type. :param headers: Custom Headers. :param filename: Override filename. :param _range: Args: location (Union[str, PurePath]): Location of file on system. status (int, optional): HTTP response code. Won't enforce the passed in status if only a part of the content will be sent (206) or file is being validated (304). Defaults to `200`. chunk_size (int, optional): The size of each chunk in the stream (in bytes). Defaults to `4096`. mime_type (Optional[str], optional): Specific mime_type. headers (Optional[Dict[str, str]], optional): Custom HTTP headers. filename (Optional[str], optional): Override filename. _range (Optional[Range], optional): The range of bytes to send. rirjrkrmrrvrqrrrsrtruc stddIdH4IdH^}rH|jIdHj}|dkrG|tjfIdH}t|dkr5n|t|8}||IdH|dks!n |IdH}t|dkrXn ||IdHqIWdIdHdS1IdHsrwYdS)Nrnrorr)rrzr{r}r|minlenwrite)rrto_sendcontentrfrrYr(r) _streaming_fnvs(   .z"file_stream.._streaming_fn) streaming_fnrr!r-)rxrryrr{r~rr) rYrrr^r!r`rfr{r~rrr(rr) file_streamLs* r)rN)rr r!r"r#r)r+Nr,N)r&r rr r!r"r-r.r/r0r1r r#r)r+Nr3) r&r.rr r!r"r-r.r#r) r&r<rr r!r"r-r.r#r)r+N)r&r>rr r!r"r#r)rErrFrGr#rH)rYrZrr rEr[r\r]r^r_r!r"r`r_rFrarbrcrdrerfrgr#r)NrrA) rr.r!r"rr r-r.r#r)r+rNNNN)rYrZrr rr r^r_r!r"r`r_rfrgr#r)1 __future__rrr email.utilsrr mimetypesrosrpathlibr r typingr r r rr urllib.parser sanic.compatrrrsanic.constantsr sanic.helpersrr sanic.logrsanic.models.protocol_typesrrtypesrrrr*r2r;r=rDrXrrrr(r(r(r)sp          !    7 b