Metadata-Version: 2.1
Name: qpod-hub
Version: 2021.10.11
Summary: A hub portal UI and proxy service for QPod.
Home-page: https://github.com/QPod/qpod-hub
Author: QPod
Author-email: 45032326+QPod0@users.noreply.github.com
License: BSD
Platform: Linux
Platform: Mac OS X
Platform: Windows
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE

# QPod Hub Package

[![License](https://img.shields.io/badge/License-BSD%203--Clause-green.svg)](https://opensource.org/licenses/BSD-3-Clause)
[![TravisCI Pipeline Status](https://img.shields.io/travis/com/QPod/qpod-hub.svg)](https://travis-ci.com/QPod/qpod-hub)
[![PyPI version](https://img.shields.io/pypi/v/qpod-hub.svg)](https://pypi.org/project/qpod-hub/#history)
[![PyPI format](https://img.shields.io/pypi/format/qpod-hub.svg)](https://pypi.org/project/qpod-hub/#files)
[![PyPI download month](https://img.shields.io/pypi/dm/qpod-hub.svg)](https://pypi.org/project/qpod-hub/)
[![GitHub Starts](https://img.shields.io/github/stars/QPod/qpod-hub.svg?label=Stars&style=social)](https://github.com/QPod/qpod-hub/stargazers)

**Notice:** If you are looking for the out-of-box QPod docker images, please goto: https://github.com/QPod/docker-images

## Introduction

The `qpod-hub` package provides a hub portal user interface and proxy service for QPod.

As a hub service, `qpod-hub` detect if specific service are installed and provides a homepage GUI for users.
Currently, the following services are supported:

- Jupyter Notebook
- JupyterLab
- Code-server
- Tensorboard
- RStudio Server
- Shiny Server

![Screen shot of QPod](https://raw.githubusercontent.com/wiki/QPod/qpod-hub/img/QPod-screenshot.webp "Screen shot of QPod")

## Development

### Under Linux/macOS

```bash
docker run -it --rm \
    --name=dev_QPod \
    --hostname="docker-develop@" \
    -v `pwd`/:/root/ \
    -p 8800-8888:8800-8888 \
    qpod /bin/bash
```

### Under Windows

```cmd
docker run -it --rm ^
    --name=dev_QPod  ^
    --hostname="docker-develop@" ^
    -v %cd%/:/root/ ^
    -p 8800-8888:8800-8888 ^
    qpod /bin/bash
```

### Enter into the container and Debug/Install

```bash
docker exec -it dev_QPod /bin/bash

PYLIB_DIR="/opt/conda/lib/python3.9/site-packages/"
ln -s `pwd`/qpod $PYLIB_DIR/
ln -s `pwd`/qpod/base/etc/qpod_hub-jpserverextension.json /opt/conda/etc/jupyter/jupyter_server_config.d/
ln -s `pwd`/qpod/base/etc/qpod_hub-nbserverextension.json /opt/conda/etc/jupyter/jupyter_notebook_config.d/
ln -s `pwd`/qpod/base/etc/qpod_hub-nbextension.json       /opt/conda/etc/jupyter/nbconfig/tree.d/


yarn --cwd `pwd`/qpod/base/static/
python -m qpod

python setup.py sdist bdist_wheel
pip install -U dist/*.whl
jupyter notebook
```


