Skip to content

ptsandbox.exceptions

ptsandbox.exceptions

SandboxException

Bases: Exception

Base exception for all custom errors raised by the library.

SandboxUploadException

Bases: SandboxException

Raised when uploading one or more files to the sandbox fails.

SandboxTooManyErrorsException

Bases: SandboxException

Raised by wait_for_report when the number of consecutive errors while polling for a scan result exceeds the configured error_limit.

SandboxWaitTimeoutException

Bases: SandboxException

Raised by wait_for_report when the scan result is not ready within the specified wait_time.

SandboxScanNotFullException

Bases: SandboxException

Raised by wait_for_report when the scan reaches a terminal state but the behavioral analysis did not produce a full report.

This means the task is no longer running, so it is useless to keep waiting: the report endpoint will never return a full (long) report for it. The terminal state and any scan errors are attached for the caller to react to — the error type values (e.g. sandbox_run_sample, internal, max_depth_exceeded) carry the closest thing to an error code available via the public API.