Panoptes-utils

------

Fixed
^^^^^

* Fixes to support 420 namespaces and pyscaffold.
* Don't deserialize all strings as dates unless they actually look like a date.

------

Breaking
^^^^^^^^

* This release removes the Docker components from the repository, pushing some of the dependencies to ``POCS``. This is an attempt to make this module slimmer and more useful.
* The ``astrometry.net`` plate solving tests have been removed since we no longer build and test against a Docker image. The plate solving will continue to transition to the self-contained ``plate-solver`` repository.

------

Added
^^^^^

* New ``panoptes.utils.serial.device.SerialDevice`` that will replace the ``rs232.SerialData``. New class uses the threaded reader with optional callback for better asynchronous reading from a serial device. Example notebook included. 274
* ``ObservationPathInfo`` allows for easy parsing of the standard PANOPTES file name scheme, as provided by ``PATH_MATCHER``. 282
* ``extract_metadata`` pulls FITS headers into a common dictionary structure. 282
* Docker updates: Add ``PYTHONUNBUFFERED`` to docker files; Remove ``version`` and ``deploy`` keys from docker compose files. 284

Changed
^^^^^^^

* The serial protocol handlers were moved to the ``panoptes.utils.serial.handlers`` namespace. 274
* Testing Dockerfile has ``privileged`` permission to get device ``loop``. 275
* Dockerfile: update ``conda`` in Dockerfile before installing environment; install ``panoptes-utils`` module in user-editable mode. 277
* Dockerfile: use ``condaforge/miniforge3`` as the base, which reduces image size. Push multi-stage builds for better caching. 278, 279
* Consistent multi-stage names in Dockerfile; added ``jupyter_console``. 280
* Change behavior of ``parse_config_directories`` so the ``base`` entry must always exist or be missing (in which case the cwd is used). Remove the ``must_exist`` param. 283


Fixed
^^^^^

* Don't nest storage objects for the ``PanFileDB``. 280

-------------------

Added
^^^^^

* Added an ``RGB`` IntEnum for easy iterating and consistent array access of rgb data. 265
* Added ``save_rgb_bg_fits`` that will save a FITS files with seven extensions: combined rgb map, and then the background and rms maps for each color. 265

Changed
^^^^^^^

* ``get_rgb_background`` only accepts a ``data`` argument and a filename can no longer be passed. 265
* Updated defaults for ``get_rgb_background``. 265
* ``get_stamp_slice`` has ``as_slices`` param added with default ``True`` for legacy behavior. If ``False`` then just the four points are returned. 265
* Test coverage will skip `noqa` markers and pytest will run all tests. 265
* Added `ruamel.yaml` to base dependencies instead of just ``config`` extras. 265

Fixed
^^^^^

* The `timeout` parameter is now passed from `get_solve_field` to `solve_field`. 266

-------------------

Added
^^^^^

* Docker musical chairs:

* Add Dockerfile to be ``panoptes-utils`` but don't use for testing. (264)
* Generic ``panoptes-utils`` with ``panoptes-config-server`` as default command example. (264)
* Move conda ``environment`` file into ``docker`` folder. (264)

Bugs Fixed
^^^^^^^^^^

* ``parse_config_directories`` no longer modifies dictionary in place. (264)

Changed
^^^^^^^

* Clean out the Contributing guide to point to POCS. (264)
* Removing ``pillow<7`` requirement. (264)

Removed
^^^^^^^

* Removing unused new cli experiment. (264)
* Removed all ``PANDIR`` and ``PANLOG`` references. Closes 263. (264)
* Removed ``astroplan`` from dependencies. (264)

-------------------

Added
^^^^^

* Conda environment file (wtgee 260)
* A cli script for ``panoptes-utils``. This will eventually take over the ``panoptes-config-server`` and any other simple commands needed. For now can use ``panoptes-utils tests run`` for building and running tests.

Changed
^^^^^^^

* Updated testing to use specific docker image. Updated run script for more specific options on starting testing config server. (wtgee 260)
* Different ``extras`` install options: ``config``, ``docs``, ``images``, ``testing``, and ``social``. (wtgee 260)
* Use ``loguru`` for logging directly in all files, rather than needless import. (wtgee 260)
* Make the ``CountdownTimer.sleep()`` less noisy. (259)

Fixed
^^^^^

* Plate solving extras option parsing correctly. (wtgee 260)
* Explicit imports for some of the utils. (wtgee 260)

Removed
^^^^^^^

* Remove Docker services except for testing. (wtgee 260)
* Removed unused files: (wtgee 260)


* Example data fetching notebook removed.
* Hotspot script removed.
* Data (astrometry index and IERS) download removed.
* ``wait-for-it.sh`` script removed.
* TheSkyX utils moving to POCS directly.
* Removed ``moving_average``.
* Removed pipeline functions for getting ``image_id`` and ``sequence_id``.