Files
e2b-dev--e2b/packages/python-sdk/e2b/exceptions.py
T
2026-07-13 12:47:58 +08:00

134 lines
2.8 KiB
Python

def format_sandbox_timeout_exception(message: str):
return TimeoutException(
f"{message}: This error is likely due to sandbox timeout. You can modify the sandbox timeout by passing 'timeout' when starting the sandbox or calling '.set_timeout' on the sandbox with the desired timeout."
)
def format_request_timeout_error() -> Exception:
return TimeoutException(
"Request timed out — the 'request_timeout' option can be used to increase this timeout",
)
class SandboxException(Exception):
"""
Base class for all sandbox errors.
Raised when a general sandbox exception occurs.
"""
pass
class TimeoutException(SandboxException):
"""
Raised when a timeout occurs.
The `unavailable` exception type is caused by sandbox timeout.\n
The `canceled` exception type is caused by exceeding request timeout.\n
The `deadline_exceeded` exception type is caused by exceeding the timeout for process, watch, etc.\n
The `unknown` exception type is sometimes caused by the sandbox timeout when the request is not processed correctly.\n
"""
pass
class InvalidArgumentException(SandboxException):
"""
Raised when an invalid argument is provided.
"""
pass
class NotEnoughSpaceException(SandboxException):
"""
Raised when there is not enough disk space.
"""
pass
class NotFoundException(SandboxException):
"""
Raised when a resource is not found.
.. deprecated::
Use :class:`FileNotFoundException` or :class:`SandboxNotFoundException` instead.
This class will be removed in the next major version.
"""
pass
class FileNotFoundException(NotFoundException):
"""
Raised when a file or directory is not found inside a sandbox.
"""
pass
class SandboxNotFoundException(NotFoundException):
"""
Raised when a sandbox is not found (e.g. it doesn't exist or is no longer running).
"""
pass
class AuthenticationException(Exception):
"""
Raised when authentication fails.
"""
pass
class GitAuthException(AuthenticationException):
"""
Raised when git authentication fails.
"""
pass
class GitUpstreamException(SandboxException):
"""
Raised when git upstream tracking is missing.
"""
pass
class TemplateException(SandboxException):
"""
Exception raised when the template uses old envd version. It isn't compatible with the new SDK.
"""
class RateLimitException(SandboxException):
"""
Raised when the API rate limit is exceeded.
"""
class BuildException(Exception):
"""
Raised when the build fails.
"""
class FileUploadException(BuildException):
"""
Raised when the file upload fails.
"""
class VolumeException(Exception):
"""
Base class for all volume errors.
Raised when general volume errors occur.
"""