Skip to content

Source: examples/notebooks/storage-write-book.py#

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
import marimo

__generated_with = "0.9.33"
app = marimo.App(width="medium")


@app.cell
def __():
    import argparse
    import os
    import sys
    import textwrap

    import dbus
    import pandas as pd
    import marimo as mo

    return argparse, dbus, mo, os, pd, sys, textwrap


@app.cell(hide_code=True)
def __(mo):
    mo.md(
        """
        # Write image to removable storage device as User App

        Uses image from image_path to write to a removable storage device specified by serial_number.

        - Uses Udisks2 and DBus to access the storage devices as user interactive
        - Returns 0 for success, 1 for errors, and 2 for device not found or non-removable
        """
    )
    return


@app.cell
def __(dbus):
    args = {
        "serial": "20220100016184",
        "size": 127865454592,
        "imagefile": "build/tmp/sim/fcos/fedora-coreos-41.20241122.1.0-metal.aarch64.raw",
    }
    bus = dbus.SystemBus()
    udisks = bus.get_object("org.freedesktop.UDisks2", "/org/freedesktop/UDisks2", introspect=False)
    udisks_manager = dbus.Interface(udisks, "org.freedesktop.DBus.ObjectManager")
    return args, bus, udisks, udisks_manager


@app.cell(hide_code=True)
def __(device_name, os):
    def list_drives(udisks_interface):
        """Prints a list of storage devices (and if they are removable)"""

        managed_objects = udisks_interface.GetManagedObjects()

        drives_dataset = []
        for path, interfaces in managed_objects.items():
            if "org.freedesktop.UDisks2.Drive" in interfaces:
                device_info = interfaces["org.freedesktop.UDisks2.Drive"]
                drives_dataset.append(
                    {
                        "path": os.path.basename(path),
                        "serial": device_info["Serial"],
                        "size": device_info["Size"],
                        "removable": "Removable" if device_info["MediaRemovable"] else "Fixed",
                        "present": device_info["TimeMediaDetected"],
                    }
                )
        return drives_dataset

    def get_removable_drive(serial_number, udisks_interface):
        """Returns UDisks2.Drive Interface of an external attached storage device with the specified serial number"""

        managed_objects = udisks_interface.GetManagedObjects()

        for path, interfaces in managed_objects.items():
            if "org.freedesktop.UDisks2.Drive" in interfaces:
                drive_info = interfaces["org.freedesktop.UDisks2.Drive"]
                if drive_info["Serial"] == serial_number and drive_info["MediaRemovable"]:
                    return path, drive_info
        return None, None

    def get_block_device(drive_object_path, udisks_interface):
        managed_objects = udisks_interface.GetManagedObjects()

        for path, interfaces in managed_objects.items():
            if "org.freedesktop.UDisks2.Block" in interfaces:
                interface = interfaces["org.freedesktop.UDisks2.Block"]
                if interface["Drive"] == drive_object_path:
                    return interface
        return None

    def write_image_to_block_device(drive_object_path, image_file, udisks_interface):
        with open(image_file, "rb") as image:
            with open("/mnt/" + device_name, "wb") as destination:
                for chunk in iter(lambda: image.read(2**18), b""):
                    destination.write(chunk)

    return (
        get_block_device,
        get_removable_drive,
        list_drives,
        write_image_to_block_device,
    )


@app.cell
def __(list_drives, pd, udisks_manager):
    drives_df = pd.DataFrame(list_drives(udisks_manager))
    return (drives_df,)


@app.cell
def __(drives_df, mo):
    mo.ui.table(drives_df)
    return


@app.cell
def __(args, get_block_device, get_removable_drive, sys, udisks_manager):
    if args:
        path, drive_interface = get_removable_drive(args["serial"], udisks_manager)
        if not path or not drive_interface:
            print(
                "ERROR: No Device with serial {} found".format(args["serial"]),
                file=sys.stderr,
            )
        else:
            if drive_interface["Size"] == 0 or drive_interface["TimeMediaDetected"] == 0:
                print("ERROR: Size 0 or TimeMediaDetected 0", file=sys.stderr)
            else:
                block_interface = get_block_device(path, udisks_manager)
                if block_interface["Size"] == 0:
                    print("ERROR: Size 0 or TimeMediaDetected 0", file=sys.stderr)
                else:
                    if drive_interface["Size"] != args["size"]:
                        print(
                            "ERROR: Size Expected: {}, Actual: {}".format(
                                args["size"], drive_interface["Size"]
                            )
                        )
                    else:
                        print("Would write To Storage Device at {}".format(path))
    return block_interface, drive_interface, path


if __name__ == "__main__":
    app.run()