Exceptions

All dazpy exceptions inherit from DazError.

exception dazpy.exceptions.DazError[source]

Bases: Exception

Base class for all dazpy exceptions.

exception dazpy.exceptions.ConnectionError[source]

Bases: DazError

Raised when the SDK cannot reach the DAZ Studio Script Server.

exception dazpy.exceptions.AuthenticationError[source]

Bases: DazError

Raised on HTTP 401 or 403 (bad or missing API token, or IP blocked).

exception dazpy.exceptions.ScriptError(message, script='', request_id='')[source]

Bases: DazError

Base class for errors that originate inside a DazScript execution.

script

The DazScript source that was submitted (may be empty for file-based executions).

request_id

The server-assigned request ID, useful for log correlation.

property diagnostic: str

Return a formatted string with line-numbered source and error details.

exception dazpy.exceptions.ScriptSyntaxError(message, script='', request_id='')[source]

Bases: ScriptError

Raised when the DazScript engine reports a parse / syntax error.

exception dazpy.exceptions.ScriptRuntimeError(message, script='', request_id='')[source]

Bases: ScriptError

Raised when a DazScript execution fails at runtime (TypeError, ReferenceError, etc.).

exception dazpy.exceptions.TimeoutError[source]

Bases: DazError

Raised when an HTTP request or async poll exceeds its timeout.

exception dazpy.exceptions.NodeNotFoundError[source]

Bases: DazError

Raised when a requested scene node, bone, or skeleton cannot be found.

exception dazpy.exceptions.AsyncExecutionError(message, request_id='')[source]

Bases: DazError

Raised when an async request fails, is cancelled, or times out while polling.

request_id

The server-assigned request ID of the failed async job.