harness-drone/pkg/remote/remote.go

package remote

import (
	"net/http"

	"github.com/drone/drone/pkg/oauth2"
	"github.com/drone/drone/pkg/types"

	log "github.com/drone/drone/Godeps/_workspace/src/github.com/Sirupsen/logrus"
)

var drivers = make(map[string]DriverFunc)

// Register makes a remote driver available by the provided name.
// If Register is called twice with the same name or if driver is nil,
// it panics.
func Register(name string, driver DriverFunc) {
	if driver == nil {
		panic("remote: Register driver is nil")
	}
	if _, dup := drivers[name]; dup {
		panic("remote: Register called twice for driver " + name)
	}
	drivers[name] = driver
}

// DriverFunc returns a new connection to the remote.
// Config is a struct, with base remote configuration.
type DriverFunc func(config string) (Remote, error)

// New creates a new remote connection.
func New(driver, config string) (Remote, error) {
	fn, ok := drivers[driver]
	if !ok {
		log.Fatalf("remote: unknown driver %q", driver)
	}
	log.Infof("remote: loading driver %s", driver)
	log.Infof("remote: loading config %s", config)
	return fn(config)
}

type Remote interface {
	// Login authenticates the session and returns the
	// remote user details.
	Login(token, secret string) (*types.User, error)

	// Orgs fetches the organizations for the given user.
	Orgs(u *types.User) ([]string, error)

	// Repo fetches the named repository from the remote system.
	Repo(u *types.User, owner, repo string) (*types.Repo, error)

	// Perm fetches the named repository permissions from
	// the remote system for the specified user.
	Perm(u *types.User, owner, repo string) (*types.Perm, error)

	// Script fetches the build script (.drone.yml) from the remote
	// repository and returns in string format.
	Script(u *types.User, r *types.Repo, b *types.Build) ([]byte, error)

	// Status sends the commit status to the remote system.
	// An example would be the GitHub pull request status.
	Status(u *types.User, r *types.Repo, b *types.Build) error

	// Netrc returns a .netrc file that can be used to clone
	// private repositories from a remote system.
	Netrc(u *types.User, r *types.Repo) (*types.Netrc, error)

	// Activate activates a repository by creating the post-commit hook and
	// adding the SSH deploy key, if applicable.
	Activate(u *types.User, r *types.Repo, k *types.Keypair, link string) error

	// Deactivate removes a repository by removing all the post-commit hooks
	// which are equal to link and removing the SSH deploy key.
	Deactivate(u *types.User, r *types.Repo, link string) error

	// Hook parses the post-commit hook from the Request body
	// and returns the required data in a standard format.
	Hook(r *http.Request) (*types.Hook, error)

	// Oauth2Transport
	Oauth2Transport(r *http.Request) *oauth2.Transport

	// GetOrgs returns all allowed organizations for remote.
	GetOrgs() []string

	// GetOpen returns boolean field with enabled or disabled
	// registration.
	GetOpen() bool

	// Default scope for remote
	Scope() string
}