"""A tiny real JPEG, for tests that need decodable image bytes. The frame server's tests use a fake that writes a PNG (zlib is in the standard library). MJPEG needs *JPEG* parts, and there is no JPEG encoder in the stdlib, so the smallest honest thing is one real 1x1 JPEG embedded as base64 and reused. `jpeg_bytes(marker)` rewrites one *quantisation-table* byte, so two frames differ byte-for-byte (a test can prove "a new frame arrived") while the image stays valid: the EOI marker, the headers and the scan data are untouched. """ from __future__ import annotations import base64 #: A 1x1 JPEG. Real enough that `hhstream.capture.image_size` reports (1, 1). _ONE_PIXEL = ( "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRof" "Hh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/wAALCAABAAEBAREA/8QAFAAB" "AAAAAAAAAAAAAAAAAAAACf/EABQQAQAAAAAAAAAAAAAAAAAAAAD/2gAIAQEAAD8AVN//2Q==" ) #: The start of the quantisation table: `FFDB`, length `0043`, precision/id `00`. _DQT = b"\xff\xdb\x00C\x00" def jpeg_bytes(marker: int = 0) -> bytes: """The 1x1 JPEG with one table byte varied by `marker` (0..249).""" data = bytearray(base64.b64decode(_ONE_PIXEL)) start = data.index(_DQT) + len(_DQT) data[start + 63] = (marker % 250) + 1 # a nonzero quantiser keeps it decodable return bytes(data)