signal-bot/signal_bot/__main__.py
Krzysztof kuhy Rudnicki b9022d3fa3
Some checks are pending
CI / check (push) Waiting to run
feat: the bot can describe an envelope without quoting anybody
DOCS-signal-envelopes.md exists because this wire format is not obvious
and guessing at it has cost real bugs -- the sticker read off the wrong
nesting level, and 0.0.3's !gekon shipping green on an assumption nobody
had checked against the live API. The recurring cost is that answering
"what does a frame with an attachment actually look like?" needed a code
change, a restart, and somebody sending one at the right moment.

So at DEBUG the dispatcher now logs each frame's *shape*: keys and value
types, never values. Two fields keep their values because they are wire
format rather than anything a person said -- a MIME type and a groupInfo
type. A message body, a name, a number, a uuid, quoted text and a
sticker id all come out as "str". An album collapses to one element and
a count instead of printing the same dict twenty times.

Verified against a live frame: the body, the quoted text, the uuid and
the phone number do not survive, and contentType does.

This also had to fix DEBUG being unusable. LOG_LEVEL=DEBUG set the root
logger, which turns on httpx, httpcore and asyncio; the bot polls a
group listing every 30 seconds, so the one interesting line arrived
buried and journald started dropping. Libraries are now held at WARNING
whatever the bot is set to -- at INFO httpx was already emitting an
"HTTP Request: GET ... 200 OK" line every thirty seconds, forever.
Measured on the running unit: 17 library lines per minute down to 2.

Two bugs in that setup found by its own tests rather than by review:
basicConfig is a documented no-op once the root logger has a handler, so
the level silently did not apply under pytest; and the floor belongs at
INFO too, not only below it.

A self-send does not produce a capturable attachment envelope, by the
way -- signal-cli emits no syncMessage for a send made over the same
connection. Two probe images returned HTTP 201 and no frame came back,
so the inbound shape still needs a human to post one.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d48t4qsQLBJnDwDeo2Nom
2026-08-30 19:29:06 +02:00

38 lines
1.4 KiB
Python

# Copyright (c) 2026 Krzysztof Rudnicki. MIT licence.
"""Console entrypoint, so `python -m signal_bot` actually starts the bot.
The old readme told people to run `python main.py`, which had no __main__
block and no uvicorn.run() call, so it silently did nothing at all.
The bind address comes from Config rather than os.getenv() here: this module
runs *before* uvicorn imports the app, and therefore before anything has
called load_dotenv(), so reading the environment directly would ignore
BIND_HOST/BIND_PORT whenever they live in .env -- which is where they live.
"""
from __future__ import annotations
import uvicorn
from signal_bot.config_env import load_config
from signal_bot.logging_setup import configure as configure_logging
from signal_bot.portcheck import PortInUseError, assert_port_free
def main() -> None:
"""Run the ASGI app under uvicorn, refusing to start on a taken port."""
config = load_config()
# Before anything else: uvicorn only configures its own loggers, so
# without this the bot's own log lines go to logging.lastResort and
# anything below WARNING is thrown away.
configure_logging(config.log_level)
try:
assert_port_free(config.bind_host, config.bind_port)
except PortInUseError as exc:
raise SystemExit(str(exc)) from exc
uvicorn.run("signal_bot.app:app", host=config.bind_host, port=config.bind_port)
if __name__ == "__main__":
main()