diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 88bca9f..255dafd 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -12,7 +12,7 @@ sphinx: configuration: docs/conf.py build: - os: ubuntu-20.04 + os: ubuntu-lts-latest tools: python: "3" diff --git a/adafruit_rgb_display/rgb.py b/adafruit_rgb_display/rgb.py index 8cfa5c9..0227cce 100644 --- a/adafruit_rgb_display/rgb.py +++ b/adafruit_rgb_display/rgb.py @@ -255,6 +255,19 @@ def rotation(self, val: int) -> None: raise ValueError("Rotation must be 0/90/180/270") self._rotation = val + @property + def root_group(self) -> None: + """Placeholder attribute to catch displayio use""" + raise NotImplementedError( + "Please use a displayio driver for the display. This is the pixel-level driver." + ) + + @root_group.setter + def root_group(self, val) -> None: + raise NotImplementedError( + "Please use a displayio driver for the display. This is the pixel-level driver." + ) + class DisplaySPI(Display): """Base class for SPI type devices""" diff --git a/docs/_static/custom.css b/docs/_static/custom.css new file mode 100644 index 0000000..d60cf4b --- /dev/null +++ b/docs/_static/custom.css @@ -0,0 +1,8 @@ +/* SPDX-FileCopyrightText: 2025 Sam Blenny + * SPDX-License-Identifier: MIT + */ + +/* Monkey patch the rtd theme to prevent horizontal stacking of short items + * see https://github.com/readthedocs/sphinx_rtd_theme/issues/1301 + */ +.py.property{display: block !important;} diff --git a/docs/conf.py b/docs/conf.py index 6ad6c55..6b33eca 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -104,6 +104,9 @@ # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ["_static"] +# Include extra css to work around rtd theme glitches +html_css_files = ["custom.css"] + # The name of an image file (relative to this directory) to use as a favicon of # the docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 # pixels large. diff --git a/ruff.toml b/ruff.toml index 6818392..bd41569 100644 --- a/ruff.toml +++ b/ruff.toml @@ -17,7 +17,6 @@ extend-select = [ "PLC2401", # non-ascii-name "PLC2801", # unnecessary-dunder-call "PLC3002", # unnecessary-direct-lambda-call - "E999", # syntax-error "PLE0101", # return-in-init "F706", # return-outside-function "F704", # yield-outside-function