Repository Providers

Repository Providers (or RepoProviders) are locations where repositories are stored (e.g., GitHub). BinderHub supports a number of providers out of the box, and can be extended to support new providers. For a complete listing of the provider classes, see repoproviders.

Supported repoproviders

Currently supported providers, their prefixes and specs are:

Adding a new repository provider

It is possible to add new repository providers to BinderHub, allowing a BinderHub deployment to fetch repositories from new locations on the web. Doing so involves defining your own RepoProvider sub-class and modifying a set of methods/attributes to interface with the online provider to which you are providing access. It also often involves building a new repo2docker content provider.

In order to extend the supported repository providers, follow these instructions. We’ll provide example links for each step to a recent BinderHub pull-request that implements the DataverseProvider class.

  1. Review the repoprovider module. This shows a number of example repository providers.

  2. Check whether repo2docker has a ContentProvider class that will work with your repository provider. If not, then you’ll need to create one first.

  3. Create a new class that sub-classes the RepoProvider class. Define your own methods for actions that are repository provider-specific. For example, here is the DataverseProvider class.

  4. Add this class to the list of default RepoProviders in BinderHub.

  5. Add the new provider prefix to the BinderHub UI and the index javascript and make the appropriate changes to the index page based on the URL specification for this repository provider.

  6. Add a test for your repoprovider to ensure that it properly resolves and fetches a repository URL.

  7. Document your new repository provider on the Repository Providers page as well as the repoproviders page.