chore: import upstream snapshot with attribution

2026-07-13 12:47:58 +08:00
commit b16403ea71
789 changed files with 115226 additions and 0 deletions
@@ -0,0 +1,133 @@
+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.
+    """