go-proto-stomp

README

go-proto-stomp

STOMP Protocol Implementation in Golang (with interactive CLI)

Includes:

1. stomp: STOMP Broker/Client Library
2. stompd: STOMP Broker
3. stomper: Interactive CLI for STOMP Client

stomp

Package import:

go get -u github.com/tjs-w/go-proto-stomp

stomper

stomper -p tcp

stompd

stompd -p tcp <host> <port>

STOMP Library Documentation

Installation

STOMP Protocol Specification

The implementation adheres to the spec leaning towards the version 1.2 of the protocol.

STOMP Frame: Augmented BNF Form

This implementation strictly follows the below grammar for frame construction and validation.

NULL                = <US-ASCII null (octet 0)>
LF                  = <US-ASCII line feed (aka newline) (octet 10)>
CR                  = <US-ASCII carriage return (octet 13)>
EOL                 = [CR] LF 
OCTET               = <any 8-bit sequence of data>

frame-stream        = 1*frame

frame               = command EOL
                      *( header EOL )
                      EOL
                      *OCTET
                      NULL
                      *( EOL )

command             = client-command | server-command

client-command      = "SEND"
                      | "SUBSCRIBE"
                      | "UNSUBSCRIBE"
                      | "BEGIN"
                      | "COMMIT"
                      | "ABORT"
                      | "ACK"
                      | "NACK"
                      | "DISCONNECT"
                      | "CONNECT"
                      | "STOMP"

server-command      = "CONNECTED"
                      | "MESSAGE"
                      | "RECEIPT"
                      | "ERROR"

header              = header-name ":" header-value
header-name         = 1*<any OCTET except CR or LF or ":">
header-value        = *<any OCTET except CR or LF or ":">

License

MIT License

Copyright (c) 2022 Tejas Wanjari