serialization

Filesystem Database Serialization

This module provides functionality for serializing and deserializing filesystem database (FSDB) objects, facilitating the structured management and manipulation of files and filesets within a scan-based hierarchical storage system.

Key Features

• Parsing and conversion of filesystem database components (Scans, Filesets, and Files)
• Validation of filesystem entries and their required attributes
• Hierarchical data structure serialization to dictionary format
• Error handling for missing IDs, filenames, and non-existent files
• Path validation and verification for filesystem integrity

Usage Examples

>>> # Example of converting a scan to a dictionary representation
>>> from plantdb.commons.fsdb.core import Scan

>>> # Assuming we have a scan object
>>> scan = Scan(...)

>>> # Convert scan structure to dictionary
>>> scan_dict = _scan_to_dict(scan)
# Result format:
# {
#     "filesets": [
#         {
#             "id": "fileset_id",
#             "files": [
#                 {
#                     "id": "file_id",
#                     "file": "filename.ext"
#                 }
#             ]
#         }
#     ]
# }

>>> # Parse a fileset from dictionary
>>> fileset_info = {"id": "fileset_id"}
>>> fileset = _parse_fileset(scan, fileset_info)

>>> # Parse a file from dictionary
>>> file_info = {"id": "file_id", "file": "example.txt"}
>>> file = _parse_file(fileset, file_info)