board_tiles
===========

.. py:module:: board_tiles

.. autoapi-nested-parse::

   Fetch and change the tile settings of the board over the WLAN.

       uv run tools/board_tiles.py pull [--file tiles.json]
       uv run tools/board_tiles.py push [--file tiles.json]

   `pull` stores the board's tiles and warning sources in a local JSON file;
   edit it, then `push` sends it through the same API the web interface uses
   (POST /api/tiles), so the board checks it in the same way and redraws at
   once. A sleeping board is woken through the maintenance switch (see
   `wake`), so the command can be left running unattended. The file holds
   entity IDs of your installation and is ignored by git.



Attributes
----------

.. autoapisummary::

   board_tiles.ROOT
   board_tiles.DEFAULT_FILE


Functions
---------

.. autoapisummary::

   board_tiles.get_settings
   board_tiles.post_settings
   board_tiles.load_file
   board_tiles.save_file
   board_tiles.main


Module Contents
---------------

.. py:data:: ROOT

.. py:data:: DEFAULT_FILE

.. py:function:: get_settings(base)

   The board's tiles and warning sources, or None if it does not answer.


.. py:function:: post_settings(base, settings)

   Send the settings; return what the board saved.

   :raises SystemExit: With the board's message if it rejects the settings.


.. py:function:: load_file(path)

   Read and check settings from `path` before the board is woken.

   :raises SystemExit: If the file is missing or the settings are invalid.


.. py:function:: save_file(path, settings)

   Write settings to `path`, readable for editing.


.. py:function:: main()

   Run the command line tool.