Release commit created with Cranko.

+++ cranko-release-info-v1
[[projects]]
qnames = ["pywwt", "npm"]
version = "1.6.0"
age = 0

[[projects]]
qnames = ["pywwt", "pypa"]
version = "0.22.0"
age = 0

+++

.readthedocs.yaml

@@ -1,18 +1,17 @@
 version: 2
 
 build:
-  image: latest
+  os: ubuntu-22.04
+  tools:
+    python: mambaforge-4.10
+    nodejs: "18"
   apt_packages:
     - libpci-dev
 
-# As of June 2021, We need to set up a conda environment to install
-# a sufficiently new Node.js: https://github.com/readthedocs/readthedocs.org/issues/8249
-
 conda:
   environment: .readthedocs_env.yml
 
 python:
-  version: 3.9
   install:
     - method: pip
       path: .

.readthedocs_env.yml

@@ -5,30 +5,21 @@ channels:
 dependencies:
   - astropy
   - astropy-sphinx-theme
-  - commonmark
   - ipyevents
-  - ipython
+  - ipykernel
   - ipywidgets
-  - jupyterlab
-  - jupyterlab_widgets
-  - krb5
   - lxml
   - matplotlib
   - nbclassic
-  - nodejs
-  - notebook
   - numpydoc
   - pip
   - pyopengl
   - pyqt
   - pyqtwebengine
-  - python=3.9
+  - python =3.10
   - qt
   - qtpy
-  - recommonmark
   - reproject
-  - scipy
   - setuptools
   - sphinx
   - sphinx-automodapi
-  - widgetsnbextension

CHANGELOG.md

@@ -1,3 +1,15 @@
+# pypa:pywwt 0.22.0 (2023-09-15)
+
+- When using the bundled version of the WWT research app, make sure that we pull
+  in the new ESM-based WebGL rendering engine, by requiring the 0.16.x version
+  series of the research app (#366, #367, @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 help ensure that we're using
+  the new code.
+- Various sponsorship branding updates (#364, #366, @pkgw).
+- Various build system and CI/CD improvements (#362, #363, @pkgw)
+
+
 # pypa:pywwt 0.21.0 (2023-07-28)
 
 - Update `pywwt` to work with version 7 of the Jupyter `notebook` package (#356,

MANIFEST.in

@@ -23,10 +23,7 @@ graft pywwt/web_static
 
 # Documentation
 graft docs
-exclude docs/\#*
-prune docs/build
-prune docs/gh-pages
-prune docs/dist
+prune docs/_build
 
 # Tests
 graft tests

README.md

@@ -2,30 +2,27 @@
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.7164147.svg)](https://doi.org/10.5281/zenodo.7164147)
 [![Build Status](https://dev.azure.com/aasworldwidetelescope/WWT/_apis/build/status/WorldWideTelescope.pywwt?branchName=master)](https://dev.azure.com/aasworldwidetelescope/WWT/_build/latest?definitionId=2&branchName=master)
 
-# pywwt: AAS WorldWide Telescope from Python/Jupyter
+# pywwt: WorldWide Telescope from Python/Jupyter
 
 🚀🚀 [Click here to try out pywwt in the cloud!][go-cloud] 🚀🚀
 
 [go-cloud]: https://mybinder.org/v2/gh/WorldWideTelescope/pywwt-notebooks/master?urlpath=lab/tree/Start%20Here.ipynb
 
-*Note: our cloud servers usually start up quickly, but if they were recently
+*Note: the cloud servers usually start up quickly, but if they were recently
 updated you may have to wait a few minutes for the backing software images to be
 rebuilt.*
 
+
 ## About
 
 The [pywwt] package is the official toolkit for visualizing astronomical data in
-Python using [AAS][aas] [WorldWide Telescope][wwt] (WWT). WWT is a free,
-open-source tool for visually exploring humanity’s scientific understanding of
-the Universe. It includes a sophisticated 4D WebGL rendering engine and a
-cloud-based web service for sharing and visualizing terabytes of astronomical
-data. WWT is brought to you by the non-profit [American Astronomical Society][aas]
-(AAS), the major organization of professional astronomers in North America, and
-the [.NET Foundation][dnf].
+Python using [WorldWide Telescope][wwt] (WWT), a free, open-source astronomy
+visualization system. WWT includes a sophisticated 4D WebGL rendering engine and
+a cloud-based web service for sharing and visualizing terabytes of astronomical
+data.
 
 [pywwt]: https://pywwt.readthedocs.io/
-[aas]: https://aas.org/
-[wwt]: http://www.worldwidetelescope.org/home
+[wwt]: https://worldwidetelescope.org/home
 [dnf]: https://dotnetfoundation.org/
 
 ![A WWT screenshot showing exoplanets in the Kepler field overlaid on a background sky map.](docs/images/data_layers_kepler.png "Kepler exoplanets in pywwt")
@@ -43,8 +40,32 @@ With [pywwt] you can:
 [qt]: https://www.qt.io/
 [tables]: https://docs.astropy.org/en/stable/table/
 
-The full documentation, including installation instructions, can be found at
-<http://pywwt.readthedocs.io/>.
+[//]: # (numfocus-fiscal-sponsor-attribution)
+
+The WorldWide Telescope project uses an [open governance
+model](https://worldwidetelescope.org/about/governance/) and is fiscally
+sponsored by [NumFOCUS](https://numfocus.org/). Consider making a
+[tax-deductible donation](https://numfocus.org/donate-for-worldwide-telescope)
+to help the project pay for developer time, professional services, travel,
+workshops, and a variety of other needs.
+
+<div align="center">
+  <a href="https://numfocus.org/donate-for-worldwide-telescope">
+    <img height="60px"
+         src="https://raw.githubusercontent.com/numfocus/templates/master/images/numfocus-logo.png">
+  </a>
+</div>
+
+
+## Installation
+
+The full pywwt documentation, including installation instructions, can be found
+at <https://pywwt.readthedocs.io/>.
+
+
+## Reporting issues
+
+If you run into any issues, please open an issue [here](https://github.com/WorldWideTelescope/pywwt/issues).
 
 
 ## For Developers: Testing
@@ -95,22 +116,50 @@ the Git repository doesn't actually make it smaller, so removing old reference
 images only helps a bit with housekeeping.
 
 
-## Reporting issues
+## Continuous Integration and Deployment
 
-If you run into any issues, please open an issue [here](https://github.com/WorldWideTelescope/pywwt/issues).
+This repository uses [Cranko] to automate release workflows. This automation is
+essential to the smooth and reproducible deployment of the WWT web services.
+
+[Cranko]: https://pkgw.github.io/cranko/
+
+
+## Getting involved
+
+We love it when people get involved in the WWT community! You can get started
+by [participating in our user forum] or by
+[signing up for our low-traffic newsletter]. If you would like to help make
+WWT better, our [Contributor Hub] aims to be your one-stop shop for
+information about how to contribute to the project, with the
+[Contributors’ Guide] being the first thing you should read. Here on GitHub we
+operate with a standard [fork-and-pull] model.
+
+[participating in our user forum]: https://wwt-forum.org/
+[signing up for our low-traffic newsletter]: https://bit.ly/wwt-signup
+[Contributor Hub]: https://worldwidetelescope.github.io/
+[Contributors’ Guide]: https://worldwidetelescope.github.io/contributing/
+[fork-and-pull]: https://help.github.com/en/articles/about-collaborative-development-models
+
+All participation in WWT communities is conditioned on your adherence to the
+[WWT Code of Conduct], which basically says that you should not be a jerk.
+
+[WWT Code of Conduct]: https://worldwidetelescope.github.io/code-of-conduct/
 
 
 ## Acknowledgments
 
-The AAS WorldWide Telescope (WWT) system, including pywwt, is a [.NET
-Foundation][dnf] project. Work on WWT and pywwt has been supported by the
-[American Astronomical Society][aas] (AAS), the US [National Science Foundation][nsf]
-(grants [1550701], [1642446], and [2004840]), the [Gordon and Betty Moore Foundation][moore], and
-[Microsoft][msft].
-
-[nsf]: https://www.nsf.gov/
-[1550701]: https://www.nsf.gov/awardsearch/showAward?AWD_ID=1550701
-[1642446]: https://www.nsf.gov/awardsearch/showAward?AWD_ID=1642446
-[2004840]: https://www.nsf.gov/awardsearch/showAward?AWD_ID=2004840
-[moore]: https://www.moore.org/
-[msft]: https://microsoft.com/
+Work on the WorldWide Telescope system has been supported by the [American
+Astronomical Society] (AAS), the [.NET Foundation], and other partners. See [the
+WWT user website][acks] for details.
+
+[American Astronomical Society]: https://aas.org/
+[.NET Foundation]: https://dotnetfoundation.org/
+[acks]: https://worldwidetelescope.org/about/acknowledgments/
+
+
+## Legalities
+
+The WWT code is licensed under the [MIT License]. The copyright to the code is
+owned by the [.NET Foundation].
+
+[MIT License]: https://opensource.org/licenses/MIT

ci/azure-build-and-test.yml

@@ -230,7 +230,7 @@ jobs:
       source activate-conda.sh
       conda activate build
       set -x
-      \conda install -y astropy astropy-sphinx-theme jupyter_sphinx numpydoc sphinx sphinx-automodapi
+      \conda install -y astropy astropy-sphinx-theme ipykernel jupyter_sphinx nbclassic numpydoc sphinx sphinx-automodapi
       cd docs
       make html
     displayName: Build docs

ci/zenodo.json5

@@ -47,27 +47,27 @@
         "orcid": "0000-0003-3175-2347"
       }
     ],
-    "description": "pywwt is the official toolkit for accessing AAS WorldWide Telescope (WWT) from Python. Learn more at <a href=\"https://pywwt.readthedocs.io/\">the pywwt website</a>.",
+    "description": "pywwt is the official toolkit for accessing WorldWide Telescope (WWT) from Python. Learn more at <a href=\"https://pywwt.readthedocs.io/\">the pywwt website</a>.",
     "grants": [
       {
         "id": "10.13039/100000001::1550701"
       }
     ],
     "keywords": [
-      "AAS WorldWide Telescope",
       "Astronomy",
       "Python",
-      "Visualization"
+      "Visualization",
+      "WorldWide Telescope"
     ],
     "language": "eng",
     "license": "BSD-3-Clause",
-    "publication_date": "2023-07-28",
-    "title": "pypa:pywwt 0.21.0",
+    "publication_date": "2023-09-15",
+    "title": "pypa:pywwt 0.22.0",
     "upload_type": "software",
-    "version": "0.21.0"
+    "version": "0.22.0"
   },
   "conceptdoi": "10.5281/zenodo.7164147",
-  "record_id": "8193603",
-  "doi": "10.5281/zenodo.8193603",
-  "bucket_link": "https://zenodo.org/api/files/7fe44d30-f757-497f-8468-df0bf078b6af"
+  "record_id": "8350627",
+  "doi": "10.5281/zenodo.8350627",
+  "bucket_link": "https://zenodo.org/api/files/4d1eeef7-6d48-44b1-a8eb-ee7127b1eba4"
 }

docs/api/pywwt.core.BaseWWTWidget.rst

@@ -12,6 +12,8 @@ BaseWWTWidget
 
       ~BaseWWTWidget.actual_planet_scale
       ~BaseWWTWidget.alt_az_grid
+      ~BaseWWTWidget.alt_az_grid_color
+      ~BaseWWTWidget.alt_az_text
       ~BaseWWTWidget.available_hips_catalog_names
       ~BaseWWTWidget.available_layers
       ~BaseWWTWidget.available_views
@@ -20,18 +22,27 @@ BaseWWTWidget
       ~BaseWWTWidget.constellation_boundary_color
       ~BaseWWTWidget.constellation_figure_color
       ~BaseWWTWidget.constellation_figures
+      ~BaseWWTWidget.constellation_labels
+      ~BaseWWTWidget.constellation_pictures
       ~BaseWWTWidget.constellation_selection
       ~BaseWWTWidget.constellation_selection_color
       ~BaseWWTWidget.crosshairs
       ~BaseWWTWidget.crosshairs_color
       ~BaseWWTWidget.current_mode
       ~BaseWWTWidget.ecliptic
+      ~BaseWWTWidget.ecliptic_color
       ~BaseWWTWidget.ecliptic_grid
+      ~BaseWWTWidget.ecliptic_grid_color
+      ~BaseWWTWidget.ecliptic_text
       ~BaseWWTWidget.foreground
       ~BaseWWTWidget.foreground_opacity
       ~BaseWWTWidget.galactic_grid
+      ~BaseWWTWidget.galactic_grid_color
       ~BaseWWTWidget.galactic_mode
+      ~BaseWWTWidget.galactic_text
       ~BaseWWTWidget.grid
+      ~BaseWWTWidget.grid_color
+      ~BaseWWTWidget.grid_text
       ~BaseWWTWidget.imagery
       ~BaseWWTWidget.instruments
       ~BaseWWTWidget.layers
@@ -40,6 +51,8 @@ BaseWWTWidget
       ~BaseWWTWidget.location_latitude
       ~BaseWWTWidget.location_longitude
       ~BaseWWTWidget.most_recent_source
+      ~BaseWWTWidget.precession_chart
+      ~BaseWWTWidget.precession_chart_color
       ~BaseWWTWidget.selected_sources
       ~BaseWWTWidget.solar_system
 
@@ -58,6 +71,7 @@ BaseWWTWidget
       ~BaseWWTWidget.get_center
       ~BaseWWTWidget.get_current_time
       ~BaseWWTWidget.get_fov
+      ~BaseWWTWidget.get_roll
       ~BaseWWTWidget.load_image_collection
       ~BaseWWTWidget.load_tour
       ~BaseWWTWidget.pause_time
@@ -75,6 +89,8 @@ BaseWWTWidget
 
    .. autoattribute:: actual_planet_scale
    .. autoattribute:: alt_az_grid
+   .. autoattribute:: alt_az_grid_color
+   .. autoattribute:: alt_az_text
    .. autoattribute:: available_hips_catalog_names
    .. autoattribute:: available_layers
    .. autoattribute:: available_views
@@ -83,18 +99,27 @@ BaseWWTWidget
    .. autoattribute:: constellation_boundary_color
    .. autoattribute:: constellation_figure_color
    .. autoattribute:: constellation_figures
+   .. autoattribute:: constellation_labels
+   .. autoattribute:: constellation_pictures
    .. autoattribute:: constellation_selection
    .. autoattribute:: constellation_selection_color
    .. autoattribute:: crosshairs
    .. autoattribute:: crosshairs_color
    .. autoattribute:: current_mode
    .. autoattribute:: ecliptic
+   .. autoattribute:: ecliptic_color
    .. autoattribute:: ecliptic_grid
+   .. autoattribute:: ecliptic_grid_color
+   .. autoattribute:: ecliptic_text
    .. autoattribute:: foreground
    .. autoattribute:: foreground_opacity
    .. autoattribute:: galactic_grid
+   .. autoattribute:: galactic_grid_color
    .. autoattribute:: galactic_mode
+   .. autoattribute:: galactic_text
    .. autoattribute:: grid
+   .. autoattribute:: grid_color
+   .. autoattribute:: grid_text
    .. autoattribute:: imagery
    .. autoattribute:: instruments
    .. autoattribute:: layers
@@ -103,6 +128,8 @@ BaseWWTWidget
    .. autoattribute:: location_latitude
    .. autoattribute:: location_longitude
    .. autoattribute:: most_recent_source
+   .. autoattribute:: precession_chart
+   .. autoattribute:: precession_chart_color
    .. autoattribute:: selected_sources
    .. autoattribute:: solar_system
 
@@ -119,6 +146,7 @@ BaseWWTWidget
    .. automethod:: get_center
    .. automethod:: get_current_time
    .. automethod:: get_fov
+   .. automethod:: get_roll
    .. automethod:: load_image_collection
    .. automethod:: load_tour
    .. automethod:: pause_time

docs/api/pywwt.layers.TableLayer.rst

@@ -26,6 +26,7 @@ TableLayer
       ~TableLayer.marker_scale
       ~TableLayer.marker_type
       ~TableLayer.opacity
+      ~TableLayer.selectable
       ~TableLayer.size_att
       ~TableLayer.size_scale
       ~TableLayer.size_vmax
@@ -63,6 +64,7 @@ TableLayer
    .. autoattribute:: marker_scale
    .. autoattribute:: marker_type
    .. autoattribute:: opacity
+   .. autoattribute:: selectable
    .. autoattribute:: size_att
    .. autoattribute:: size_scale
    .. autoattribute:: size_vmax