Galaxy BEEP frame

Build and manage Block Extensible Exchange Protocol (BEEP) Frame.

Getting started

Requirements

• Python >= 3.14

Installation

To install this package in the current python environment, use: python -m pip install galaxy_beep_frame

Usage

from io import BytesIO

from galaxy_beep_frame.frame import Frame, ContinuationIndicator
from galaxy_beep_frame.header_type import PossibleHeaderType
from galaxy_beep_frame.converter import Lexer, Parser

# emitter
frame = Frame(
    payload=(
        b"Content-Type: application/beep+xml\r\n"
        b"\r\n"
        b"<greeting>\r\n"
        b"   <profile uri='http://iana.org/beep/TLS' />\r\n"
        b"</greeting>\r\n"
    ),
    channel_number=0,
    message_number=0,
    sequence_number=0,
    answer_number=None,
    continuation_indicator=ContinuationIndicator.COMPLETE,
    header_type=PossibleHeaderType.RPY,
)

bus = BytesIO(frame.build())

# client
lexer = Lexer()
frames = Parser.parse(lexer.lex(bus))

if len(frames) > 0:
    greeting_frame = frames[0]

Documentation

A complete documentation is available in the wiki.

Development

Development Requirements

This project use mise to manage development tools.

This project use the following tools:

• just: command runner
• hatch: project manager and package builder
• uv: package installer
• ruff: python linter and formatter
• ty: python type checker
• jujutsu: version control

Development Usage

just can be used to speed up development for an identical toolchain.

Before making a commit, just fix will run all tests, format the code, lint and type check. If you don’t want to modify the code, just check will run all tests, lint and type check without any attempt to fix any issue.

Before a version change, just release will push all local commits to repository and publish the new package version.

All available commands can be listed with just -l.

License

This project is licensed under the GNU GPL v3+. See license file for more information.

Acknowledgement

Thanks to all the people that worked on the tools used, like python, neovim and mise.