WorldWide Telescope embedded as an app within JupyterLab.
Перейти к файлу
Peter Williams a57c416555
Merge pull request #17 from pkgw/npm-publish-3
ci/azure-deployment.yml: OK it worked last time but one last thing to fix
2023-08-21 16:24:09 +00:00
.config/cranko Prep for repo rename 2021-01-28 16:34:12 -05:00
ci ci/azure-deployment.yml: OK it worked last time but one last thing to fix 2023-08-21 11:54:00 -04:00
schema Initial port to JupyterLab v4 2023-08-18 16:01:21 -04:00
src More sponsorship branding updates 2023-08-18 16:02:49 -04:00
style ... and move jupyterlab/ to the top level 2021-01-27 16:47:01 -05:00
wwt_jupyterlab_extension wwt_jupyterlab_extension/wwt_jupyterlab_extension/__init__.py: streamline this 2023-08-21 11:20:52 -04:00
.eslintignore ... and move jupyterlab/ to the top level 2021-01-27 16:47:01 -05:00
.eslintrc.js Fix eslints 2021-10-22 17:32:32 -04:00
.gitattributes Initial port to JupyterLab v4 2023-08-18 16:01:21 -04:00
.gitignore Initial port to JupyterLab v4 2023-08-18 16:01:21 -04:00
.prettierignore ... and move jupyterlab/ to the top level 2021-01-27 16:47:01 -05:00
.prettierrc ... and move jupyterlab/ to the top level 2021-01-27 16:47:01 -05:00
.yarnrc.yml .yarnrc.yml: no yarnPath for jlpm builds, I think 2023-08-18 16:36:38 -04:00
CHANGELOG.md Add main-branch changelog stubs 2021-10-23 09:54:03 -04:00
LICENSE wwt_jupyterlab_extension: add infra for Python prebuilt extension 2021-10-22 16:54:30 -04:00
README.md Initial port to JupyterLab v4 2023-08-18 16:01:21 -04:00
package.json Initial port to JupyterLab v4 2023-08-18 16:01:21 -04:00
tsconfig.json Initial port to JupyterLab v4 2023-08-18 16:01:21 -04:00
yarn.lock ci/azure-deployment.yml: fix NPM publishing (hopefully) 2023-08-21 10:29:59 -04:00

README.md

Build Status Powered by NumFOCUS

@wwtelescope/jupyterlab

WorldWide Telescope (WWT) inside JupyterLab. Learn more about WWT here.

Requirements

This extension supports:

  • The JupyterLab 4.x series

Older releases support the 2.x and 3.x series of JupyterLab.

Installation

To install this extension, you must first install JupyterLab. Currently this extensions only supports the JupyterLab 4.x version series.

Next, install this extensions Python package, wwt_jupyterlab_extension. On the command line this might be done with:

$ pip install wwt_jupyterlab_extension

This is known as a “prebuilt” extension installation is strongly preferred in current versions of JupyterLab.

In concert with this extension we recommend that you install:

Configuration

The extension has one configuration setting, appUrl, that specifies the URL to use for loading the WWT research app. The default value is the latest web-hosted version of the app, found at https://web.wwtassets.org/research/latest/. It might be useful to override this for local development or to force the use of a local app (required by some servers for security reasons).

Users can change extension settings in the JupyterLab “Advanced Settings Editor”, accessible through the “Settings” menu. To change this setting in a system-wide fashion, create a file named $JUPYTER_DATA_DIR/lab/settings/overrides.json with contents of the following form:

{
  "@wwtelescope/jupyterlab:research": {
    "appUrl": "/wwtstatic/research/"
  }
}

Here, $JUPYTER_DATA_DIR can be obtained by running the command jupyter --data-dir, and the customized lab URL is /wwtstatic/research/, which will use a locally bundled version of the app if you've installed the latest version of pywwt as a Jupyter server extension.

Development

Since this repo contains a JupyterLab extension, the primary build interface is using the jlpm command, which is JupyterLabs bundled version of yarn.

Some useful commands are as follows:

$ jlpm run build  # compile TS -> JS
$ jupyter labextension build  # create wwt_jupyterlab_extension/wwt_jupyterlab_extension/labextension
$ cd wwt_jupyterlab_extension && python -m build  # create dists of the Python package

$ jlpm add ${npm_package_name}  # add a dep
$ jlpm eslint  # detect *and fix* ESLint complaints

$ jlpm watch  # Auto-rebuild sources (long-running)
$ jupyter lab --watch  # Run JupyterLab, auto-reloading changed extensions (long-running)

Continuous Integration and Deployment

This repository uses Cranko to automate release workflows. This automation is essential to the smooth and reproducible deployment of the WWT web services.

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.

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.

Acknowledgments

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 for details.

Legalities

The WWT code is licensed under the MIT License. The copyright to the code is owned by the .NET Foundation.