bench-forgejo/vendor/github.com/xanzy/go-gitlab
6543 792b4dba2c
[Vendor] Update directly used dependencys (#15593)
* update github.com/blevesearch/bleve v2.0.2 -> v2.0.3

* github.com/denisenkom/go-mssqldb v0.9.0 -> v0.10.0

* github.com/editorconfig/editorconfig-core-go v2.4.1 -> v2.4.2

* github.com/go-chi/cors v1.1.1 -> v1.2.0

* github.com/go-git/go-billy v5.0.0 -> v5.1.0

* github.com/go-git/go-git v5.2.0 -> v5.3.0

* github.com/go-ldap/ldap v3.2.4 -> v3.3.0

* github.com/go-redis/redis v8.6.0 -> v8.8.2

* github.com/go-sql-driver/mysql v1.5.0 -> v1.6.0

* github.com/go-swagger/go-swagger v0.26.1 -> v0.27.0

* github.com/lib/pq v1.9.0 -> v1.10.1

* github.com/mattn/go-sqlite3 v1.14.6 -> v1.14.7

* github.com/go-testfixtures/testfixtures v3.5.0 -> v3.6.0

* github.com/issue9/identicon v1.0.1 -> v1.2.0

* github.com/klauspost/compress v1.11.8 -> v1.12.1

* github.com/mgechev/revive v1.0.3 -> v1.0.6

* github.com/microcosm-cc/bluemonday v1.0.7 -> v1.0.8

* github.com/niklasfasching/go-org v1.4.0 -> v1.5.0

* github.com/olivere/elastic v7.0.22 -> v7.0.24

* github.com/pelletier/go-toml v1.8.1 -> v1.9.0

* github.com/prometheus/client_golang v1.9.0 -> v1.10.0

* github.com/xanzy/go-gitlab v0.44.0 -> v0.48.0

* github.com/yuin/goldmark v1.3.3 -> v1.3.5

* github.com/6543/go-version v1.2.4 -> v1.3.1

* do github.com/lib/pq v1.10.0 -> v1.10.1 again ...
2021-04-22 20:08:53 -04:00
..
.gitignore Add support for migrating from Gitlab (#9084) 2020-04-19 23:44:11 +08:00
.golangci.yml Vendor Update (#14496) 2021-01-28 17:56:38 +01:00
access_requests.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
applications.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
audit_events.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
award_emojis.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
boards.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
branches.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
broadcast_messages.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
ci_yml_templates.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
client_options.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
commits.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
container_registry.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
custom_attributes.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
deploy_keys.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
deploy_tokens.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
deployments.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
discussions.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
environments.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
epic_issues.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
epics.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
event_parsing.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
event_systemhook_types.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
event_webhook_types.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
events.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
feature_flags.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
freeze_periods.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
gitignore_templates.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
gitlab.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
go.mod [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
go.sum [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
group_badges.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
group_boards.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
group_clusters.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
group_hooks.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
group_labels.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
group_members.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
group_milestones.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
group_variables.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
group_wikis.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
groups.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
instance_clusters.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
instance_variables.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
invites.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
issue_links.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
issues.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
issues_statistics.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
jobs.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
keys.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
labels.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
LICENSE Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
license.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
license_templates.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
merge_request_approvals.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
merge_requests.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
milestones.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
namespaces.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
notes.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
notifications.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
packages.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
pages_domains.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
pipeline_schedules.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
pipeline_triggers.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
pipelines.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
project_access_tokens.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
project_badges.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
project_clusters.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
project_import_export.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
project_members.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
project_mirror.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
project_snippets.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
project_variables.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
projects.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
protected_branches.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
protected_environments.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
protected_tags.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
README.md [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
releaselinks.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
releases.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
repositories.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
repository_files.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
request_options.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
resource_label_events.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
resource_state_events.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
runners.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
search.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
services.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
settings.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
sidekiq_metrics.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
snippets.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
strings.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
system_hooks.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
tags.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
time_stats.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
todos.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
types.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
users.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
validate.go [Vendor] Update directly used dependencys (#15593) 2021-04-22 20:08:53 -04:00
version.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00
wikis.go Vendor Update (#14696) 2021-02-16 22:47:24 -05:00

go-gitlab

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

Build Status Sourcegraph GoDoc Go Report Card

NOTE

Release v0.6.0 (released on 25-08-2017) no longer supports the older V3 Gitlab API. If you need V3 support, please use the f-api-v3 branch. This release contains some backwards incompatible changes that were needed to fully support the V4 Gitlab API.

Coverage

This API client package covers most of the existing Gitlab API calls and is updated regularly to add new and/or missing endpoints. Currently the following services are supported:

  • Applications
  • Award Emojis
  • Branches
  • Broadcast Messages
  • Commits
  • Container Registry
  • Custom Attributes
  • Deploy Keys
  • Deployments
  • Discussions (threaded comments)
  • Environments
  • Epic Issues
  • Epics
  • Events
  • Feature Flags
  • Geo Nodes
  • GitLab CI Config Templates
  • Gitignores Templates
  • Group Access Requests
  • Group Issue Boards
  • Group Members
  • Group Milestones
  • Group Wikis
  • Group-Level Variables
  • Groups
  • Instance Clusters
  • Invites
  • Issue Boards
  • Issues
  • Jobs
  • Keys
  • Labels
  • License
  • Merge Request Approvals
  • Merge Requests
  • Namespaces
  • Notes (comments)
  • Notification Settings
  • Open Source License Templates
  • Pages Domains
  • Personal Access Tokens
  • Pipeline Schedules
  • Pipeline Triggers
  • Pipelines
  • Project Access Requests
  • Project Badges
  • Project Clusters
  • Project Import/export
  • Project Members
  • Project Milestones
  • Project Snippets
  • Project-Level Variables
  • Projects (including setting Webhooks)
  • Protected Branches
  • Protected Environments
  • Protected Tags
  • Repositories
  • Repository Files
  • Runners
  • Search
  • Services
  • Settings
  • Sidekiq Metrics
  • System Hooks
  • Tags
  • Todos
  • Users
  • Validate CI Configuration
  • Version
  • Wikis

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, err := gitlab.NewClient("yourtokengoeshere")
if err != nil {
  log.Fatalf("Failed to create client: %v", err)
}
users, _, err := git.Users.ListUsers(&gitlab.ListUsersOptions{})

There are a few With... option functions that can be used to customize the API client. For example, to set a custom base URL:

git, err := gitlab.NewClient("yourtokengoeshere", gitlab.WithBaseURL("https://git.mydomain.com/api/v4"))
if err != nil {
  log.Fatalf("Failed to create client: %v", err)
}
users, _, err := git.Users.ListUsers(&gitlab.ListUsersOptions{})

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

git := gitlab.NewClient("yourtokengoeshere")
opt := &ListProjectsOptions{Search: gitlab.String("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, err := gitlab.NewClient("yourtokengoeshere")
	if err != nil {
		log.Fatalf("Failed to create client: %v", err)
	}

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

	// Add a new snippet
	s := &gitlab.CreateProjectSnippetOptions{
		Title:           gitlab.String("Dummy Snippet"),
		FileName:        gitlab.String("snippet.go"),
		Content:         gitlab.String("package main...."),
		Visibility:      gitlab.Visibility(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@vanharmelen.nl)

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