private

Documentation

Index

• Constants
• func AddLogger(ctx context.Context, group, name, mode string, config map[string]interface{}) (int, string)
• func AuthorizedPublicKeyByContent(ctx context.Context, content string) (string, error)
• func FlushQueues(ctx context.Context, timeout time.Duration, nonBlocking bool) (int, string)
• func HookPreReceive(ctx context.Context, ownerName, repoName string, opts HookOptions) (int, string)
• func IsErrServCommand(err error) bool
• func PauseLogging(ctx context.Context) (int, string)
• func ReleaseReopenLogging(ctx context.Context) (int, string)
• func RemoveLogger(ctx context.Context, group, name string) (int, string)
• func Restart(ctx context.Context) (int, string)
• func RestoreRepo(ctx context.Context, repoDir, ownerName, repoName string, units []string) (int, string)
• func ResumeLogging(ctx context.Context) (int, string)
• func SSHLog(ctx context.Context, isErr bool, msg string) error
• func SendEmail(ctx context.Context, subject, message string, to []string) (int, string)
• func ServNoCommand(ctx context.Context, keyID int64) (*asymkey_model.PublicKey, *user_model.User, error)
• func SetDefaultBranch(ctx context.Context, ownerName, repoName, branch string) error
• func Shutdown(ctx context.Context) (int, string)
• func UpdatePublicKeyInRepo(ctx context.Context, keyID, repoID int64) error
• type Email
• type ErrServCommand
  • func (err ErrServCommand) Error() string
• type FlushOptions
• type GitPushOptions
  • func (g GitPushOptions) Bool(key string, def bool) bool
• type HookOptions
• type HookPostReceiveBranchResult
• type HookPostReceiveResult
  • func HookPostReceive(ctx context.Context, ownerName, repoName string, opts HookOptions) (*HookPostReceiveResult, string)
• type HookProcReceiveRefResult
• type HookProcReceiveResult
  • func HookProcReceive(ctx context.Context, ownerName, repoName string, opts HookOptions) (*HookProcReceiveResult, error)
• type KeyAndOwner
• type LoggerOptions
• type Response
• type RestoreParams
• type SSHLogOption
• type ServCommandResults
  • func ServCommand(ctx context.Context, keyID int64, ownerName, repoName string, ...) (*ServCommandResults, error)

Constants

const (
	GitAlternativeObjectDirectories = "GIT_ALTERNATE_OBJECT_DIRECTORIES"
	GitObjectDirectory              = "GIT_OBJECT_DIRECTORY"
	GitQuarantinePath               = "GIT_QUARANTINE_PATH"
	GitPushOptionCount              = "GIT_PUSH_OPTION_COUNT"
)

Git environment variables

const (
	GitPushOptionRepoPrivate  = "repo.private"
	GitPushOptionRepoTemplate = "repo.template"
)

GitPushOptions keys

Functions

func AddLogger

func AddLogger(ctx context.Context, group, name, mode string, config map[string]interface{}) (int, string)

AddLogger adds a logger

func AuthorizedPublicKeyByContent

func AuthorizedPublicKeyByContent(ctx context.Context, content string) (string, error)

AuthorizedPublicKeyByContent searches content as prefix (leak e-mail part) and returns public key found.

func FlushQueues

func FlushQueues(ctx context.Context, timeout time.Duration, nonBlocking bool) (int, string)

FlushQueues calls the internal flush-queues function

func HookPreReceive

func HookPreReceive(ctx context.Context, ownerName, repoName string, opts HookOptions) (int, string)

HookPreReceive check whether the provided commits are allowed

func IsErrServCommand

func IsErrServCommand(err error) bool

IsErrServCommand checks if an error is a ErrServCommand.

func PauseLogging

func PauseLogging(ctx context.Context) (int, string)

PauseLogging pauses logging

func ReleaseReopenLogging

func ReleaseReopenLogging(ctx context.Context) (int, string)

ReleaseReopenLogging releases and reopens logging files

func RemoveLogger

func RemoveLogger(ctx context.Context, group, name string) (int, string)

RemoveLogger removes a logger

func Restart

func Restart(ctx context.Context) (int, string)

Restart calls the internal restart function

func RestoreRepo

func RestoreRepo(ctx context.Context, repoDir, ownerName, repoName string, units []string) (int, string)

RestoreRepo calls the internal RestoreRepo function

func ResumeLogging

func ResumeLogging(ctx context.Context) (int, string)

ResumeLogging resumes logging

func SSHLog

func SSHLog(ctx context.Context, isErr bool, msg string) error

SSHLog sends ssh error log response

func SendEmail

func SendEmail(ctx context.Context, subject, message string, to []string) (int, string)

SendEmail calls the internal SendEmail function

It accepts a list of usernames. If DB contains these users it will send the email to them.

If to list == nil its supposed to send an email to every user present in DB

func ServNoCommand

func ServNoCommand(ctx context.Context, keyID int64) (*asymkey_model.PublicKey, *user_model.User, error)

ServNoCommand returns information about the provided key

func SetDefaultBranch

func SetDefaultBranch(ctx context.Context, ownerName, repoName, branch string) error

SetDefaultBranch will set the default branch to the provided branch for the provided repository

func Shutdown

func Shutdown(ctx context.Context) (int, string)

Shutdown calls the internal shutdown function

func UpdatePublicKeyInRepo

func UpdatePublicKeyInRepo(ctx context.Context, keyID, repoID int64) error

UpdatePublicKeyInRepo update public key and if necessary deploy key updates

Types

type Email

type Email struct {
	Subject string
	Message string
	To      []string
}

Email structure holds a data for sending general emails

type ErrServCommand

type ErrServCommand struct {
	Results    ServCommandResults
	Err        string
	StatusCode int
}

ErrServCommand is an error returned from ServCommmand.

func (ErrServCommand) Error

func (err ErrServCommand) Error() string

type FlushOptions

type FlushOptions struct {
	Timeout     time.Duration
	NonBlocking bool
}

FlushOptions represents the options for the flush call

type GitPushOptions

type GitPushOptions map[string]string

GitPushOptions is a wrapper around a map[string]string

func (GitPushOptions) Bool

func (g GitPushOptions) Bool(key string, def bool) bool

Bool checks for a key in the map and parses as a boolean

type HookOptions

type HookOptions struct {
	OldCommitIDs                    []string
	NewCommitIDs                    []string
	RefFullNames                    []string
	UserID                          int64
	UserName                        string
	GitObjectDirectory              string
	GitAlternativeObjectDirectories string
	GitQuarantinePath               string
	GitPushOptions                  GitPushOptions
	PullRequestID                   int64
	DeployKeyID                     int64 // if the pusher is a DeployKey, then UserID is the repo's org user.
	IsWiki                          bool
}

HookOptions represents the options for the Hook calls

type HookPostReceiveBranchResult

type HookPostReceiveBranchResult struct {
	Message bool
	Create  bool
	Branch  string
	URL     string
}

HookPostReceiveBranchResult represents an individual branch result from PostReceive

type HookPostReceiveResult

type HookPostReceiveResult struct {
	Results      []HookPostReceiveBranchResult
	RepoWasEmpty bool
	Err          string
}

HookPostReceiveResult represents an individual result from PostReceive

func HookPostReceive

func HookPostReceive(ctx context.Context, ownerName, repoName string, opts HookOptions) (*HookPostReceiveResult, string)

HookPostReceive updates services and users

type HookProcReceiveRefResult

type HookProcReceiveRefResult struct {
	OldOID       string
	NewOID       string
	Ref          string
	OriginalRef  string
	IsForcePush  bool
	IsNotMatched bool
	Err          string
}

HookProcReceiveRefResult represents an individual result from ProcReceive

type HookProcReceiveResult

type HookProcReceiveResult struct {
	Results []HookProcReceiveRefResult
	Err     string
}

HookProcReceiveResult represents an individual result from ProcReceive

func HookProcReceive

func HookProcReceive(ctx context.Context, ownerName, repoName string, opts HookOptions) (*HookProcReceiveResult, error)

HookProcReceive proc-receive hook

type KeyAndOwner

type KeyAndOwner struct {
	Key   *asymkey_model.PublicKey `json:"key"`
	Owner *user_model.User         `json:"user"`
}

KeyAndOwner is the response from ServNoCommand

type LoggerOptions

type LoggerOptions struct {
	Group  string
	Name   string
	Mode   string
	Config map[string]interface{}
}

LoggerOptions represents the options for the add logger call

type Response

type Response struct {
	Err string `json:"err"`
}

Response internal request response

type RestoreParams

type RestoreParams struct {
	RepoDir   string
	OwnerName string
	RepoName  string
	Units     []string
}

RestoreParams structure holds a data for restore repository

type SSHLogOption

type SSHLogOption struct {
	IsError bool
	Message string
}

SSHLogOption ssh log options

type ServCommandResults

type ServCommandResults struct {
	IsWiki      bool
	DeployKeyID int64
	KeyID       int64  // public key
	KeyName     string // this field is ambiguous, it can be the name of DeployKey, or the name of the PublicKey
	UserName    string
	UserEmail   string
	UserID      int64
	OwnerName   string
	RepoName    string
	RepoID      int64
}

ServCommandResults are the results of a call to the private route serv

func ServCommand

func ServCommand(ctx context.Context, keyID int64, ownerName, repoName string, mode perm.AccessMode, verbs ...string) (*ServCommandResults, error)

ServCommand preps for a serv call