Release request commit created with Cranko.

+++ cranko-rc-info-v1
[[projects]]
qnames = ["pywwt", "npm"]
bump_spec = "minor bump"

[[projects]]
qnames = ["pywwt", "pypa"]
bump_spec = "minor bump"

+++

.readthedocs_env.yml

@@ -22,4 +22,8 @@ dependencies:
   - reproject
   - setuptools
   - sphinx
-  - sphinx-automodapi
+  # This pin is to work around a conda verification error
+  # that first appeared in the CI for https://github.com/WorldWideTelescope/pywwt/pull/375.
+  # At the time of writing this, the issue only occurs with sphinx-automodapi==0.17,
+  # which is the newest version.
+  - sphinx-automodapi=0.16

CHANGELOG.md

@@ -1,14 +1,17 @@
-# rc: micro bump
+# rc: minor bump
 
-- Add kernel data relay to JupyterLab install requirements, and a `notebook` set
-  of named dependencies (#370, @Carifio24).
-
-This release once again has DOI registration and Zenodo deposition (#371,
-@pkgw).
+- Add an API to allow refreshing of the engine's tile cache (#375, @Carifio24).
+  This is not something that should be needed in any kind of regular usage, but
+  for long-lived applications that want to avoid page reloads, it can provide
+  an emergency means to unstick the data flow.
+- Only require `qtpy` if one of the Qt options is enabled (#376, @Carifio24).
+- Update Jupyter install requirements (#370, @Carifio24).
+- Re-enable DOI registration (#371, @pkgw). The Cranko Zenodo support has been
+  updated to work with the new Zenodo API contracts.
 
 The DOI of this release is [xx.xxxx/dev-build.pypa:pywwt.version][vdoi].
 
-[vdoi]: https://doi.org/xx.xxxx/dev-build.pypa:pywwt.version
+[vdoi]: xx.xxxx/dev-build.pypa:pywwt.version
 
 
 # pypa:pywwt 0.23.0 (2023-11-28)

ci/azure-build-and-test.yml

@@ -199,7 +199,7 @@ jobs:
       set -x
       \conda install -y pytest-cov pytest-remotedata pytest-timeout
       python setup.py build
-      pytest -v -s pywwt -p no:warnings --timeout=180 --timeout_method=thread --cov-report=xml --cov=pywwt
+      pytest -v -s pywwt -p no:warnings --timeout=1800 --timeout_method=thread --cov-report=xml --cov=pywwt
     displayName: Test with coverage
 
   - bash: bash <(curl -s https://codecov.io/bash)

ci/azure-job-setup.yml

@@ -100,8 +100,6 @@ steps:
       set -euo pipefail
       source activate-conda.sh
       set -x
-      # workaround for the Windows CI image:
-      conda install -y brotlipy
       conda config --add channels conda-forge
       conda config --set channel_priority strict
       conda update -y --all

frontend/CHANGELOG.md

@@ -1,8 +1,121 @@
-# See elsewhere for changelog
+# rc: minor bump
 
-This project’s release notes are curated from the Git history of its main
-branch. You can find them by looking at [the version of this file on the
-`release` branch][branch] or the [GitHub release history][gh-releases].
+- Require version 0.17 of the research app, which adds an API for refreshing
+  the tile cache (#375, @Carifio24).
 
-[branch]: https://github.com/WorldWideTelescope/pywwt/blob/release/frontend/CHANGELOG.md
-[gh-releases]: https://github.com/WorldWideTelescope/pywwt/releases
+
+# npm:pywwt 1.7.0 (2023-11-28)
+
+- Update the Jupyter widget implementation to use ES6 class syntax (#368,
+  @Carifio24). This should fix up compatibility with the 8.x series of
+  `ipywidgets`.
+
+
+# npm:pywwt 1.6.0 (2023-09-15)
+
+- Require the new ESM-based engine through the 0.16.x series of the research app
+  (#366, @pkgw). This shouldn't lead to any user-visible changes (or even
+  developer-visible ones), but in an effort to smoke out any oversights, we take
+  this step to ensure that we're using the new code. This change also brings in
+  a few sponsorship branding updates.
+
+
+# npm:pywwt 1.5.3 (2023-07-06)
+
+- Require the version 0.15.0 of the research app, to get new settings for
+  various grid colors (#355, @Carifio24).
+
+
+# npm:pywwt 1.5.2 (2023-05-30)
+
+- Require the version 0.14.3 of the research app, to get a fix for communicating
+  information about catalog sources (#353, @pkgw; pulls in
+  WorldWideTelescope/wwt-webgl-engine#251, @Carifio24).
+
+
+# npm:pywwt 1.5.1 (2023-05-26)
+
+- Require the version 0.14.2 of the research app, to get a fix for HiPS
+  catalogs loaded in HTTPS contexts (#352, @pkgw).
+
+
+# npm:pywwt 1.5.0 (2023-03-08)
+
+- Require version 0.14 of the research app, to get messages allowing the roll
+  state of the WWT camera to be read and written (#349, @Carifio24).
+
+
+# npm:pywwt 1.4.0 (2022-12-01)
+
+- Require version 0.12 of the research app, to get the latest improvements
+  including the Vue 3 update (#342, @pkgw).
+
+
+# npm:pywwt 1.3.3 (2022-01-19)
+
+- Require version 0.9.2 of the research app, to ensure we have support for
+  naming imageset layers (#326, @pkgw)
+
+
+# npm:pywwt 1.3.2 (2022-01-14)
+
+- Fix up license annotations
+- Require the latest research-app, version 0.9
+
+
+# npm:pywwt 1.3.1 (2021-10-14)
+
+- Fix a dumb string-processing bug in the URL canonicalization code that broke
+  the widget in Jupyter environments where the "base URL" is nontrivial (#314,
+  @pkgw).
+
+
+# npm:pywwt 1.3.0 (2021-09-24)
+
+- Bundle the research app in the pywwt distribution; currently requiring version
+  0.7.1 (#301, #313, @pkgw). Compared to the previous release of this package,
+  this includes a ton of new features: HiPS catalogs with data retrieval, tiled
+  FITS, and lots of UI polish!
+- Port the ipywidgets frontend to use the research app
+- Modify the internal APIs to allow the app to come and go, not just become
+  ready once
+
+
+# npm:pywwt 1.2.0 (2021-06-14)
+
+- New release to track internal cleanups in the pywwt Python code; the built-in
+  widget HTML is now served from `$baseurl/wwt/widget/`, instead of
+  `$baseurl/wwt/wwt.html`.
+- Internal cleanups.
+
+
+# npm:pywwt 1.1.1 (2021-01-27)
+
+- Proclaim compatibility with the 4.x series of @jupyter-widgets/base. This
+  should get the widget to work in the JupyterLab 3.x series.
+
+
+# npm:pywwt 1.1.0 (2020-10-22)
+
+- The Jupyter widget has reworked multi-view management to behave much better
+  when there are multiple views for the same widget model, or when views are
+  hidden and recreated.
+- The Jupyter widget now exposes a _viewConnected trait to indicate the case
+  when the widget has been created, but there are no active views presented to
+  the user. This isn't wired up to the Python layer, but it could be useful
+  later.
+
+
+# npm:pywwt 1.0.0 (2020-10-21)
+
+- Address #258 by transmitting WWT clock information using a reference point and
+  a rate, rather than constantly transmitting the current time. Dramatically
+  reduces JS <=> Python traffic.
+- Tidy up the JavaScript files.
+
+
+# npm:pywwt 0.9.1 (2020-10-18)
+
+- First release with version number decoupled from the pywwt Python package.
+- No code chages, but internal reorganizations including the use of Cranko for
+  release automation.

frontend/package.json

@@ -5,7 +5,7 @@
   },
   "dependencies": {
     "@jupyter-widgets/base": "^2  || ^3 || ^4 || ^5 || ^6",
-    "@wwtelescope/research-app": "^0.16.0",
+    "@wwtelescope/research-app": "^0.17.0",
     "underscore": "^1"
   },
   "description": "WorldWide Telescope from Python",

pywwt/core.py

@@ -1372,3 +1372,13 @@ def _serialize_to_json(self, file, title, max_width, max_height):
 
     def _save_added_data(self, dir):
         self.layers._save_all_data_for_serialization(dir)
+
+    # Miscellaneous
+
+    def refresh_tile_cache(self):
+        """
+        Clear the current cache of tiles.
+        Note that this should only be used when necessary, as any
+        previously downloaded tiles will need to be re-fetched.
+        """
+        self._send_msg(event="clear_tile_cache")

pywwt/tests/test_layers.py

@@ -10,6 +10,7 @@
 import pytest
 from stat import S_IWGRP, S_IWOTH, S_IWUSR, S_IMODE
 from tempfile import TemporaryDirectory
+from warnings import catch_warnings
 
 from . import assert_widget_image, wait_for_test, DATA
 from ..conftest import RUNNING_ON_CI, QT_INSTALLED  # noqa
@@ -285,7 +286,7 @@ def test_cartesian_layer(self):
 
         # Make sure adding the layer doesn't emit any warnings, which previously
         # happened due to a bug with the logic in the table layer initialization
-        with pytest.warns(None) as record:
+        with catch_warnings(record=True) as record:
             layer = self.client.layers.add_table_layer(
                 table=table, coord_type="rectangular", x_att="x", y_att="y", z_att="z"
             )

pywwt/tests/test_qt_widget.py

@@ -6,7 +6,7 @@
 from ..conftest import RUNNING_ON_CI
 
 
-WAIT_TIME = 5 if RUNNING_ON_CI else 1
+WAIT_TIME = 10 if RUNNING_ON_CI else 1
 M42 = SkyCoord.from_name('M42')
 
 

setup.py

@@ -117,7 +117,6 @@
         "numpy>=1.9",
         "python-dateutil",
         "pytz",
-        "qtpy",
         "reproject>=0.8",
         "requests",
         "toasty>=0.18",
@@ -142,10 +141,12 @@
         "qt": [
             'PyQt5;python_version>="3"',
             'PyQtWebEngine;python_version>="3"',
+            "qtpy",
         ],
         "qt6": [
             'PyQt6;python_version>="3"',
             'PyQt6-WebEngine;python_version>="3"',
+            "qtpy",
         ],
         "notebook": [
             "wwt_kernel_data_relay",