beebium 0.1.2__py3-none-any.whl

beebium/client/__init__.py

@@ -0,0 +1,173 @@
+# Copyright 2026 Robert Smallshire <robert@smallshire.org.uk>
+#
+# This file is part of Beebium.
+#
+# Beebium is free software: you can redistribute it and/or modify it under the terms of the
+# GNU General Public License as published by the Free Software Foundation, either version 3 of the
+# License, or (at your option) any later version. Beebium is distributed in the hope that it will
+# be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+# You should have received a copy of the GNU General Public License along with Beebium.
+# If not, see <https://www.gnu.org/licenses/>.
+
+"""
+Beebium - Python client for the Beebium BBC Micro emulator.
+
+Usage:
+    from beebium.client import Beebium
+
+    # Connect to an existing server
+    with Beebium.connect() as bbc:
+        bbc.debugger.stop()
+        print(f"PC = ${bbc.cpu.pc:04X}")
+
+    # Launch and manage a server
+    with Beebium.launch(mos_filepath="acorn-mos_1_20.rom") as bbc:
+        bbc.keyboard.type("PRINT 42")
+        bbc.keyboard.press_return()
+"""
+
+from beebium.client._proto.protocol_fingerprint import PROTOCOL_FINGERPRINT
+from beebium.client._version import __version__
+from beebium.client.audio import (
+    AudioChunk,
+    AudioFormat,
+    AudioSource,
+    ChannelGroup,
+    SourceEncoding,
+)
+from beebium.client.client import Beebium
+from beebium.client.econet import (
+    AdlcStatus,
+    EconetEvent,
+    EconetFrameInfo,
+    EconetStatus,
+    HandshakeStatus,
+)
+from beebium.client.econet_transport import TransportInfo
+from beebium.client.exceptions import (
+    BeebiumError,
+    ConnectionError,
+    DebuggerError,
+    DiscError,
+    EconetError,
+    ExtensionAdapterNotInstalledError,
+    ExtensionAmbiguousError,
+    ExtensionError,
+    ExtensionNotLoadedError,
+    InvalidConditionError,
+    MemoryAccessError,
+    ProtocolMismatchError,
+    ServerNotFoundError,
+    ServerStartupError,
+    TimeoutError,
+)
+from beebium.client.extension import (
+    EconetTransportAdapter,
+    ExtensionAdapter,
+    PeripheralExtensionAdapter,
+)
+from beebium.client.extension_ui import (
+    Button,
+    Choice,
+    Control,
+    ControlKind,
+    DispatchResult,
+    Group,
+    Indicator,
+    IndicatorState,
+    Label,
+    SubscriptionHandle,
+    TextInput,
+    Toggle,
+    View,
+)
+from beebium.client.extensions import (
+    ExtensionInfo,
+    Extensions,
+    ParameterSchemaInfo,
+    StorageDevice,
+    StorageKind,
+)
+from beebium.client.host import (
+    host_identifier,
+    is_local_host,
+    local_host_fingerprint,
+)
+from beebium.client.system import (
+    AdvertisementState,
+    MachineIdentity,
+    Provenance,
+    ServerStatus,
+    ServerStatusEvent,
+    ShutdownConditionStatus,
+    ShutdownMode,
+    ShutdownResponse,
+)
+
+# Default gRPC port for beebium servers (0xBEEB = 48875)
+DEFAULT_GRPC_PORT = 0xBEEB
+
+__all__ = [
+    "AdlcStatus",
+    "AdvertisementState",
+    "AudioChunk",
+    "AudioFormat",
+    "AudioSource",
+    "Beebium",
+    "BeebiumError",
+    "Button",
+    "ChannelGroup",
+    "Choice",
+    "ConnectionError",
+    "Control",
+    "ExtensionInfo",
+    "Extensions",
+    "host_identifier",
+    "PROTOCOL_FINGERPRINT",
+    "is_local_host",
+    "local_host_fingerprint",
+    "ProtocolMismatchError",
+    "ControlKind",
+    "DebuggerError",
+    "DEFAULT_GRPC_PORT",
+    "DiscError",
+    "DispatchResult",
+    "EconetError",
+    "EconetEvent",
+    "EconetFrameInfo",
+    "EconetStatus",
+    "EconetTransportAdapter",
+    "ExtensionAdapter",
+    "PeripheralExtensionAdapter",
+    "ExtensionAdapterNotInstalledError",
+    "ExtensionAmbiguousError",
+    "ExtensionError",
+    "ExtensionNotLoadedError",
+    "Group",
+    "HandshakeStatus",
+    "Indicator",
+    "IndicatorState",
+    "Label",
+    "MachineIdentity",
+    "MemoryAccessError",
+    "ParameterSchemaInfo",
+    "Provenance",
+    "ServerNotFoundError",
+    "ServerStartupError",
+    "ServerStatus",
+    "ServerStatusEvent",
+    "ShutdownConditionStatus",
+    "ShutdownMode",
+    "ShutdownResponse",
+    "SourceEncoding",
+    "StorageDevice",
+    "StorageKind",
+    "SubscriptionHandle",
+    "TextInput",
+    "TimeoutError",
+    "Toggle",
+    "TransportInfo",
+    "View",
+    "__version__",
+]

beebium/client/_proto/__init__.py

@@ -0,0 +1,28 @@
+# Copyright 2026 Robert Smallshire <robert@smallshire.org.uk>
+#
+# This file is part of Beebium.
+#
+# Beebium is free software: you can redistribute it and/or modify it under the terms of the
+# GNU General Public License as published by the Free Software Foundation, either version 3 of the
+# License, or (at your option) any later version. Beebium is distributed in the hope that it will
+# be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+# You should have received a copy of the GNU General Public License along with Beebium.
+# If not, see <https://www.gnu.org/licenses/>.
+
+"""Generated protocol buffer modules.
+
+Run scripts/generate_proto.sh to regenerate these files from the .proto definitions.
+"""
+
+# These imports will be available after running generate_proto.sh
+try:
+    from beebium.client._proto import video_pb2, video_pb2_grpc
+    from beebium.client._proto import keyboard_pb2, keyboard_pb2_grpc
+    from beebium.client._proto import debugger_pb2, debugger_pb2_grpc
+    from beebium.client._proto import system_pb2, system_pb2_grpc
+    from beebium.client._proto import disc_pb2, disc_pb2_grpc
+    from beebium.client._proto import econet_pb2, econet_pb2_grpc
+except ImportError:
+    # Proto files not yet generated
+    pass

beebium/client/_proto/audio_pb2.py

@@ -0,0 +1,62 @@
+# Copyright 2026 Robert Smallshire <robert@smallshire.org.uk>
+#
+# This file is part of Beebium.
+#
+# Beebium is free software: you can redistribute it and/or modify it under the terms of the
+# GNU General Public License as published by the Free Software Foundation, either version 3 of the
+# License, or (at your option) any later version. Beebium is distributed in the hope that it will
+# be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+# You should have received a copy of the GNU General Public License along with Beebium.
+# If not, see <https://www.gnu.org/licenses/>.
+
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: audio.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'audio.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0b\x61udio.proto\x12\x07\x62\x65\x65\x62ium\"+\n\x15SubscribeAudioRequest\x12\x12\n\nchunk_size\x18\x01 \x01(\r\"Z\n\nAudioChunk\x12\x10\n\x08sequence\x18\x01 \x01(\x04\x12\x14\n\x0csample_count\x18\x02 \x01(\r\x12\x13\n\x0b\x63ycle_count\x18\x03 \x01(\x04\x12\x0f\n\x07samples\x18\x04 \x01(\x0c\"\x8c\x01\n\x0b\x41udioSource\x12\x14\n\x0csource_index\x18\x01 \x01(\r\x12\x13\n\x0bsource_name\x18\x02 \x01(\t\x12)\n\x08\x65ncoding\x18\x03 \x01(\x0e\x32\x17.beebium.SourceEncoding\x12\x15\n\rchannel_names\x18\x04 \x03(\t\x12\x10\n\x08group_id\x18\x05 \x01(\r\"X\n\x0c\x43hannelGroup\x12\x10\n\x08group_id\x18\x01 \x01(\r\x12\x12\n\ngroup_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\r\n\x05\x63olor\x18\x04 \x01(\t\"\x17\n\x15GetAudioFormatRequest\"\x86\x01\n\x0b\x41udioFormat\x12\x13\n\x0bsample_rate\x18\x01 \x01(\r\x12\x14\n\x0csource_count\x18\x02 \x01(\r\x12%\n\x07sources\x18\x03 \x03(\x0b\x32\x14.beebium.AudioSource\x12%\n\x06groups\x18\x04 \x03(\x0b\x32\x15.beebium.ChannelGroup*\x9a\x01\n\x0eSourceEncoding\x12\x1a\n\x16\x45NCODING_4X8BIT_SIGNED\x10\x00\x12\x1b\n\x17\x45NCODING_2X16BIT_SIGNED\x10\x01\x12\x1b\n\x17\x45NCODING_1X32BIT_SIGNED\x10\x02\x12\x14\n\x10\x45NCODING_SILENCE\x10\x03\x12\x1c\n\x18\x45NCODING_4X8BIT_UNSIGNED\x10\x04\x32\x9f\x01\n\x0c\x41udioService\x12G\n\x0eSubscribeAudio\x12\x1e.beebium.SubscribeAudioRequest\x1a\x13.beebium.AudioChunk0\x01\x12\x46\n\x0eGetAudioFormat\x12\x1e.beebium.GetAudioFormatRequest\x1a\x14.beebium.AudioFormatb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'audio_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_SOURCEENCODING']._serialized_start=557
+  _globals['_SOURCEENCODING']._serialized_end=711
+  _globals['_SUBSCRIBEAUDIOREQUEST']._serialized_start=24
+  _globals['_SUBSCRIBEAUDIOREQUEST']._serialized_end=67
+  _globals['_AUDIOCHUNK']._serialized_start=69
+  _globals['_AUDIOCHUNK']._serialized_end=159
+  _globals['_AUDIOSOURCE']._serialized_start=162
+  _globals['_AUDIOSOURCE']._serialized_end=302
+  _globals['_CHANNELGROUP']._serialized_start=304
+  _globals['_CHANNELGROUP']._serialized_end=392
+  _globals['_GETAUDIOFORMATREQUEST']._serialized_start=394
+  _globals['_GETAUDIOFORMATREQUEST']._serialized_end=417
+  _globals['_AUDIOFORMAT']._serialized_start=420
+  _globals['_AUDIOFORMAT']._serialized_end=554
+  _globals['_AUDIOSERVICE']._serialized_start=714
+  _globals['_AUDIOSERVICE']._serialized_end=873
+# @@protoc_insertion_point(module_scope)

beebium/client/_proto/audio_pb2.pyi

@@ -0,0 +1,244 @@
+# Copyright 2026 Robert Smallshire <robert@smallshire.org.uk>
+#
+# This file is part of Beebium.
+#
+# Beebium is free software: you can redistribute it and/or modify it under the terms of the
+# GNU General Public License as published by the Free Software Foundation, either version 3 of the
+# License, or (at your option) any later version. Beebium is distributed in the hope that it will
+# be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+# You should have received a copy of the GNU General Public License along with Beebium.
+# If not, see <https://www.gnu.org/licenses/>.
+
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+"""
+
+from collections import abc as _abc
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf.internal import containers as _containers
+from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
+import builtins as _builtins
+import sys
+import typing as _typing
+
+if sys.version_info >= (3, 11):
+    from typing import TypeAlias as _TypeAlias, Never as _Never
+else:
+    from typing_extensions import TypeAlias as _TypeAlias, Never as _Never
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class _SourceEncoding:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _SourceEncodingEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_SourceEncoding.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    ENCODING_4X8BIT_SIGNED: _SourceEncoding.ValueType  # 0
+    """4 × int8 channels, zero-centered (legacy)"""
+    ENCODING_2X16BIT_SIGNED: _SourceEncoding.ValueType  # 1
+    """2 × int16 channels (e.g., Music 5000 stereo)"""
+    ENCODING_1X32BIT_SIGNED: _SourceEncoding.ValueType  # 2
+    """1 × int32 channel (high-quality)"""
+    ENCODING_SILENCE: _SourceEncoding.ValueType  # 3
+    """Unused/silent source"""
+    ENCODING_4X8BIT_UNSIGNED: _SourceEncoding.ValueType  # 4
+    """4 × uint8 channels, DC bias pre-applied (SN76489)"""
+
+class SourceEncoding(_SourceEncoding, metaclass=_SourceEncodingEnumTypeWrapper):
+    """Describes how to interpret a 32-bit source field"""
+
+ENCODING_4X8BIT_SIGNED: SourceEncoding.ValueType  # 0
+"""4 × int8 channels, zero-centered (legacy)"""
+ENCODING_2X16BIT_SIGNED: SourceEncoding.ValueType  # 1
+"""2 × int16 channels (e.g., Music 5000 stereo)"""
+ENCODING_1X32BIT_SIGNED: SourceEncoding.ValueType  # 2
+"""1 × int32 channel (high-quality)"""
+ENCODING_SILENCE: SourceEncoding.ValueType  # 3
+"""Unused/silent source"""
+ENCODING_4X8BIT_UNSIGNED: SourceEncoding.ValueType  # 4
+"""4 × uint8 channels, DC bias pre-applied (SN76489)"""
+Global___SourceEncoding: _TypeAlias = SourceEncoding  # noqa: Y015
+
+@_typing.final
+class SubscribeAudioRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CHUNK_SIZE_FIELD_NUMBER: _builtins.int
+    chunk_size: _builtins.int
+    """Samples per chunk (default: 1024)"""
+    def __init__(
+        self,
+        *,
+        chunk_size: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["chunk_size", b"chunk_size"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___SubscribeAudioRequest: _TypeAlias = SubscribeAudioRequest  # noqa: Y015
+
+@_typing.final
+class AudioChunk(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    SEQUENCE_FIELD_NUMBER: _builtins.int
+    SAMPLE_COUNT_FIELD_NUMBER: _builtins.int
+    CYCLE_COUNT_FIELD_NUMBER: _builtins.int
+    SAMPLES_FIELD_NUMBER: _builtins.int
+    sequence: _builtins.int
+    """Chunk sequence number (for drop detection)"""
+    sample_count: _builtins.int
+    """Number of samples in this chunk"""
+    cycle_count: _builtins.int
+    """Emulation cycle at start of chunk (reserved)"""
+    samples: _builtins.bytes
+    """Packed sample data: sample_count × source_count × 4 bytes
+    Each sample is N × 32-bit fields, where N = source_count from AudioFormat
+    Use GetAudioFormat to determine how to interpret each 32-bit field
+    """
+    def __init__(
+        self,
+        *,
+        sequence: _builtins.int = ...,
+        sample_count: _builtins.int = ...,
+        cycle_count: _builtins.int = ...,
+        samples: _builtins.bytes = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["cycle_count", b"cycle_count", "sample_count", b"sample_count", "samples", b"samples", "sequence", b"sequence"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___AudioChunk: _TypeAlias = AudioChunk  # noqa: Y015
+
+@_typing.final
+class AudioSource(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    SOURCE_INDEX_FIELD_NUMBER: _builtins.int
+    SOURCE_NAME_FIELD_NUMBER: _builtins.int
+    ENCODING_FIELD_NUMBER: _builtins.int
+    CHANNEL_NAMES_FIELD_NUMBER: _builtins.int
+    GROUP_ID_FIELD_NUMBER: _builtins.int
+    source_index: _builtins.int
+    """Index into sample sources array"""
+    source_name: _builtins.str
+    """E.g., "SN76489", "Speech", "Music5000" """
+    encoding: Global___SourceEncoding.ValueType
+    """How the 32-bit field is subdivided"""
+    group_id: _builtins.int
+    """Channel group ID (0 = ungrouped)"""
+    @_builtins.property
+    def channel_names(self) -> _containers.RepeatedScalarFieldContainer[_builtins.str]:
+        """Sub-channel labels using MOS SOUND channel numbering:
+        "0" (noise), "1", "2", "3" (tones) - matches BBC BASIC SOUND command
+        """
+
+    def __init__(
+        self,
+        *,
+        source_index: _builtins.int = ...,
+        source_name: _builtins.str = ...,
+        encoding: Global___SourceEncoding.ValueType = ...,
+        channel_names: _abc.Iterable[_builtins.str] | None = ...,
+        group_id: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["channel_names", b"channel_names", "encoding", b"encoding", "group_id", b"group_id", "source_index", b"source_index", "source_name", b"source_name"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___AudioSource: _TypeAlias = AudioSource  # noqa: Y015
+
+@_typing.final
+class ChannelGroup(_message.Message):
+    """Channel group for organizing related audio sources in UI"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    GROUP_ID_FIELD_NUMBER: _builtins.int
+    GROUP_NAME_FIELD_NUMBER: _builtins.int
+    DESCRIPTION_FIELD_NUMBER: _builtins.int
+    COLOR_FIELD_NUMBER: _builtins.int
+    group_id: _builtins.int
+    """Unique group identifier"""
+    group_name: _builtins.str
+    """E.g., "Internal Sound", "Music 5000" """
+    description: _builtins.str
+    """Optional description"""
+    color: _builtins.str
+    """Optional UI hint (e.g., "#FF5733")"""
+    def __init__(
+        self,
+        *,
+        group_id: _builtins.int = ...,
+        group_name: _builtins.str = ...,
+        description: _builtins.str = ...,
+        color: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["color", b"color", "description", b"description", "group_id", b"group_id", "group_name", b"group_name"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ChannelGroup: _TypeAlias = ChannelGroup  # noqa: Y015
+
+@_typing.final
+class GetAudioFormatRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___GetAudioFormatRequest: _TypeAlias = GetAudioFormatRequest  # noqa: Y015
+
+@_typing.final
+class AudioFormat(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    SAMPLE_RATE_FIELD_NUMBER: _builtins.int
+    SOURCE_COUNT_FIELD_NUMBER: _builtins.int
+    SOURCES_FIELD_NUMBER: _builtins.int
+    GROUPS_FIELD_NUMBER: _builtins.int
+    sample_rate: _builtins.int
+    """Output sample rate (48000 Hz)"""
+    source_count: _builtins.int
+    """Number of 32-bit fields per sample"""
+    @_builtins.property
+    def sources(self) -> _containers.RepeatedCompositeFieldContainer[Global___AudioSource]:
+        """Metadata for each active source"""
+
+    @_builtins.property
+    def groups(self) -> _containers.RepeatedCompositeFieldContainer[Global___ChannelGroup]:
+        """Channel group definitions"""
+
+    def __init__(
+        self,
+        *,
+        sample_rate: _builtins.int = ...,
+        source_count: _builtins.int = ...,
+        sources: _abc.Iterable[Global___AudioSource] | None = ...,
+        groups: _abc.Iterable[Global___ChannelGroup] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["groups", b"groups", "sample_rate", b"sample_rate", "source_count", b"source_count", "sources", b"sources"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___AudioFormat: _TypeAlias = AudioFormat  # noqa: Y015

beebium/client/_proto/audio_pb2_grpc.py

@@ -0,0 +1,160 @@
+# Copyright 2026 Robert Smallshire <robert@smallshire.org.uk>
+#
+# This file is part of Beebium.
+#
+# Beebium is free software: you can redistribute it and/or modify it under the terms of the
+# GNU General Public License as published by the Free Software Foundation, either version 3 of the
+# License, or (at your option) any later version. Beebium is distributed in the hope that it will
+# be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+# You should have received a copy of the GNU General Public License along with Beebium.
+# If not, see <https://www.gnu.org/licenses/>.
+
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+from . import audio_pb2 as audio__pb2
+
+GRPC_GENERATED_VERSION = '1.76.0'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + ' but the generated code in audio_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )
+
+
+class AudioServiceStub(object):
+    """Audio streaming service
+    Note: Sound chip state introspection moved to DebuggerControl.GetSoundChipState
+    """
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.SubscribeAudio = channel.unary_stream(
+                '/beebium.AudioService/SubscribeAudio',
+                request_serializer=audio__pb2.SubscribeAudioRequest.SerializeToString,
+                response_deserializer=audio__pb2.AudioChunk.FromString,
+                _registered_method=True)
+        self.GetAudioFormat = channel.unary_unary(
+                '/beebium.AudioService/GetAudioFormat',
+                request_serializer=audio__pb2.GetAudioFormatRequest.SerializeToString,
+                response_deserializer=audio__pb2.AudioFormat.FromString,
+                _registered_method=True)
+
+
+class AudioServiceServicer(object):
+    """Audio streaming service
+    Note: Sound chip state introspection moved to DebuggerControl.GetSoundChipState
+    """
+
+    def SubscribeAudio(self, request, context):
+        """Stream audio samples as they're generated
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def GetAudioFormat(self, request, context):
+        """Get audio format metadata (how to interpret sample data)
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_AudioServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'SubscribeAudio': grpc.unary_stream_rpc_method_handler(
+                    servicer.SubscribeAudio,
+                    request_deserializer=audio__pb2.SubscribeAudioRequest.FromString,
+                    response_serializer=audio__pb2.AudioChunk.SerializeToString,
+            ),
+            'GetAudioFormat': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetAudioFormat,
+                    request_deserializer=audio__pb2.GetAudioFormatRequest.FromString,
+                    response_serializer=audio__pb2.AudioFormat.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'beebium.AudioService', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers('beebium.AudioService', rpc_method_handlers)
+
+
+ # This class is part of an EXPERIMENTAL API.
+class AudioService(object):
+    """Audio streaming service
+    Note: Sound chip state introspection moved to DebuggerControl.GetSoundChipState
+    """
+
+    @staticmethod
+    def SubscribeAudio(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_stream(
+            request,
+            target,
+            '/beebium.AudioService/SubscribeAudio',
+            audio__pb2.SubscribeAudioRequest.SerializeToString,
+            audio__pb2.AudioChunk.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def GetAudioFormat(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/beebium.AudioService/GetAudioFormat',
+            audio__pb2.GetAudioFormatRequest.SerializeToString,
+            audio__pb2.AudioFormat.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)