Metadata-Version: 2.1
Name: jupyterhub-traefik-proxy
Version: 0.1.5
Summary: JupyterHub proxy implementation with traefik
Home-page: https://jupyterhub-traefik-proxy.readthedocs.io
Author: Project Jupyter Contributors
Author-email: jupyter@googlegroups.com
License: BSD
Project-URL: Documentation, https://jupyterhub-traefik-proxy.readthedocs.io
Project-URL: Source, https://github.com/jupyterhub/traefik-proxy/
Project-URL: Tracker, https://github.com/jupyter/traefik-proxy/issues
Description: 
        # JupyterHub Traefik Proxy
        
        [![Documentation build status](https://img.shields.io/readthedocs/jupyterhub-traefik-proxy?logo=read-the-docs)](https://jupyterhub-traefik-proxy.readthedocs.org/en/latest/)
        [![TravisCI (.org) build status](https://img.shields.io/travis/jupyterhub/traefik-proxy/master?logo=travis)](https://travis-ci.org/jupyterhub/traefik-proxy)
        [![CircleCI build status](https://img.shields.io/circleci/build/github/jupyterhub/jupyterhub?logo=circleci)](https://circleci.com/gh/jupyterhub/jupyterhub)
        [![Latest PyPI version](https://img.shields.io/pypi/v/jupyterhub-traefik-proxy?logo=pypi)](https://pypi.python.org/pypi/jupyterhub-traefik-proxy)
        [![GitHub](https://img.shields.io/badge/issue_tracking-github-blue?logo=github)](https://github.com/jupyterhub/traefik-proxy/issues)
        [![Discourse](https://img.shields.io/badge/help_forum-discourse-blue?logo=discourse)](https://discourse.jupyter.org/c/jupyterhub)
        [![Gitter](https://img.shields.io/badge/social_chat-gitter-blue?logo=gitter)](https://gitter.im/jupyterhub/jupyterhub)
        
        When JupyterHub starts a server for a user, it will _dynamically configure a
        proxy server_ so that accessing `jupyterhub.example.com/user/<user>` routes to
        the individual Jupyter server. This project contains what JupyterHub need to
        dynamically configure the routes of a [traefik](https://traefik.io) proxy
        server! There are three implementations of the [JupyterHub proxy
        API](https://jupyterhub.readthedocs.io/en/stable/reference/proxy.html),
        depending on how traefik store its routing configuration.
        
        For **smaller**, single-node deployments:
        
        * TraefikTomlProxy
        
        For **distributed** setups:
        
        * TraefikEtcdProxy
        * TraefikConsulProxy
        
        ## Installation
        The [documentation](https://jupyterhub-traefik-proxy.readthedocs.io) contains a
        [complete installation
        guide](https://jupyterhub-traefik-proxy.readthedocs.io/en/latest/install.html)
        with examples for the three different implementations.
        
        * [For TraefikTomlProxy](https://jupyterhub-traefik-proxy.readthedocs.io/en/latest/toml.html#example-setup)
        * [For TraefikEtcdProxy](https://jupyterhub-traefik-proxy.readthedocs.io/en/latest/etcd.html#example-setup)
        * [For TraefikConsulProxy](https://jupyterhub-traefik-proxy.readthedocs.io/en/latest/consul.html#example-setup)
        
        
        ## Running tests
        There are some tests that use *etcdctl* command line client for etcd. Make sure
        to set environment variable `ETCDCTL_API=3` before running the tests, so that
        the v3 API to be used, e.g.:
        
        ```
        $ export ETCDCTL_API=3
        ```
        
        You can then run the all the test suite from the *traefik-proxy* directory with:
        
        ```
        $ pytest -v ./tests
        ```
        
        Or you can run a specific test file with:
        
        ```
        $ pytest -v ./tests/<test-file-name>
        ```
        
Keywords: jupyter jupyterhub traefik proxy
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
