exceptions

plantdb.commons.fsdb.exceptions

Custom FSDB Exceptions

A collection of specialized exception classes designed to handle various error scenarios in a file system database (FSDB) implementation. These exceptions provide clear, specific error handling for database operations, scan management, and fileset manipulations.

Key Features

• Database Validation - NotAnFSDBError for handling invalid database instances
• Scan Management - ScanNotFoundError for handling missing scan directories
• Fileset Operations - Multiple exceptions for fileset-related errors:
• FilesetNotFoundError for missing fileset directories
• FilesetNoIDError for missing fileset identifiers
• File Handling - Specific exceptions for file-related issues:
• FileNoIDError for missing file identifiers
• FileNoFileNameError for missing file names

Usage Examples

# Example of handling scan-related errors
try:
    scan = db.get_scan("non_existent_scan")
except ScanNotFoundError as e:
    print(f"Error: {e}")

# Example of handling fileset errors
try:
    fileset = scan.get_fileset("invalid_fileset")
except FilesetNotFoundError as e:
    print(f"Error: {e}")

FileNoFileNameError

Bases: Exception

No 'file' entry could be found for this file.

FileNoIDError

Bases: Exception

No 'id' entry could be found for this file.

FileNotFoundError

FileNotFoundError(fs, f_id)

Bases: Exception

Could not find the file.

Source code in plantdb/commons/fsdb/exceptions.py

def __init__(self, fs, f_id: str):
    super().__init__(f"Unknown file id '{f_id}' in scan/fileset '{fs.scan.id}/{fs.id}'!")

FilesetNoIDError

Bases: Exception

No 'id' entry could be found for this fileset.

FilesetNotFoundError

FilesetNotFoundError(scan, fs_id)

Bases: Exception

Could not find the fileset directory.

Source code in plantdb/commons/fsdb/exceptions.py

def __init__(self, scan, fs_id: str):
    super().__init__(f"Unknown fileset id '{fs_id}' in scan '{scan.id}'!")

ScanNotFoundError

ScanNotFoundError(db, scan_id)

Bases: Exception

Could not find the scan directory.

Source code in plantdb/commons/fsdb/exceptions.py

def __init__(self, db, scan_id: str):
    super().__init__(f"Unknown scan id '{scan_id}' in database '{db.path()}'!")