MoaT Link
% start synopsis % start main
Moat-Link is a library that distributes messages between several possible back-ends, channel arrangements or encodings.
The associated server links these backends into one coherent system, provide message history, documentation, and whatnot.
% end synopsis
Rationale
Often, services have differing ideas how to encode "their" messages. For instance, Home Assistant likes JSON, except for boolean content which is encoded as "ON" and "OFF". On the other hand, encodings like msgpack or CBOR replace the overhead of textual analysis and repeated division by ten with typed binary data.
MoaT-KV supported this usecase via its own MQTT server, which is based on hbmqtt. Unfortunately hbmqtt is unsupported, high-overhead, and doesn't support MQTT 5. MoaT-KV adds its own overhead and doesn't support non-retained messages.
Structure
MoaT-Link consists of a couple of related services.
Server
The main server records messages in its history, affords redundancy, can re-supply the MQTT server with retained state, and so on.
Translator
Translators send and receive messages from other channels or topics.
For instance, Home Assistant's default of device state/cmd/control in one single hierarchy doesn't always mesh well with other systems' ideas.
Persistency, Redundancy
There can be multiple MoaT-Link servers. Clients automatically reconnect when one of them disconnects or becomes unresponsive.
Planned: support for multiple MQTT servers.
Error handling
In a system that aspires to be reliable, misbehaving code needs to record that it failed. MoaT-Link comes with a wrapper that auto-creates a problem report, or deletes it when the problem no longer occurs.
TODO: basic infrastructure exists but reporting needs a heap of code and there are a few parts that would benefit from error-handling wrappers.
Of course, if the system that handles error reporting fails … there's nobody to send an error. Thus, MoaT-Link also has a keepalive mechanism that can automatically notify you as soon as one of the critical components is down.
(This part works …)
Data Schema
Any large system suffers from data rot. The optional moat-link-schema
package adds JSON Schema based validation, schema lookup, and mismatch
reporting for MoaT-Link data.
Web view
Last but not least, we want a HTML front-end for introspection and debugging.
Message Encoding
MoaT-Link supports various encodings, most notably CBOR and msgpack. Its native default is CBOR because, unlike msgpack, CBOR's extensions are simply normal (but tagged) data structures and thus are introspectable.
% end main
1 maintainer
Metadata
1 maintainer
Release files for moat-link 0.10.13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| moat_link-0.10.13.tar.gz | 97.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| moat_link-0.10.13-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 207.1 kB
Release files / moat_link-0.10.13.tar.gz
| Download URL | moat_link-0.10.13.tar.gz |
|---|---|
| Size | 97.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
83c014c5ad178f11de7c0ecbbdeccb564118d574af497cb1209994f78953da1c
|
|
BLAKE2b-256 checksum How to use checksums |
3104f53384bd8c8782619eb3fb95daf1a58b1057aad13edb52fbdcc5687f0375
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / moat_link-0.10.13-py3-none-any.whl
| Download URL | moat_link-0.10.13-py3-none-any.whl |
|---|---|
| Size | 109.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3e64fe0762c88958a387a2035ee16006077c0a6d602021d20ba48d749421ef3e
|
|
BLAKE2b-256 checksum How to use checksums |
0e5ec9dcab659019a7ff74400475782a6e16ad18342eddf777e0121f08571ed3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
