Exceptions
app.shared.exceptionsModule for exceptions; provides reusable helpers across application layers.
See Also
SessionManager— raises session lifecycle exceptionsSessionHandler— handles session-opening failures in the UI
Layer: Shared utilities. Context: Provides reusable helpers across application layers at this architectural boundary.
BlurzyException
Bases: Exception
Base exception for domain/business failures in Blurzy.
Layer: Shared utilities. Context: Provides reusable cross-layer behavior without owning workflow state.
DomainException
Bases: BlurzyException
Domain/application boundary error.
Layer: Shared utilities. Context: Provides reusable cross-layer behavior without owning workflow state.
InfrastructureException
Bases: BlurzyException
Infrastructure/runtime integration error.
Layer: Shared utilities. Context: Provides reusable cross-layer behavior without owning workflow state.
SessionAlreadyExistsException
Bases: DomainException
Signal the session already exists error condition.
| PARAMETER | DESCRIPTION |
|---|---|
message
|
Message describing the error or condition.
TYPE:
|
full_path
|
Full path of the video file.
TYPE:
|
full_path = full_path
instance-attribute
__init__(message: str, full_path: str) -> None
NoNewOpenedSessionsException
Bases: DomainException
Signal the no new opened sessions error condition.
| PARAMETER | DESCRIPTION |
|---|---|
num_open_sessions
|
Number of sessions that were already open.
TYPE:
|
num_open_sessions = num_open_sessions
instance-attribute
__init__(num_open_sessions: int) -> None
NoItemsInSessionListException
Bases: DomainException
Signal the no items in session list error condition.
| PARAMETER | DESCRIPTION |
|---|---|
session_list
|
Session entries available to the operation.
TYPE:
|
session_list = session_list
instance-attribute
__init__(session_list: QListWidget) -> None
UnsupportedLayerException
Bases: DomainException
Signal the unsupported layer error condition.
| PARAMETER | DESCRIPTION |
|---|---|
message
|
Message describing the error or condition.
TYPE:
|
source_layer_name
|
Name of the source layer.
TYPE:
|
session_id
|
Identifier of the session associated with this object.
TYPE:
|
session_id = session_id
instance-attribute
source_layer_name = source_layer_name
instance-attribute
__init__(message: str, source_layer_name: str, session_id: SessionId) -> None
TrackingWorkerAlreadyRunningException
Bases: DomainException
Signal the tracking worker already running error condition.
| PARAMETER | DESCRIPTION |
|---|---|
message
|
Message describing the error or condition.
TYPE:
|
session_id
|
Identifier of the session associated with this object.
TYPE:
|
session_id = session_id
instance-attribute
__init__(message: str, session_id: SessionId) -> None
EmptyLayerException
Bases: DomainException
Signal the empty layer error condition.
| PARAMETER | DESCRIPTION |
|---|---|
message
|
Message describing the error or condition.
TYPE:
|
layer_name
|
Name of the affected layer.
TYPE:
|
session_id
|
Identifier of the session associated with this object.
TYPE:
|
layer_name = layer_name
instance-attribute
session_id = session_id
instance-attribute
__init__(message: str, layer_name: str, session_id: SessionId) -> None
InvalidSessionIdException
Bases: DomainException
Signal the invalid session id error condition.
| PARAMETER | DESCRIPTION |
|---|---|
message
|
Message describing the error or condition.
TYPE:
|
session_id
|
Identifier of the session associated with this object.
TYPE:
|
session_id = session_id
instance-attribute
__init__(message: str, session_id: SessionId | None) -> None
TrackingWorkerNotFoundException
Bases: DomainException
Signal the tracking worker not found error condition.
| PARAMETER | DESCRIPTION |
|---|---|
message
|
Message describing the error or condition.
TYPE:
|
session_id
|
Identifier of the session associated with this object.
TYPE:
|
session_id = session_id
instance-attribute
__init__(message: str, session_id: SessionId) -> None
WorkerAlreadyRunningException
Bases: DomainException
Signal the worker already running error condition.
| PARAMETER | DESCRIPTION |
|---|---|
message
|
Message describing the error or condition.
TYPE:
|
session_id
|
Identifier of the session associated with this object.
TYPE:
|
session_id = session_id
instance-attribute
__init__(message: str, session_id: SessionId) -> None
NullModelNameException
Bases: DomainException
Signal the null model name error condition.
| PARAMETER | DESCRIPTION |
|---|---|
message
|
Message describing the error or condition.
TYPE:
|
session_id
|
Identifier of the session associated with this object.
TYPE:
|
session_id = session_id
instance-attribute
__init__(message: str, session_id: SessionId) -> None
VideoFileOpenException
Bases: InfrastructureException
Signal the video file open error condition.
| PARAMETER | DESCRIPTION |
|---|---|
path
|
Filesystem path of the video or resource.
TYPE:
|
reason
|
Explanation of why the operation failed.
TYPE:
|
path = path
instance-attribute
__init__(path: str, reason: str) -> None
VideoStreamStateException
Bases: InfrastructureException
Signal the video stream state error condition.
| PARAMETER | DESCRIPTION |
|---|---|
path
|
Filesystem path of the video or resource.
TYPE:
|
detail
|
Details describing the invalid state or operation.
TYPE:
|
path = path
instance-attribute
__init__(path: str, detail: str) -> None
VideoReadFrameException
Bases: InfrastructureException
Signal the video read frame error condition.
| PARAMETER | DESCRIPTION |
|---|---|
path
|
Filesystem path of the video or resource.
TYPE:
|
frame_index
|
Zero-based video frame associated with the error.
TYPE:
|
reason
|
Explanation of why the operation failed.
TYPE:
|
frame_index = frame_index
instance-attribute
path = path
instance-attribute
__init__(path: str, frame_index: int, reason: str) -> None
EndOfVideoStreamException
Bases: InfrastructureException
Signal the end of video stream error condition.
| PARAMETER | DESCRIPTION |
|---|---|
path
|
Filesystem path of the video or resource.
TYPE:
|
path = path
instance-attribute
__init__(path: str) -> None
UnsupportedLayerOperationException
Bases: DomainException
Signal the unsupported layer operation error condition.
| PARAMETER | DESCRIPTION |
|---|---|
operation
|
Name of the attempted operation.
TYPE:
|
layer_name
|
Name of the affected layer.
TYPE:
|
layer_name = layer_name
instance-attribute
operation = operation
instance-attribute
__init__(operation: str, layer_name: object) -> None
ImmutableLayerOperationException
Bases: DomainException
Signal the immutable layer operation error condition.
| PARAMETER | DESCRIPTION |
|---|---|
operation
|
Name of the attempted operation.
TYPE:
|
layer_name
|
Name of the affected layer.
TYPE:
|
layer_name = layer_name
instance-attribute
operation = operation
instance-attribute
__init__(operation: str, layer_name: object) -> None
UnsupportedDirectionException
Bases: DomainException
Signal the unsupported direction error condition.
| PARAMETER | DESCRIPTION |
|---|---|
direction
|
Frame-navigation direction.
TYPE:
|
direction = direction
instance-attribute
__init__(direction: object) -> None
UnsupportedTabException
Bases: DomainException
Signal the unsupported tab error condition.
| PARAMETER | DESCRIPTION |
|---|---|
tab
|
Tab identifier associated with the request.
TYPE:
|
tab = tab
instance-attribute
__init__(tab: object) -> None
UnknownFrameItemException
Bases: DomainException
Signal the unknown frame item error condition.
| PARAMETER | DESCRIPTION |
|---|---|
item_key
|
Key identifying the frame item.
TYPE:
|
item_key = item_key
instance-attribute
__init__(item_key: str) -> None
UnsupportedImportExportFormatException
Bases: DomainException
Signal the unsupported import export format error condition.
| PARAMETER | DESCRIPTION |
|---|---|
extension
|
File extension that was supplied.
TYPE:
|
operation
|
Name of the attempted operation.
TYPE:
|
extension = extension
instance-attribute
operation = operation
instance-attribute
__init__(extension: str, operation: str) -> None
ProjectFormatException
Bases: DomainException
Signal the project format error condition.
| PARAMETER | DESCRIPTION |
|---|---|
detail
|
Details describing the invalid state or operation.
TYPE:
|