jupyter-codeserver-proxy

This package was built using the jupyter-server-proxy cookiecutter template.

Requirements

• Python 3.6+
• Jupyter Notebook 6.0+
• JupyterLab 2.1+

(Optional) For testing:

• Docker
• docker-compose

This package executes the standard codeserver command. This command assumes the codeserver command is available in the environment's PATH. For convenience, the tests include cases that assert outputs when running the codeserver command from a docker container. If you don't need to run tests with this setup running in a docker container, then remove the tests/test_codeserver_docker.py file or comment out the code in the file.

Quick Starts

Launch with binder

This test requires you to have a database instance available as a public endpoint or installed within the notebook container itself.

The Hard Way

Create and Activate Environment

virtualenv -p python3 venv
source venv/bin/activate

Install jupyter-codeserver-proxy

pip install git+https://github.com/dragonstyle/jupyter-codeserver-proxy.git

Enable jupyter-codeserver-proxy Extensions

1. For Jupyter Classic, activate the jupyter-server-proxy extension:

jupyter serverextension enable --sys-prefix jupyter_server_proxy

2. For Jupyter Lab, install the @jupyterlab/server-proxy extension:

jupyter labextension install @jupyterlab/server-proxy
jupyter lab build

3. Start Jupyter Classic or Jupyter Lab

4. Click on the codeserver icon from the Jupyter Lab Launcher or the codeserver item from the New dropdown in Jupyter Classic.

Credits

• jupyter-server-proxy

License

BSD 3-Clause