aboutsummaryrefslogtreecommitdiffstats
path: root/clients/common.go
blob: b6da6568e121f8c88e5e1ba9adc9591ea76284ae (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
// Go-git needs the packfile and the refs of the repo. The
// `NewGitUploadPackService` function returns an object that allows to
// download them.
//
// Go-git supports HTTP and SSH (see `KnownProtocols`) for downloading
// the packfile and the refs, but you can also install your own
// protocols (see `InstallProtocol` below).
//
// Each protocol has its own implementation of
// `NewGitUploadPackService`, but you should generally not use them
// directly, use this package's `NewGitUploadPackService` instead.
package clients

import (
	"fmt"
	"net/url"

	"gopkg.in/src-d/go-git.v3/clients/common"
	"gopkg.in/src-d/go-git.v3/clients/http"
	"gopkg.in/src-d/go-git.v3/clients/ssh"
)

// DefaultProtocols are the protocols supported by default.
var DefaultProtocols = map[string]common.GitUploadPackService{
	"http":  http.NewGitUploadPackService(),
	"https": http.NewGitUploadPackService(),
	"ssh":   ssh.NewGitUploadPackService(),
}

// KnownProtocols holds the current set of known protocols. Initially
// it gets its contents from `DefaultProtocols`. See `InstallProtocol`
// below to add or modify this variable.
var KnownProtocols = make(map[string]common.GitUploadPackService, len(DefaultProtocols))

func init() {
	for k, v := range DefaultProtocols {
		InstallProtocol(k, v)
	}
}

// InstallProtocol adds or modifies an existing protocol.
func InstallProtocol(scheme string, service common.GitUploadPackService) {
	if service == nil {
		panic("nil service")
	}

	KnownProtocols[scheme] = service
}

// NewGitUploadPackService returns the appropriate upload pack service
// among of the set of known protocols: HTTP, SSH. See `InstallProtocol`
// to add or modify protocols.
func NewGitUploadPackService(repoURL string) (common.GitUploadPackService, error) {
	u, err := url.Parse(repoURL)
	if err != nil {
		return nil, fmt.Errorf("invalid url %q", repoURL)
	}
	s, ok := KnownProtocols[u.Scheme]
	if !ok {
		return nil, fmt.Errorf("unsupported scheme %q", u.Scheme)
	}

	return s, nil
}