pyBROTlib

Python interface to BROT telescopes, talking to the telescope's TwinCAT/PLC control system over MQTT.

Installation

uv add pybrotlib

Usage

Connect a transport (currently MQTT) to a named telescope and drive it through the BROT object:

import asyncio

from pybrotlib import BROT
from pybrotlib.transport import MQTTTransport


async def main() -> None:
    transport = MQTTTransport(host="localhost", port=1883)
    brot = BROT(transport, "MyTelescope")

    # the transport needs its own task to receive telemetry/publish commands
    asyncio.create_task(transport.run())
    await asyncio.sleep(2)  # give it a moment to connect and receive first telemetry

    await brot.telescope.track(ra=10.5, dec=41.2)
    print(brot.telescope.status)


asyncio.run(main())

transport.telemetry holds the live telemetry tree (see pybrotlib/telemetry.py), which is kept up to date by messages received on <telescope>/.../Telemetry topics and read by the component properties below.

Components

Each BROT instance exposes one component per subsystem, all constructed from the same transport and telescope name:

telescope (BROTTelescope) — pointing (track, move), offsets (set_offset_ha, set_offset_dec, set_offset_alt, set_offset_az), power/park/stop/reset, and status (status, motion_state, global_status).
focus (BROTFocus) — position, set(focus), powered, referenced.
dome (BROTDome) — shutter/tracking state, open, close, start_tracking, stop_tracking, park, reset.
roof (BROTRoof) — roll-off roof state, open, close, stop, reset.
mirrorcovers (BROTMirrorCovers) — status, open, close.

All commands are fire-and-forget MQTT publishes; callers are expected to poll telemetry (directly, or via the component's status properties) to observe the result.

Weather

pybrotlib.weather publishes live temperature/humidity/pressure onto a telescope's {site}/Telescope/SET topic, for sites where a Python process has access to a weather source. Pick a WeatherSource and hand it to a WeatherPublisher alongside your transport:

from pybrotlib.weather import PyobsWeatherSource, WeatherPublisher
# or: from pybrotlib.weather import FileWeatherSource

source = PyobsWeatherSource("https://weather.example.org")
weather = WeatherPublisher(transport, "MyTelescope", source, interval=60, max_age=300)

asyncio.create_task(weather.run())

max_age (seconds) guards against publishing a stale reading: BROTLib has no way to tell a fresh value from a stale one once it's received, so a source that's alive but returning an old cached reading is caught here instead. A reading missing one field (e.g. a broken pressure sensor) still publishes the fields it does have.

Development

uv sync --group dev
uv run pytest

Metadata

Release files for pyBROTlib 1.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyBROTlib 1.3.2
File	Size	Uploaded
pybrotlib-1.3.2.tar.gz	8.8 kB	Oct 6, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pyBROTlib 1.3.2
File	Interpreter	ABI	Platform	Reset
pybrotlib-1.3.2-py3-none-any.whl 15.0 kB Oct 6, 2026	Python 3	none	any	Details

Total release size: 23.8 kB

Release files / pybrotlib-1.3.2.tar.gz

Download URL	pybrotlib-1.3.2.tar.gz
Size	8.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`617e636331c2d8642ca043348a9019ef3c3ec590ed6ce43b197503ca0890ad20`
BLAKE2b-256 checksum How to use checksums	`bb500e621a74bc3b7531cfd5c2715c113a5ce82d162f1001cc30f3dfbcfb8140`
Upload date	Oct 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / pybrotlib-1.3.2-py3-none-any.whl

Download URL	pybrotlib-1.3.2-py3-none-any.whl
Size	15.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8de83ec54f58da2f7e11fd8d34d54b8f6f05c8b22ff4fe8d845c88548fcb7045`
BLAKE2b-256 checksum How to use checksums	`63e04996f1db30a73eb9fb2bea8cbdc674580568f9fafa51480763ca089c50fe`
Upload date	Oct 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`