# jupyter-forward
| CI | [![GitHub Workflow Status][github-ci-badge]][github-ci-link] [![Code Coverage Status][codecov-badge]][codecov-link] [![pre-commit.ci status][pre-commit.ci-badge]][pre-commit.ci-link] |
| :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| **Docs** | [![Documentation Status][rtd-badge]][rtd-link] |
| **Package** | [![Conda][conda-badge]][conda-link] [![PyPI][pypi-badge]][pypi-link] |
| **License** | [![License][license-badge]][repo-link] |
## Overview
Jupyter-forward simplifies the process of running `jupyter lab` on a remote machine by performing the following tasks on behalf of the users:
1. Logging into a remote cluster/resource via the SSH protocol.
2. Launching Jupyter Lab on the remote cluster.
3. Port forwarding Jupyter Lab session back to your local machine.
4. Opening the port forwarded Jupyter Lab session in your local browser.
## Installation
Jupyter-forward can be installed from PyPI with pip:
```bash
python -m pip install jupyter-forward
```
Jupyter-forward is also available from conda-forge for conda installations:
```bash
conda install -c conda-forge jupyter-forward
```
See [documentation](https://jupyter-forward.readthedocs.io) for more information.
[github-ci-badge]: https://github.com/ncar-xdev/jupyter-forward/actions/workflows/ci.yaml/badge.svg
[github-ci-link]: https://github.com/ncar-xdev/jupyter-forward/actions/workflows/ci.yaml
[codecov-badge]: https://img.shields.io/codecov/c/github/ncar-xdev/jupyter-forward.svg?logo=codecov
[codecov-link]: https://codecov.io/gh/ncar-xdev/jupyter-forward
[rtd-badge]: https://readthedocs.org/projects/jupyter-forward/badge/?version=latest
[rtd-link]: https://jupyter-forward.readthedocs.io/en/latest/?badge=latest
[pypi-badge]: https://img.shields.io/pypi/v/jupyter-forward?logo=pypi
[pypi-link]: https://pypi.org/project/jupyter-forward
[conda-badge]: https://img.shields.io/conda/vn/conda-forge/jupyter-forward?logo=anaconda
[conda-link]: https://anaconda.org/conda-forge/jupyter-forward
[license-badge]: https://img.shields.io/github/license/ncar-xdev/jupyter-forward
[repo-link]: https://github.com/ncar-xdev/jupyter-forward
[pre-commit.ci-badge]: https://results.pre-commit.ci/badge/github/ncar-xdev/jupyter-forward/main.svg
[pre-commit.ci-link]: https://results.pre-commit.ci/latest/github/ncar-xdev/jupyter-forward/main
Raw data
{
"_id": null,
"home_page": null,
"name": "jupyter-forward",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Xdev <xdev@ucar.edu>",
"keywords": "jupyter-forward",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/87/a1/aaad5a328da1eff83b1d9c4fe1d70c838d1fb58011a92c5d9e815d7f190c/jupyter_forward-2025.1.16.tar.gz",
"platform": null,
"description": "# jupyter-forward\n\n| CI | [![GitHub Workflow Status][github-ci-badge]][github-ci-link] [![Code Coverage Status][codecov-badge]][codecov-link] [![pre-commit.ci status][pre-commit.ci-badge]][pre-commit.ci-link] |\n| :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n| **Docs** | [![Documentation Status][rtd-badge]][rtd-link] |\n| **Package** | [![Conda][conda-badge]][conda-link] [![PyPI][pypi-badge]][pypi-link] |\n| **License** | [![License][license-badge]][repo-link] |\n\n## Overview\n\nJupyter-forward simplifies the process of running `jupyter lab` on a remote machine by performing the following tasks on behalf of the users:\n\n1. Logging into a remote cluster/resource via the SSH protocol.\n2. Launching Jupyter Lab on the remote cluster.\n3. Port forwarding Jupyter Lab session back to your local machine.\n4. Opening the port forwarded Jupyter Lab session in your local browser.\n\n## Installation\n\nJupyter-forward can be installed from PyPI with pip:\n\n```bash\npython -m pip install jupyter-forward\n```\n\nJupyter-forward is also available from conda-forge for conda installations:\n\n```bash\nconda install -c conda-forge jupyter-forward\n```\n\nSee [documentation](https://jupyter-forward.readthedocs.io) for more information.\n\n[github-ci-badge]: https://github.com/ncar-xdev/jupyter-forward/actions/workflows/ci.yaml/badge.svg\n[github-ci-link]: https://github.com/ncar-xdev/jupyter-forward/actions/workflows/ci.yaml\n[codecov-badge]: https://img.shields.io/codecov/c/github/ncar-xdev/jupyter-forward.svg?logo=codecov\n[codecov-link]: https://codecov.io/gh/ncar-xdev/jupyter-forward\n[rtd-badge]: https://readthedocs.org/projects/jupyter-forward/badge/?version=latest\n[rtd-link]: https://jupyter-forward.readthedocs.io/en/latest/?badge=latest\n[pypi-badge]: https://img.shields.io/pypi/v/jupyter-forward?logo=pypi\n[pypi-link]: https://pypi.org/project/jupyter-forward\n[conda-badge]: https://img.shields.io/conda/vn/conda-forge/jupyter-forward?logo=anaconda\n[conda-link]: https://anaconda.org/conda-forge/jupyter-forward\n[license-badge]: https://img.shields.io/github/license/ncar-xdev/jupyter-forward\n[repo-link]: https://github.com/ncar-xdev/jupyter-forward\n[pre-commit.ci-badge]: https://results.pre-commit.ci/badge/github/ncar-xdev/jupyter-forward/main.svg\n[pre-commit.ci-link]: https://results.pre-commit.ci/latest/github/ncar-xdev/jupyter-forward/main\n",
"bugtrack_url": null,
"license": "Apache Software License 2.0",
"summary": "Jupyter Lab Port Forwarding Utility",
"version": "2025.1.16",
"project_urls": {
"Documentation": "https://github.com/ncar-xdev/jupyter-forward",
"Homepage": "https://github.com/ncar-xdev/jupyter-forward",
"Source": "https://github.com/ncar-xdev/jupyter-forward",
"Tracker": "https://github.com/ncar-xdev/jupyter-forward/issues"
},
"split_keywords": [
"jupyter-forward"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4821f92ee2b2fd0072a048eae21568104f807f1b34ad28d9cc9d56f71bf70a33",
"md5": "3079c424cb33c1aa3346c58ea62b0e1d",
"sha256": "108bbb5c142c46319854e92c6abddbde6b8c0e3aa7c3f49b5289cb5708c33b3f"
},
"downloads": -1,
"filename": "jupyter_forward-2025.1.16-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3079c424cb33c1aa3346c58ea62b0e1d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 13977,
"upload_time": "2025-01-16T17:10:35",
"upload_time_iso_8601": "2025-01-16T17:10:35.990759Z",
"url": "https://files.pythonhosted.org/packages/48/21/f92ee2b2fd0072a048eae21568104f807f1b34ad28d9cc9d56f71bf70a33/jupyter_forward-2025.1.16-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "87a1aaad5a328da1eff83b1d9c4fe1d70c838d1fb58011a92c5d9e815d7f190c",
"md5": "4b278efeca3d085e76e503f1c47e32ce",
"sha256": "8d5baeb46c05908660be9c67396ec1e887dac01102feb9fa3c9af5cae7662b49"
},
"downloads": -1,
"filename": "jupyter_forward-2025.1.16.tar.gz",
"has_sig": false,
"md5_digest": "4b278efeca3d085e76e503f1c47e32ce",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 70157,
"upload_time": "2025-01-16T17:10:38",
"upload_time_iso_8601": "2025-01-16T17:10:38.352978Z",
"url": "https://files.pythonhosted.org/packages/87/a1/aaad5a328da1eff83b1d9c4fe1d70c838d1fb58011a92c5d9e815d7f190c/jupyter_forward-2025.1.16.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-16 17:10:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ncar-xdev",
"github_project": "jupyter-forward",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "typer",
"specs": [
[
">=",
"0.9"
]
]
},
{
"name": "fabric",
"specs": [
[
">=",
"2.5"
]
]
},
{
"name": "rich",
"specs": [
[
">=",
"13.0.0"
]
]
}
],
"lcname": "jupyter-forward"
}
JSON
