bitbucketcloud

Documentation

Overview

Package bitbucketcloud holds code for Bitbucket Cloud aka (bitbucket.org). It is separate from bitbucketserver because Bitbucket Server has different APIs.

Index

• Constants
• type Actor
• type Author
• type Branch
• type BranchMeta
• type Client
  • func NewClient(httpClient *http.Client, username string, password string, atlantisURL string) *Client
  • func (b *Client) CreateComment(repo models.Repo, pullNum int, comment string, command string) error
  • func (b *Client) DiscardReviews(repo models.Repo, pull models.PullRequest) error
  • func (b *Client) GetCloneURL(VCSHostType models.VCSHostType, repo string) (string, error)
  • func (b *Client) GetFileContent(pull models.PullRequest, fileName string) (bool, []byte, error)
  • func (b *Client) GetModifiedFiles(repo models.Repo, pull models.PullRequest) ([]string, error)
  • func (b *Client) GetTeamNamesForUser(repo models.Repo, user models.User) ([]string, error)
  • func (b *Client) HidePrevCommandComments(repo models.Repo, pullNum int, command string) error
  • func (b *Client) MarkdownPullLink(pull models.PullRequest) (string, error)
  • func (b *Client) MergePull(pull models.PullRequest, pullOptions models.PullRequestOptions) error
  • func (b *Client) PullIsApproved(repo models.Repo, pull models.PullRequest) (approvalStatus models.ApprovalStatus, err error)
  • func (b *Client) PullIsMergeable(repo models.Repo, pull models.PullRequest, vcsstatusname string) (bool, error)
  • func (b *Client) ReactToComment(repo models.Repo, commentID int64, reaction string) error
  • func (b *Client) SupportsSingleFileDownload(models.Repo) bool
  • func (b *Client) UpdateStatus(repo models.Repo, pull models.PullRequest, status models.CommitStatus, ...) error
• type Comment
• type CommentContent
• type CommentEvent
• type Commit
• type CommonEventData
• type DiffStat
• type DiffStatFile
• type DiffStatValue
• type Link
• type Links
• type Participant
• type PullRequest
• type PullRequestEvent
• type Repository

Constants

const (
	PullCreatedHeader        = "pullrequest:created"
	PullUpdatedHeader        = "pullrequest:updated"
	PullFulfilledHeader      = "pullrequest:fulfilled"
	PullRejectedHeader       = "pullrequest:rejected"
	PullCommentCreatedHeader = "pullrequest:comment_created"
)

const BaseURL = "https://api.bitbucket.org"

Types

type Actor

type Actor struct {
	AccountID *string `json:"account_id,omitempty" validate:"required"`
}

type Author

type Author struct {
	UUID *string `json:"uuid,omitempty" validate:"required"`
}

type Branch

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

type BranchMeta

type BranchMeta struct {
	Repository *Repository `json:"repository,omitempty" validate:"required"`
	Commit     *Commit     `json:"commit,omitempty" validate:"required"`
	Branch     *Branch     `json:"branch,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, atlantisURL string) *Client

NewClient builds a bitbucket cloud client. 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(repo models.Repo, pullNum int, comment string, command string) error

CreateComment creates a comment on the merge request.

func (*Client) DiscardReviews

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

func (*Client) GetCloneURL

func (b *Client) GetCloneURL(VCSHostType models.VCSHostType, repo string) (string, error)

func (*Client) GetFileContent

func (b *Client) GetFileContent(pull models.PullRequest, fileName 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(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) GetTeamNamesForUser

func (b *Client) GetTeamNamesForUser(repo models.Repo, user 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(repo models.Repo, pullNum int, command 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(pull models.PullRequest, pullOptions models.PullRequestOptions) error

MergePull merges the pull request.

func (*Client) PullIsApproved

func (b *Client) PullIsApproved(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(repo models.Repo, pull models.PullRequest, vcsstatusname string) (bool, error)

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

func (*Client) ReactToComment

func (b *Client) ReactToComment(repo models.Repo, commentID int64, reaction string) error

UpdateComment updates the body of a comment on the merge request.

func (*Client) SupportsSingleFileDownload

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

func (*Client) UpdateStatus

func (b *Client) UpdateStatus(repo 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 {
	Content *CommentContent `json:"content,omitempty" validate:"required"`
}

type CommentContent

type CommentContent struct {
	Raw *string `json:"raw,omitempty" validate:"required"`
}

type CommentEvent

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

type Commit

type Commit struct {
	Hash *string `json:"hash,omitempty" validate:"required"`
}

type CommonEventData

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

type DiffStat

type DiffStat struct {
	Values []DiffStatValue `json:"values,omitempty" validate:"required"`
	Next   *string         `json:"next,omitempty"`
}

type DiffStatFile

type DiffStatFile struct {
	Path *string `json:"path,omitempty" validate:"required"`
}

type DiffStatValue

type DiffStatValue struct {
	Status *string `json:"status,omitempty" validate:"required"`
	// Old is the old file, this can be null.
	Old *DiffStatFile `json:"old,omitempty"`
	// New is the new file, this can be null.
	New *DiffStatFile `json:"new,omitempty"`
}

type Link

type Link struct {
	HREF *string `json:"href,omitempty" validate:"required"`
}

type Links

type Links struct {
	HTML *Link `json:"html,omitempty" validate:"required"`
}

type Participant

type Participant struct {
	Approved *bool `json:"approved,omitempty" validate:"required"`
	User     *struct {
		UUID *string `json:"uuid,omitempty" validate:"required"`
	} `json:"user,omitempty" validate:"required"`
}

type PullRequest

type PullRequest struct {
	ID           *int          `json:"id,omitempty" validate:"required"`
	Source       *BranchMeta   `json:"source,omitempty" validate:"required"`
	Destination  *BranchMeta   `json:"destination,omitempty" validate:"required"`
	Participants []Participant `json:"participants,omitempty" validate:"required"`
	Links        *Links        `json:"links,omitempty" validate:"required"`
	State        *string       `json:"state,omitempty" validate:"required"`
	Author       *Author       `jsonN:"author,omitempty" validate:"required"`
}

type PullRequestEvent

type PullRequestEvent struct {
	CommonEventData
}

type Repository

type Repository struct {
	FullName *string `json:"full_name,omitempty" validate:"required"`
	Links    Links   `json:"links,omitempty" validate:"required"`
}