Metadata-Version: 2.4
Name: swanhub
Version: 1.0.2
Summary: Custom SWAN templates and handlers for JupyterHub
Home-page: https://github.com/swan-cern/jupyterhub-extensions
Author: SWAN Admins
License: AGPL-3.0
Keywords: JupyterHub,SWAN,CERN
Platform: Linux
Platform: Mac OS X
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
Requires-Dist: jupyterhub~=4.1.6
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: platform
Dynamic: requires-dist
Dynamic: summary

# SwanHub

JupyterHub wrapper that automatically configures the SWAN templates and handlers.

These handlers replace the default ones with slightly modified versions (for example, the user info api endpoint provides information about the auth state, which is hidden in the default implementation).

## Requirements

This module requires and installs JupyterHub.

## Installation

Install the package

```bash
pip install swanhub
```

To have the proper css, it is necessary to download a release from https://github.com/swan-cern/common into the folder `/usr/local/share/jupyterhub/static/swan/`.

## Usage

Start SwanHub as you would for JupyterHub, and with the same configurations. Example:

```bash
swanhub --config /path/to/my/jupyterhub_config.py
```
