SwanCuller

JupyterHub service that checks and cleans user sessions. It also calls bash scripts to check/renew kerberos tokens for the users, if their sessions still exist, or remove them if not in use.

Requirements

This module requires and installs Tornado.

Installation

Install the package:

pip install swanculler

Usage

Call the binary and specify configuration parameters:

swanculler --cull_every=600

Configuration parameters:

url: The JupyterHub API URL (default=$JUPYTERHUB_API_URL)
timeout: The idle timeout (in seconds) (default=600)
cull_every: The interval (in seconds) for checking for idle servers to cull (default=0)
max_age: The maximum age (in seconds) of servers that should be culled even if they are active (default=0)
cull_users: Cull users in addition to servers (default=False)
concurrency: Limit the number of concurrent requests made to the Hub (default=10)
hooks_dir: Path to the directory for the krb tickets script (check_ticket.sh) (default="/srv/jupyterhub/culler)
disable_hooks: Whether to call the krb tickets scripts or not (default=False)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

swanculler-1.0.7.tar.gz (7.7 kB view details)

Uploaded Mar 4, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

swanculler-1.0.7-py3-none-any.whl (8.4 kB view details)

Uploaded Mar 4, 2026 Python 3

File details

Details for the file swanculler-1.0.7.tar.gz.

File metadata

Download URL: swanculler-1.0.7.tar.gz
Upload date: Mar 4, 2026
Size: 7.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for swanculler-1.0.7.tar.gz
Algorithm	Hash digest
SHA256	`7198707d194844c04dd990064ed26a10be855149fca8396f2bd9a1cd8166ae49`
MD5	`b21e1faf28f107bb63b2b957a2dfc797`
BLAKE2b-256	`1d9a47c20ff8460ea23a0f9610afe00f00b67e4e22131e2fde3f36d0838bdd06`

See more details on using hashes here.

Provenance

The following attestation bundles were made for swanculler-1.0.7.tar.gz:

Publisher: swan-ci-ca.yml on swan-cern/jupyterhub-extensions

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: swanculler-1.0.7.tar.gz
- Subject digest: 7198707d194844c04dd990064ed26a10be855149fca8396f2bd9a1cd8166ae49
- Sigstore transparency entry: 1025970059
- Sigstore integration time: Mar 4, 2026
Source repository:
- Permalink: swan-cern/jupyterhub-extensions@0d2715f3ac0a9bdd1e3ee2267d80e802a3291ecf
- Branch / Tag: refs/tags/SwanCuller/v1.0.7
- Owner: https://github.com/swan-cern
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: swan-ci-ca.yml@0d2715f3ac0a9bdd1e3ee2267d80e802a3291ecf
- Trigger Event: push