bitbucketserver

Documentation

Index

• Constants
• func ValidateSignature(payload []byte, signature string, secretKey []byte) error
• type Actor
• type Changes
• type Client
  • func NewClient(httpClient *http.Client, username string, password string, baseURL string, ...) (*Client, error)
  • func (b *Client) CreateComment(logger logging.SimpleLogging, repo models.Repo, pullNum int, comment string, ...) error
  • func (b *Client) DiscardReviews(_ models.Repo, _ models.PullRequest) error
  • func (b *Client) GetCloneURL(_ logging.SimpleLogging, _ models.VCSHostType, _ string) (string, error)
  • func (b *Client) GetFileContent(_ logging.SimpleLogging, _ models.PullRequest, _ string) (bool, []byte, error)
  • func (b *Client) GetModifiedFiles(logger logging.SimpleLogging, repo models.Repo, pull models.PullRequest) ([]string, error)
  • func (b *Client) GetProjectKey(repoName string, cloneURL string) (string, error)
  • func (b *Client) GetPullLabels(_ logging.SimpleLogging, _ models.Repo, _ models.PullRequest) ([]string, error)
  • func (b *Client) GetTeamNamesForUser(_ models.Repo, _ models.User) ([]string, error)
  • func (b *Client) HidePrevCommandComments(_ logging.SimpleLogging, _ models.Repo, _ int, _ string, _ string) error
  • func (b *Client) MarkdownPullLink(pull models.PullRequest) (string, error)
  • func (b *Client) MergePull(logger logging.SimpleLogging, pull models.PullRequest, ...) error
  • func (b *Client) PullIsApproved(logger logging.SimpleLogging, repo models.Repo, pull models.PullRequest) (approvalStatus models.ApprovalStatus, err error)
  • func (b *Client) PullIsMergeable(logger logging.SimpleLogging, repo models.Repo, pull models.PullRequest, ...) (bool, error)
  • func (b *Client) ReactToComment(_ logging.SimpleLogging, _ models.Repo, _ int, _ int64, _ string) error
  • func (b *Client) SupportsSingleFileDownload(_ models.Repo) bool
  • func (b *Client) UpdateStatus(logger logging.SimpleLogging, _ models.Repo, pull models.PullRequest, ...) error
• type Comment
• type CommentEvent
• type CommonEventData
• type DeleteSourceBranch
• type MergeStatus
• type Project
• type PullRequest
• type PullRequestEvent
• type Ref
• type Repository

Constants

const (
	DiagnosticsPingHeader    = "diagnostics:ping"
	PullCreatedHeader        = "pr:opened"
	PullFromRefUpdatedHeader = "pr:from_ref_updated"
	PullMergedHeader         = "pr:merged"
	PullDeclinedHeader       = "pr:declined"
	PullDeletedHeader        = "pr:deleted"
	PullCommentCreatedHeader = "pr:comment:added"
)

Functions

func ValidateSignature

func ValidateSignature(payload []byte, signature string, secretKey []byte) error

Types

type Actor

type Actor struct {
	Username *string `json:"name,omitempty" validate:"required"`
}

type Changes

type Changes struct {
	Values []struct {
		Path struct {
			ToString *string `json:"toString,omitempty" validate:"required"`
		} `json:"path,omitempty" validate:"required"`
		SrcPath *struct {
			ToString *string `json:"toString,omitempty"`
		} `json:"srcPath,omitempty"`
	} `json:"values,omitempty" validate:"required"`
	NextPageStart *int  `json:"nextPageStart,omitempty"`
	IsLastPage    *bool `json:"isLastPage,omitempty" validate:"required"`
}

type Client

type Client struct {
	HTTPClient  *http.Client
	Username    string
	Password    string
	BaseURL     string
	AtlantisURL string
}

func NewClient

func NewClient(httpClient *http.Client, username string, password string, baseURL string, atlantisURL string) (*Client, error)

NewClient builds a bitbucket cloud client. Returns an error if the baseURL is malformed. httpClient is the client to use to make the requests, username and password are used as basic auth in the requests, baseURL is the API's baseURL, ex. https://corp.com:7990. Don't include the API version, ex. '/1.0' since that changes based on the API call. atlantisURL is the URL for Atlantis that will be linked to from the build status icons. This linking is annoying because we don't have anywhere good to link but a URL is required.

func (*Client) CreateComment

func (b *Client) CreateComment(logger logging.SimpleLogging, repo models.Repo, pullNum int, comment string, _ string) error

CreateComment creates a comment on the merge request. It will write multiple comments if a single comment is too long.

func (*Client) DiscardReviews

func (b *Client) DiscardReviews(_ models.Repo, _ models.PullRequest) error

func (*Client) GetCloneURL

func (b *Client) GetCloneURL(_ logging.SimpleLogging, _ models.VCSHostType, _ string) (string, error)

func (*Client) GetFileContent

func (b *Client) GetFileContent(_ logging.SimpleLogging, _ models.PullRequest, _ string) (bool, []byte, error)

GetFileContent a repository file content from VCS (which support fetch a single file from repository) The first return value indicates whether the repo contains a file or not if BaseRepo had a file, its content will placed on the second return value

func (*Client) GetModifiedFiles

func (b *Client) GetModifiedFiles(logger logging.SimpleLogging, repo models.Repo, pull models.PullRequest) ([]string, error)

GetModifiedFiles returns the names of files that were modified in the merge request relative to the repo root, e.g. parent/child/file.txt.

func (*Client) GetProjectKey

func (b *Client) GetProjectKey(repoName string, cloneURL string) (string, error)

func (*Client) GetPullLabels

func (b *Client) GetPullLabels(_ logging.SimpleLogging, _ models.Repo, _ models.PullRequest) ([]string, error)

func (*Client) GetTeamNamesForUser

func (b *Client) GetTeamNamesForUser(_ models.Repo, _ models.User) ([]string, error)

GetTeamNamesForUser returns the names of the teams or groups that the user belongs to (in the organization the repository belongs to).

func (*Client) HidePrevCommandComments

func (b *Client) HidePrevCommandComments(_ logging.SimpleLogging, _ models.Repo, _ int, _ string, _ string) error

func (*Client) MarkdownPullLink

func (b *Client) MarkdownPullLink(pull models.PullRequest) (string, error)

MarkdownPullLink specifies the character used in a pull request comment.

func (*Client) MergePull

func (b *Client) MergePull(logger logging.SimpleLogging, pull models.PullRequest, pullOptions models.PullRequestOptions) error

MergePull merges the pull request.

func (*Client) PullIsApproved

func (b *Client) PullIsApproved(logger logging.SimpleLogging, repo models.Repo, pull models.PullRequest) (approvalStatus models.ApprovalStatus, err error)

PullIsApproved returns true if the merge request was approved.

func (*Client) PullIsMergeable

func (b *Client) PullIsMergeable(logger logging.SimpleLogging, repo models.Repo, pull models.PullRequest, _ string) (bool, error)

PullIsMergeable returns true if the merge request has no conflicts and can be merged.

func (*Client) ReactToComment

func (b *Client) ReactToComment(_ logging.SimpleLogging, _ models.Repo, _ int, _ int64, _ string) error

func (*Client) SupportsSingleFileDownload

func (b *Client) SupportsSingleFileDownload(_ models.Repo) bool

func (*Client) UpdateStatus

func (b *Client) UpdateStatus(logger logging.SimpleLogging, _ models.Repo, pull models.PullRequest, status models.CommitStatus, src string, description string, url string) error

UpdateStatus updates the status of a commit.

type Comment

type Comment struct {
	Text *string `json:"text,omitempty" validate:"required"`
}

type CommentEvent

type CommentEvent struct {
	CommonEventData
	Comment *Comment `json:"comment,omitempty" validate:"required"`
}

type CommonEventData

type CommonEventData struct {
	Actor       *Actor       `json:"actor,omitempty" validate:"required"`
	PullRequest *PullRequest `json:"pullRequest,omitempty" validate:"required"`
}

type DeleteSourceBranch

type DeleteSourceBranch struct {
	Name   string `json:"name"`
	DryRun bool   `json:"dryRun"`
}

type MergeStatus

type MergeStatus struct {
	CanMerge   *bool `json:"canMerge,omitempty" validate:"required"`
	Conflicted *bool `json:"conflicted,omitempty" validate:"required"`
}

type Project

type Project struct {
	Name *string `json:"name,omitempty" validate:"required"`
	Key  *string `json:"key,omitempty" validate:"required"`
}

type PullRequest

type PullRequest struct {
	Version   *int    `json:"version,omitempty" validate:"required"`
	ID        *int    `json:"id,omitempty" validate:"required"`
	FromRef   *Ref    `json:"fromRef,omitempty" validate:"required"`
	ToRef     *Ref    `json:"toRef,omitempty" validate:"required"`
	State     *string `json:"state,omitempty" validate:"required"`
	Reviewers []struct {
		Approved *bool `json:"approved,omitempty" validate:"required"`
	} `json:"reviewers,omitempty" validate:"required"`
}

type PullRequestEvent

type PullRequestEvent struct {
	CommonEventData
}

type Ref

type Ref struct {
	Repository   *Repository `json:"repository,omitempty" validate:"required"`
	DisplayID    *string     `json:"displayId,omitempty" validate:"required"`
	LatestCommit *string     `json:"latestCommit,omitempty" validate:"required"`
}

type Repository

type Repository struct {
	Slug    *string  `json:"slug,omitempty" validate:"required"`
	Project *Project `json:"project,omitempty" validate:"required"`
}