# go-gitlab-client

**Repository Path**: themoonstone/go-gitlab-client

## Basic Information

- **Project Name**: go-gitlab-client
- **Description**: A simple gitlab api client written in Go
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-12-07
- **Last Updated**: 2021-12-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# go-gitlab-client
================

go-gitlab-client is a simple client written in golang to consume gitlab API.

[![Build Status](https://travis-ci.org/plouc/go-gitlab-client.png?branch=master)](https://travis-ci.org/plouc/go-gitlab-client)


## features

*
	### Projects [gitlab api doc](http://doc.gitlab.com/ce/api/projects.html)
	* list projects
	* add/get/edit/rm single project
*
	### Repositories [gitlab api doc](http://doc.gitlab.com/ce/api/repositories.html)
	* list repository branches
	* get single repository branch
	* list project repository tags
	* list repository commits
	* list project hooks
	* add/get/edit/rm project hook

*
	### Users [gitlab api doc](http://api.gitlab.org/users.html)
	* get single user
	* manage user keys

*
	### Groups [gitlab api doc](https://docs.gitlab.com/ce/api/groups.html)
	* list groups
	* add/get/edit/rm single group
	* list projects in a group
	* list members in a group

*
	### Deploy Keys [gitlab api doc](http://doc.gitlab.com/ce/api/deploy_keys.html)
	* list project deploy keys
	* add/get/rm project deploy key

*
	### Builds [gitlab api doc](http://doc.gitlab.com/ce/api/builds.html)
	* List project builds
 	* Get a single build
 	* List commit builds
 	* Get build artifacts
 	* Cancel a build
 	* Retry a build
 	* Erase a build

*
	### Runners [gitlab api doc](http://doc.gitlab.com/ce/api/runners.html)
	* list owned runners
	* list shared runners
	* list projects runners
	* get a single runner
	* update/remove runner
	* enable/disable runner in project


## Installation

To install go-gitlab-client, use `go get`:

    go get github.com/plouc/go-gitlab-client

Import the `go-gitlab-client` package into your code:

```go
package whatever

import (
    "github.com/plouc/go-gitlab-client"
)
```


## Update

To update `go-gitlab-client`, use `go get -u`:

    go get -u github.com/plouc/go-gitlab-client


##Documentation

Visit the docs at http://godoc.org/github.com/plouc/go-gitlab-client


## Examples

You can play with the examples located in the `examples` directory

* [projects](https://github.com/plouc/go-gitlab-client/tree/master/examples/projects)
* [repositories](https://github.com/plouc/go-gitlab-client/tree/master/examples/repositories)