o ñ;—iÃ(ã@sädZddlZddlZddlmZmZddlZddlZej j Z Gdd„de ƒZ Gdd„dej ƒZGdd „d e eƒZGd d „d e eƒZGd d „d e eƒZGdd„de eƒZGdd„deeƒZGdd„de eƒZGdd„de eƒZGdd„de eƒZGdd„de eƒZGdd„de eƒZGdd„de eƒZGdd„de ƒZGd d!„d!e ƒZGd"d#„d#eƒZGd$d%„d%eƒZGd&d'„d'e ƒZGd(d)„d)eƒZGd*d+„d+eƒZ Gd,d-„d-eƒZ!Gd.d/„d/eƒZ"Gd0d1„d1eƒZ#Gd2d3„d3e ƒZ$Gd4d5„d5e ƒZ%Gd6d7„d7e ƒZ&Gd8d9„d9e ƒZ'Gd:d;„d;e ƒZ(Gdd?„d?e*ƒZ+Gd@dA„dAe*ƒZ,GdBdC„dCe*ƒZ-GdDdE„dEe*ƒZ.GdFdG„dGe ƒZ/GdHdI„dIe ƒZ0dJdK„Z1dXdLe2dMe2fdNdO„Z3GdPdQ„dQe4ƒZ5GdRdS„dSe ƒZ6GdTdU„dUe ƒZ7GdVdW„dWe ƒZ8dS)Ya© Modal-specific exception types. ## Notes on `grpclib.GRPCError` migration Historically, the Modal SDK could propagate `grpclib.GRPCError` exceptions out to user code. As of v1.3, we are in the process of gracefully migrating to always raising a Modal exception type in these cases. To avoid breaking user code that relies on catching `grpclib.GRPCError`, a subset of Modal exception types temporarily inherit from `grpclib.GRPCError`. We encourage users to migrate any code that currently catches `grpclib.GRPCError` to instead catch the appropriate Modal exception type. The following mapping between GRPCError status codes and Modal exception types is currently in use: ``` CANCELLED -> ServiceError UNKNOWN -> ServiceError INVALID_ARGUMENT -> InvalidError DEADLINE_EXCEEDED -> ServiceError NOT_FOUND -> NotFoundError ALREADY_EXISTS -> AlreadyExistsError PERMISSION_DENIED -> PermissionDeniedError RESOURCE_EXHAUSTED -> ResourceExhaustedError FAILED_PRECONDITION -> ConflictError ABORTED -> ConflictError OUT_OF_RANGE -> InvalidError UNIMPLEMENTED -> UnimplementedError INTERNAL -> InternalError UNAVAILABLE -> ServiceError DATA_LOSS -> DataLossError UNAUTHENTICATED -> AuthError ``` éN)ÚAnyÚOptionalc@óeZdZdZdS)ÚErrorah Base class for all Modal errors. See [`modal.exception`](https://modal.com/docs/reference/modal.exception) for the specialized error classes. **Usage** ```python notest import modal try: ... except modal.Error: # Catch any exception raised by Modal's systems. print("Responding to error...") ``` N©Ú__name__Ú __module__Ú __qualname__Ú__doc__©r r úC/home/ubuntu/.local/lib/python3.10/site-packages/modal/exception.pyr0órc@sÚeZdZUdZeed<ejed<eed<dde efdd„Z d efd d „Z dd d „Z e d efdd„ƒZejded dfdd„ƒZe d ejfdd„ƒZejdejd dfdd„ƒZe d efdd„ƒZejded dfdd„ƒZdS)Ú_GRPCErrorWrappera÷This transitional class helps us migrate away from propagating `grpclib.GRPCError` to users. It serves two purposes: - It avoids abruptly breaking user code that catches `grpclib.GRPCError` - It actively warns when users access attributes defined by `grpclib.GRPCError` This won't catch all cases (users might react indiscriminately to GRPCError without checking the status). The mapping between GRPCError status codes and our error types is defined in `modal._grpc_client`. Ú _grpc_messageÚ _grpc_statusÚ _grpc_detailsNÚmessagecCs|pd|_dS)NÚ)Ú_message)Úselfrr r r Ú__init__Usz_GRPCErrorWrapper.__init__ÚreturncCst|ƒj›d|j›dS)Nú(ú))Útyperr©rr r r Ú__repr__Zsz_GRPCErrorWrapper.__repr__cCs0ddlm}t|ƒj}|dd|›ddddS)Né)Údeprecation_warning)iéé é z}Modal will stop propagating the `grpclib.GRPCError` type in the future. Update your code so that it catches `modal.exception.zE` directly to avoid changes to error handling behavior in the future.T)Úpending)Ú_utils.deprecationrrr)rrÚexc_typer r r Ú$_warn_on_grpc_error_attribute_access]s  ÿ ûz6_GRPCErrorWrapper._warn_on_grpc_error_attribute_accesscCó| ¡|jS©N)r$rrr r r rióz_GRPCErrorWrapper.messageÚvaluecCó ||_dSr&)r©rr(r r r rnó cCr%r&)r$rrr r r Ústatusrr'z_GRPCErrorWrapper.statuscCr)r&)rr*r r r r,wr+cCr%r&)r$rrr r r Údetails{r'z_GRPCErrorWrapper.detailscCr)r&)rr*r r r r-€r+r&)rN)rrr r ÚstrÚ__annotations__ÚgrpclibÚStatusrrrrr$ÚpropertyrÚsetterr,r-r r r r rCs(    rc@r)ÚAlreadyExistsErrorzDRaised when a resource creation conflicts with an existing resource.Nrr r r r r4…r r4c@r)Ú AuthErrorz;Raised when a client has missing or invalid authentication.Nrr r r r r5‰r r5c@r)Ú InternalErrorz9Raised when an internal error occurs in the Modal system.Nrr r r r r6r r6c@r)Ú InvalidErrorz(Raised when user does something invalid.Nrr r r r r7‘r r7c@r)Ú ConflictErrorzTRaised when a resource conflict occurs between the request and current system state.Nrr r r r r8•r r8c@r)Ú DataLossErrorz&Raised when data is lost or corrupted.Nrr r r r r9™r r9c@r)Ú NotFoundErrorz/Raised when a requested resource was not found.Nrr r r r r:r r:c@r)ÚPermissionDeniedErrorzORaised when a user does not have permission to perform the requested operation.Nrr r r r r;¡r r;c@r)ÚResourceExhaustedErrorzRRaised when a server-side resource has been exhausted, e.g. a quota or rate limit.Nrr r r r r<¥r r<c@r)Ú ServiceErrorzARaised when an error occurs in basic client/server communication.Nrr r r r r=©r r=c@r)ÚUnimplementedErrorzFRaised when a requested operation is not implemented or not supported.Nrr r r r r>­r r>c@r)Ú RemoteErrorz0Raised when an error occurs on the Modal server.Nrr r r r r?±r r?c@r)Ú TimeoutErrorzBase class for Modal timeouts.Nrr r r r r@µr r@c@r)ÚSandboxTimeoutErrorzIRaised when a Sandbox exceeds its execution duration limit and times out.Nrr r r r rA¹r rAc@r)ÚExecTimeoutErrorzSRaised when a container process exceeds its execution duration limit and times out.Nrr r r r rB½r rBc@r)ÚSandboxTerminatedErrorz;Raised when a Sandbox is terminated for an internal reason.Nrr r r r rCÁr rCc@r)ÚFunctionTimeoutErrorzJRaised when a Function exceeds its execution duration limit and times out.Nrr r r r rDÅr rDc@r)ÚMountUploadTimeoutErrorz%Raised when a Mount upload times out.Nrr r r r rEÉr rEc@r)ÚVolumeUploadTimeoutErrorz&Raised when a Volume upload times out.Nrr r r r rFÍr rFc@r)ÚInteractiveTimeoutErrorzRRaised when interactive frontends time out while trying to connect to a container.Nrr r r r rGÑr rGc@r)ÚOutputExpiredErrorz8Raised when the Output exceeds expiration and times out.Nrr r r r rHÕr rHc@r)ÚConnectionErrorzBRaised when an issue occurs while connecting to the Modal servers.Nrr r r r rIÙr rIc@r)Ú VersionErrorz?Raised when the current client version of Modal is unsupported.Nrr r r r rJÝr rJc@r)ÚExecutionErrorz9Raised when something unexpected happened during runtime.Nrr r r r rKár rKc@r)ÚDeserializationErrorzSRaised to provide more context when an error is encountered during deserialization.Nrr r r r rLår rLc@r)ÚSerializationErrorzQRaised to provide more context when an error is encountered during serialization.Nrr r r r rMér rMc@r)ÚRequestSizeErrorzdRaised when an operation produces a gRPC request that is rejected by the server for being too large.Nrr r r r rNír rNc@r)ÚDeprecationErrorzLUserWarning category emitted when a deprecated Modal feature or API is used.Nrr r r r rOñr rOc@r)ÚPendingDeprecationErrorzWSoon to be deprecated feature. Only used intermittently because of multi-repo concerns.Nrr r r r rP÷r rPc@r)Ú ServerWarningzGWarning originating from the Modal server and re-issued in client code.Nrr r r r rQûr rQc@r)ÚAsyncUsageWarningzLWarning emitted when a blocking Modal interface is used in an async context.Nrr r r r rRÿr rRc@r)ÚInternalFailurezRetriable internal error.Nrr r r r rSr rSc@seZdZdZdefdd„ZdS)Ú_CliUserExecutionErroraAmdmd:hidden Private wrapper for exceptions during when importing or running Apps from the CLI. This intentionally does not inherit from `modal.exception.Error` because it is a private type that should never bubble up to users. Exceptions raised in the CLI at this stage will have tracebacks printed. Ú user_sourcecCr)r&)rU)rrUr r r rs z_CliUserExecutionError.__init__N)rrr r r.rr r r r rTsrTcCst d¡tdƒ‚)Néz1Simulated preemption interrupt from modal-client!)ÚsignalÚalarmÚKeyboardInterrupt)ÚsignumÚframer r r Ú_simulate_preemption_interrupts r\Ú wait_secondsÚjitter_secondscCsD|dkrtdƒ‚t tjt¡|rt d|¡nd}t ||¡dS)a× Utility for simulating a preemption interrupt after `wait_seconds` seconds. The first interrupt is the SIGINT signal. After 30 seconds, a second interrupt will trigger. This second interrupt simulates SIGKILL, and should not be caught. Optionally add between zero and `jitter_seconds` seconds of additional waiting before first interrupt. **Usage:** ```python notest import time from modal.exception import simulate_preemption simulate_preemption(3) try: time.sleep(4) except KeyboardInterrupt: print("got preempted") # Handle interrupt raise ``` See https://modal.com/docs/guide/preemption for more details on preemption handling. rz#Time to wait must be greater than 0N)Ú ValueErrorrWÚSIGALRMr\ÚrandomÚ randrangerX)r]r^Újitterr r r Úsimulate_preemptions rdc@r)ÚInputCancellationzóRaised when the current input is cancelled by the task Intentionally a BaseException instead of an Exception, so it won't get caught by unspecified user exception clauses that might be used for retries and other control flow. Nrr r r r re=r rec@ó eZdZdS)ÚModuleNotMountableN©rrr r r r r rgFórgc@rf)Ú ClientClosedNrhr r r r rjJrirjc@r)ÚFilesystemExecutionErrorzORaised when an unknown error is thrown during a container filesystem operation.Nrr r r r rkNr rk)r)9r rarWÚtypingrrr0Úsynchronicity.exceptionsÚ synchronicityÚ exceptionsÚUserCodeExceptionÚ ExceptionrÚ GRPCErrorrr4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNÚ UserWarningrOrPrQrRrSrTr\ÚintrdÚ BaseExceptionrergrjrkr r r r Ús`$B"