gitlab

package module
v0.0.0-...-ba610b8 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 9, 2016 License: Apache-2.0 Imports: 14 Imported by: 0

README

go-gitlab

A GitLab API client enabling Go programs to interact with GitLab in a simple and uniform way

Documentation: GoDoc
Build Status: Build Status

Coverage

This API client package covers 100% of the existing GitLab API calls! So this includes all calls to the following services:

  • Users
  • Session
  • Projects (including setting Webhooks)
  • Project Snippets
  • Services
  • Repositories
  • Repository Files
  • Commits
  • Branches
  • Merge Requests
  • Issues
  • Labels
  • Milestones
  • Notes (comments)
  • Deploy Keys
  • System Hooks
  • Groups
  • Namespaces
  • Settings

Usage

import "github.com/xanzy/go-gitlab"

Construct a new GitLab client, then use the various services on the client to access different parts of the GitLab API. For example, to list all users:

git := gitlab.NewClient(nil, "yourtokengoeshere")
//git.SetBaseURL("https://git.mydomain.com/api/v3")
users, _, err := git.Users.ListUsers()

Some API methods have optional parameters that can be passed. For example, to list all projects for user "svanharmelen":

git := gitlab.NewClient(nil)
opt := &ListProjectsOptions{Search: "svanharmelen"})
projects, _, err := git.Projects.ListProjects(opt)
Examples

The examples directory contains a couple for clear examples, of which one is partially listed here as well:

package main

import (
	"log"

	"github.com/xanzy/go-gitlab"
)

func main() {
	git := gitlab.NewClient(nil, "yourtokengoeshere")

	// Create new project
	p := &gitlab.CreateProjectOptions{
		Name:                 "My Project",
		Description:          "Just a test project to play with",
		MergeRequestsEnabled: true,
		SnippetsEnabled:      true,
		VisibilityLevel:      gitlab.PublicVisibility,
	}
	project, _, err := git.Projects.CreateProject(p)
	if err != nil {
		log.Fatal(err)
	}

	// Add a new snippet
	s := &gitlab.CreateSnippetOptions{
		Title:           "Dummy Snippet",
		FileName:        "snippet.go",
		Code:            "package main....",
		VisibilityLevel: gitlab.PublicVisibility,
	}
	_, _, err = git.ProjectSnippets.CreateSnippet(project.ID, s)
	if err != nil {
		log.Fatal(err)
	}
}

For complete usage of go-gitlab, see the full package docs.

ToDo

  • The biggest thing this package still needs is tests 😞

Issues

Author

Sander van Harmelen (sander@xanzy.io)

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Bool

func Bool(v bool) *bool

Bool is a helper routine that allocates a new bool value to store v and returns a pointer to it.

func CheckResponse

func CheckResponse(r *http.Response) error

CheckResponse checks the API response for errors, and returns them if present. A response is considered an error if it has a status code outside the 200 range. API error responses are expected to have either no response body, or a JSON response body that maps to ErrorResponse. Any other response body will be silently ignored.

func Int

func Int(v int) *int

Int is a helper routine that allocates a new int32 value to store v and returns a pointer to it, but unlike Int32 its argument value is an int.

func String

func String(v string) *string

String is a helper routine that allocates a new string value to store v and returns a pointer to it.

func Stringify

func Stringify(message interface{}) string

Stringify attempts to create a reasonable string representation of types in the GitHub library. It does things like resolve pointers to their values and omits struct fields with nil values.

Types

type AccessLevel

type AccessLevel int

AccessLevel represents a permission level within GitLab.

GitLab API docs: http://doc.gitlab.com/ce/permissions/permissions.html

const (
	GuestPermissions     AccessLevel = 10
	ReporterPermissions  AccessLevel = 20
	DeveloperPermissions AccessLevel = 30
	MasterPermissions    AccessLevel = 40
	OwnerPermission      AccessLevel = 50
)

List of available access levels

GitLab API docs: http://doc.gitlab.com/ce/permissions/permissions.html

type AddDeployKeyOptions

type AddDeployKeyOptions struct {
	Title string `url:"title,omitempty" json:"title,omitempty"`
	Key   string `url:"key,omitempty" json:"key,omitempty"`
}

AddDeployKeyOptions represents the available ADDDeployKey() options.

GitLab API docs: http://doc.gitlab.com/ce/api/deploy_keys.html#add-deploy-key

type AddGroupMemberOptions

type AddGroupMemberOptions struct {
	UserID      int         `url:"user_id,omitempty" json:"user_id,omitempty"`
	AccessLevel AccessLevel `url:"access_level,omitempty" json:"access_level,omitempty"`
}

AddGroupMemberOptions represents the available AddGroupMember() options.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#add-group-member

type AddHookOptions

type AddHookOptions struct {
	URL string `url:"url,omitempty" json:"url,omitempty"`
}

AddHookOptions represents the available AddHook() options.

GitLab API docs: http://doc.gitlab.com/ce/api/system_hooks.html#add-new-system-hook-hook

type AddProjectHookOptions

type AddProjectHookOptions struct {
	URL                 string `url:"url,omitempty" json:"url,omitempty"`
	PushEvents          *bool  `url:"push_events,omitempty" json:"push_events,omitempty"`
	IssuesEvents        *bool  `url:"issues_events,omitempty" json:"issues_events,omitempty"`
	MergeRequestsEvents *bool  `url:"merge_requests_events,omitempty" json:"merge_requests_events,omitempty"`
	TagPushEvents       *bool  `url:"tag_push_events,omitempty" json:"tag_push_events,omitempty"`
}

AddProjectHookOptions represents the available AddProjectHook() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#add-project-hook

type AddProjectMemberOptions

type AddProjectMemberOptions struct {
	UserID      int         `url:"user_id,omitempty" json:"user_id,omitempty"`
	AccessLevel AccessLevel `url:"access_level,omitempty" json:"access_level,omitempty"`
}

AddProjectMemberOptions represents the available AddProjectMember() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#add-project-team-member

type AddSSHKeyOptions

type AddSSHKeyOptions struct {
	Title string `url:"title,omitempty" json:"title,omitempty"`
	Key   string `url:"key,omitempty" json:"key,omitempty"`
}

AddSSHKeyOptions represents the available AddSSHKey() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#add-ssh-key

type ArchiveOptions

type ArchiveOptions struct {
	SHA string `url:"sha,omitempty" json:"sha,omitempty"`
}

ArchiveOptions represents the available Archive() options.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#get-file-archive

type Author

type Author struct {
	ID        int       `json:"id"`
	Username  string    `json:"username"`
	Email     string    `json:"email"`
	Name      string    `json:"name"`
	State     string    `json:"state"`
	Blocked   bool      `json:"blocked"`
	CreatedAt time.Time `json:"created_at"`
}

type Branch

type Branch struct {
	Commit    *Commit `json:"commit"`
	Name      string  `json:"name"`
	Protected bool    `json:"protected"`
}

Branch represents a GitLab branch.

GitLab API docs: http://doc.gitlab.com/ce/api/branches.html

func (Branch) String

func (b Branch) String() string

type BranchesService

type BranchesService struct {
	// contains filtered or unexported fields
}

BranchesService handles communication with the branch related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/branches.html

func (*BranchesService) CreateBranch

func (s *BranchesService) CreateBranch(
	pid interface{},
	opt *CreateBranchOptions) (*Branch, *Response, error)

CreateBranch creates branch from commit SHA or existing branch.

GitLab API docs: http://doc.gitlab.com/ce/api/branches.html#create-repository-branch

func (*BranchesService) DeleteBranch

func (s *BranchesService) DeleteBranch(pid interface{}, branch string) (*Response, error)

DeleteBranch deletes an existing branch.

GitLab API docs: http://doc.gitlab.com/ce/api/branches.html#delete-repository-branch

func (*BranchesService) GetBranch

func (s *BranchesService) GetBranch(pid interface{}, branch string) (*Branch, *Response, error)

GetBranch gets a single project repository branch.

GitLab API docs: http://doc.gitlab.com/ce/api/branches.html#get-single-repository-branch

func (*BranchesService) ListBranches

func (s *BranchesService) ListBranches(pid interface{}) ([]*Branch, *Response, error)

ListBranches gets a list of repository branches from a project, sorted by name alphabetically.

GitLab API docs: http://doc.gitlab.com/ce/api/branches.html#list-repository-branches

func (*BranchesService) ProtectBranch

func (s *BranchesService) ProtectBranch(pid interface{}, branch string) (*Branch, *Response, error)

ProtectBranch protects a single project repository branch. This is an idempotent function, protecting an already protected repository branch still returns a 200 OK status code.

GitLab API docs: http://doc.gitlab.com/ce/api/branches.html#protect-repository-branch

func (*BranchesService) UnprotectBranch

func (s *BranchesService) UnprotectBranch(
	pid interface{},
	branch string) (*Branch, *Response, error)

UnprotectBranch unprotects a single project repository branch. This is an idempotent function, unprotecting an already unprotected repository branch still returns a 200 OK status code.

GitLab API docs: http://doc.gitlab.com/ce/api/branches.html#unprotect-repository-branch

type BuildState

type BuildState string
const (
	Pending  BuildState = "pending"
	Running  BuildState = "running"
	Success  BuildState = "success"
	Failed   BuildState = "failed"
	Canceled BuildState = "canceled"
)

type Client

type Client struct {

	// User agent used when communicating with the GitLab API.
	UserAgent string

	// Services used for talking to different parts of the GitLab API.
	Branches        *BranchesService
	Commits         *CommitsService
	DeployKeys      *DeployKeysService
	Groups          *GroupsService
	Issues          *IssuesService
	Labels          *LabelsService
	MergeRequests   *MergeRequestsService
	Milestones      *MilestonesService
	Namespaces      *NamespacesService
	Notes           *NotesService
	Projects        *ProjectsService
	ProjectSnippets *ProjectSnippetsService
	Repositories    *RepositoriesService
	RepositoryFiles *RepositoryFilesService
	Services        *ServicesService
	Session         *SessionService
	Settings        *SettingsService
	SystemHooks     *SystemHooksService
	Users           *UsersService
	Variables       *VariablesService
	// contains filtered or unexported fields
}

A Client manages communication with the GitLab API.

func NewClient

func NewClient(httpClient *http.Client, token string) *Client

NewClient returns a new GitLab API client. If a nil httpClient is provided, http.DefaultClient will be used. To use API methods which require authentication, provide a valid private token.

func (*Client) BaseURL

func (c *Client) BaseURL() *url.URL

BaseURL return a copy of the baseURL.

func (*Client) Do

func (c *Client) Do(req *http.Request, v interface{}) (*Response, error)

Do sends an API request and returns the API response. The API response is JSON decoded and stored in the value pointed to by v, or returned as an error if an API error has occurred. If v implements the io.Writer interface, the raw response body will be written to v, without attempting to first decode it.

func (*Client) NewRequest

func (c *Client) NewRequest(method, path string, opt interface{}) (*http.Request, error)

NewRequest creates an API request. A relative URL path can be provided in urlStr, in which case it is resolved relative to the base URL of the Client. Relative URL paths should always be specified without a preceding slash. If specified, the value pointed to by body is JSON encoded and included as the request body.

func (*Client) SetBaseURL

func (c *Client) SetBaseURL(urlStr string) error

SetBaseURL sets the base URL for API requests to a custom endpoint. urlStr should always be specified with a trailing slash.

type Commit

type Commit struct {
	ID            string    `json:"id"`
	ShortID       string    `json:"short_id"`
	Title         string    `json:"title"`
	AuthorName    string    `json:"author_name"`
	AuthorEmail   string    `json:"author_email"`
	AuthoredDate  time.Time `json:"authored_date"`
	CommittedDate time.Time `json:"committed_date"`
	CreatedAt     time.Time `json:"created_at"`
	Message       string    `json:"message"`
	ParentsIds    []string  `json:"parents_ids"`
}

Commit represents a GitLab commit.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html

func (Commit) String

func (c Commit) String() string

type CommitComment

type CommitComment struct {
	Note     string `json:"note"`
	Path     string `json:"path"`
	Line     int    `json:"line"`
	LineType string `json:"line_type"`
	Author   Author `json:"author"`
}

CommitComment represents a GitLab commit comment.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html

func (CommitComment) String

func (c CommitComment) String() string

type CommitStatus

type CommitStatus struct {
	ID          int       `json:"id"`
	SHA         string    `json:"sha"`
	Ref         string    `json:"ref"`
	Status      string    `json:"status"`
	Name        string    `json:"name"`
	TargetUrl   string    `json:"target_url"`
	Description string    `json:"description"`
	CreatedAt   time.Time `json:"created_at"`
	StartedAt   time.Time `json:"started_at"`
	FinishedAt  time.Time `json:"finished_at"`
	Author      Author    `json:"author"`
}

CommitStatus represents a GitLab commit status.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#get-the-status-of-a-commit

type CommitsService

type CommitsService struct {
	// contains filtered or unexported fields
}

CommitsService handles communication with the commit related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html

func (*CommitsService) GetCommit

func (s *CommitsService) GetCommit(
	pid interface{},
	sha string) (*Commit, *Response, error)

GetCommit gets a specific commit identified by the commit hash or name of a branch or tag.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#get-a-single-commit

func (*CommitsService) GetCommitComments

func (s *CommitsService) GetCommitComments(
	pid interface{},
	sha string) ([]*CommitComment, *Response, error)

GetCommitComments gets the comments of a commit in a project.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#get-the-comments-of-a-commit

func (*CommitsService) GetCommitDiff

func (s *CommitsService) GetCommitDiff(
	pid interface{},
	sha string) ([]*Diff, *Response, error)

GetCommitDiff gets the diff of a commit in a project..

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#get-the-diff-of-a-commit

func (*CommitsService) GetCommitStatuses

func (s *CommitsService) GetCommitStatuses(
	pid interface{},
	sha string,
	opt *GetCommitStatusesOptions) ([]*CommitStatus, *Response, error)

GetCommitStatuses gets the statuses of a commit in a project.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#get-the-status-of-a-commit

func (*CommitsService) ListCommits

func (s *CommitsService) ListCommits(
	pid interface{},
	opt *ListCommitsOptions) ([]*Commit, *Response, error)

ListCommits gets a list of repository commits in a project.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#list-commits

func (*CommitsService) PostCommitComment

func (s *CommitsService) PostCommitComment(
	pid interface{},
	sha string,
	opt *PostCommitCommentOptions) (*CommitComment, *Response, error)

PostCommitComment adds a comment to a commit. Optionally you can post comments on a specific line of a commit. Therefor both path, line_new and line_old are required.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#post-comment-to-commit

func (*CommitsService) SetCommitStatus

func (s *CommitsService) SetCommitStatus(
	pid interface{},
	sha string,
	opt *SetCommitStatusOptions) (*CommitStatus, *Response, error)

SetCommitStatus sets the status of a commit in a project.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#post-the-status-to-commit

type Compare

type Compare struct {
	Commit         *Commit   `json:"commit"`
	Commits        []*Commit `json:"commits"`
	Diffs          []*Diff   `json:"diffs"`
	CompareTimeout bool      `json:"compare_timeout"`
	CompareSameRef bool      `json:"compare_same_ref"`
}

Compare represents the result of a comparison of branches, tags or commits.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#compare-branches-tags-or-commits

func (Compare) String

func (c Compare) String() string

type CompareOptions

type CompareOptions struct {
	From string `url:"from,omitempty" json:"from,omitempty"`
	To   string `url:"to,omitempty" json:"to,omitempty"`
}

CompareOptions represents the available Compare() options.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#compare-branches-tags-or-commits

type Contributor

type Contributor struct {
	Name      string `json:"name,omitempty"`
	Email     string `json:"email,omitempty"`
	Commits   int    `json:"commits,omitempty"`
	Additions int    `json:"additions,omitempty"`
	Deletions int    `json:"deletions,omitempty"`
}

Contributor represents a GitLap contributor.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#contributer

func (Contributor) String

func (c Contributor) String() string

type CreateBranchOptions

type CreateBranchOptions struct {
	BranchName string `url:"branch_name,omitempty" json:"branch_name,omitempty"`
	Ref        string `url:"ref,omitempty" json:"ref,omitempty"`
}

CreateBranchOptions represents the available CreateBranch() options.

GitLab API docs: http://doc.gitlab.com/ce/api/branches.html#create-repository-branch

type CreateFileOptions

type CreateFileOptions struct {
	FilePath      string `url:"file_path,omitempty" json:"file_path,omitempty"`
	BranchName    string `url:"branch_name,omitempty" json:"branch_name,omitempty"`
	Encoding      string `url:"encoding,omitempty" json:"encoding,omitempty"`
	Content       string `url:"content,omitempty" json:"content,omitempty"`
	CommitMessage string `url:"commit_message,omitempty" json:"commit_message,omitempty"`
}

CreateFileOptions represents the available CreateFile() options.

GitLab API docs: http://doc.gitlab.com/ce/api/repository_files.html#create-new-file-in-repository

type CreateGroupOptions

type CreateGroupOptions struct {
	Name        string `url:"name,omitempty" json:"name,omitempty"`
	Path        string `url:"path,omitempty" json:"path,omitempty"`
	Description string `url:"description,omitempty" json:"description,omitempty"`
}

CreateGroupOptions represents the available CreateGroup() options.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#new-group

type CreateIssueNoteOptions

type CreateIssueNoteOptions struct {
	Body string `url:"body,omitempty" json:"body,omitempty"`
}

CreateIssueNoteOptions represents the available CreateIssueNote() options.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#create-new-issue-note

type CreateIssueOptions

type CreateIssueOptions struct {
	Title       string `url:"title,omitempty" json:"title,omitempty"`
	Description string `url:"description,omitempty" json:"description,omitempty"`
	AssigneeID  int    `url:"assignee_id,omitempty" json:"assignee_id,omitempty"`
	MilestoneID int    `url:"milestone_id,omitempty" json:"milestone_id,omitempty"`
	Labels      Labels `url:"labels,comma,omitempty" json:"labels,omitempty"`
}

CreateIssueOptions represents the available CreateIssue() options.

GitLab API docs: http://doc.gitlab.com/ce/api/issues.html#new-issues

type CreateLabelOptions

type CreateLabelOptions struct {
	Name  string `url:"name,omitempty" json:"name,omitempty"`
	Color string `url:"color,omitempty" json:"color,omitempty"`
}

CreateLabelOptions represents the available CreateLabel() options.

GitLab API docs: http://doc.gitlab.com/ce/api/labels.html#create-a-new-label

type CreateMergeRequestNoteOptions

type CreateMergeRequestNoteOptions struct {
	Body string `url:"body,omitempty" json:"body,omitempty"`
}

CreateMergeRequestNoteOptions represents the available CreateMergeRequestNote() options.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#create-new-merge-request-note

type CreateMergeRequestOptions

type CreateMergeRequestOptions struct {
	Title           string `url:"title,omitempty" json:"title,omitempty"`
	Description     string `url:"description,omitempty" json:"description,omitempty"`
	SourceBranch    string `url:"source_branch,omitemtpy" json:"source_branch,omitemtpy"`
	TargetBranch    string `url:"target_branch,omitemtpy" json:"target_branch,omitemtpy"`
	AssigneeID      int    `url:"assignee_id,omitempty" json:"assignee_id,omitempty"`
	TargetProjectID int    `url:"target_project_id,omitempty" json:"target_project_id,omitempty"`
}

CreateMergeRequestOptions represents the available CreateMergeRequest() options.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html#create-mr

type CreateMilestoneOptions

type CreateMilestoneOptions struct {
	Title       string `url:"title,omitempty" json:"title,omitempty"`
	Description string `url:"description,omitempty" json:"description,omitempty"`
	DueDate     string `url:"due_date,omitempty" json:"due_date,omitempty"`
}

CreateMilestoneOptions represents the available CreateMilestone() options.

GitLab API docs: http://doc.gitlab.com/ce/api/milestones.html#create-new-milestone

type CreateProjectForUserOptions

type CreateProjectForUserOptions struct {
	Name                 string          `url:"name,omitempty" json:"name,omitempty"`
	Description          string          `url:"description,omitempty" json:"description,omitempty"`
	DefaultBranch        string          `url:"default_branch,omitempty" json:"default_branch,omitempty"`
	IssuesEnabled        *bool           `url:"issues_enabled,omitempty" json:"issues_enabled,omitempty"`
	MergeRequestsEnabled *bool           `url:"merge_requests_enabled,omitempty" json:"merge_requests_enabled,omitempty"`
	WikiEnabled          *bool           `url:"wiki_enabled,omitempty" json:"wiki_enabled,omitempty"`
	SnippetsEnabled      *bool           `url:"snippets_enabled,omitempty" json:"snippets_enabled,omitempty"`
	Public               *bool           `url:"public,omitempty" json:"public,omitempty"`
	VisibilityLevel      VisibilityLevel `url:"visibility_level,omitempty" json:"visibility_level,omitempty"`
	ImportURL            string          `url:"import_url,omitempty" json:"import_url,omitempty"`
}

CreateProjectForUserOptions represents the available CreateProjectForUser() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#create-project-for-user

type CreateProjectOptions

type CreateProjectOptions struct {
	Name                 string          `url:"name,omitempty" json:"name,omitempty"`
	Path                 string          `url:"path,omitempty" json:"path,omitempty"`
	NamespaceID          string          `url:"namespace_id,omitempty" json:"namespace_id,omitempty"`
	Description          string          `url:"description,omitempty" json:"description,omitempty"`
	IssuesEnabled        *bool           `url:"issues_enabled,omitempty" json:"issues_enabled,omitempty"`
	MergeRequestsEnabled *bool           `url:"merge_requests_enabled,omitempty" json:"merge_requests_enabled,omitempty"`
	WikiEnabled          *bool           `url:"wiki_enabled,omitempty" json:"wiki_enabled,omitempty"`
	SnippetsEnabled      *bool           `url:"snippets_enabled,omitempty" json:"snippets_enabled,omitempty"`
	Public               *bool           `url:"public,omitempty" json:"public,omitempty"`
	VisibilityLevel      VisibilityLevel `url:"visibility_level,omitempty" json:"visibility_level,omitempty"`
	ImportURL            string          `url:"import_url,omitempty" json:"import_url,omitempty"`
}

CreateProjectOptions represents the available CreateProjects() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#create-project

type CreateSnippetNoteOptions

type CreateSnippetNoteOptions struct {
	Body string `url:"body,omitempty" json:"body,omitempty"`
}

CreateSnippetNoteOptions represents the available CreateSnippetNote() options.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#create-new-snippet-note

type CreateSnippetOptions

type CreateSnippetOptions struct {
	Title           string          `url:"title,omitempty" json:"title,omitempty"`
	FileName        string          `url:"file_name,omitempty" json:"file_name,omitempty"`
	Code            string          `url:"code,omitempty" json:"code,omitempty"`
	VisibilityLevel VisibilityLevel `url:"visibility_level,omitempty" json:"visibility_level,omitempty"`
}

CreateSnippetOptions represents the available CreateSnippet() options.

GitLab API docs: http://doc.gitlab.com/ce/api/project_snippets.html#create-new-snippet

type CreateTagOptions

type CreateTagOptions struct {
	TagName string `url:"tag_name,omitempty" json:"tag_name,omitempty"`
	Ref     string `url:"ref,omitempty" json:"ref,omitempty"`
	Message string `url:"message,omitempty" json:"message,omitempty"`
}

CreateTagOptions represents the available CreateTag() options.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#create-a-new-tag

type CreateUserOptions

type CreateUserOptions struct {
	Email          string `url:"email,omitempty" json:"email,omitempty"`
	Password       string `url:"password,omitempty" json:"password,omitempty"`
	Username       string `url:"username,omitempty" json:"username,omitempty"`
	Name           string `url:"name,omitempty" json:"name,omitempty"`
	Skype          string `url:"skype,omitempty" json:"skype,omitempty"`
	Linkedin       string `url:"linkedin,omitempty" json:"linkedin,omitempty"`
	Twitter        string `url:"twitter,omitempty" json:"twitter,omitempty"`
	WebsiteURL     string `url:"website_url,omitempty" json:"website_url,omitempty"`
	ProjectsLimit  int    `url:"projects_limit,omitempty" json:"projects_limit,omitempty"`
	ExternUID      string `url:"extern_uid,omitempty" json:"extern_uid,omitempty"`
	Provider       string `url:"provider,omitempty" json:"provider,omitempty"`
	Bio            string `url:"bio,omitempty" json:"bio,omitempty"`
	Admin          bool   `url:"admin,omitempty" json:"admin,omitempty"`
	CanCreateGroup bool   `url:"can_create_group,omitempty" json:"can_create_group,omitempty"`
	Confirm        bool   `url:"confirm,omitempty" json:"confirm,omitempty"`
}

CreateUserOptions represents the available CreateUser() options.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#user-creation

type DeleteFileOptions

type DeleteFileOptions struct {
	FilePath      string `url:"file_path,omitempty" json:"file_path,omitempty"`
	BranchName    string `url:"branch_name,omitempty" json:"branch_name,omitempty"`
	CommitMessage string `url:"commit_message,omitempty" json:"commit_message,omitempty"`
}

DeleteFileOptions represents the available DeleteFile() options.

GitLab API docs: http://doc.gitlab.com/ce/api/repository_files.html#delete-existing-file-in-repository

type DeleteLabelOptions

type DeleteLabelOptions struct {
	Name string `url:"name,omitempty" json:"name,omitempty"`
}

DeleteLabelOptions represents the available DeleteLabel() options.

GitLab API docs: http://doc.gitlab.com/ce/api/labels.html#delete-a-label

type DeployKey

type DeployKey struct {
	ID        int       `json:"id"`
	Title     string    `json:"title"`
	Key       string    `json:"key"`
	CreatedAt time.Time `json:"created_at"`
}

DeployKey represents a GitLab deploy key.

func (DeployKey) String

func (k DeployKey) String() string

type DeployKeysService

type DeployKeysService struct {
	// contains filtered or unexported fields
}

DeployKeysService handles communication with the keys related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/deploy_keys.html

func (*DeployKeysService) AddDeployKey

func (s *DeployKeysService) AddDeployKey(
	pid interface{},
	opt *AddDeployKeyOptions) (*DeployKey, *Response, error)

AddDeployKey creates a new deploy key for a project. If deploy key already exists in another project - it will be joined to project but only if original one was is accessible by same user.

GitLab API docs: http://doc.gitlab.com/ce/api/deploy_keys.html#add-deploy-key

func (*DeployKeysService) DeleteDeployKey

func (s *DeployKeysService) DeleteDeployKey(pid interface{}, deployKey int) (*Response, error)

DeleteDeployKey deletes a deploy key from a project.

GitLab API docs: http://doc.gitlab.com/ce/api/deploy_keys.html#delete-deploy-key

func (*DeployKeysService) GetDeployKey

func (s *DeployKeysService) GetDeployKey(
	pid interface{},
	deployKey int) (*DeployKey, *Response, error)

GetDeployKey gets a single deploy key.

GitLab API docs: http://doc.gitlab.com/ce/api/deploy_keys.html#single-deploy-key

func (*DeployKeysService) ListDeployKeys

func (s *DeployKeysService) ListDeployKeys(pid interface{}) ([]*DeployKey, *Response, error)

ListDeployKeys gets a list of a project's deploy keys

GitLab API docs: http://doc.gitlab.com/ce/api/deploy_keys.html#list-deploy-keys

type Diff

type Diff struct {
	Diff        string `json:"diff"`
	NewPath     string `json:"new_path"`
	OldPath     string `json:"old_path"`
	AMode       string `json:"a_mode"`
	BMode       string `json:"b_mode"`
	NewFile     bool   `json:"new_file"`
	RenamedFile bool   `json:"renamed_file"`
	DeletedFile bool   `json:"deleted_file"`
}

Diff represents a GitLab diff.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html

func (Diff) String

func (d Diff) String() string

type DroneCIService

type DroneCIService struct {
	Service
	Properties *DroneCIServiceProperties `json:"properties"`
}

DroneCIService represents Drone CI service settings.

type DroneCIServiceProperties

type DroneCIServiceProperties struct {
	Token                 *string `url:"token" json:"token"`
	DroneURL              *string `url:"drone_url" json:"drone_url"`
	EnableSSLVerification *string `url:"enable_ssl_verification" json:"enable_ssl_verification"`
}

DroneCIServiceProperties represents Drone CI specific properties.

type EditProjectHookOptions

type EditProjectHookOptions struct {
	URL                 string `url:"url,omitempty" json:"url,omitempty"`
	PushEvents          *bool  `url:"push_events,omitempty" json:"push_events,omitempty"`
	IssuesEvents        *bool  `url:"issues_events,omitempty" json:"issues_events,omitempty"`
	MergeRequestsEvents *bool  `url:"merge_requests_events,omitempty" json:"merge_requests_events,omitempty"`
	TagPushEvents       *bool  `url:"tag_push_events,omitempty" json:"tag_push_events,omitempty"`
}

EditProjectHookOptions represents the available EditProjectHook() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#edit-project-hook

type EditProjectMemberOptions

type EditProjectMemberOptions struct {
	AccessLevel AccessLevel `url:"access_level,omitempty" json:"access_level,omitempty"`
}

EditProjectMemberOptions represents the available EditProjectMember() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#edit-project-team-member

type EditProjectOptions

type EditProjectOptions struct {
	Name                 string          `url:"name,omitempty" json:"name,omitempty"`
	Path                 string          `url:"path,omitempty" json:"path,omitempty"`
	Description          string          `url:"description,omitempty" json:"description,omitempty"`
	DefaultBranch        string          `url:"default_branch,omitempty" json:"default_branch,omitempty"`
	IssuesEnabled        *bool           `url:"issues_enabled,omitempty" json:"issues_enabled,omitempty"`
	MergeRequestsEnabled *bool           `url:"merge_requests_enabled,omitempty" json:"merge_requests_enabled,omitempty"`
	WikiEnabled          *bool           `url:"wiki_enabled,omitempty" json:"wiki_enabled,omitempty"`
	SnippetsEnabled      *bool           `url:"snippets_enabled,omitempty" json:"snippets_enabled,omitempty"`
	Public               *bool           `url:"public,omitempty" json:"public,omitempty"`
	VisibilityLevel      VisibilityLevel `url:"visibility_level,omitempty" json:"visibility_level,omitempty"`
}

EditProjectOptions represents the available EditProject() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#edit-project

type Error

type Error struct {
	Resource string `json:"resource"` // resource on which the error occurred
	Field    string `json:"field"`    // field on which the error occurred
	Code     string `json:"code"`     // validation error code
}

An Error reports more details on an individual error in an ErrorResponse. These are the possible validation error codes:

missing:
    resource does not exist
missing_field:
    a required field on a resource has not been set
invalid:
    the formatting of a field is invalid
already_exists:
    another resource has the same valid as this field

GitLab API docs: http://doc.gitlab.com/ce/api/README.html#data-validation-and-error-reporting

func (*Error) Error

func (e *Error) Error() string

type ErrorResponse

type ErrorResponse struct {
	Response *http.Response // HTTP response that caused this error
	Message  string         `json:"message"` // error message
	Errors   []Error        `json:"errors"`  // more detail on individual errors
}

An ErrorResponse reports one or more errors caused by an API request.

GitLab API docs: http://doc.gitlab.com/ce/api/README.html#data-validation-and-error-reporting

func (*ErrorResponse) Error

func (r *ErrorResponse) Error() string

type File

type File struct {
	FileName string `json:"file_name"`
	FilePath string `json:"file_path"`
	Size     int    `json:"size"`
	Encoding string `json:"encoding"`
	Content  string `json:"content"`
	Ref      string `json:"ref"`
	BlobID   string `json:"blob_id"`
	CommitID string `json:"commit_id"`
}

File represents a GitLab repository file.

GitLab API docs: http://doc.gitlab.com/ce/api/repository_files.html

func (File) String

func (r File) String() string

type FileInfo

type FileInfo struct {
	FilePath   string `json:"file_path"`
	BranchName string `json:"branch_name"`
}

FileInfo represents file details of a GitLab repository file.

GitLab API docs: http://doc.gitlab.com/ce/api/repository_files.html

func (FileInfo) String

func (r FileInfo) String() string

type GetCommitStatusesOptions

type GetCommitStatusesOptions struct {
	Ref   string `url:"ref,omitempty" json:"ref,omitempty"`
	Stage string `url:"stage,omitempty" json:"stage,omitempty"`
	Name  string `url:"name,omitempty" json:"name,omitempty"`
	All   bool   `url:"all,omitempty" json:"all,omitempty"`
}

GetCommitStatusesOptions represents the available GetCommitStatuses() options.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#get-the-status-of-a-commit

type GetFileOptions

type GetFileOptions struct {
	FilePath string `url:"file_path,omitempty" json:"file_path,omitempty"`
	Ref      string `url:"ref,omitempty" json:"ref,omitempty"`
}

GetFileOptions represents the available GetFile() options.

GitLab API docs: http://doc.gitlab.com/ce/api/repository_files.html#get-file-from-respository

type GetMergeRequestCommentsOptions

type GetMergeRequestCommentsOptions struct {
	ListOptions
}

GetMergeRequestCommentsOptions represents the available GetMergeRequestComments() options.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html#get-the-comments-on-a-mr

type GetMilestoneIssuesOptions

type GetMilestoneIssuesOptions struct {
	ListOptions
}

GetMilestoneIssuesOptions represents the available GetMilestoneIssues() options.

GitLab API docs: http://doc.gitlab.com/ce/api/milestones.html#get-all-issues-assigned-to-a-single-milestone

type GetProjectEventsOptions

type GetProjectEventsOptions struct {
	ListOptions
}

GetProjectEventsOptions represents the available GetProjectEvents() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#get-project-events

type GetSessionOptions

type GetSessionOptions struct {
	Login    string `url:"login,omitempty" json:"login,omitempty"`
	Email    string `url:"email,omitempty" json:"email,omitempty"`
	Password string `url:"password,omitempty" json:"password,omitempty"`
}

GetSessionOptions represents the available Session() options.

GitLab API docs: http://doc.gitlab.com/ce/api/session.html#session

type Group

type Group struct {
	ID          int        `json:"id"`
	Name        string     `json:"name"`
	Path        string     `json:"path"`
	Description string     `json:"description"`
	Projects    *[]Project `json:"projects,omitempty"`
}

Group represents a GitLab group.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html

type GroupAccess

type GroupAccess struct {
	AccessLevel       AccessLevel       `json:"access_level"`
	NotificationLevel NotificationLevel `json:"notification_level"`
}

type GroupMember

type GroupMember struct {
	ID          int         `json:"id"`
	Username    string      `json:"username"`
	Email       string      `json:"email"`
	Name        string      `json:"name"`
	State       string      `json:"state"`
	CreatedAt   time.Time   `json:"created_at"`
	AccessLevel AccessLevel `json:"access_level"`
}

GroupMember represents a GitLab group member.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html

type GroupsService

type GroupsService struct {
	// contains filtered or unexported fields
}

GroupsService handles communication with the group related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html

func (*GroupsService) AddGroupMember

func (s *GroupsService) AddGroupMember(
	gid interface{},
	opt *AddGroupMemberOptions) (*GroupMember, *Response, error)

AddGroupMember adds a user to the list of group members.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#list-group-members

func (*GroupsService) CreateGroup

func (s *GroupsService) CreateGroup(opt *CreateGroupOptions) (*Group, *Response, error)

CreateGroup creates a new project group. Available only for users who can create groups.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#new-group

func (*GroupsService) DeleteGroup

func (s *GroupsService) DeleteGroup(gid interface{}) (*Response, error)

DeleteGroup removes group with all projects inside.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#remove-group

func (*GroupsService) GetGroup

func (s *GroupsService) GetGroup(gid interface{}) (*Group, *Response, error)

GetGroup gets all details of a group.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#details-of-a-group

func (*GroupsService) ListGroupMembers

func (s *GroupsService) ListGroupMembers(gid interface{}) ([]*GroupMember, *Response, error)

ListGroupMembers get a list of group members viewable by the authenticated user.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#list-group-members

func (*GroupsService) ListGroups

func (s *GroupsService) ListGroups(opt *ListGroupsOptions) ([]*Group, *Response, error)

ListGroups gets a list of groups. (As user: my groups, as admin: all groups)

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#list-project-groups

func (*GroupsService) RemoveGroupMember

func (s *GroupsService) RemoveGroupMember(gid interface{}, user int) (*Response, error)

RemoveGroupMember removes user from user team.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#remove-user-from-user-team

func (*GroupsService) SearchGroup

func (s *GroupsService) SearchGroup(query string) ([]*Group, *Response, error)

SearchGroup get all groups that match your string in their name or path.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#search-for-group

func (*GroupsService) TransferGroup

func (s *GroupsService) TransferGroup(gid interface{}, project int) (*Group, *Response, error)

TransferGroup transfers a project to the Group namespace. Available only for admin.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#transfer-project-to-group

func (*GroupsService) UpdateGroupMember

func (s *GroupsService) UpdateGroupMember(
	gid interface{},
	user int,
	opt *UpdateGroupMemberOptions) (*GroupMember, *Response, error)

UpdateGroupMember updates a group team member to a specified access level.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#list-group-members

type Hook

type Hook struct {
	ID        int       `json:"id"`
	URL       string    `json:"url"`
	CreatedAt time.Time `json:"created_at"`
}

Hook represents a GitLap system hook.

GitLab API docs: http://doc.gitlab.com/ce/api/system_hooks.html

func (Hook) String

func (h Hook) String() string

type HookEvent

type HookEvent struct {
	EventName  string `json:"event_name"`
	Name       string `json:"name"`
	Path       string `json:"path"`
	ProjectID  int    `json:"project_id"`
	OwnerName  string `json:"owner_name"`
	OwnerEmail string `json:"owner_email"`
}

HookEvent represents an event triggert by a GitLab system hook.

GitLab API docs: http://doc.gitlab.com/ce/api/system_hooks.html

func (HookEvent) String

func (h HookEvent) String() string

type Issue

type Issue struct {
	ID          int      `json:"id"`
	IID         int      `json:"iid"`
	ProjectID   int      `json:"project_id"`
	Title       string   `json:"title"`
	Description string   `json:"description"`
	Labels      []string `json:"labels"`
	Milestone   struct {
		ID          int       `json:"id"`
		Title       string    `json:"title"`
		Description string    `json:"description"`
		DueDate     string    `json:"due_date"`
		State       string    `json:"state"`
		UpdatedAt   time.Time `json:"updated_at"`
		CreatedAt   time.Time `json:"created_at"`
	} `json:"milestone"`
	Assignee struct {
		ID        int       `json:"id"`
		Username  string    `json:"username"`
		Email     string    `json:"email"`
		Name      string    `json:"name"`
		State     string    `json:"state"`
		CreatedAt time.Time `json:"created_at"`
	} `json:"assignee"`
	Author struct {
		ID        int       `json:"id"`
		Username  string    `json:"username"`
		Email     string    `json:"email"`
		Name      string    `json:"name"`
		State     string    `json:"state"`
		CreatedAt time.Time `json:"created_at"`
	} `json:"author"`
	State     string    `json:"state"`
	UpdatedAt time.Time `json:"updated_at"`
	CreatedAt time.Time `json:"created_at"`
}

Issue represents a GitLab issue.

GitLab API docs: http://doc.gitlab.com/ce/api/issues.html

func (Issue) String

func (i Issue) String() string

type IssuesService

type IssuesService struct {
	// contains filtered or unexported fields
}

IssuesService handles communication with the issue related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/issues.html

func (*IssuesService) CreateIssue

func (s *IssuesService) CreateIssue(
	pid interface{},
	opt *CreateIssueOptions) (*Issue, *Response, error)

CreateIssue creates a new project issue.

GitLab API docs: http://doc.gitlab.com/ce/api/issues.html#new-issues

func (*IssuesService) DeleteIssue

func (s *IssuesService) DeleteIssue(pid interface{}, issue int) (*Response, error)

DeleteIssue deletes a single project issue.

GitLab API docs: http://doc.gitlab.com/ce/api/issues.html#delete-an-issue

func (*IssuesService) GetIssue

func (s *IssuesService) GetIssue(pid interface{}, issue int) (*Issue, *Response, error)

GetIssue gets a single project issue.

GitLab API docs: http://doc.gitlab.com/ce/api/issues.html#single-issues

func (*IssuesService) ListIssues

func (s *IssuesService) ListIssues(opt *ListIssuesOptions) ([]*Issue, *Response, error)

ListIssues gets all issues created by authenticated user. This function takes pagination parameters page and per_page to restrict the list of issues.

GitLab API docs: http://doc.gitlab.com/ce/api/issues.html#list-issues

func (*IssuesService) ListProjectIssues

func (s *IssuesService) ListProjectIssues(
	pid interface{},
	opt *ListProjectIssuesOptions) ([]*Issue, *Response, error)

ListProjectIssues gets a list of project issues. This function accepts pagination parameters page and per_page to return the list of project issues.

GitLab API docs: http://doc.gitlab.com/ce/api/issues.html#list-project-issues

func (*IssuesService) UpdateIssue

func (s *IssuesService) UpdateIssue(
	pid interface{},
	issue int,
	opt *UpdateIssueOptions) (*Issue, *Response, error)

UpdateIssue updates an existing project issue. This function is also used to mark an issue as closed.

GitLab API docs: http://doc.gitlab.com/ce/api/issues.html#edit-issues

type Label

type Label struct {
	Name  string `json:"name"`
	Color string `json:"color"`
}

Label represents a GitLab label.

GitLab API docs: http://doc.gitlab.com/ce/api/labels.html

func (Label) String

func (l Label) String() string

type Labels

type Labels []string

Labels is a custom type with specific marshaling characteristics.

func (*Labels) MarshalJSON

func (l *Labels) MarshalJSON() ([]byte, error)

MarshalJSON implements the json.Marshaler interface.

type LabelsService

type LabelsService struct {
	// contains filtered or unexported fields
}

LabelsService handles communication with the label related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/labels.html

func (*LabelsService) CreateLabel

func (s *LabelsService) CreateLabel(
	pid interface{},
	opt *CreateLabelOptions) (*Label, *Response, error)

CreateLabel creates a new label for given repository with given name and color.

GitLab API docs: http://doc.gitlab.com/ce/api/labels.html#create-a-new-label

func (*LabelsService) DeleteLabel

func (s *LabelsService) DeleteLabel(pid interface{}, opt *DeleteLabelOptions) (*Response, error)

DeleteLabel deletes a label given by its name.

GitLab API docs: http://doc.gitlab.com/ce/api/labels.html#delete-a-label

func (*LabelsService) ListLabels

func (s *LabelsService) ListLabels(pid interface{}) ([]*Label, *Response, error)

ListLabels gets all labels for given project.

GitLab API docs: http://doc.gitlab.com/ce/api/labels.html#list-labels

func (*LabelsService) UpdateLabel

func (s *LabelsService) UpdateLabel(
	pid interface{},
	opt *UpdateLabelOptions) (*Label, *Response, error)

UpdateLabel updates an existing label with new name or now color. At least one parameter is required, to update the label.

GitLab API docs: http://doc.gitlab.com/ce/api/labels.html#edit-an-existing-label

type ListCommitsOptions

type ListCommitsOptions struct {
	ListOptions
	RefName string `url:"ref_name,omitempty" json:"ref_name,omitempty"`
}

ListCommitsOptions represents the available ListCommits() options.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#list-commits

type ListGroupsOptions

type ListGroupsOptions struct {
	ListOptions
	Search string `url:"search,omitempty" json:"search,omitempty"`
}

ListGroupsOptions represents the available ListGroups() options.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#list-project-groups

type ListIssueNotesOptions

type ListIssueNotesOptions struct {
	ListOptions
}

ListIssueNotesOptions represents the available ListIssueNotes() options.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#list-project-issue-notes

type ListIssuesOptions

type ListIssuesOptions struct {
	ListOptions
	State   string `url:"state,omitempty" json:"state,omitempty"`
	Labels  Labels `url:"labels,comma,omitempty" json:"labels,omitempty"`
	OrderBy string `url:"order_by,omitempty" json:"order_by,omitempty"`
	Sort    string `url:"sort,omitempty" json:"sort,omitempty"`
}

ListIssuesOptions represents the available ListIssues() options.

GitLab API docs: http://doc.gitlab.com/ce/api/issues.html#list-issues

type ListMergeRequestsOptions

type ListMergeRequestsOptions struct {
	ListOptions
	IID     int    `url:"iid,omitempty" json:"iid,omitempty"`
	State   string `url:"state,omitempty" json:"state,omitempty"`
	OrderBy string `url:"order_by,omitempty" json:"order_by,omitempty"`
	Sort    string `url:"sort,omitempty" json:"sort,omitempty"`
}

ListMergeRequestsOptions represents the available ListMergeRequests() options.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html#list-merge-requests

type ListMilestonesOptions

type ListMilestonesOptions struct {
	ListOptions
	IID int `url:"iid,omitempty" json:"iid,omitempty"`
}

ListMilestonesOptions represents the available ListMilestones() options.

GitLab API docs: http://doc.gitlab.com/ce/api/milestones.html#list-project-milestones

type ListNamespacesOptions

type ListNamespacesOptions struct {
	ListOptions
	Search string `url:"search,omitempty" json:"search,omitempty"`
}

ListNamespacesOptions represents the available ListNamespaces() options.

GitLab API docs: http://doc.gitlab.com/ce/api/namespaces.html#list-namespaces

type ListOptions

type ListOptions struct {
	// For paginated result sets, page of results to retrieve.
	Page int `url:"page,omitempty" json:"page,omitempty"`

	// For paginated result sets, the number of results to include per page.
	PerPage int `url:"per_page,omitempty" json:"per_page,omitempty"`
}

ListOptions specifies the optional parameters to various List methods that support pagination.

type ListProjectHooksOptions

type ListProjectHooksOptions struct {
	ListOptions
}

ListProjectHooksOptions represents the available ListProjectHooks() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#list-project-hooks

type ListProjectIssuesOptions

type ListProjectIssuesOptions struct {
	ListOptions
	IID       int    `url:"iid,omitempty" json:"iid,omitempty"`
	State     string `url:"state,omitempty" json:"state,omitempty"`
	Labels    Labels `url:"labels,comma,omitempty" json:"labels,omitempty"`
	Milestone string `url:"milestone,omitempty" json:"milestone,omitempty"`
	OrderBy   string `url:"order_by,omitempty" json:"order_by,omitempty"`
	Sort      string `url:"sort,omitempty" json:"sort,omitempty"`
}

ListProjectIssuesOptions represents the available ListProjectIssues() options.

GitLab API docs: http://doc.gitlab.com/ce/api/issues.html#list-issues

type ListProjectMembersOptions

type ListProjectMembersOptions struct {
	ListOptions
	Query string `url:"query,omitempty" json:"query,omitempty"`
}

ListProjectMembersOptions represents the available ListProjectMembers() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#list-project-team-members

type ListProjectsOptions

type ListProjectsOptions struct {
	ListOptions
	Archived       *bool  `url:"archived,omitempty" json:"archived,omitempty"`
	OrderBy        string `url:"order_by,omitempty" json:"order_by,omitempty"`
	Sort           string `url:"sort,omitempty" json:"sort,omitempty"`
	Search         string `url:"search,omitempty" json:"search,omitempty"`
	CIEnabledFirst *bool  `url:"ci_enabled_first,omitempty" json:"ci_enabled_first,omitempty"`
}

ListProjectsOptions represents the available ListProjects() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#list-projects

type ListSnippetsOptions

type ListSnippetsOptions struct {
	ListOptions
}

ListSnippetsOptions represents the available ListSnippets() options.

GitLab API docs: http://doc.gitlab.com/ce/api/project_snippets.html#list-snippets

type ListTreeOptions

type ListTreeOptions struct {
	Path    string `url:"path,omitempty" json:"path,omitempty"`
	RefName string `url:"ref_name,omitempty" json:"ref_name,omitempty"`
}

ListTreeOptions represents the available ListTree() options.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#list-repository-tree

type ListUsersOptions

type ListUsersOptions struct {
	ListOptions
	Active bool   `url:"active,omitempty" json:"active,omitempty"`
	Search string `url:"search,omitempty" json:"search,omitempty"`
}

ListUsersOptions represents the available ListUsers() options.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#list-users

type MergeRequest

type MergeRequest struct {
	ID             int       `json:"id"`
	IID            int       `json:"iid"`
	ProjectID      int       `json:"project_id"`
	Title          string    `json:"title"`
	Description    string    `json:"description"`
	WorkInProgress bool      `json:"work_in_progress"`
	State          string    `json:"state"`
	CreatedAt      time.Time `json:"created_at"`
	UpdatedAt      time.Time `json:"updated_at"`
	TargetBranch   string    `json:"target_branch"`
	SourceBranch   string    `json:"source_branch"`
	Upvotes        int       `json:"upvotes"`
	Downvotes      int       `json:"downvotes"`
	Author         struct {
		Name      string `json:"name"`
		Username  string `json:"username"`
		ID        int    `json:"id"`
		State     string `json:"state"`
		AvatarURL string `json:"avatar_url"`
	} `json:"author"`
	Assignee struct {
		Name      string `json:"name"`
		Username  string `json:"username"`
		ID        int    `json:"id"`
		State     string `json:"state"`
		AvatarURL string `json:"avatar_url"`
	} `json:"assignee"`
	SourceProjectID int      `json:"source_project_id"`
	TargetProjectID int      `json:"target_project_id"`
	Labels          []string `json:"labels"`
	Milestone       struct {
		ID          int       `json:"id"`
		Iid         int       `json:"iid"`
		ProjectID   int       `json:"project_id"`
		Title       string    `json:"title"`
		Description string    `json:"description"`
		State       string    `json:"state"`
		CreatedAt   time.Time `json:"created_at"`
		UpdatedAt   time.Time `json:"updated_at"`
		DueDate     string    `json:"due_date"`
	} `json:"milestone"`
	Files []struct {
		OldPath     string `json:"old_path"`
		NewPath     string `json:"new_path"`
		AMode       string `json:"a_mode"`
		BMode       string `json:"b_mode"`
		Diff        string `json:"diff"`
		NewFile     bool   `json:"new_file"`
		RenamedFile bool   `json:"renamed_file"`
		DeletedFile bool   `json:"deleted_file"`
	} `json:"files"`
}

MergeRequest represents a GitLab merge request.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html

func (MergeRequest) String

func (m MergeRequest) String() string

type MergeRequestComment

type MergeRequestComment struct {
	Note   string `json:"note"`
	Author struct {
		ID        int       `json:"id"`
		Username  string    `json:"username"`
		Email     string    `json:"email"`
		Name      string    `json:"name"`
		State     string    `json:"state"`
		CreatedAt time.Time `json:"created_at"`
	} `json:"author"`
}

MergeRequestComment represents a GitLab merge request comment.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html

func (MergeRequestComment) String

func (m MergeRequestComment) String() string

type MergeRequestsService

type MergeRequestsService struct {
	// contains filtered or unexported fields
}

MergeRequestsService handles communication with the merge requests related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html

func (*MergeRequestsService) AcceptMergeRequest

func (s *MergeRequestsService) AcceptMergeRequest(
	pid interface{},
	mergeRequest int) (*MergeRequest, *Response, error)

AcceptMergeRequest merges changes submitted with MR using this API. If merge success you get 200 OK. If it has some conflicts and can not be merged - you get 405 and error message 'Branch cannot be merged'. If merge request is already merged or closed - you get 405 and error message 'Method Not Allowed'

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html#accept-mr

func (*MergeRequestsService) CreateMergeRequest

func (s *MergeRequestsService) CreateMergeRequest(
	pid interface{},
	opt *CreateMergeRequestOptions) (*MergeRequest, *Response, error)

CreateMergeRequest creates a new merge request.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html#create-mr

func (*MergeRequestsService) GetMergeRequest

func (s *MergeRequestsService) GetMergeRequest(
	pid interface{},
	mergeRequest int) (*MergeRequest, *Response, error)

GetMergeRequest shows information about a single merge request.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html#get-single-mr

func (*MergeRequestsService) GetMergeRequestChanges

func (s *MergeRequestsService) GetMergeRequestChanges(
	pid interface{},
	mergeRequest int) (*MergeRequest, *Response, error)

GetMergeRequestChanges shows information about the merge request including its files and changes.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html#get-single-mr-changes

func (*MergeRequestsService) GetMergeRequestComments

func (s *MergeRequestsService) GetMergeRequestComments(
	pid interface{},
	mergeRequest int,
	opt *GetMergeRequestCommentsOptions) ([]*MergeRequestComment, *Response, error)

GetMergeRequestComments gets all the comments associated with a merge request.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html#get-the-comments-on-a-mr

func (*MergeRequestsService) ListMergeRequests

func (s *MergeRequestsService) ListMergeRequests(
	pid interface{},
	opt *ListMergeRequestsOptions) ([]*MergeRequest, *Response, error)

ListMergeRequests gets all merge requests for this project. The state parameter can be used to get only merge requests with a given state (opened, closed, or merged) or all of them (all). The pagination parameters page and per_page can be used to restrict the list of merge requests.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html#list-merge-requests

func (*MergeRequestsService) PostMergeRequestComment

func (s *MergeRequestsService) PostMergeRequestComment(
	pid interface{},
	mergeRequest int,
	opt *PostMergeRequestCommentOptions) (*MergeRequestComment, *Response, error)

PostMergeRequestComment dds a comment to a merge request.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#post-comment-to-mr

func (*MergeRequestsService) UpdateMergeRequest

func (s *MergeRequestsService) UpdateMergeRequest(
	pid interface{},
	mergeRequest int,
	opt *UpdateMergeRequestOptions) (*MergeRequest, *Response, error)

UpdateMergeRequest updates an existing project milestone.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html#update-mr

type Milestone

type Milestone struct {
	ID          int       `json:"id"`
	Iid         int       `json:"iid"`
	ProjectID   int       `json:"project_id"`
	Title       string    `json:"title"`
	Description string    `json:"description"`
	DueDate     string    `json:"due_date"`
	State       string    `json:"state"`
	UpdatedAt   time.Time `json:"updated_at"`
	CreatedAt   time.Time `json:"created_at"`
}

Milestone represents a GitLab milestone.

GitLab API docs: http://doc.gitlab.com/ce/api/branches.html

func (Milestone) String

func (m Milestone) String() string

type MilestonesService

type MilestonesService struct {
	// contains filtered or unexported fields
}

MilestonesService handles communication with the milestone related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/milestones.html

func (*MilestonesService) CreateMilestone

func (s *MilestonesService) CreateMilestone(
	pid interface{},
	opt *CreateMilestoneOptions) (*Milestone, *Response, error)

CreateMilestone creates a new project milestone.

GitLab API docs: http://doc.gitlab.com/ce/api/milestones.html#create-new-milestone

func (*MilestonesService) GetMilestone

func (s *MilestonesService) GetMilestone(
	pid interface{},
	milestone int) (*Milestone, *Response, error)

GetMilestone gets a single project milestone.

GitLab API docs: http://doc.gitlab.com/ce/api/milestones.html#get-single-milestone

func (*MilestonesService) GetMilestoneIssues

func (s *MilestonesService) GetMilestoneIssues(
	pid interface{},
	milestone int,
	opt *GetMilestoneIssuesOptions) ([]*Issue, *Response, error)

GetMilestoneIssues gets all issues assigned to a single project milestone.

GitLab API docs: http://doc.gitlab.com/ce/api/milestones.html#get-all-issues-assigned-to-a-single-milestone

func (*MilestonesService) ListMilestones

func (s *MilestonesService) ListMilestones(
	pid interface{},
	opt *ListMilestonesOptions) ([]*Milestone, *Response, error)

ListMilestones returns a list of project milestones.

GitLab API docs: http://doc.gitlab.com/ce/api/milestones.html#list-project-milestones

func (*MilestonesService) UpdateMilestone

func (s *MilestonesService) UpdateMilestone(
	pid interface{},
	milestone int,
	opt *UpdateMilestoneOptions) (*Milestone, *Response, error)

UpdateMilestone updates an existing project milestone.

GitLab API docs: http://doc.gitlab.com/ce/api/milestones.html#edit-milestone

type ModifyUserOptions

type ModifyUserOptions struct {
	Email          string `url:"email,omitempty" json:"email,omitempty"`
	Password       string `url:"password,omitempty" json:"password,omitempty"`
	Username       string `url:"username,omitempty" json:"username,omitempty"`
	Name           string `url:"name,omitempty" json:"name,omitempty"`
	Skype          string `url:"skype,omitempty" json:"skype,omitempty"`
	Linkedin       string `url:"linkedin,omitempty" json:"linkedin,omitempty"`
	Twitter        string `url:"twitter,omitempty" json:"twitter,omitempty"`
	WebsiteURL     string `url:"website_url,omitempty" json:"website_url,omitempty"`
	ProjectsLimit  int    `url:"projects_limit,omitempty" json:"projects_limit,omitempty"`
	ExternUID      string `url:"extern_uid,omitempty" json:"extern_uid,omitempty"`
	Provider       string `url:"provider,omitempty" json:"provider,omitempty"`
	Bio            string `url:"bio,omitempty" json:"bio,omitempty"`
	Admin          bool   `url:"admin,omitempty" json:"admin,omitempty"`
	CanCreateGroup bool   `url:"can_create_group,omitempty" json:"can_create_group,omitempty"`
}

ModifyUserOptions represents the available ModifyUser() options.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#user-modification

type Namespace

type Namespace struct {
	ID   int    `json:"id"`
	Path string `json:"path"`
	Kind string `json:"kind"`
}

Namespace represents a GitLab namespace.

GitLab API docs: http://doc.gitlab.com/ce/api/namespaces.html

func (Namespace) String

func (n Namespace) String() string

type NamespacesService

type NamespacesService struct {
	// contains filtered or unexported fields
}

NamespacesService handles communication with the namespace related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/namespaces.html

func (*NamespacesService) ListNamespaces

func (s *NamespacesService) ListNamespaces(opt *ListNamespacesOptions) ([]*Namespace, *Response, error)

ListNamespaces gets a list of projects accessible by the authenticated user.

GitLab API docs: http://doc.gitlab.com/ce/api/namespaces.html#list-namespaces

func (*NamespacesService) SearchNamespace

func (s *NamespacesService) SearchNamespace(query string) ([]*Namespace, *Response, error)

SearchNamespace gets all namespaces that match your string in their name or path.

GitLab API docs: http://doc.gitlab.com/ce/api/namespaces.html#search-for-namespace

type Note

type Note struct {
	ID         int    `json:"id"`
	Body       string `json:"body"`
	Attachment string `json:"attachment"`
	Title      string `json:"title"`
	FileName   string `json:"file_name"`
	Author     struct {
		ID        int       `json:"id"`
		Username  string    `json:"username"`
		Email     string    `json:"email"`
		Name      string    `json:"name"`
		State     string    `json:"state"`
		CreatedAt time.Time `json:"created_at"`
	} `json:"author"`
	ExpiresAt *time.Time `json:"expires_at"`
	UpdatedAt time.Time  `json:"updated_at"`
	CreatedAt time.Time  `json:"created_at"`
}

Note represents a GitLab note.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html

func (Note) String

func (n Note) String() string

type NotesService

type NotesService struct {
	// contains filtered or unexported fields
}

NotesService handles communication with the notes related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html

func (*NotesService) CreateIssueNote

func (s *NotesService) CreateIssueNote(
	pid interface{},
	issue int,
	opt *CreateIssueNoteOptions) (*Note, *Response, error)

CreateIssueNote creates a new note to a single project issue.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#create-new-issue-note

func (*NotesService) CreateMergeRequestNote

func (s *NotesService) CreateMergeRequestNote(
	pid interface{},
	mergeRequest int,
	opt *CreateMergeRequestNoteOptions) (*Note, *Response, error)

CreateMergeRequestNote creates a new note for a single merge request.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#create-new-merge-request-note

func (*NotesService) CreateSnippetNote

func (s *NotesService) CreateSnippetNote(
	pid interface{},
	snippet int,
	opt *CreateSnippetNoteOptions) (*Note, *Response, error)

CreateSnippetNote creates a new note for a single snippet. Snippet notes are comments users can post to a snippet.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#create-new-snippet-note

func (*NotesService) GetIssueNote

func (s *NotesService) GetIssueNote(
	pid interface{},
	issue int,
	note int) (*Note, *Response, error)

GetIssueNote returns a single note for a specific project issue.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#get-single-issue-note

func (*NotesService) GetMergeRequestNote

func (s *NotesService) GetMergeRequestNote(
	pid interface{},
	mergeRequest int,
	note int) (*Note, *Response, error)

GetMergeRequestNote returns a single note for a given merge request.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#get-single-merge-request-note

func (*NotesService) GetSnippetNote

func (s *NotesService) GetSnippetNote(
	pid interface{},
	snippet int,
	note int) (*Note, *Response, error)

GetSnippetNote returns a single note for a given snippet.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#get-single-snippet-note

func (*NotesService) ListIssueNotes

func (s *NotesService) ListIssueNotes(
	pid interface{},
	issue int,
	opt *ListIssueNotesOptions) ([]*Note, *Response, error)

ListIssueNotes gets a list of all notes for a single issue.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#list-project-issue-notes

func (*NotesService) ListMergeRequestNotes

func (s *NotesService) ListMergeRequestNotes(
	pid interface{},
	mergeRequest int) ([]*Note, *Response, error)

ListMergeRequestNotes gets a list of all notes for a single merge request.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#list-all-merge-request-notes

func (*NotesService) ListSnippetNotes

func (s *NotesService) ListSnippetNotes(pid interface{}, snippet int) ([]*Note, *Response, error)

ListSnippetNotes gets a list of all notes for a single snippet. Snippet notes are comments users can post to a snippet.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#list-all-snippet-notes

func (*NotesService) UpdateIssueNote

func (s *NotesService) UpdateIssueNote(
	pid interface{},
	issue int,
	note int,
	opt *UpdateIssueNoteOptions) (*Note, *Response, error)

UpdateIssueNote modifies existing note of an issue.

http://doc.gitlab.com/ce/api/notes.html#modify-existing-issue-note

func (*NotesService) UpdateMergeRequestNote

func (s *NotesService) UpdateMergeRequestNote(
	pid interface{},
	mergeRequest int,
	note int,
	opt *UpdateMergeRequestNoteOptions) (*Note, *Response, error)

UpdateMergeRequestNote modifies existing note of a merge request.

http://doc.gitlab.com/ce/api/notes.html#modify-existing-merge-request-note

func (*NotesService) UpdateSnippetNote

func (s *NotesService) UpdateSnippetNote(
	pid interface{},
	snippet int,
	note int,
	opt *UpdateSnippetNoteOptions) (*Note, *Response, error)

UpdateSnippetNote modifies existing note of a snippet.

http://doc.gitlab.com/ce/api/notes.html#modify-existing-snippet-note

type NotificationLevel

type NotificationLevel int

NotificationLevel represents a notification level within Gitlab.

GitLab API docs: http://doc.gitlab.com/ce/...?

const (
	DisabledNotifications NotificationLevel = iota
	ParticipatingNotifications
	WatchNotifications
	GlobalNotifications
	MentionNotifications
)

List of available notification levels

GitLab API docs: http://doc.gitlab.com/ce/...?

type Permissions

type Permissions struct {
	ProjectAccess *ProjectAccess `json:"project_access"`
	GroupAccess   *GroupAccess   `json:"group_access"`
}

type PostCommitCommentOptions

type PostCommitCommentOptions struct {
	Note     string `url:"note,omitempty" json:"note,omitempty"`
	Path     string `url:"path" json:"path"`
	Line     int    `url:"line" json:"line"`
	LineType string `url:"line_type" json:"line_type"`
}

PostCommitCommentOptions represents the available PostCommitComment() options.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#post-comment-to-commit

type PostMergeRequestCommentOptions

type PostMergeRequestCommentOptions struct {
	Note string `url:"note,omitempty" json:"note,omitempty"`
}

PostMergeRequestCommentOptions represents the available PostMergeRequestComment() options.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#post-comment-to-mr

type Project

type Project struct {
	ID                   *int              `json:"id"`
	Description          *string           `json:"description"`
	DefaultBranch        *string           `json:"default_branch"`
	Public               *bool             `json:"public"`
	VisibilityLevel      *VisibilityLevel  `json:"visibility_level"`
	SSHURLToRepo         *string           `json:"ssh_url_to_repo"`
	HTTPURLToRepo        *string           `json:"http_url_to_repo"`
	WebURL               *string           `json:"web_url"`
	TagList              *[]string         `json:"tag_list"`
	Owner                *User             `json:"owner"`
	Name                 *string           `json:"name"`
	NameWithNamespace    *string           `json:"name_with_namespace"`
	Path                 *string           `json:"path"`
	PathWithNamespace    *string           `json:"path_with_namespace"`
	IssuesEnabled        *bool             `json:"issues_enabled"`
	OpenIssuesCount      *int              `json:"open_issues_count"`
	MergeRequestsEnabled *bool             `json:"merge_requests_enabled"`
	BuildsEnabled        *bool             `json:"builds_enabled"`
	WikiEnabled          *bool             `json:"wiki_enabled"`
	SnippetsEnabled      *bool             `json:"snippets_enabled"`
	CreatedAt            *time.Time        `json:"created_at,omitempty"`
	LastActivityAt       *time.Time        `json:"last_activity_at,omitempty"`
	CreatorID            *int              `json:"creator_id"`
	Namespace            *ProjectNamespace `json:"namespace"`
	Permissions          *Permissions      `json:"permissions"`
	Archived             *bool             `json:"archived"`
	AvatarURL            *string           `json:"avatar_url"`
	SharedRunnersEnabled *bool             `json:"shared_runners_enabled"`
	ForksCount           *int              `json:"forks_count"`
	StarCount            *int              `json:"star_count"`
	RunnersToken         *string           `json:"runners_token"`
	PublicBuilds         *bool             `json:"public_builds"`
}

Project represents a GitLab project.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html

func (Project) String

func (s Project) String() string

type ProjectAccess

type ProjectAccess struct {
	AccessLevel       AccessLevel       `json:"access_level"`
	NotificationLevel NotificationLevel `json:"notification_level"`
}

type ProjectEvent

type ProjectEvent struct {
	Title          interface{} `json:"title"`
	ProjectID      int         `json:"project_id"`
	ActionName     string      `json:"action_name"`
	TargetID       interface{} `json:"target_id"`
	TargetType     interface{} `json:"target_type"`
	AuthorID       int         `json:"author_id"`
	AuthorUsername string      `json:"author_username"`
	Data           struct {
		Before     string `json:"before"`
		After      string `json:"after"`
		Ref        string `json:"ref"`
		UserID     int    `json:"user_id"`
		UserName   string `json:"user_name"`
		Repository struct {
			Name        string `json:"name"`
			URL         string `json:"url"`
			Description string `json:"description"`
			Homepage    string `json:"homepage"`
		} `json:"repository"`
		Commits []struct {
			ID        string    `json:"id"`
			Message   string    `json:"message"`
			Timestamp time.Time `json:"timestamp"`
			URL       string    `json:"url"`
			Author    struct {
				Name  string `json:"name"`
				Email string `json:"email"`
			} `json:"author"`
		} `json:"commits"`
		TotalCommitsCount int `json:"total_commits_count"`
	} `json:"data"`
	TargetTitle interface{} `json:"target_title"`
}

ProjectEvent represents a GitLab project event.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#get-project-events

func (ProjectEvent) String

func (s ProjectEvent) String() string

type ProjectForkRelation

type ProjectForkRelation struct {
	ID                  int       `json:"id"`
	ForkedToProjectID   int       `json:"forked_to_project_id"`
	ForkedFromProjectID int       `json:"forked_from_project_id"`
	CreatedAt           time.Time `json:"created_at"`
	UpdatedAt           time.Time `json:"updated_at"`
}

ProjectForkRelation represents a project fork relationship.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#admin-fork-relation

type ProjectHook

type ProjectHook struct {
	ID                  int       `json:"id"`
	URL                 string    `json:"url"`
	ProjectID           int       `json:"project_id"`
	PushEvents          *bool     `json:"push_events"`
	IssuesEvents        *bool     `json:"issues_events"`
	MergeRequestsEvents *bool     `json:"merge_requests_events"`
	CreatedAt           time.Time `json:"created_at"`
}

ProjectHook represents a project hook.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#list-project-hooks

type ProjectMember

type ProjectMember struct {
	ID          int         `json:"id"`
	Username    string      `json:"username"`
	Email       string      `json:"email"`
	Name        string      `json:"name"`
	State       string      `json:"state"`
	CreatedAt   time.Time   `json:"created_at"`
	AccessLevel AccessLevel `json:"access_level"`
}

ProjectMember represents a project member.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#list-project-team-members

type ProjectNamespace

type ProjectNamespace struct {
	CreatedAt   *time.Time `json:"created_at"`
	Description *string    `json:"description"`
	ID          *int       `json:"id"`
	Name        *string    `json:"name"`
	OwnerID     *int       `json:"owner_id"`
	Path        *string    `json:"path"`
	UpdatedAt   *time.Time `json:"updated_at"`
}

type ProjectSnippetsService

type ProjectSnippetsService struct {
	// contains filtered or unexported fields
}

ProjectSnippetsService handles communication with the project snippets related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/project_snippets.html

func (*ProjectSnippetsService) CreateSnippet

func (s *ProjectSnippetsService) CreateSnippet(
	pid interface{},
	opt *CreateSnippetOptions) (*Snippet, *Response, error)

CreateSnippet creates a new project snippet. The user must have permission to create new snippets.

GitLab API docs: http://doc.gitlab.com/ce/api/project_snippets.html#create-new-snippet

func (*ProjectSnippetsService) DeleteSnippet

func (s *ProjectSnippetsService) DeleteSnippet(pid interface{}, snippet int) (*Response, error)

DeleteSnippet deletes an existing project snippet. This is an idempotent function and deleting a non-existent snippet still returns a 200 OK status code.

GitLab API docs: http://doc.gitlab.com/ce/api/project_snippets.html#delete-snippet

func (*ProjectSnippetsService) GetSnippet

func (s *ProjectSnippetsService) GetSnippet(
	pid interface{},
	snippet int) (*Snippet, *Response, error)

GetSnippet gets a single project snippet

GitLab API docs: http://doc.gitlab.com/ce/api/project_snippets.html#single-snippet

func (*ProjectSnippetsService) ListSnippets

func (s *ProjectSnippetsService) ListSnippets(
	pid interface{},
	opt *ListSnippetsOptions) ([]*Snippet, *Response, error)

ListSnippets gets a list of project snippets.

GitLab API docs: http://doc.gitlab.com/ce/api/project_snippets.html#list-snippets

func (*ProjectSnippetsService) SnippetContent

func (s *ProjectSnippetsService) SnippetContent(
	pid interface{},
	snippet int) ([]byte, *Response, error)

SnippetContent returns the raw project snippet as plain text.

GitLab API docs: http://doc.gitlab.com/ce/api/project_snippets.html#snippet-content

func (*ProjectSnippetsService) UpdateSnippet

func (s *ProjectSnippetsService) UpdateSnippet(
	pid interface{},
	snippet int,
	opt *UpdateSnippetOptions) (*Snippet, *Response, error)

UpdateSnippet updates an existing project snippet. The user must have permission to change an existing snippet.

GitLab API docs: http://doc.gitlab.com/ce/api/project_snippets.html#update-snippet

type ProjectsService

type ProjectsService struct {
	// contains filtered or unexported fields
}

ProjectsService handles communication with the repositories related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html

func (*ProjectsService) AddProjectHook

func (s *ProjectsService) AddProjectHook(
	pid interface{},
	opt *AddProjectHookOptions) (*ProjectHook, *Response, error)

AddProjectHook adds a hook to a specified project.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#add-project-hook

func (*ProjectsService) AddProjectMember

func (s *ProjectsService) AddProjectMember(
	pid interface{},
	opt *AddProjectMemberOptions) (*ProjectMember, *Response, error)

AddProjectMember adds a user to a project team. This is an idempotent method and can be called multiple times with the same parameters. Adding team membership to a user that is already a member does not affect the existing membership.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#add-project-team-member

func (*ProjectsService) ArchiveProject

func (s *ProjectsService) ArchiveProject(pid interface{}) (*Project, *Response, error)

Archives the project if the user is either admin or the project owner of this project.

GitLab API docs: http://docs.gitlab.com/ce/api/projects.html#archive-a-project

func (*ProjectsService) CreateProject

func (s *ProjectsService) CreateProject(
	opt *CreateProjectOptions) (*Project, *Response, error)

CreateProject creates a new project owned by the authenticated user.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#create-project

func (*ProjectsService) CreateProjectForUser

func (s *ProjectsService) CreateProjectForUser(
	user int,
	opt *CreateProjectForUserOptions) (*Project, *Response, error)

CreateProjectForUser creates a new project owned by the specified user. Available only for admins.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#create-project-for-user

func (*ProjectsService) CreateProjectForkRelation

func (s *ProjectsService) CreateProjectForkRelation(
	pid int,
	fork int) (*ProjectForkRelation, *Response, error)

CreateProjectForkRelation creates a forked from/to relation between existing projects.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#create-a-forked-fromto-relation-between-existing-projects.

func (*ProjectsService) DeleteProject

func (s *ProjectsService) DeleteProject(pid interface{}) (*Response, error)

DeleteProject removes a project including all associated resources (issues, merge requests etc.)

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#remove-project

func (*ProjectsService) DeleteProjectForkRelation

func (s *ProjectsService) DeleteProjectForkRelation(pid int) (*Response, error)

DeleteProjectForkRelation deletes an existing forked from relationship.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#delete-an-existing-forked-from-relationship

func (*ProjectsService) DeleteProjectHook

func (s *ProjectsService) DeleteProjectHook(pid interface{}, hook int) (*Response, error)

DeleteProjectHook removes a hook from a project. This is an idempotent method and can be called multiple times. Either the hook is available or not.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#delete-project-hook

func (*ProjectsService) DeleteProjectMember

func (s *ProjectsService) DeleteProjectMember(pid interface{}, user int) (*Response, error)

DeleteProjectMember removes a user from a project team.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#remove-project-team-member

func (*ProjectsService) EditProject

func (s *ProjectsService) EditProject(
	pid interface{},
	opt *EditProjectOptions) (*Project, *Response, error)

EditProject updates an existing project.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#edit-project

func (*ProjectsService) EditProjectHook

func (s *ProjectsService) EditProjectHook(
	pid interface{},
	hook int,
	opt *EditProjectHookOptions) (*ProjectHook, *Response, error)

EditProjectHook edits a hook for a specified project.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#edit-project-hook

func (*ProjectsService) EditProjectMember

func (s *ProjectsService) EditProjectMember(
	pid interface{},
	user int,
	opt *EditProjectMemberOptions) (*ProjectMember, *Response, error)

EditProjectMember updates a project team member to a specified access level..

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#edit-project-team-member

func (*ProjectsService) ForkProject

func (s *ProjectsService) ForkProject(pid interface{}) (*Project, *Response, error)

ForkProject forks a project into the user namespace of the authenticated user.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#fork-project

func (*ProjectsService) GetProject

func (s *ProjectsService) GetProject(pid interface{}) (*Project, *Response, error)

GetProject gets a specific project, identified by project ID or NAMESPACE/PROJECT_NAME, which is owned by the authenticated user.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#get-single-project

func (*ProjectsService) GetProjectEvents

func (s *ProjectsService) GetProjectEvents(
	pid interface{},
	opt *GetProjectEventsOptions) ([]*ProjectEvent, *Response, error)

GetProjectEvents gets the events for the specified project. Sorted from newest to latest.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#get-project-events

func (*ProjectsService) GetProjectHook

func (s *ProjectsService) GetProjectHook(
	pid interface{},
	hook int) (*ProjectHook, *Response, error)

GetProjectHook gets a specific hook for a project.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#get-project-hook

func (*ProjectsService) GetProjectMember

func (s *ProjectsService) GetProjectMember(
	pid interface{},
	user int) (*ProjectMember, *Response, error)

GetProjectMember gets a project team member.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#get-project-team-member

func (*ProjectsService) ListAllProjects

func (s *ProjectsService) ListAllProjects(opt *ListProjectsOptions) ([]*Project, *Response, error)

ListAllProjects gets a list of all GitLab projects (admin only).

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#list-all-projects

func (*ProjectsService) ListOwnedProjects

func (s *ProjectsService) ListOwnedProjects(
	opt *ListProjectsOptions) ([]*Project, *Response, error)

ListOwnedProjects gets a list of projects which are owned by the authenticated user.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#list-owned-projects

func (*ProjectsService) ListProjectHooks

func (s *ProjectsService) ListProjectHooks(
	pid interface{},
	opt *ListProjectHooksOptions) ([]*ProjectHook, *Response, error)

ListProjectHooks gets a list of project hooks.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#list-project-hooks

func (*ProjectsService) ListProjectMembers

func (s *ProjectsService) ListProjectMembers(
	pid interface{},
	opt *ListProjectMembersOptions) ([]*ProjectMember, *Response, error)

ListProjectMembers gets a list of a project's team members.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#list-project-team-members

func (*ProjectsService) ListProjects

func (s *ProjectsService) ListProjects(opt *ListProjectsOptions) ([]*Project, *Response, error)

ListProjects gets a list of projects accessible by the authenticated user.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#list-projects

func (*ProjectsService) ListStarredProjects

func (s *ProjectsService) ListStarredProjects(
	opt *ListProjectsOptions) ([]*Project, *Response, error)

ListOwnedProjects gets a list of projects which are starred by the authenticated user.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#list-starred-projects

func (*ProjectsService) SearchProjects

func (s *ProjectsService) SearchProjects(
	query string,
	opt *SearchProjectsOptions) ([]*Project, *Response, error)

SearchProjects searches for projects by name which are accessible to the authenticated user.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#search-for-projects-by-name

func (*ProjectsService) UnarchiveProject

func (s *ProjectsService) UnarchiveProject(pid interface{}) (*Project, *Response, error)

Unarchives the project if the user is either admin or the project owner of this project.

GitLab API docs: http://docs.gitlab.com/ce/api/projects.html#unarchive-a-project

type RawFileContentOptions

type RawFileContentOptions struct {
	FilePath string `url:"filepath,omitempty" json:"filepath,omitempty"`
}

RawFileContentOptions represents the available RawFileContent() options.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#raw-file-content

type RepositoriesService

type RepositoriesService struct {
	// contains filtered or unexported fields
}

RepositoriesService handles communication with the repositories related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html

func (*RepositoriesService) Archive

func (s *RepositoriesService) Archive(
	pid interface{},
	opt *ArchiveOptions) ([]byte, *Response, error)

Archive gets an archive of the repository.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#get-file-archive

func (*RepositoriesService) Compare

func (s *RepositoriesService) Compare(
	pid interface{},
	opt *CompareOptions) (*Compare, *Response, error)

Compare compares branches, tags or commits.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#compare-branches-tags-or-commits

func (*RepositoriesService) Contributors

func (s *RepositoriesService) Contributors(pid interface{}) ([]*Contributor, *Response, error)

Contributors gets the repository contributors list.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#contributer

func (*RepositoriesService) CreateTag

func (s *RepositoriesService) CreateTag(
	pid interface{},
	opt *CreateTagOptions) (*Tag, *Response, error)

CreateTag creates a new tag in the repository that points to the supplied ref.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#create-a-new-tag

func (*RepositoriesService) ListTags

func (s *RepositoriesService) ListTags(pid interface{}) ([]*Tag, *Response, error)

ListTags gets a list of repository tags from a project, sorted by name in reverse alphabetical order.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#list-project-repository-tags

func (*RepositoriesService) ListTree

func (s *RepositoriesService) ListTree(
	pid interface{},
	opt *ListTreeOptions) ([]*TreeNode, *Response, error)

ListTree gets a list of repository files and directories in a project.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#list-repository-tree

func (*RepositoriesService) RawBlobContent

func (s *RepositoriesService) RawBlobContent(
	pid interface{},
	sha string) ([]byte, *Response, error)

RawBlobContent gets the raw file contents for a blob by blob SHA.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#raw-blob-content

func (*RepositoriesService) RawFileContent

func (s *RepositoriesService) RawFileContent(
	pid interface{},
	sha string,
	opt *RawFileContentOptions) ([]byte, *Response, error)

RawFileContent gets the raw file contents for a file by commit SHA and path

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#raw-file-content

type RepositoryFilesService

type RepositoryFilesService struct {
	// contains filtered or unexported fields
}

RepositoryFilesService handles communication with the repository files related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/repository_files.html

func (*RepositoryFilesService) CreateFile

func (s *RepositoryFilesService) CreateFile(
	pid interface{},
	opt *CreateFileOptions) (*FileInfo, *Response, error)

CreateFile creates a new file in a repository.

GitLab API docs: http://doc.gitlab.com/ce/api/repository_files.html#create-new-file-in-repository

func (*RepositoryFilesService) DeleteFile

func (s *RepositoryFilesService) DeleteFile(
	pid interface{},
	opt *DeleteFileOptions) (*FileInfo, *Response, error)

DeleteFile deletes an existing file in a repository

GitLab API docs: http://doc.gitlab.com/ce/api/repository_files.html#delete-existing-file-in-repository

func (*RepositoryFilesService) GetFile

func (s *RepositoryFilesService) GetFile(
	pid interface{},
	opt *GetFileOptions) (*File, *Response, error)

GetFile allows you to receive information about a file in repository like name, size, content. Note that file content is Base64 encoded.

GitLab API docs: http://doc.gitlab.com/ce/api/repository_files.html#get-file-from-respository

func (*RepositoryFilesService) UpdateFile

func (s *RepositoryFilesService) UpdateFile(
	pid interface{},
	opt *UpdateFileOptions) (*FileInfo, *Response, error)

UpdateFile updates an existing file in a repository

GitLab API docs: http://doc.gitlab.com/ce/api/repository_files.html#update-existing-file-in-repository

type Response

type Response struct {
	*http.Response

	NextPage  int
	PrevPage  int
	FirstPage int
	LastPage  int
}

Response is a GitLab API response. This wraps the standard http.Response returned from GitLab and provides convenient access to things like pagination links.

type SSHKey

type SSHKey struct {
	ID        int       `json:"id"`
	Title     string    `json:"title"`
	Key       string    `json:"key"`
	CreatedAt time.Time `json:"created_at"`
}

SSHKey represents a SSH key.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#list-ssh-keys

type SearchProjectsOptions

type SearchProjectsOptions struct {
	ListOptions
	OrderBy string `url:"order_by,omitempty" json:"order_by,omitempty"`
	Sort    string `url:"sort,omitempty" json:"sort,omitempty"`
}

SearchProjectsOptions represents the available SearchProjects() options.

GitLab API docs: http://doc.gitlab.com/ce/api/projects.html#search-for-projects-by-name

type Service

type Service struct {
	ID                  *int       `json:"id"`
	Title               *string    `json:"title"`
	CreatedAt           *time.Time `json:"created_at"`
	UpdatedAt           *time.Time `json:"created_at"`
	Active              *bool      `json:"active"`
	PushEvents          *bool      `json:"push_events"`
	IssuesEvents        *bool      `json:"issues_events"`
	MergeRequestsEvents *bool      `json:"merge_requests_events"`
	TagPushEvents       *bool      `json:"tag_push_events"`
	NoteEvents          *bool      `json:"note_events"`
}

type ServicesService

type ServicesService struct {
	// contains filtered or unexported fields
}

ServicesService handles communication with the services related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/services.html

func (*ServicesService) DeleteDroneCIService

func (s *ServicesService) DeleteDroneCIService(pid interface{}) (*Response, error)

DeleteDroneCIService deletes Drone CI service settings for a project.

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#delete-drone-ci-service

func (*ServicesService) DeleteGitLabCIService

func (s *ServicesService) DeleteGitLabCIService(pid interface{}) (*Response, error)

DeleteGitLabCIService deletes GitLab CI service settings for a project.

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#delete-gitlab-ci-service

func (*ServicesService) DeleteHipChatService

func (s *ServicesService) DeleteHipChatService(pid interface{}) (*Response, error)

DeleteHipChatService deletes HipChat service for project.

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#delete-hipchat-service

func (*ServicesService) DeleteSlackService

func (s *ServicesService) DeleteSlackService(pid interface{}) (*Response, error)

DeleteSlackService deletes Slack service for project.

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#delete-slack-service

func (*ServicesService) GetDroneCIService

func (s *ServicesService) GetDroneCIService(pid interface{}) (*DroneCIService, *Response, error)

GetDroneCIService gets Drone CI service settings for a project.

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#get-drone-ci-service-settings

func (*ServicesService) SetDroneCIService

func (s *ServicesService) SetDroneCIService(
	pid interface{},
	opt *SetDroneCIServiceOptions) (*Response, error)

SetDroneCIService sets Drone CI service for a project.

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#createedit-drone-ci-service

func (*ServicesService) SetGitLabCIService

func (s *ServicesService) SetGitLabCIService(
	pid interface{},
	opt *SetGitLabCIServiceOptions) (*Response, error)

SetGitLabCIService sets GitLab CI service for a project.

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#edit-gitlab-ci-service

func (*ServicesService) SetHipChatService

func (s *ServicesService) SetHipChatService(
	pid interface{},
	opt *SetHipChatServiceOptions) (*Response, error)

SetHipChatService sets HipChat service for a project

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#edit-hipchat-service

func (*ServicesService) SetSlackService

func (s *ServicesService) SetSlackService(
	pid interface{},
	opt *SetSlackServiceOptions) (*Response, error)

SetSlackService sets Slack service for a project

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#edit-slack-service

type Session

type Session struct {
	ID               int         `json:"id"`
	Username         string      `json:"username"`
	Email            string      `json:"email"`
	Name             string      `json:"name"`
	PrivateToken     string      `json:"private_token"`
	Blocked          bool        `json:"blocked"`
	CreatedAt        time.Time   `json:"created_at"`
	Bio              interface{} `json:"bio"`
	Skype            string      `json:"skype"`
	Linkedin         string      `json:"linkedin"`
	Twitter          string      `json:"twitter"`
	WebsiteURL       string      `json:"website_url"`
	DarkScheme       bool        `json:"dark_scheme"`
	ThemeID          int         `json:"theme_id"`
	IsAdmin          bool        `json:"is_admin"`
	CanCreateGroup   bool        `json:"can_create_group"`
	CanCreateTeam    bool        `json:"can_create_team"`
	CanCreateProject bool        `json:"can_create_project"`
}

Session represents a GitLab session.

GitLab API docs: http://doc.gitlab.com/ce/api/session.html#session

type SessionService

type SessionService struct {
	// contains filtered or unexported fields
}

SessionService handles communication with the session related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/session.html

func (*SessionService) GetSession

func (s *SessionService) GetSession(opt *GetSessionOptions) (*Session, *Response, error)

GetSession logs in to get private token.

GitLab API docs: http://doc.gitlab.com/ce/api/session.html#session

type SetCommitStatusOptions

type SetCommitStatusOptions struct {
	State       BuildState `url:"state" json:"state"`
	Ref         string     `url:"ref,omitempty" json:"ref,omitempty"`
	Name        string     `url:"name,omitempty" json:"name,omitempty"`
	Context     string     `url:"context,omitempty" json:"context,omitempty"`
	TargetUrl   string     `url:"target_url,omitempty" json:"target_url,omitempty"`
	Description string     `url:"description,omitempty" json:"description,omitempty"`
}

SetCommitStatusOptions represents the available SetCommitStatus() options.

GitLab API docs: http://doc.gitlab.com/ce/api/commits.html#post-the-status-to-commit

type SetDroneCIServiceOptions

type SetDroneCIServiceOptions struct {
	Token                 string `url:"token" json:"token" `
	DroneURL              string `url:"drone_url" json:"drone_url"`
	EnableSSLVerification string `url:"enable_ssl_verification,omitempty" json:"enable_ssl_verification,omitempty"`
}

SetDroneCIServiceOptions represents the available SetDroneCIService() options.

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#createedit-drone-ci-service

type SetGitLabCIServiceOptions

type SetGitLabCIServiceOptions struct {
	Token      string `url:"token,omitempty" json:"token,omitempty"`
	ProjectURL string `url:"project_url,omitempty" json:"project_url,omitempty"`
}

SetGitLabCIServiceOptions represents the available SetGitLabCIService() options.

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#edit-gitlab-ci-service

type SetHipChatServiceOptions

type SetHipChatServiceOptions struct {
	Token string `url:"token,omitempty" json:"token,omitempty" `
	Room  string `url:"room,omitempty" json:"room,omitempty"`
}

SetHipChatServiceOptions represents the available SetHipChatService() options.

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#edit-hipchat-service

type SetSlackServiceOptions

type SetSlackServiceOptions struct {
	WebHook  string `url:"webhook,omitempty" json:"webhook,omitempty" `
	Username string `url:"username,omitempty" json:"username,omitempty" `
	Channel  string `url:"channel,omitempty" json:"channel,omitempty"`
}

SetSlackServiceOptions represents the available SetSlackService() options.

GitLab API docs: http://doc.gitlab.com/ce/api/services.html#edit-slack-service

type Settings

type Settings struct {
	ID                         int               `json:"id"`
	DefaultProjectsLimit       int               `json:"default_projects_limit"`
	SignupEnabled              *bool             `json:"signup_enabled"`
	SigninEnabled              *bool             `json:"signin_enabled"`
	GravatarEnabled            *bool             `json:"gravatar_enabled"`
	SignInText                 string            `json:"sign_in_text"`
	CreatedAt                  time.Time         `json:"created_at"`
	UpdatedAt                  time.Time         `json:"updated_at"`
	HomePageURL                string            `json:"home_page_url"`
	DefaultBranchProtection    int               `json:"default_branch_protection"`
	TwitterSharingEnabled      *bool             `json:"twitter_sharing_enabled"`
	RestrictedVisibilityLevels []VisibilityLevel `json:"restricted_visibility_levels"`
	MaxAttachmentSize          int               `json:"max_attachment_size"`
	SessionExpireDelay         int               `json:"session_expire_delay"`
	DefaultProjectVisibility   VisibilityLevel   `json:"default_project_visibility"`
	DefaultSnippetVisibility   VisibilityLevel   `json:"default_snippet_visibility"`
	RestrictedSignupDomains    []string          `json:"restricted_signup_domains"`
	UserOauthApplications      *bool             `json:"user_oauth_applications"`
	AfterSignOutPath           string            `json:"after_sign_out_path"`
}

Settings represents the GitLab application settings.

GitLab API docs: http://doc.gitlab.com/ce/api/settings.html

func (Settings) String

func (s Settings) String() string

type SettingsService

type SettingsService struct {
	// contains filtered or unexported fields
}

SettingsService handles communication with the application SettingsService related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/settings.html

func (*SettingsService) GetSettings

func (s *SettingsService) GetSettings() (*Settings, *Response, error)

GetSettings gets the current application settings.

GitLab API docs: http://doc.gitlab.com/ce/api/settings.html#get-current-application.settings

func (*SettingsService) UpdateSettings

func (s *SettingsService) UpdateSettings(opt *UpdateSettingsOptions) (*Settings, *Response, error)

UpdateSettings updates the application settings.

GitLab API docs: http://doc.gitlab.com/ce/api/settings.html#change-application.settings

type Snippet

type Snippet struct {
	ID       int    `json:"id"`
	Title    string `json:"title"`
	FileName string `json:"file_name"`
	Author   struct {
		ID        int       `json:"id"`
		Username  string    `json:"username"`
		Email     string    `json:"email"`
		Name      string    `json:"name"`
		State     string    `json:"state"`
		CreatedAt time.Time `json:"created_at"`
	} `json:"author"`
	ExpiresAt *time.Time `json:"expires_at"`
	UpdatedAt time.Time  `json:"updated_at"`
	CreatedAt time.Time  `json:"created_at"`
}

Snippet represents a GitLab project snippet.

GitLab API docs: http://doc.gitlab.com/ce/api/project_snippets.html

func (Snippet) String

func (s Snippet) String() string

type SystemHooksService

type SystemHooksService struct {
	// contains filtered or unexported fields
}

SystemHooksService handles communication with the system hooks related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/system_hooks.html

func (*SystemHooksService) AddHook

func (s *SystemHooksService) AddHook(opt *AddHookOptions) (*Hook, *Response, error)

AddHook adds a new system hook hook.

GitLab API docs: http://doc.gitlab.com/ce/api/system_hooks.html#add-new-system-hook-hook

func (*SystemHooksService) DeleteHook

func (s *SystemHooksService) DeleteHook(hook int) (*Response, error)

DeleteHook deletes a system hook. This is an idempotent API function and returns 200 OK even if the hook is not available. If the hook is deleted it is also returned as JSON.

GitLab API docs: http://doc.gitlab.com/ce/api/system_hooks.html#delete-system-hook

func (*SystemHooksService) ListHooks

func (s *SystemHooksService) ListHooks() ([]*Hook, *Response, error)

ListHooks gets a list of system hooks.

GitLab API docs: http://doc.gitlab.com/ce/api/system_hooks.html#list-system-hooks

func (*SystemHooksService) TestHook

func (s *SystemHooksService) TestHook(hook int) (*HookEvent, *Response, error)

TestHook tests a system hook.

GitLab API docs: http://doc.gitlab.com/ce/api/system_hooks.html#test-system-hook

type Tag

type Tag struct {
	Commit  *Commit `json:"commit"`
	Name    string  `json:"name"`
	Message string  `json:"message"`
}

Tag represents a GitLab repository tag.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#list-project-repository-tags

func (Tag) String

func (r Tag) String() string

type TreeNode

type TreeNode struct {
	ID   string `json:"id"`
	Name string `json:"name"`
	Type string `json:"type"`
	Mode string `json:"mode"`
}

TreeNode represents a GitLab repository file or directory.

GitLab API docs: http://doc.gitlab.com/ce/api/repositories.html#list-repository-tree

func (TreeNode) String

func (t TreeNode) String() string

type UpdateFileOptions

type UpdateFileOptions struct {
	FilePath      string `url:"file_path,omitempty" json:"file_path,omitempty"`
	BranchName    string `url:"branch_name,omitempty" json:"branch_name,omitempty"`
	Encoding      string `url:"encoding,omitempty" json:"encoding,omitempty"`
	Content       string `url:"content,omitempty" json:"content,omitempty"`
	CommitMessage string `url:"commit_message,omitempty" json:"commit_message,omitempty"`
}

UpdateFileOptions represents the available UpdateFile() options.

GitLab API docs: http://doc.gitlab.com/ce/api/repository_files.html#update-existing-file-in-repository

type UpdateGroupMemberOptions

type UpdateGroupMemberOptions struct {
	AccessLevel AccessLevel `url:"access_level,omitempty" json:"access_level,omitempty"`
}

UpdateGroupMemberOptions represents the available UpdateGroupMember() options.

GitLab API docs: http://doc.gitlab.com/ce/api/groups.html#edit-group-team-member

type UpdateIssueNoteOptions

type UpdateIssueNoteOptions struct {
	Body string `url:"body,omitempty" json:"body,omitempty"`
}

UpdateIssueNoteOptions represents the available UpdateIssueNote() options.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#modify-existing-issue-note

type UpdateIssueOptions

type UpdateIssueOptions struct {
	Title       string `url:"title,omitempty" json:"title,omitempty"`
	Description string `url:"description,omitempty" json:"description,omitempty"`
	AssigneeID  int    `url:"assignee_id,omitempty" json:"assignee_id,omitempty"`
	MilestoneID int    `url:"milestone_id,omitempty" json:"milestone_id,omitempty"`
	Labels      Labels `url:"labels,comma,omitempty" json:"labels,omitempty"`
	StateEvent  string `url:"state_event,omitempty" json:"state_event,omitempty"`
}

UpdateIssueOptions represents the available UpdateIssue() options.

GitLab API docs: http://doc.gitlab.com/ce/api/issues.html#edit-issues

type UpdateLabelOptions

type UpdateLabelOptions struct {
	Name    string `url:"name,omitempty" json:"name,omitempty"`
	NewName string `url:"new_name,omitempty" json:"new_name,omitempty"`
	Color   string `url:"color,omitempty" json:"color,omitempty"`
}

UpdateLabelOptions represents the available UpdateLabel() options.

GitLab API docs: http://doc.gitlab.com/ce/api/labels.html#delete-a-label

type UpdateMergeRequestNoteOptions

type UpdateMergeRequestNoteOptions struct {
	Body string `url:"body,omitempty" json:"body,omitempty"`
}

UpdateMergeRequestNoteOptions represents the available UpdateMergeRequestNote() options.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#modify-existing-merge-request-note

type UpdateMergeRequestOptions

type UpdateMergeRequestOptions struct {
	Title        string `url:"title,omitempty" json:"title,omitempty"`
	Description  string `url:"description,omitempty" json:"description,omitempty"`
	TargetBranch string `url:"target_branch,omitemtpy" json:"target_branch,omitemtpy"`
	AssigneeID   int    `url:"assignee_id,omitempty" json:"assignee_id,omitempty"`
	StateEvent   string `url:"state_event,omitempty" json:"state_event,omitempty"`
}

UpdateMergeRequestOptions represents the available UpdateMergeRequest() options.

GitLab API docs: http://doc.gitlab.com/ce/api/merge_requests.html#update-mr

type UpdateMilestoneOptions

type UpdateMilestoneOptions struct {
	Title       string `url:"title,omitempty" json:"title,omitempty"`
	Description string `url:"description,omitempty" json:"description,omitempty"`
	DueDate     string `url:"due_date,omitempty" json:"due_date,omitempty"`
	StateEvent  string `url:"state_event,omitempty" json:"state_event,omitempty"`
}

UpdateMilestoneOptions represents the available UpdateMilestone() options.

GitLab API docs: http://doc.gitlab.com/ce/api/milestones.html#edit-milestone

type UpdateSettingsOptions

type UpdateSettingsOptions struct {
	DefaultProjectsLimit       int               `url:"default_projects_limit,omitempty" json:"default_projects_limit,omitempty"`
	SignupEnabled              *bool             `url:"signup_enabled,omitempty" json:"signup_enabled,omitempty"`
	SigninEnabled              *bool             `url:"signin_enabled,omitempty" json:"signin_enabled,omitempty"`
	GravatarEnabled            *bool             `url:"gravatar_enabled,omitempty" json:"gravatar_enabled,omitempty"`
	SignInText                 string            `url:"sign_in_text,omitempty" json:"sign_in_text,omitempty"`
	HomePageURL                string            `url:"home_page_url,omitempty" json:"home_page_url,omitempty"`
	DefaultBranchProtection    int               `url:"default_branch_protection,omitempty" json:"default_branch_protection,omitempty"`
	TwitterSharingEnabled      *bool             `url:"twitter_sharing_enabled,omitempty" json:"twitter_sharing_enabled,omitempty"`
	RestrictedVisibilityLevels []VisibilityLevel `url:"restricted_visibility_levels,omitempty" json:"restricted_visibility_levels,omitempty"`
	MaxAttachmentSize          int               `url:"max_attachment_size,omitempty" json:"max_attachment_size,omitempty"`
	SessionExpireDelay         int               `url:"session_expire_delay,omitempty" json:"session_expire_delay,omitempty"`
	DefaultProjectVisibility   VisibilityLevel   `url:"default_project_visibility,omitempty" json:"default_project_visibility,omitempty"`
	DefaultSnippetVisibility   VisibilityLevel   `url:"default_snippet_visibility,omitempty" json:"default_snippet_visibility,omitempty"`
	RestrictedSignupDomains    []string          `url:"restricted_signup_domains,omitempty" json:"restricted_signup_domains,omitempty"`
	UserOauthApplications      *bool             `url:"user_oauth_applications,omitempty" json:"user_oauth_applications,omitempty"`
	AfterSignOutPath           string            `url:"after_sign_out_path,omitempty" json:"after_sign_out_path,omitempty"`
}

UpdateSettingsOptions represents the available UpdateSettings() options.

GitLab API docs: http://doc.gitlab.com/ce/api/settings.html#change-application.settings

type UpdateSnippetNoteOptions

type UpdateSnippetNoteOptions struct {
	Body string `url:"body,omitempty" json:"body,omitempty"`
}

UpdateSnippetNoteOptions represents the available UpdateSnippetNote() options.

GitLab API docs: http://doc.gitlab.com/ce/api/notes.html#modify-existing-snippet-note

type UpdateSnippetOptions

type UpdateSnippetOptions struct {
	Title           string          `url:"title,omitempty" json:"title,omitempty"`
	FileName        string          `url:"file_name,omitempty" json:"file_name,omitempty"`
	Code            string          `url:"code,omitempty" json:"code,omitempty"`
	VisibilityLevel VisibilityLevel `url:"visibility_level,omitempty" json:"visibility_level,omitempty"`
}

UpdateSnippetOptions represents the available UpdateSnippet() options.

GitLab API docs: http://doc.gitlab.com/ce/api/project_snippets.html#update-snippet

type User

type User struct {
	ID               int             `json:"id"`
	Username         string          `json:"username"`
	Email            string          `json:"email"`
	Name             string          `json:"name"`
	State            string          `json:"state"`
	CreatedAt        time.Time       `json:"created_at"`
	Bio              string          `json:"bio"`
	Skype            string          `json:"skype"`
	Linkedin         string          `json:"linkedin"`
	Twitter          string          `json:"twitter"`
	WebsiteURL       string          `json:"website_url"`
	ExternUID        string          `json:"extern_uid"`
	Provider         string          `json:"provider"`
	ThemeID          int             `json:"theme_id"`
	ColorSchemeID    int             `json:"color_scheme_id"`
	IsAdmin          bool            `json:"is_admin"`
	AvatarURL        string          `json:"avatar_url"`
	CanCreateGroup   bool            `json:"can_create_group"`
	CanCreateProject bool            `json:"can_create_project"`
	ProjectsLimit    int             `json:"projects_limit"`
	CurrentSignInAt  *time.Time      `json:"current_sign_in_at"`
	LastSignInAt     *time.Time      `json:"last_sign_in_at"`
	TwoFactorEnabled bool            `json:"two_factor_enabled"`
	Identities       []*UserIdentity `json:"identities"`
}

User represents a GitLab user.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html

type UserIdentity

type UserIdentity struct {
	Provider  string `json:"provider"`
	ExternUID string `json:"extern_uid"`
}

type UsersService

type UsersService struct {
	// contains filtered or unexported fields
}

UsersService handles communication with the user related methods of the GitLab API.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html

func (*UsersService) AddSSHKey

func (s *UsersService) AddSSHKey(opt *AddSSHKeyOptions) (*SSHKey, *Response, error)

AddSSHKey creates a new key owned by the currently authenticated user.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#add-ssh-key

func (*UsersService) AddSSHKeyForUser

func (s *UsersService) AddSSHKeyForUser(
	user int,
	opt *AddSSHKeyOptions) (*SSHKey, *Response, error)

AddSSHKeyForUser creates new key owned by specified user. Available only for admin.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#add-ssh-key-for-user

func (*UsersService) BlockUser

func (s *UsersService) BlockUser(user int) error

BlockUser blocks the specified user. Available only for admin.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#block-user

func (*UsersService) CreateUser

func (s *UsersService) CreateUser(opt *CreateUserOptions) (*User, *Response, error)

CreateUser creates a new user. Note only administrators can create new users.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#user-creation

func (*UsersService) CurrentUser

func (s *UsersService) CurrentUser() (*User, *Response, error)

CurrentUser gets currently authenticated user.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#current-user

func (*UsersService) DeleteSSHKey

func (s *UsersService) DeleteSSHKey(kid int) (*Response, error)

DeleteSSHKey deletes key owned by currently authenticated user. This is an idempotent function and calling it on a key that is already deleted or not available results in 200 OK.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#delete-ssh-key-for-current-owner

func (*UsersService) DeleteSSHKeyForUser

func (s *UsersService) DeleteSSHKeyForUser(user int, kid int) (*Response, error)

DeleteSSHKeyForUser deletes key owned by a specified user. Available only for admin.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#delete-ssh-key-for-given-user

func (*UsersService) DeleteUser

func (s *UsersService) DeleteUser(user int) (*Response, error)

DeleteUser deletes a user. Available only for administrators. This is an idempotent function, calling this function for a non-existent user id still returns a status code 200 OK. The JSON response differs if the user was actually deleted or not. In the former the user is returned and in the latter not.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#user-deletion

func (*UsersService) GetSSHKey

func (s *UsersService) GetSSHKey(kid int) (*SSHKey, *Response, error)

GetSSHKey gets a single key.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#single-ssh-key

func (*UsersService) GetUser

func (s *UsersService) GetUser(user int) (*User, *Response, error)

GetUser gets a single user.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#single-user

func (*UsersService) ListSSHKeys

func (s *UsersService) ListSSHKeys() ([]*SSHKey, *Response, error)

ListSSHKeys gets a list of currently authenticated user's SSH keys.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#list-ssh-keys

func (*UsersService) ListSSHKeysForUser

func (s *UsersService) ListSSHKeysForUser(user int) ([]*SSHKey, *Response, error)

ListSSHKeysForUser gets a list of a specified user's SSH keys. Available only for admin

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#list-ssh-keys-for-user

func (*UsersService) ListUsers

func (s *UsersService) ListUsers(opt *ListUsersOptions) ([]*User, *Response, error)

ListUsers gets a list of users.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#list-users

func (*UsersService) ModifyUser

func (s *UsersService) ModifyUser(user int, opt *ModifyUserOptions) (*User, *Response, error)

ModifyUser modifies an existing user. Only administrators can change attributes of a user.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#user-modification

func (*UsersService) UnblockUser

func (s *UsersService) UnblockUser(user int) error

UnblockUser unblocks the specified user. Available only for admin.

GitLab API docs: http://doc.gitlab.com/ce/api/users.html#unblock-user

type Variable

type Variable struct {
	Key   string `json:"key"`
	Value string `json:"value"`
}

Variable represents a variable available for each build of the given project

Gitlab API Docs : https://docs.gitlab.com/ce/api/build_variables.html

type VariablesService

type VariablesService struct {
	// contains filtered or unexported fields
}

VariablesService handles communication with the project variables related methods of the Gitlab API

Gitlab API Docs : https://docs.gitlab.com/ce/api/build_variables.html

func (*VariablesService) CreateVariable

func (s *VariablesService) CreateVariable(pid interface{}, variable Variable) (*Variable, *Response, error)

CreateVariable creates a variable for a given project

Gitlab API Docs: https://docs.gitlab.com/ce/api/build_variables.html#create-variable

func (*VariablesService) GetSingleVariable

func (s *VariablesService) GetSingleVariable(pid interface{}, variableKey string) (*Variable, *Response, error)

GetSingleVariable gets a single project variable of a project

Gitlab API Docs: https://docs.gitlab.com/ce/api/build_variables.html#show-variable-details

func (*VariablesService) ListVariables

func (s *VariablesService) ListVariables(pid interface{}) ([]*Variable, *Response, error)

ListVariables gets the a list of project variables in a project

Gitlab API Docs: https://docs.gitlab.com/ce/api/build_variables.html#list-project-variables

func (*VariablesService) RemoveVariable

func (s *VariablesService) RemoveVariable(pid interface{}, variableKey string) (*Response, error)

RemoveVariable removes a project variable of a given project identified by its key

Gitlab API Docs: https://docs.gitlab.com/ce/api/build_variables.html#remove-variable

func (*VariablesService) UpdateVariable

func (s *VariablesService) UpdateVariable(pid interface{}, variableKey string, variable Variable) (*Variable, *Response, error)

UpdateVariable updates an existing project variable The variable key must exist

Gitlab API Docs: https://docs.gitlab.com/ce/api/build_variables.html#update-variable

type VisibilityLevel

type VisibilityLevel int

VisibilityLevel represents a visibility level within GitLab.

GitLab API docs: http://doc.gitlab.com/ce/...?

const (
	PrivateVisibility  VisibilityLevel = 0
	InternalVisibility VisibilityLevel = 10
	PublicVisibility   VisibilityLevel = 20
)

List of available visibility levels

GitLab API docs: http://doc.gitlab.com/ce/...?

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL