rblhost 0.2.0

The rblhost application is a fast command-line utility providing McuBoot library used on the host computer to initiate communication and issue commands to the MCU bootloader.
Documentation 
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

# Copyright 2025 NXP
#
# SPDX-License-Identifier: BSD-3-Clause
"""Custom build backend that generates stub files before building."""

import os
import shutil
import subprocess

from setuptools.build_meta import build_editable as _build_editable
from setuptools.build_meta import build_sdist as _build_sdist
from setuptools.build_meta import build_wheel as _build_wheel


def _generate_stubs():
    """Generate stub files before building."""
    # Check if we're in an sdist (no Cargo.toml means we're in sdist)
    if not os.path.exists("Cargo.toml"):
        print("Skipping stub generation in sdist build")
        return

    print("Generating Python stub files...")

    try:
        # Run the stub generator
        result = subprocess.run(
            ["cargo", "run", "--bin", "stub_gen", "--features", "python"],
            check=True,
            capture_output=True,
            text=True,
        )
        print(f"Stub generation output: {result.stdout}")

        # Ensure the pymboot directory exists
        os.makedirs("pymboot_rs", exist_ok=True)

        # Copy the generated stub file to the package directory
        if os.path.exists("pymboot_rs.pyi"):
            shutil.copy("pymboot_rs.pyi", "pymboot_rs/__init__.pyi")
            print("Copied pymboot_rs.pyi to pymboot_rs/__init__.pyi")
        else:
            print("Warning: pymboot.pyi was not generated!")

        # Create py.typed marker for PEP 561 compliance
        with open("pymboot_rs/py.typed", "w") as f:
            pass
        print("Created py.typed marker")

    except subprocess.CalledProcessError as e:
        print(f"Error generating stubs: {e}")
        print(f"stdout: {e.stdout}")
        print(f"stderr: {e.stderr}")
        raise


def build_wheel(wheel_directory, config_settings=None, metadata_directory=None):
    """Build wheel with stub generation."""
    _generate_stubs()
    return _build_wheel(wheel_directory, config_settings, metadata_directory)


def build_sdist(sdist_directory, config_settings=None):
    """Build source distribution with stub generation."""
    _generate_stubs()
    return _build_sdist(sdist_directory, config_settings)


def build_editable(wheel_directory, config_settings=None, metadata_directory=None):
    """Build editable install with stub generation."""
    _generate_stubs()
    return _build_editable(wheel_directory, config_settings, metadata_directory)