xanzy/go-gitlab

This repository is archived as it's development has been moved to GitLab! # go-gitlab (deprecated) 🚧 **Project moved to https://gitlab.com/gitlab-org/api/client-go** 🚧 This package, `github.com/xanzy/go-gitlab`, has been moved to [`gitlab.com/gitlab-org/api/client-go`](https://gitlab.com/gitlab-org/api/client-go). **References**: - [GitLab Project](https://gitlab.com/gitlab-org/api/client-go) - [Issue Tracker](https://gitlab.com/gitlab-org/api/client-go/-/issues) ## Migration Steps - Replace `github.com/xanzy/go-gitlab` with `gitlab.com/gitlab-org/api/client-go` in your code base. - Profit 🎉 - *(the code is fully backwards-compatible, no breaking changes are expected)*

Former README contents

A GitLab API client enabling Go programs to interact with GitLab in a simple and uniform way [](https://github.com/xanzy/go-gitlab/actions?workflow=Lint%20and%20Test) [](https://sourcegraph.com/github.com/xanzy/go-gitlab?badge) [](https://godoc.org/github.com/xanzy/go-gitlab) [](https://goreportcard.com/report/github.com/xanzy/go-gitlab) [](https://raw.githack.com/wiki/xanzy/go-gitlab/coverage.html) ## 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: - [x] Applications - [x] Award Emojis - [x] Branches - [x] Broadcast Messages - [x] Commits - [x] Container Registry - [x] Custom Attributes - [x] Dependency List Export - [x] Deploy Keys - [x] Deployments - [x] Discussions (threaded comments) - [x] Environments - [x] Epic Issues - [x] Epics - [x] Error Tracking - [x] Events - [x] Feature Flags - [x] Geo Nodes - [x] Generic Packages - [x] GitLab CI Config Templates - [x] Gitignores Templates - [x] Group Access Requests - [x] Group Issue Boards - [x] Group Members - [x] Group Milestones - [x] Group Wikis - [x] Group-Level Variables - [x] Groups - [x] Instance Clusters - [x] Invites - [x] Issue Boards - [x] Issues - [x] Jobs - [x] Keys - [x] Labels - [x] License - [x] Markdown - [x] Merge Request Approvals - [x] Merge Requests - [x] Namespaces - [x] Notes (comments) - [x] Notification Settings - [x] Open Source License Templates - [x] Packages - [x] Pages - [x] Pages Domains - [x] Personal Access Tokens - [x] Pipeline Schedules - [x] Pipeline Triggers - [x] Pipelines - [x] Plan limits - [x] Project Access Requests - [x] Project Badges - [x] Project Clusters - [x] Project Import/export - [x] Project Members - [x] Project Milestones - [x] Project Repository Storage Moves - [x] Project Snippets - [x] Project Vulnerabilities - [x] Project-Level Variables - [x] Projects (including setting Webhooks) - [x] Protected Branches - [x] Protected Environments - [x] Protected Tags - [x] Repositories - [x] Repository Files - [x] Repository Submodules - [x] Runners - [x] Search - [x] Services - [x] Settings - [x] Sidekiq Metrics - [x] System Hooks - [x] Tags - [x] Todos - [x] Topics - [x] Users - [x] Validate CI Configuration - [x] Version - [x] 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 := &gitlab.ListProjectsOptions{Search: gitlab.Ptr("svanharmelen")} projects, _, err := git.Projects.ListProjects(opt) ### Examples The [examples](https://github.com/xanzy/go-gitlab/tree/master/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.Ptr("My Project"), Description: gitlab.Ptr("Just a test project to play with"), MergeRequestsAccessLevel: gitlab.Ptr(gitlab.EnabledAccessControl), SnippetsAccessLevel: gitlab.Ptr(gitlab.EnabledAccessControl), Visibility: gitlab.Ptr(gitlab.PublicVisibility), } project, _, err := git.Projects.CreateProject(p) if err != nil { log.Fatal(err) } // Add a new snippet s := &gitlab.CreateProjectSnippetOptions{ Title: gitlab.Ptr("Dummy Snippet"), FileName: gitlab.Ptr("snippet.go"), Content: gitlab.Ptr("package main...."), Visibility: gitlab.Ptr(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](https://godoc.org/github.com/xanzy/go-gitlab). ## ToDo - The biggest thing this package still needs is tests :disappointed: ## Issues - If you have an issue: report it on the [issue tracker](https://github.com/xanzy/go-gitlab/issues) ## Author Sander van Harmelen () ## 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

标签：EVTX分析