o NK&hh@sddlmZddlmZddlmZddlmZmZm Z ddl m Z ddl m Z GdddeZGd d d eZGd d d eZGd ddeZGdddeZGdddeZeZeZGdddeZeZGdddeZeZGdddeZGdddeZGdddeZGdddeZGdd d eZGd!d"d"eZ Gd#d$d$eZ!Gd%d&d&eZ"e"Z#Gd'd(d(eZ$e$Z%Gd)d*d*eZ&Gd+d,d,e"Z'Gd-d.d.eZ(Gd/d0d0eZ)Gd1d2d2eZ*Gd3d4d4eZ+Gd5d6d6eZ,d7S)8)CancelledError)Sequence)PathLike)AnyOptionalUnion) STATUS_CODES)Rangec@eZdZdZdS)RequestCancelledTN)__name__ __module__ __qualname__quietrrC/var/www/html/venv/lib/python3.10/site-packages/sanic/exceptions.pyr r c@eZdZdZdZdS) ServerKilledz]Exception Sanic server uses when killing a server process for something unexpected happening.TN)r r r__doc__rrrrrrsrcseZdZUdZdZeed<dZee ed<iZ e e e fed<dZ e ed< dd d d d d deee efdeedee d ee e efd ee e efdee e e fd d ffddZZS)SanicExceptionapGeneric exception that will generate an HTTP response when raised in the context of a request lifecycle. Usually, it is best practice to use one of the more specific exceptions than this generic one. Even when trying to raise a 500, it is generally preferable to use `ServerError`. Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None`, then the appropriate HTTP response status message will be used instead. Defaults to `None`. status_code (Optional[int], optional): The HTTP response code to send, if applicable. If `None`, then it will be 500. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. Examples: ```python raise SanicException( "Something went wrong", status_code=999, context={ "info": "Some additional details to send to the client", }, headers={ "X-Foo": "bar" } ) ```  status_codeFrheadersmessageNrcontextextrarrrreturncs||_||_|pt|jdd}|dur|nt|jdd}|p$t|jdi}|dur;|j}|s:|r:t|d}|}n t|t rD|}t ||pN|j |_ ||_ ||_z||_WdStyfYdSw)Nrrr)rrgetattr __class__rrgetdecode isinstancebytessuper__init__rrrAttributeError)selfrrrrrrmsgr"rrr(=s6        zSanicException.__init__NN)r r rrrint__annotations__rrboolrdictstrrrr&rr( __classcell__rrr,rrs8  #  rcs~eZdZdZ d ddddddeeeefdeedee ee fdee ee fdee ee fd df fd d Z Z S) HTTPExceptionzDA base class for other exceptions and should not be called directly.Nrrrrrrrcstj|||||ddSNrr'r()r*rrrrrr,rrr(hs  zHTTPException.__init__N) r r rrrrr2r&r0r1rr(r3rrr,rr4es*r4c@eZdZdZdZdZdS)NotFoundaA base class for other exceptions and should not be called directly. Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None`, then the appropriate HTTP response status message will be used instead. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. iTNr r rrrrrrrrr9zr9c@r8) BadRequest\400 Bad Request Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Bad Request' will be sent. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. iTNr:rrrrr<r;r<cseZdZdZdZdZ   dddddddeeee fded ee ed ee d ee ee fd ee ee fd ee ee fffddZZS)MethodNotAllowedab405 Method Not Allowed Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Method Not Allowed' will be sent. Defaults to `None`. method (Optional[str], optional): The HTTP method that was used. Defaults to an empty string. allowed_methods (Optional[Sequence[str]], optional): The HTTP methods that can be used instead of the one that was attempted. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. iTNrrrmethodallowed_methodsrrrrcsDtj|||||d|ri|jdd|i|_||_||_dS)NrAllow, )r'r(rjoinr?r@)r*rr?r@rrrrr,rrr(s   zMethodNotAllowed.__init__)NrN)r r rrrrrrr2r&rr0r1rr(r3rrr,rr>s6  r>c@r) ServerErrora500 Internal Server Error A general server-side error has occurred. If no other HTTP exception is appropriate, then this should be used Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Bad Request' will be sent. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. rNr r rrrrrrrrDsrDc@r8)ServiceUnavailablea503 Service Unavailable The server is currently unavailable (because it is overloaded or down for maintenance). Generally, this is a temporary state. Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Bad Request' will be sent. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. iTNr:rrrrrFrFc@r) URLBuildErrora500 Internal Server Error An exception used by Sanic internals when unable to build a URL. Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Bad Request' will be sent. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. rNrErrrrrH srHcseZdZdZ   d ddddddeeeefdeedeedee dee ee fd ee ee fd ee ee fffd d Z Z S) FileNotFounda404 Not Found A specific form of :class:`.NotFound` that is specifically when looking for a file on the file system at a known path. Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Not Found' will be sent. Defaults to `None`. path (Optional[PathLike], optional): The path, if any, to the file that could not be found. Defaults to `None`. relative_url (Optional[str], optional): A relative URL of the file. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. Nrrpath relative_urlrrrrcs&tj|||||d||_||_dSr5)r'r(rJrK)r*rrJrKrrrrr,rrr(5s  zFileNotFound.__init__)NNN)r r rrrrr2r&rr0r1rr(r3rrr,rrIs2 rIc@r8)RequestTimeoutaX408 Request Timeout The Web server (running the Web site) thinks that there has been too long an interval of time between 1) the establishment of an IP connection (socket) between the client and the server and 2) the receipt of any data on that socket, so the server has dropped the connection. The socket connection has actually been lost - the Web server has 'timed out' on that particular socket connection. This is an internal exception thrown by Sanic and should not be used directly. Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Bad Request' will be sent. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. iTNr:rrrrrLKsrLc@r8)PayloadTooLargea413 Payload Too Large This is an internal exception thrown by Sanic and should not be used directly. Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Bad Request' will be sent. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. iTNr:rrrrrMirGrMc@r )HeaderNotFoundr=Nr r rrrrrrrNrrNc@r ) InvalidHeaderr=NrOrrrrrPrrPcseZdZdZdZdZ  dddddddeeee fdee dee d ee ee fd ee ee fd ee ee ff fd d ZZS)RangeNotSatisfiablea416 Range Not Satisfiable Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Range Not Satisfiable' will be sent. Defaults to `None`. content_range (Optional[ContentRange], optional): An object meeting the :class:`.ContentRange` protocol that has a `total` property. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. TNrr content_rangerrrrcsBtj|||||d|duri|jdd|ji|_dSdS)Nrz Content-Rangezbytes */)r'r(rtotal)r*rrSrrrrr,rrr(s   zRangeNotSatisfiable.__init__r-)r r rrrrrrr2r&r r0r1rr(r3rrr,rrQs0rQc@r8)ExpectationFailedac417 Expectation Failed Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Bad Request' will be sent. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. iTNr:rrrrrUr;rUc@r8) ForbiddenaZ403 Forbidden Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Bad Request' will be sent. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. iTNr:rrrrrVr;rVc@r8)InvalidRangeTypeaf416 Range Not Satisfiable Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Bad Request' will be sent. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. rRTNr:rrrrrWr;rWcsneZdZ d ddddddeedeedeeeefdeeeefdeeeeff fdd Z Z S) PyFileErrorNrrrrrrcs tjd||||||ddS)Nz could not execute config file %s)rrrrrr6)r*filerrrrrr,rrr(s  zPyFileError.__init__r7) r r rrr.r0r1r2rr(r3rrr,rrXs$rXcseZdZdZdZdZ  dddddddeeee fdeedee d ee ee fd ee ee fd ee ee ff fd d Z ZS) Unauthorizeda **Status**: 401 Unauthorized When present, additional keyword arguments may be used to complete the WWW-Authentication header. Args: message (Optional[Union[str, bytes]], optional): The message to be sent to the client. If `None` then the HTTP status 'Bad Request' will be sent. Defaults to `None`. scheme (Optional[str], optional): Name of the authentication scheme to be used. Defaults to `None`. quiet (Optional[bool], optional): When `True`, the error traceback will be suppressed from the logs. Defaults to `None`. context (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will be sent to the client upon exception. Defaults to `None`. extra (Optional[Dict[str, Any]], optional): Additional mapping of key/value data that will NOT be sent to the client when in PRODUCTION mode. Defaults to `None`. headers (Optional[Dict[str, Any]], optional): Additional headers that should be sent with the HTTP response. Defaults to `None`. **challenges (Dict[str, Any]): Additional keyword arguments that will be used to complete the WWW-Authentication header. Defaults to `None`. Examples: With a Basic auth-scheme, realm MUST be present: ```python raise Unauthorized( "Auth required.", scheme="Basic", realm="Restricted Area" ) ``` With a Digest auth-scheme, things are a bit more complicated: ```python raise Unauthorized( "Auth required.", scheme="Digest", realm="Restricted Area", qop="auth, auth-int", algorithm="MD5", nonce="abcdef", opaque="zyxwvu" ) ``` With a Bearer auth-scheme, realm is optional so you can write: ```python raise Unauthorized("Auth required.", scheme="Bearer") ``` or, if you want to specify the realm: ```python raise Unauthorized( "Auth required.", scheme="Bearer", realm="Restricted Area" ) ``` iTNrrschemerrrrc  sdtj|||||d|dur0dd|D}d|} i|jd|d| i|_dSdS)NrcSs g|] \}}|d|dqS)z=""r).0kvrrr zs z)Unauthorized.__init__..rBzWWW-Authenticate )r'r(itemsrCrrstrip) r*rr[rrrr challengesvalues challenger,rrr(es     zUnauthorized.__init__r-)r r rrrrrrr2r&r0r1rr(r3rrr,rrZ&s0;rZc@r )LoadFileExceptionz.Exception raised when a file cannot be loaded.NrOrrrrrgrrgc@r ) InvalidSignalz0Exception raised when an invalid signal is sent.NrOrrrrrhrrhc@r8)WebsocketClosedz,Exception raised when a websocket is closed.Tz*Client has closed the websocket connectionN)r r rrrrrrrrrisriN)-asynciorcollections.abcrosrtypingrrr sanic.helpersrsanic.models.protocol_typesr r Exceptionrrr4r9r< InvalidUsageBadURLr>MethodNotSupportedrDInternalServerErrorrFrHrIrLrMrNrPrQContentRangeErrorrUHeaderExpectationFailedrVrWrXrZrgrhrirrrrsH    Q1,-]