# <a href="https://github.com/jupyterhub/repo2docker"><img src="https://raw.githubusercontent.com/jupyterhub/repo2docker/8731ecf0967cc5fde028c456f2b92be651ebbc18/docs/source/_static/images/repo2docker.png" height="48px" /> repo2docker</a>
[![Build Status](https://github.com/jupyterhub/repo2docker/workflows/Test/badge.svg)](https://github.com/jupyterhub/repo2docker/actions)
[![Documentation Status](https://readthedocs.org/projects/repo2docker/badge/?version=latest)](http://repo2docker.readthedocs.io/en/latest/?badge=latest)
[![Contribute](https://img.shields.io/badge/I_want_to_contribute!-grey?logo=jupyter)](https://repo2docker.readthedocs.io/en/latest/contributing/contributing.html)
[![Docker Repository on Quay](https://img.shields.io/badge/quay.io-container-green "Docker Repository on Quay")](https://quay.io/repository/jupyterhub/repo2docker?tab=tags)
`repo2docker` fetches a git repository and builds a container image based on
the configuration files found in the repository.
See the [repo2docker documentation](http://repo2docker.readthedocs.io)
for more information on using repo2docker.
For support questions please search or post to https://discourse.jupyter.org/c/binder.
See the [contributing guide](CONTRIBUTING.md) for information on contributing to
repo2docker.
---
Please note that this repository is participating in a study into sustainability
of open source projects. Data will be gathered about this repository for
approximately the next 12 months, starting from 2021-06-11.
Data collected will include number of contributors, number of PRs, time taken to
close/merge these PRs, and issues closed.
For more information, please visit
[our informational page](https://sustainable-open-science-and-software.github.io/) or download our [participant information sheet](https://sustainable-open-science-and-software.github.io/assets/PIS_sustainable_software.pdf).
---
## Using repo2docker
### Prerequisites
1. Docker to build & run the repositories. The [community edition](https://store.docker.com/search?type=edition&offering=community)
is recommended.
2. Python 3.6+.
Supported on Linux and macOS. [See documentation note about Windows support.](http://repo2docker.readthedocs.io/en/latest/install.html#note-about-windows-support)
### Installation
This a quick guide to installing `repo2docker`, see our documentation for [a full guide](https://repo2docker.readthedocs.io/en/latest/install.html).
To install from PyPI:
```bash
pip install jupyter-repo2docker
```
To install from source:
```bash
git clone https://github.com/jupyterhub/repo2docker.git
cd repo2docker
pip install -e .
```
### Usage
The core feature of repo2docker is to fetch a git repository (from GitHub or locally),
build a container image based on the specifications found in the repository &
optionally launch the container that you can use to explore the repository.
**Note that Docker needs to be running on your machine for this to work.**
Example:
```bash
jupyter-repo2docker https://github.com/norvig/pytudes
```
After building (it might take a while!), it should output in your terminal
something like:
```bash
Copy/paste this URL into your browser when you connect for the first time,
to login with a token:
http://0.0.0.0:36511/?token=f94f8fabb92e22f5bfab116c382b4707fc2cade56ad1ace0
```
If you copy paste that URL into your browser you will see a Jupyter Notebook
with the contents of the repository you had just built!
For more information on how to use `repo2docker`, see the
[usage guide](http://repo2docker.readthedocs.io/en/latest/usage.html).
## Repository specifications
Repo2Docker looks for configuration files in the source repository to
determine how the Docker image should be built. For a list of the configuration
files that `repo2docker` can use, see the
[complete list of configuration files](https://repo2docker.readthedocs.io/en/latest/config_files.html).
The philosophy of repo2docker is inspired by
[Heroku Build Packs](https://devcenter.heroku.com/articles/buildpacks).
## Docker Image
Repo2Docker can be run inside a Docker container if access to the Docker Daemon is provided, for example see [BinderHub](https://github.com/jupyterhub/binderhub). Docker images are [published to quay.io](https://quay.io/repository/jupyterhub/repo2docker?tab=tags). The old [Docker Hub image](https://hub.docker.com/r/jupyter/repo2docker) is no longer supported.
Raw data
{
"_id": null,
"home_page": "https://repo2docker.readthedocs.io/en/latest/",
"name": "jupyter-repo2docker",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "reproducible science environments docker",
"author": "Project Jupyter Contributors",
"author_email": "jupyter@googlegroups.com",
"download_url": "https://files.pythonhosted.org/packages/22/a4/bc7936de31cfe0a3681023b69ca7389e9ce3dde86c1ecb621ed4b5d5d3a2/jupyter-repo2docker-2024.3.0.tar.gz",
"platform": null,
"description": "# <a href=\"https://github.com/jupyterhub/repo2docker\"><img src=\"https://raw.githubusercontent.com/jupyterhub/repo2docker/8731ecf0967cc5fde028c456f2b92be651ebbc18/docs/source/_static/images/repo2docker.png\" height=\"48px\" /> repo2docker</a>\n\n[![Build Status](https://github.com/jupyterhub/repo2docker/workflows/Test/badge.svg)](https://github.com/jupyterhub/repo2docker/actions)\n[![Documentation Status](https://readthedocs.org/projects/repo2docker/badge/?version=latest)](http://repo2docker.readthedocs.io/en/latest/?badge=latest)\n[![Contribute](https://img.shields.io/badge/I_want_to_contribute!-grey?logo=jupyter)](https://repo2docker.readthedocs.io/en/latest/contributing/contributing.html)\n[![Docker Repository on Quay](https://img.shields.io/badge/quay.io-container-green \"Docker Repository on Quay\")](https://quay.io/repository/jupyterhub/repo2docker?tab=tags)\n\n`repo2docker` fetches a git repository and builds a container image based on\nthe configuration files found in the repository.\n\nSee the [repo2docker documentation](http://repo2docker.readthedocs.io)\nfor more information on using repo2docker.\n\nFor support questions please search or post to https://discourse.jupyter.org/c/binder.\n\nSee the [contributing guide](CONTRIBUTING.md) for information on contributing to\nrepo2docker.\n\n---\n\nPlease note that this repository is participating in a study into sustainability\nof open source projects. Data will be gathered about this repository for\napproximately the next 12 months, starting from 2021-06-11.\n\nData collected will include number of contributors, number of PRs, time taken to\nclose/merge these PRs, and issues closed.\n\nFor more information, please visit\n[our informational page](https://sustainable-open-science-and-software.github.io/) or download our [participant information sheet](https://sustainable-open-science-and-software.github.io/assets/PIS_sustainable_software.pdf).\n\n---\n\n## Using repo2docker\n\n### Prerequisites\n\n1. Docker to build & run the repositories. The [community edition](https://store.docker.com/search?type=edition&offering=community)\n is recommended.\n2. Python 3.6+.\n\nSupported on Linux and macOS. [See documentation note about Windows support.](http://repo2docker.readthedocs.io/en/latest/install.html#note-about-windows-support)\n\n### Installation\n\nThis a quick guide to installing `repo2docker`, see our documentation for [a full guide](https://repo2docker.readthedocs.io/en/latest/install.html).\n\nTo install from PyPI:\n\n```bash\npip install jupyter-repo2docker\n```\n\nTo install from source:\n\n```bash\ngit clone https://github.com/jupyterhub/repo2docker.git\ncd repo2docker\npip install -e .\n```\n\n### Usage\n\nThe core feature of repo2docker is to fetch a git repository (from GitHub or locally),\nbuild a container image based on the specifications found in the repository &\noptionally launch the container that you can use to explore the repository.\n\n**Note that Docker needs to be running on your machine for this to work.**\n\nExample:\n\n```bash\njupyter-repo2docker https://github.com/norvig/pytudes\n```\n\nAfter building (it might take a while!), it should output in your terminal\nsomething like:\n\n```bash\n Copy/paste this URL into your browser when you connect for the first time,\n to login with a token:\n http://0.0.0.0:36511/?token=f94f8fabb92e22f5bfab116c382b4707fc2cade56ad1ace0\n```\n\nIf you copy paste that URL into your browser you will see a Jupyter Notebook\nwith the contents of the repository you had just built!\n\nFor more information on how to use `repo2docker`, see the\n[usage guide](http://repo2docker.readthedocs.io/en/latest/usage.html).\n\n## Repository specifications\n\nRepo2Docker looks for configuration files in the source repository to\ndetermine how the Docker image should be built. For a list of the configuration\nfiles that `repo2docker` can use, see the\n[complete list of configuration files](https://repo2docker.readthedocs.io/en/latest/config_files.html).\n\nThe philosophy of repo2docker is inspired by\n[Heroku Build Packs](https://devcenter.heroku.com/articles/buildpacks).\n\n## Docker Image\n\nRepo2Docker can be run inside a Docker container if access to the Docker Daemon is provided, for example see [BinderHub](https://github.com/jupyterhub/binderhub). Docker images are [published to quay.io](https://quay.io/repository/jupyterhub/repo2docker?tab=tags). The old [Docker Hub image](https://hub.docker.com/r/jupyter/repo2docker) is no longer supported.\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "Repo2docker: Turn code repositories into Jupyter enabled Docker Images",
"version": "2024.3.0",
"project_urls": {
"Documentation": "https://repo2docker.readthedocs.io",
"Funding": "https://jupyter.org/about",
"Homepage": "https://repo2docker.readthedocs.io/en/latest/",
"Source": "https://github.com/jupyterhub/repo2docker/",
"Tracker": "https://github.com/jupyterhub/repo2docker/issues"
},
"split_keywords": [
"reproducible",
"science",
"environments",
"docker"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "881c28757d811cfe0e40bb8a7d63b3e38eec2128af393bf5f3d9918f728b5794",
"md5": "6d917094b7f2622a19f599080b71ce36",
"sha256": "bf21eccd409467e47a14076435d27880dfa923d6bf5cfcc4053816720f4bce2a"
},
"downloads": -1,
"filename": "jupyter_repo2docker-2024.3.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "6d917094b7f2622a19f599080b71ce36",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.6",
"size": 175661,
"upload_time": "2024-03-31T18:46:39",
"upload_time_iso_8601": "2024-03-31T18:46:39.772283Z",
"url": "https://files.pythonhosted.org/packages/88/1c/28757d811cfe0e40bb8a7d63b3e38eec2128af393bf5f3d9918f728b5794/jupyter_repo2docker-2024.3.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "22a4bc7936de31cfe0a3681023b69ca7389e9ce3dde86c1ecb621ed4b5d5d3a2",
"md5": "46bec8d2c91f1406d7a62c7410b0a80c",
"sha256": "8bb8c38e8b5b61e96200f40fa8d64c3f0dafc9c185b64fd3b540b423d2e1cc11"
},
"downloads": -1,
"filename": "jupyter-repo2docker-2024.3.0.tar.gz",
"has_sig": false,
"md5_digest": "46bec8d2c91f1406d7a62c7410b0a80c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 134205,
"upload_time": "2024-03-31T18:46:41",
"upload_time_iso_8601": "2024-03-31T18:46:41.950813Z",
"url": "https://files.pythonhosted.org/packages/22/a4/bc7936de31cfe0a3681023b69ca7389e9ce3dde86c1ecb621ed4b5d5d3a2/jupyter-repo2docker-2024.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-31 18:46:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jupyterhub",
"github_project": "repo2docker",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "jupyter-repo2docker"
}