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.
Currently supported providers, their prefixes and specs are:
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.
DataverseProvider
Review the repoprovider module. This shows a number of example repository providers.
Check whether repo2docker has a ContentProvider class that will work with your repository provider. If not, then you’ll need to create one first.
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.
RepoProvider
Add this class to the list of default RepoProviders in BinderHub.
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.
Add a test for your repoprovider to ensure that it properly resolves and fetches a repository URL.
Document your new repository provider on the Repository Providers page as well as the repoproviders page.