Minispot

Usage

1. Install Docker

2. Launch Minispot

   docker run --rm -it -p8888:8888 -v$(pwd):/workdir ghcr.io/tomokinakamaru/minispot:latest

3. Open the localhost URL displayed in the terminal

   ...
   [C 2024-01-01 00:00:00.000 ServerApp]
   ...
           http://localhost:8888/tree?token=... # ← This URL
           http://127.0.0.1:8888/tree?token=...
   ...

4. Create a notebook and do anything you want

Development

1. Install Docker
2. Open this repository using a dev container
3. Run pdm sync to setup the environment
4. Run sh kernel-install.sh to install the default kernel
5. Run source .venv/bin/activate to activate the virtual environment
6. Run jlpm install to setup the test environment

Run linters

pdm run lint
pdm run fix # Fix lint issues

Run tests

jlpm playwright install --with-deps chromium # Install dependencies
jlpm playwright test

Run GitHub actions

# Run this command outside the dev container
act --job check --matrix python-version:3.13

Build wheel

pdm build --no-sdist

Upgrade dependencies

Upgrade Python and Node

Check the URLs listed in Dockerfile

Upgrade pdm dependencies

sh pdm-upgrade.sh

Upgrade default kernel dependencies

sh kernel-upgrade.sh

Upgrade pdm-managed dependencies

pdm update --unconstrained

Upgrade jlpm-managed dependencies

jlpm plugin import @yarnpkg/plugin-interactive-tools
jlpm upgrade-interactive
jlpm plugin remove @yarnpkg/plugin-interactive-tools