An open API service indexing awesome lists of open source software.

https://github.com/jupyter-server/message_replay

Solving the (missed) kernel message problem
https://github.com/jupyter-server/message_replay

Last synced: about 1 month ago
JSON representation

Solving the (missed) kernel message problem

Awesome Lists containing this project

README

        

# message_replay

[![Github Actions Status](https://github.com/jupyter-server/message_replay/workflows/Build/badge.svg)](https://github.com/jupyter-server/message_replay/actions/workflows/build.yml)

Restore Notebook execution progress when a browser page is reloaded

See https://github.com/jupyter-server/team-compass/issues/52 to learn about how this repository came into existence.

## Requirements

- Jupyter Server

## Install

To install the extension, execute:

```bash
pip install message_replay
```

## Uninstall

To remove the extension, execute:

```bash
pip uninstall message_replay
```

## Troubleshoot

If you are seeing the frontend extension, but it is not working, check
that the server extension is enabled:

```bash
jupyter server extension list
```

## Contributing

### Development install

```bash
# Clone the repo to your local environment
# Change directory to the message_replay directory
# Install package in development mode - will automatically enable
# The server extension.
pip install -e .
```

You can watch the source directory and run your Jupyter Server-based application at the same time in different terminals to watch for changes in the extension's source and automatically rebuild the extension. For example,
when running JupyterLab:

```bash
jupyter lab --autoreload
```

If your extension does not depend a particular frontend, you can run the
server directly:

```bash
jupyter server --autoreload
```

### Running Tests

Install dependencies:

```bash
pip install -e ".[test]"
```

To run the python tests, use:

```bash
pytest

# To test a specific file
pytest message_replay/tests/test_handlers.py

# To run a specific test
pytest message_replay/tests/test_handlers.py -k "test_get"
```

### Development uninstall

```bash
pip uninstall message_replay
```

### Packaging the extension

See [RELEASE](RELEASE.md)