led-ticker-pool 0.1.0__tar.gz

led_ticker_pool-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/
+.env

led_ticker_pool-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.4.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+  - repo: local
+    hooks:
+      - id: pyright
+        name: pyright
+        entry: uv run pyright src
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [pre-push]

led_ticker_pool-0.1.0/CLAUDE.md

@@ -0,0 +1,121 @@
+# CLAUDE.md
+
+Guidance for Claude Code when working in **led-ticker-pool**, an external plugin for
+[led-ticker](https://github.com/JamesAwesome/led-ticker).
+
+`README.md` is the source of truth for the user-facing surface (config options, temperature
+zones, layouts, InfluxDB setup). This file keeps the **load-bearing invariants** a contributor
+must respect, plus navigation aids. When a fact here and the README disagree about *how a
+feature works*, the README wins; this file is the source of truth for *how to keep it working*.
+
+## Overview
+
+This plugin contributes, via the `led_ticker.plugins` entry point, a single widget:
+
+- `pool.monitor` — pool water-temperature from an InfluxDB v2 server (Flux queries). Cycles a
+  title card + today's temp (trend arrow), 7-day mean (hi/lo), and season hi/lo, zone-colored by
+  temperature. Two layouts: `ticker` (default, single-row segmented; smallsign-friendly) and
+  `two_row` (label-on-top / big-number-on-bottom; bigsign/longboi).
+
+The entry-point name `pool` is the plugin namespace, so the config `type` is `pool.monitor`
+(see `register()` in `__init__.py`).
+
+## Commands
+
+led-ticker is **not on PyPI**; it resolves from a sibling checkout via
+`[tool.uv.sources] led-ticker = { path = "../led-ticker", editable = true }`. CI checks out
+`led-ticker` next to this repo using a read-only deploy key (`LED_TICKER_DEPLOY_KEY`). The
+sibling checkout matters at test time too: `pyproject.toml` puts `../led-ticker/tests/stubs`
+on the pytest path so the rgbmatrix stub is importable headless.
+
+```bash
+uv sync --extra dev          # install deps (needs ../led-ticker checked out)
+uv run pytest -q             # full suite (asyncio_mode = "auto")
+uv run ruff check src tests  # lint — run before pushing
+```
+
+Python **3.14+** only. Running the widget needs `INFLUXDB_TOKEN` set (see below).
+
+## Package layout
+
+```
+src/led_ticker_pool/
+  __init__.py     # register(api) → api.widget("monitor")(PoolMonitor)
+  monitor.py      # PoolMonitor: async InfluxDB Flux fetch, dual-layout screen building,
+                  #   config validation, zone coloring, trend arrows, staleness dimming
+```
+
+`register(api)` (in `__init__.py`):
+
+```python
+def register(api):
+    api.widget("monitor")(PoolMonitor)
+```
+
+## Load-bearing invariants
+
+Each rule must hold when modifying `monitor.py`.
+
+**Import only the public surface** — every `led_ticker` import MUST come from `led_ticker.plugin`,
+never `led_ticker.<internal>`. Enforced by `tests/test_import_purity.py`, which AST-walks every
+source file. If you need a core symbol that isn't on `led_ticker.plugin.__all__`, that's a core
+API change — raise it upstream, don't reach around the surface.
+
+**Python 3.14 / PEP 649** — no `from __future__ import annotations` (same rule as core).
+
+**`validate_config()` contract** (`PoolMonitor.validate_config`, a classmethod run pre-coercion by
+the engine) — this widget **raises `ValueError`** directly on a bad config (unlike some plugins
+that return message strings). It rejects: a `current_window` that isn't a negative Flux duration
+(`^-(\d+(ns|us|ms|s|m|h|d|w))+$`); a `sensor_id` outside `[A-Za-z0-9_-]+` (the value is interpolated
+into Flux, so this is an injection-safety gate); a `layout` not in `("ticker", "two_row")`; and any
+of the two-row-only fields (`top_font`/`bottom_font`/`top_row_height`/the per-row size+threshold
+knobs) when `layout != "two_row"` — named, not silently ignored.
+
+**Flux `group()` before aggregation** — multi-sensor buckets MUST `group()` before `last`/`mean`/
+`min`/`max`, otherwise the CSV parser picks the first series in tag-sort order and season HI/LO
+diverges from today/7-day (the real bug: "season HI 37°F but pool app shows 90°F"). Tripwire:
+`test_inserts_group_before_aggregation` in `tests/test_monitor.py`.
+
+**Thread `font` and `label_color` everywhere** — the configured `font` and `label_color` must reach
+every `SegmentMessage` / `TwoRowMessage` the widget builds (title + all three stories + the
+placeholder). Miss one and the config knob silently no-ops (the "chunky text misplaced" / "label
+color ignored" class of bug).
+
+**`current_window` vs `stale_after` are decoupled** — `current_window` is a hard cutoff: no reading
+inside it → display `--`. `stale_after` only controls the dim-gray coloring; a reading older than
+`stale_after` still displays, dimmed. Don't collapse them.
+
+**No degree symbol in temperatures** — `_fmt_temp` emits bare `F`/`C`, never `°F`/`°C`, because the
+hires Inter font rasterized small drops U+00B0 to `?` (consistent with the weather widget).
+
+**`INFLUXDB_TOKEN` is required, never logged** — the widget raises `ValueError` in `start()` (before
+entering the monitor loop) if the token is missing, so it surfaces immediately in logs. The token
+must never appear in any log line.
+
+**One INFO log per successful `update()`** — the Container contract: a silent log stream after
+startup signals the background task died. Each successful update emits exactly one INFO line
+(including the current temp, never the token).
+
+**Zone color is always evaluated in °F** regardless of the display unit, so thresholds stay
+consistent across imperial/metric. `PoolMonitor` is an `attrs.define` class with several
+`kw_only=True` fields (`font`, `layout`, `label_color`, `top_font`, `bottom_font`, `top_row_height`)
+— construct with named args for those.
+
+## Tests / CI
+
+`uv run pytest -q` runs the suite (`tests/`):
+
+- `test_import_purity.py` — AST tripwire (public-surface-only). A failure is a contract violation.
+- `test_smoke.py` — loads the plugin through led-ticker's real loader; asserts `pool.monitor`
+  registers under the `pool` namespace.
+- `test_monitor.py` — zone coloring, trend arrows, unit conversion, CSV parsing, Flux query
+  building (incl. the `group()` tripwire), both layouts' screen building, `validate_config`, and the
+  token/staleness/logging contracts.
+
+CI (`.github/workflows/ci.yml`): checks out this repo + led-ticker as siblings (deploy key),
+Python 3.14, `uv sync --extra dev`, then `ruff check src tests` and `pytest -q`.
+
+## Adding to the plugin
+
+Register the class in `register()` in `__init__.py` (`api.widget`); it becomes `pool.<name>`.
+Import any core dependency from `led_ticker.plugin` only, and keep the import-purity test green.

led_ticker_pool-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 James Awesome
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

led_ticker_pool-0.1.0/Makefile

@@ -0,0 +1,18 @@
+.PHONY: dev test lint format typecheck
+
+dev:  ## Install dev deps + pre-commit hooks
+	uv sync --extra dev
+	uv run pre-commit install
+	uv run pre-commit install --hook-type pre-push
+
+test:  ## Run tests with coverage
+	uv run pytest --cov=src --cov-report=term-missing
+
+lint:  ## Ruff lint
+	uv run ruff check src tests
+
+format:  ## Ruff format
+	uv run ruff format src tests
+
+typecheck:  ## Pyright
+	uv run pyright src

led_ticker_pool-0.1.0/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: led-ticker-pool
+Version: 0.1.0
+Summary: Pool water-temperature monitor widget for led-ticker (InfluxDB v2 backed).
+Project-URL: Homepage, https://docs.ledticker.dev
+Project-URL: Repository, https://github.com/JamesAwesome/led-ticker-plugins
+Project-URL: Issues, https://github.com/JamesAwesome/led-ticker-plugins/issues
+Author-email: James Awesome <james@morelli.nyc>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.14
+Requires-Dist: aiohttp
+Requires-Dist: led-ticker-core>=2.0
+Provides-Extra: dev
+Requires-Dist: pre-commit>=4.0; extra == 'dev'
+Requires-Dist: pyright>=1.1; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# led-ticker-pool
+
+A pool water-temperature monitor **widget** for [led-ticker](https://github.com/JamesAwesome/led-ticker), backed by an InfluxDB v2 server (e.g. [pool_monitor](https://github.com/JamesAwesome/pool_monitor)). It's a led-ticker **plugin** — installing this package contributes a `pool.monitor` widget you reference in your led-ticker config.
+
+It cycles four screens — a title card, today's current temperature with a trend arrow (`^`/`v`/`-`) and hi/lo, a 7-day mean with hi/lo, and a season (current-year) hi/lo. Temperature is zone-colored — blue below 70°F, green 70–79°F, orange 80–89°F, red 90°F+ — so the comfort level is readable at a glance. Data is fetched in the background via async polling, so the display keeps running even if the server is briefly unreachable.
+
+## Screenshots
+
+**`layout = "ticker"`** (default — single-row segmented screens, smallsign-friendly):
+
+![Pool widget in ticker layout — single-row segmented screens with trend arrow and hi/lo](docs/widget-pool.gif)
+
+**`layout = "two_row"`** (stacked label-on-top / big-number-on-bottom, bigsign / longboi):
+
+![Pool widget in two_row layout — stacked label-on-top, big-number-on-bottom](docs/widget-pool-two-row.gif)
+
+## Prerequisites
+
+- **A running led-ticker** (the sign + its config). This widget plugs into it.
+- **A running InfluxDB v2 server** holding pool temperature data. The reference stack is [pool_monitor](https://github.com/JamesAwesome/pool_monitor), which provides the bucket and sensor schema this widget expects.
+- **An InfluxDB auth token** — set `INFLUXDB_TOKEN` in your led-ticker `.env` (or as a per-widget config key). The widget raises `ValueError` at startup if it's missing. See [InfluxDB setup](#influxdb-setup) for all four connection variables.
+
+## Install
+
+The widget auto-registers via the `led_ticker.plugins` entry point — once the package is installed, no `[plugins]` config change is needed.
+
+**Into a containerized led-ticker (recommended):** add this package to `config/requirements-plugins.txt` (copy it from `config/requirements-plugins.example.txt`, which already lists it), then rebuild:
+
+```bash
+# in your led-ticker checkout
+cp config/requirements-plugins.example.txt config/requirements-plugins.txt
+docker compose up -d --build
+```
+
+**Standalone (bare-metal / a venv that already has led-ticker):**
+
+```bash
+pip install "git+https://github.com/JamesAwesome/led-ticker-pool.git@main"
+```
+
+(led-ticker isn't on PyPI, so `pip` can't fetch it — this path works only where led-ticker is already installed, e.g. inside the led-ticker Docker image or a venv set up as in [Development](#development) below. See the led-ticker [Plugins docs](https://docs.ledticker.dev/plugins/) for the constraint-based install the image uses.)
+
+## Configuration
+
+Reference the widget in a playlist section by `type = "pool.monitor"`:
+
+```toml
+[[playlist.section.widget]]
+type = "pool.monitor"
+title = "POOL TEMPS"
+units = "imperial"
+```
+
+### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `title` | string | `"POOL TEMPS"` | Label shown on the title screen. |
+| `sensor_id` | string | none | Sensor ID to filter on. Omit to use the only/first sensor in the bucket. Must match `[A-Za-z0-9_-]+`. |
+| `units` | string | `"imperial"` | `"imperial"` (°F) or `"metric"` (°C). |
+| `update_interval` | int | `300` | Seconds between InfluxDB fetches (5 min default). |
+| `current_window` | string | `"-24h"` | How far back to search for the latest reading, as a negative Flux duration (`"-24h"`, `"-90m"`). Older than this → `--` placeholder. Widen it if your sensor reports infrequently. |
+| `stale_after` | float | `14400` | Seconds since the last reading before the temperature dims to gray (stale signal). 4 h default. |
+| `influxdb_url` | string | `$INFLUXDB_URL` / `"http://influxdb:8086"` | InfluxDB v2 base URL. Config overrides the env var. |
+| `influxdb_org` | string | `$INFLUXDB_ORG` / `"pool"` | InfluxDB organization. |
+| `influxdb_bucket` | string | `$INFLUXDB_BUCKET` / `"pool_temps"` | InfluxDB bucket. |
+| `influxdb_token` | string | `$INFLUXDB_TOKEN` | InfluxDB v2 token. **Required** — the widget raises `ValueError` at startup if it's missing. |
+| `layout` | `"ticker"` \| `"two_row"` | `"ticker"` | Render mode (see below). |
+| `label_color` | `[r,g,b]` | white | Color for prefix labels / separators. |
+| `font` / `font_size` / `font_threshold` | font name / int / int | `"6x12"` | Main text font. A BDF alias (`6x12`, `5x8`) or a hires font name (`Inter-Regular`) with `font_size` in real pixels. In `two_row`, the per-row knobs below override this. |
+| `top_font` / `top_font_size` / `top_font_threshold` | font / int / int | inherit `font` | **two_row only:** top (label) row font knobs. |
+| `bottom_font` / `bottom_font_size` / `bottom_font_threshold` | font / int / int | inherit | **two_row only:** bottom (value) row font knobs. |
+| `top_row_height` | int (logical rows) | `None` | **two_row only:** top band height. `None` = symmetric 8/8 split. |
+
+The per-row knobs apply ONLY when `layout = "two_row"`; setting them under `ticker` fails config validation.
+
+### Layouts
+
+- **`ticker`** (default) — single-row segmented screens; the today screen shows current temp + trend arrow and hi/lo, the 7-day screen the mean + hi/lo, the season screen HI/LO together. Best for small panels (smallsign 160×16).
+- **`two_row`** — stacked label-on-top / big-number-on-bottom. Cycles four screens with top-row labels `POOL` (title), `POOL 24H` (current temp, zone-colored), `POOL 7D` (7-day HI/LO), and `POOL SEASON` (season HI/LO) — HI in orange, LO in blue, shown together on one screen (e.g. `84/72F`). The trend arrow is dropped (bottom is the value only). Best for bigsign / longboi (256×64 / 512×64).
+
+A `two_row` example:
+
+```toml
+[[playlist.section.widget]]
+type = "pool.monitor"
+title = "POOL TEMPS"
+layout = "two_row"
+units = "imperial"
+font = "Inter-Regular"
+font_size = 32
+label_color = [130, 220, 255]
+```
+
+## InfluxDB setup
+
+The widget reads connection details from your led-ticker `.env` (or per-widget overrides). `INFLUXDB_TOKEN` is required; the rest default to the standard pool_monitor Docker Compose stack.
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `INFLUXDB_TOKEN` | **yes** | — | InfluxDB v2 auth token. |
+| `INFLUXDB_URL` | no | `http://influxdb:8086` | Base URL. |
+| `INFLUXDB_ORG` | no | `pool` | Organization. |
+| `INFLUXDB_BUCKET` | no | `pool_temps` | Bucket. |
+
+The widget queries water-temperature readings with Flux over HTTP and computes today / 7-day / season aggregates. Stale data (older than `stale_after`) renders dim gray; the trend arrow compares the latest reading to a ~45-minute trailing average (sub-0.5°F shows `-`).
+
+## Development
+
+led-ticker isn't on PyPI, so install it editable from a sibling checkout. This repo's `pyproject.toml` pins `led-ticker` to `../led-ticker` via `[tool.uv.sources]`:
+
+```bash
+git clone https://github.com/JamesAwesome/led-ticker ../led-ticker   # sibling checkout
+git clone https://github.com/JamesAwesome/led-ticker-pool && cd led-ticker-pool
+uv venv
+uv pip install -e ../led-ticker -e ".[dev]"
+uv run pytest -q
+```
+
+> **Note:** led-ticker's `graphics` surface works headless via its bundled stub, but the full `RGBMatrix`/canvas test stub lives in led-ticker's `tests/stubs/` and isn't shipped. This repo's tests put it on the path via `pyproject.toml`'s `[tool.pytest.ini_options] pythonpath = ["../led-ticker/tests/stubs"]`.
+
+## Links
+
+- led-ticker project: <https://github.com/JamesAwesome/led-ticker>
+- led-ticker plugin system: <https://docs.ledticker.dev/plugins/>

led_ticker_pool-0.1.0/README.md

@@ -0,0 +1,125 @@
+# led-ticker-pool
+
+A pool water-temperature monitor **widget** for [led-ticker](https://github.com/JamesAwesome/led-ticker), backed by an InfluxDB v2 server (e.g. [pool_monitor](https://github.com/JamesAwesome/pool_monitor)). It's a led-ticker **plugin** — installing this package contributes a `pool.monitor` widget you reference in your led-ticker config.
+
+It cycles four screens — a title card, today's current temperature with a trend arrow (`^`/`v`/`-`) and hi/lo, a 7-day mean with hi/lo, and a season (current-year) hi/lo. Temperature is zone-colored — blue below 70°F, green 70–79°F, orange 80–89°F, red 90°F+ — so the comfort level is readable at a glance. Data is fetched in the background via async polling, so the display keeps running even if the server is briefly unreachable.
+
+## Screenshots
+
+**`layout = "ticker"`** (default — single-row segmented screens, smallsign-friendly):
+
+![Pool widget in ticker layout — single-row segmented screens with trend arrow and hi/lo](docs/widget-pool.gif)
+
+**`layout = "two_row"`** (stacked label-on-top / big-number-on-bottom, bigsign / longboi):
+
+![Pool widget in two_row layout — stacked label-on-top, big-number-on-bottom](docs/widget-pool-two-row.gif)
+
+## Prerequisites
+
+- **A running led-ticker** (the sign + its config). This widget plugs into it.
+- **A running InfluxDB v2 server** holding pool temperature data. The reference stack is [pool_monitor](https://github.com/JamesAwesome/pool_monitor), which provides the bucket and sensor schema this widget expects.
+- **An InfluxDB auth token** — set `INFLUXDB_TOKEN` in your led-ticker `.env` (or as a per-widget config key). The widget raises `ValueError` at startup if it's missing. See [InfluxDB setup](#influxdb-setup) for all four connection variables.
+
+## Install
+
+The widget auto-registers via the `led_ticker.plugins` entry point — once the package is installed, no `[plugins]` config change is needed.
+
+**Into a containerized led-ticker (recommended):** add this package to `config/requirements-plugins.txt` (copy it from `config/requirements-plugins.example.txt`, which already lists it), then rebuild:
+
+```bash
+# in your led-ticker checkout
+cp config/requirements-plugins.example.txt config/requirements-plugins.txt
+docker compose up -d --build
+```
+
+**Standalone (bare-metal / a venv that already has led-ticker):**
+
+```bash
+pip install "git+https://github.com/JamesAwesome/led-ticker-pool.git@main"
+```
+
+(led-ticker isn't on PyPI, so `pip` can't fetch it — this path works only where led-ticker is already installed, e.g. inside the led-ticker Docker image or a venv set up as in [Development](#development) below. See the led-ticker [Plugins docs](https://docs.ledticker.dev/plugins/) for the constraint-based install the image uses.)
+
+## Configuration
+
+Reference the widget in a playlist section by `type = "pool.monitor"`:
+
+```toml
+[[playlist.section.widget]]
+type = "pool.monitor"
+title = "POOL TEMPS"
+units = "imperial"
+```
+
+### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `title` | string | `"POOL TEMPS"` | Label shown on the title screen. |
+| `sensor_id` | string | none | Sensor ID to filter on. Omit to use the only/first sensor in the bucket. Must match `[A-Za-z0-9_-]+`. |
+| `units` | string | `"imperial"` | `"imperial"` (°F) or `"metric"` (°C). |
+| `update_interval` | int | `300` | Seconds between InfluxDB fetches (5 min default). |
+| `current_window` | string | `"-24h"` | How far back to search for the latest reading, as a negative Flux duration (`"-24h"`, `"-90m"`). Older than this → `--` placeholder. Widen it if your sensor reports infrequently. |
+| `stale_after` | float | `14400` | Seconds since the last reading before the temperature dims to gray (stale signal). 4 h default. |
+| `influxdb_url` | string | `$INFLUXDB_URL` / `"http://influxdb:8086"` | InfluxDB v2 base URL. Config overrides the env var. |
+| `influxdb_org` | string | `$INFLUXDB_ORG` / `"pool"` | InfluxDB organization. |
+| `influxdb_bucket` | string | `$INFLUXDB_BUCKET` / `"pool_temps"` | InfluxDB bucket. |
+| `influxdb_token` | string | `$INFLUXDB_TOKEN` | InfluxDB v2 token. **Required** — the widget raises `ValueError` at startup if it's missing. |
+| `layout` | `"ticker"` \| `"two_row"` | `"ticker"` | Render mode (see below). |
+| `label_color` | `[r,g,b]` | white | Color for prefix labels / separators. |
+| `font` / `font_size` / `font_threshold` | font name / int / int | `"6x12"` | Main text font. A BDF alias (`6x12`, `5x8`) or a hires font name (`Inter-Regular`) with `font_size` in real pixels. In `two_row`, the per-row knobs below override this. |
+| `top_font` / `top_font_size` / `top_font_threshold` | font / int / int | inherit `font` | **two_row only:** top (label) row font knobs. |
+| `bottom_font` / `bottom_font_size` / `bottom_font_threshold` | font / int / int | inherit | **two_row only:** bottom (value) row font knobs. |
+| `top_row_height` | int (logical rows) | `None` | **two_row only:** top band height. `None` = symmetric 8/8 split. |
+
+The per-row knobs apply ONLY when `layout = "two_row"`; setting them under `ticker` fails config validation.
+
+### Layouts
+
+- **`ticker`** (default) — single-row segmented screens; the today screen shows current temp + trend arrow and hi/lo, the 7-day screen the mean + hi/lo, the season screen HI/LO together. Best for small panels (smallsign 160×16).
+- **`two_row`** — stacked label-on-top / big-number-on-bottom. Cycles four screens with top-row labels `POOL` (title), `POOL 24H` (current temp, zone-colored), `POOL 7D` (7-day HI/LO), and `POOL SEASON` (season HI/LO) — HI in orange, LO in blue, shown together on one screen (e.g. `84/72F`). The trend arrow is dropped (bottom is the value only). Best for bigsign / longboi (256×64 / 512×64).
+
+A `two_row` example:
+
+```toml
+[[playlist.section.widget]]
+type = "pool.monitor"
+title = "POOL TEMPS"
+layout = "two_row"
+units = "imperial"
+font = "Inter-Regular"
+font_size = 32
+label_color = [130, 220, 255]
+```
+
+## InfluxDB setup
+
+The widget reads connection details from your led-ticker `.env` (or per-widget overrides). `INFLUXDB_TOKEN` is required; the rest default to the standard pool_monitor Docker Compose stack.
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `INFLUXDB_TOKEN` | **yes** | — | InfluxDB v2 auth token. |
+| `INFLUXDB_URL` | no | `http://influxdb:8086` | Base URL. |
+| `INFLUXDB_ORG` | no | `pool` | Organization. |
+| `INFLUXDB_BUCKET` | no | `pool_temps` | Bucket. |
+
+The widget queries water-temperature readings with Flux over HTTP and computes today / 7-day / season aggregates. Stale data (older than `stale_after`) renders dim gray; the trend arrow compares the latest reading to a ~45-minute trailing average (sub-0.5°F shows `-`).
+
+## Development
+
+led-ticker isn't on PyPI, so install it editable from a sibling checkout. This repo's `pyproject.toml` pins `led-ticker` to `../led-ticker` via `[tool.uv.sources]`:
+
+```bash
+git clone https://github.com/JamesAwesome/led-ticker ../led-ticker   # sibling checkout
+git clone https://github.com/JamesAwesome/led-ticker-pool && cd led-ticker-pool
+uv venv
+uv pip install -e ../led-ticker -e ".[dev]"
+uv run pytest -q
+```
+
+> **Note:** led-ticker's `graphics` surface works headless via its bundled stub, but the full `RGBMatrix`/canvas test stub lives in led-ticker's `tests/stubs/` and isn't shipped. This repo's tests put it on the path via `pyproject.toml`'s `[tool.pytest.ini_options] pythonpath = ["../led-ticker/tests/stubs"]`.
+
+## Links
+
+- led-ticker project: <https://github.com/JamesAwesome/led-ticker>
+- led-ticker plugin system: <https://docs.ledticker.dev/plugins/>

led_ticker_pool-0.1.0/pyproject.toml

@@ -0,0 +1,58 @@
+[project]
+name = "led-ticker-pool"
+version = "0.1.0"
+description = "Pool water-temperature monitor widget for led-ticker (InfluxDB v2 backed)."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.14"
+authors = [{ name = "James Awesome", email = "james@morelli.nyc" }]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+    "Operating System :: POSIX :: Linux",
+    "Topic :: Multimedia :: Graphics",
+]
+dependencies = [
+    "led-ticker-core>=2.0",
+    "aiohttp",
+]
+
+# The widget is contributed to led-ticker via this entry point. The entry-point
+# NAME ("pool") becomes the plugin namespace, so the widget is referenced in
+# TOML as `type = "pool.monitor"`.
+[project.entry-points."led_ticker.plugins"]
+pool = "led_ticker_pool:register"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "pytest-cov>=5.0",
+    "pre-commit>=4.0",
+    "ruff>=0.4",
+    "pyright>=1.1",
+]
+
+[project.urls]
+Homepage = "https://docs.ledticker.dev"
+Repository = "https://github.com/JamesAwesome/led-ticker-plugins"
+Issues = "https://github.com/JamesAwesome/led-ticker-plugins/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/led_ticker_pool"]
+
+[tool.ruff]
+target-version = "py314"
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+
+[tool.coverage.report]
+fail_under = 90

led_ticker_pool-0.1.0/src/led_ticker_pool/__init__.py

@@ -0,0 +1,11 @@
+"""led-ticker-pool: a pool water-temperature monitor widget for led-ticker.
+
+Contributed via the ``led_ticker.plugins`` entry point. The entry-point name
+``pool`` is the plugin namespace, so the widget is ``type = "pool.monitor"``.
+"""
+
+from led_ticker_pool.monitor import PoolMonitor
+
+
+def register(api):
+    api.widget("monitor")(PoolMonitor)