SWAN Spawner

Spawner for JupyterHub that enables configuring a session with CVMFS/LCG stacks, support for GPU, oAuth tokens, etc. If Binder is used to configure the container image used, it reverts to the default upstream configuration. Requires Kubernetes.

Installation

pip3 install swanspawner

Usage

Add to your JupyterHub config file

c.JupyterHub.spawner_class = 'swanspawner.swankubespawner.SwanKubeSpawner'

If you deploy with Kubernetes.

Jupyter Notebook environment variables set during spawn

env
ROOT_LCG_VIEW_NAME
ROOT_LCG_VIEW_PLATFORM
USER_ENV_SCRIPT
ROOT_LCG_VIEW_PATH
USER
USER_ID
USER_GID
HOME
EOS_PATH_FORMAT
SERVER_HOSTNAME
MAX_MEMORY
JPY_USER
JPY_COOKIE_NAME
JPY_BASE_URL
JPY_HUB_PREFIX
JPY_HUB_API_URL
ACCESS_TOKEN
OAUTH_INSPECTION_ENDPOINT

Spawn Form configuration

To configure custom form, please set path to config file as below

c.SwanSpawner.options_form_config = '<path>'

High level objects

optionsform:
  header: <options header text>
  enable_customenv_form: <boolean>
  enable_generate_url_form: <boolean>
  enable_network_form: <boolean>
  with_rucio: <array of rucio options objects>
  lcg_options: <array of lcg options objects>
  customenv_options: <array of customenvs options objects>

Options type label

  lcg_options:
  - type: "label"
    label: 
      value: <id of label>,
      text: <displayed text of label>
  # ...

Options type selection

  lcg_options:
  - type: "selection"
    lcg:
      value: <id of lcg>
      text: <displayed text of lcg>
    platforms:
      - value: <id of platform>
        text: <displayed text of platform>
      # ...
    cores:
      - value: <id of cores selection>
        text: <displayed text of cores selection>
      # ...
    memory:
      - value: <id of memory selection>
        text: <displayed text of memory selection>
      # ...
    clusters:
      - value: <id of cluster>
        text: <displayed text of cluster>
      # ...
  # ...
  customenv_options:
  - type: "selection"
    builder:
      value: <id of builder>
      text: <displayed text of builder>
    cores:
      - value: <id of cores selection>
        text: <displayed text of cores selection>
      # ...
    memory:
      - value: <id of memory selection>
        text: <displayed text of memory selection>
      # ...
    clusters:
      - value: <id of cluster>
        text: <displayed text of cluster>
      # ...
  # ...

An example yaml file can be seen in options_form_config.yaml

Metadata

Release files for swanspawner 1.2.52

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for swanspawner 1.2.52
File	Size	Uploaded
swanspawner-1.2.52.tar.gz	28.5 kB	Sep 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for swanspawner 1.2.52
File	Interpreter	ABI	Platform	Reset
swanspawner-1.2.52-py3-none-any.whl 33.6 kB Sep 23, 2026	Python 3	none	any	Details

Total release size: 62.1 kB

Release files / swanspawner-1.2.52.tar.gz

Download URL	swanspawner-1.2.52.tar.gz
Size	28.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`92417773cc230a88770004de1a1af380d2f55158c434e008326749474cc36b0e`
BLAKE2b-256 checksum How to use checksums	`c04cca05697d391b6d4895742ca8dff12b2d80f4df7d680c815708c070402ee7`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/swan-cern/jupyterhub-extensions
Publishing commit: github.com/swan-cern/jupyterhub-extensions/tree/be4a2af6e801a612924e992a47c5ab8965bbebbc

Workflow

Publishing configuration: github.com/swan-cern/jupyterhub-extensions/blob/be4a2af6e801a612924e992a47c5ab8965bbebbc/.github/workflows/release.yml
Publishing logs: github.com/swan-cern/jupyterhub-extensions/actions/runs/35871127372/attempts/1

Artifact

Subject: swanspawner-1.2.52.tar.gz
SHA-256 checksum: 92417773cc230a88770004de1a1af380d2f55158c434e008326749474cc36b0e Verifying attestations

Release files / swanspawner-1.2.52-py3-none-any.whl

Download URL	swanspawner-1.2.52-py3-none-any.whl
Size	33.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7f1e53782502170d7a2c656ad06c4eaa75d3d621d9bb18a7443e3bc3a62c7fec`
BLAKE2b-256 checksum How to use checksums	`305298c4935846aa33bd591f45acacc6f4e45aeb53ac3a9f66757752e5e46e36`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/swan-cern/jupyterhub-extensions
Publishing commit: github.com/swan-cern/jupyterhub-extensions/tree/be4a2af6e801a612924e992a47c5ab8965bbebbc

Workflow

Publishing configuration: github.com/swan-cern/jupyterhub-extensions/blob/be4a2af6e801a612924e992a47c5ab8965bbebbc/.github/workflows/release.yml
Publishing logs: github.com/swan-cern/jupyterhub-extensions/actions/runs/35871127372/attempts/1

Artifact

Subject: swanspawner-1.2.52-py3-none-any.whl
SHA-256 checksum: 7f1e53782502170d7a2c656ad06c4eaa75d3d621d9bb18a7443e3bc3a62c7fec Verifying attestations