https://github.com/flc1125/go-gitlab-webhook
🚀 A lightweight Gitlab webhook dispatcher for efficient event handling
https://github.com/flc1125/go-gitlab-webhook
dispatcher event gitlab golang webhook
Last synced: 3 months ago
JSON representation
🚀 A lightweight Gitlab webhook dispatcher for efficient event handling
- Host: GitHub
- URL: https://github.com/flc1125/go-gitlab-webhook
- Owner: flc1125
- License: mit
- Created: 2024-08-19T11:48:50.000Z (11 months ago)
- Default Branch: v2.x
- Last Pushed: 2025-04-02T03:48:02.000Z (3 months ago)
- Last Synced: 2025-04-02T04:29:58.555Z (3 months ago)
- Topics: dispatcher, event, gitlab, golang, webhook
- Language: Go
- Homepage: https://github.com/flc1125/go-gitlab-webhook
- Size: 90.8 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Gitlab Webhook Dispatcher 🚀
[](https://github.com/flc1125/go-gitlab-webhook/releases)
[](https://pkg.go.dev/github.com/flc1125/go-gitlab-webhook/v2)
[](https://codecov.io/gh/flc1125/go-gitlab-webhook)
[](https://goreportcard.com/report/github.com/flc1125/go-gitlab-webhook)
[](https://github.com/flc1125/go-gitlab-webhook/actions/workflows/lint.yml)
[](https://github.com/flc1125/go-gitlab-webhook/actions/workflows/test.yml)
[](https://opensource.org/licenses/MIT)
This is a simple webhook dispatcher for Gitlab. It listens for incoming webhooks and dispatches them to the appropriate handler.
## ✨ Features
- 📋 Very convenient registration of listeners
- 🔄 A single listener can implement multiple different webhook functions
- âš¡ Support asynchronous and efficient processing
- 🚀 Multiple dispatch methods
## 📦 Installation
```shell
go get github.com/flc1125/go-gitlab-webhook/v2
```
## 💻 Usage
```go
package main
import (
"context"
"net/http"
"github.com/flc1125/go-gitlab-webhook/v2"
"gitlab.com/gitlab-org/api/client-go"
)
var (
_ gitlabwebhook.BuildListener = (*testBuildListener)(nil)
_ gitlabwebhook.CommitCommentListener = (*testCommitCommentListener)(nil)
_ gitlabwebhook.BuildListener = (*testBuildAndCommitCommentListener)(nil)
_ gitlabwebhook.CommitCommentListener = (*testBuildAndCommitCommentListener)(nil)
)
type testBuildListener struct{}
func (l *testBuildListener) OnBuild(ctx context.Context, event *gitlab.BuildEvent) error {
// do something
return nil
}
type testCommitCommentListener struct{}
func (l *testCommitCommentListener) OnCommitComment(ctx context.Context, event *gitlab.CommitCommentEvent) error {
// do something
return nil
}
type testBuildAndCommitCommentListener struct{}
func (l *testBuildAndCommitCommentListener) OnBuild(ctx context.Context, event *gitlab.BuildEvent) error {
// do something
return nil
}
func (l *testBuildAndCommitCommentListener) OnCommitComment(ctx context.Context, event *gitlab.CommitCommentEvent) error {
// do something
return nil
}
func main() {
dispatcher := gitlabwebhook.NewDispatcher(
gitlabwebhook.RegisterListeners(
&testBuildListener{},
&testCommitCommentListener{},
&testBuildAndCommitCommentListener{},
),
)
dispatcher.RegisterListeners(
&testBuildListener{},
&testCommitCommentListener{},
&testBuildAndCommitCommentListener{},
)
http.Handle("/webhook", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if err := dispatcher.DispatchRequest(r,
gitlabwebhook.DispatchRequestWithContext(context.Background()), // custom context
); err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
w.WriteHeader(http.StatusNoContent)
}))
if err := http.ListenAndServe(":8080", nil); err != nil {
panic(err)
}
}
```
## 📜 License
MIT License. See [LICENSE](LICENSE) for the full license text.
## 💖 Thanks
- [gitlab-org/api/client-go](https://gitlab.com/gitlab-org/api/client-go)(Formerly known as: [xanzy/go-gitlab](https://github.com/xanzy/go-gitlab)): Go library for accessing the GitLab API
- [stretchr/testify](github.com/stretchr/testify): A toolkit with common assertions and mocks that plays nicely with the standard library