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 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) error
  • func (b *Client) GetModifiedFiles(repo models.Repo, pull models.PullRequest) ([]string, error)
  • func (b *Client) MergePull(pull models.PullRequest) error
  • func (b *Client) PullIsApproved(repo models.Repo, pull models.PullRequest) (bool, error)
  • func (b *Client) PullIsMergeable(repo models.Repo, pull models.PullRequest) (bool, error)
  • 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 ConflictStatus
• 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 {
	Nickname *string `json:"nickname,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) error

CreateComment creates a comment on the merge request.

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. The names include the path to the file from the repo root, ex. parent/child/file.txt.

func (*Client) MergePull

func (b *Client) MergePull(pull models.PullRequest) error

MergePull merges the pull request.

func (*Client) PullIsApproved

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

PullIsApproved returns true if the merge request was approved.

func (*Client) PullIsMergeable

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

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

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 ConflictStatus

type ConflictStatus struct {
	MergeImpossible *bool `json:"mergeimpossible,omitempty" validate:"required"`
	IsConflicted    *bool `json:"isconflicted,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 {
	// 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 {
		Username *string `json:"username,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"`
}

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"`
}