mirror of
https://codeberg.org/forgejo/forgejo.git
synced 2024-09-07 12:18:21 +02:00
* first draft
* update gitea sdk to 9e280adb4da
* adapt feat of updated sdk
* releases now works
* break the Reactions loop
* use convertGiteaLabel
* fix endless loop because paggination is not supported there !!!
* rename gitea local uploader files
* pagination can bite you in the ass
* Version Checks
* lint
* docs
* rename gitea sdk import to miss future conficts
* go-swagger: dont scan the sdk structs
* make sure gitea can shutdown gracefully
* make GetPullRequests and GetIssues similar
* rm useles
* Add Test: started ...
* ... add tests ...
* Add tests and Fixing things
* Workaround missing SHA
* Adapt: Ensure that all migration requests are cancellable
(714ab71ddc
)
* LINT: fix misspells in test set
* adapt ListMergeRequestAwardEmoji
* update sdk
* Return error when creating giteadownloader failed
* update sdk
* adapt new sdk
* adopt new features
* check version before err
* adapt: 'migrate service type switch page'
* optimize
* Fix DefaultBranch
* impruve
* handle subPath
* fix test
* Fix ReviewCommentPosition
* test GetReviews
* add DefaultBranch int test set
* rm unused
* Update SDK to v0.13.0
* addopt sdk changes
* found better link
* format template
* Update Docs
* Update Gitea SDK (v0.13.1)
199 lines
6.2 KiB
Go
Vendored
199 lines
6.2 KiB
Go
Vendored
// Copyright 2020 The Gitea Authors. All rights reserved.
|
|
// Use of this source code is governed by a MIT-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
package gitea
|
|
|
|
import (
|
|
"fmt"
|
|
"net/url"
|
|
"time"
|
|
)
|
|
|
|
// NotificationThread expose Notification on API
|
|
type NotificationThread struct {
|
|
ID int64 `json:"id"`
|
|
Repository *Repository `json:"repository"`
|
|
Subject *NotificationSubject `json:"subject"`
|
|
Unread bool `json:"unread"`
|
|
Pinned bool `json:"pinned"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
URL string `json:"url"`
|
|
}
|
|
|
|
// NotificationSubject contains the notification subject (Issue/Pull/Commit)
|
|
type NotificationSubject struct {
|
|
Title string `json:"title"`
|
|
URL string `json:"url"`
|
|
LatestCommentURL string `json:"latest_comment_url"`
|
|
Type string `json:"type"`
|
|
State StateType `json:"state"`
|
|
}
|
|
|
|
// NotifyStatus notification status type
|
|
type NotifyStatus string
|
|
|
|
const (
|
|
// NotifyStatusUnread was not read
|
|
NotifyStatusUnread NotifyStatus = "unread"
|
|
// NotifyStatusRead was already read by user
|
|
NotifyStatusRead NotifyStatus = "read"
|
|
// NotifyStatusPinned notification is pinned by user
|
|
NotifyStatusPinned NotifyStatus = "pinned"
|
|
)
|
|
|
|
// ListNotificationOptions represents the filter options
|
|
type ListNotificationOptions struct {
|
|
ListOptions
|
|
Since time.Time
|
|
Before time.Time
|
|
Status []NotifyStatus
|
|
}
|
|
|
|
// MarkNotificationOptions represents the filter & modify options
|
|
type MarkNotificationOptions struct {
|
|
LastReadAt time.Time
|
|
Status []NotifyStatus
|
|
ToStatus NotifyStatus
|
|
}
|
|
|
|
// QueryEncode encode options to url query
|
|
func (opt *ListNotificationOptions) QueryEncode() string {
|
|
query := opt.getURLQuery()
|
|
if !opt.Since.IsZero() {
|
|
query.Add("since", opt.Since.Format(time.RFC3339))
|
|
}
|
|
if !opt.Before.IsZero() {
|
|
query.Add("before", opt.Before.Format(time.RFC3339))
|
|
}
|
|
for _, s := range opt.Status {
|
|
query.Add("status-types", string(s))
|
|
}
|
|
return query.Encode()
|
|
}
|
|
|
|
// Validate the CreateUserOption struct
|
|
func (opt ListNotificationOptions) Validate(c *Client) error {
|
|
if len(opt.Status) != 0 {
|
|
return c.CheckServerVersionConstraint(">=1.12.3")
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// QueryEncode encode options to url query
|
|
func (opt *MarkNotificationOptions) QueryEncode() string {
|
|
query := make(url.Values)
|
|
if !opt.LastReadAt.IsZero() {
|
|
query.Add("last_read_at", opt.LastReadAt.Format(time.RFC3339))
|
|
}
|
|
for _, s := range opt.Status {
|
|
query.Add("status-types", string(s))
|
|
}
|
|
if len(opt.ToStatus) != 0 {
|
|
query.Add("to-status", string(opt.ToStatus))
|
|
}
|
|
return query.Encode()
|
|
}
|
|
|
|
// Validate the CreateUserOption struct
|
|
func (opt MarkNotificationOptions) Validate(c *Client) error {
|
|
if len(opt.Status) != 0 || len(opt.ToStatus) != 0 {
|
|
return c.CheckServerVersionConstraint(">=1.12.3")
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// CheckNotifications list users's notification threads
|
|
func (c *Client) CheckNotifications() (int64, *Response, error) {
|
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil {
|
|
return 0, nil, err
|
|
}
|
|
new := struct {
|
|
New int64 `json:"new"`
|
|
}{}
|
|
|
|
resp, err := c.getParsedResponse("GET", "/notifications/new", jsonHeader, nil, &new)
|
|
return new.New, resp, err
|
|
}
|
|
|
|
// GetNotification get notification thread by ID
|
|
func (c *Client) GetNotification(id int64) (*NotificationThread, *Response, error) {
|
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil {
|
|
return nil, nil, err
|
|
}
|
|
thread := new(NotificationThread)
|
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/notifications/threads/%d", id), nil, nil, thread)
|
|
return thread, resp, err
|
|
}
|
|
|
|
// ReadNotification mark notification thread as read by ID
|
|
// It optionally takes a second argument if status has to be set other than 'read'
|
|
func (c *Client) ReadNotification(id int64, status ...NotifyStatus) (*Response, error) {
|
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil {
|
|
return nil, err
|
|
}
|
|
link := fmt.Sprintf("/notifications/threads/%d", id)
|
|
if len(status) != 0 {
|
|
link += fmt.Sprintf("?to-status=%s", status[0])
|
|
}
|
|
_, resp, err := c.getResponse("PATCH", link, nil, nil)
|
|
return resp, err
|
|
}
|
|
|
|
// ListNotifications list users's notification threads
|
|
func (c *Client) ListNotifications(opt ListNotificationOptions) ([]*NotificationThread, *Response, error) {
|
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil {
|
|
return nil, nil, err
|
|
}
|
|
if err := opt.Validate(c); err != nil {
|
|
return nil, nil, err
|
|
}
|
|
link, _ := url.Parse("/notifications")
|
|
link.RawQuery = opt.QueryEncode()
|
|
threads := make([]*NotificationThread, 0, 10)
|
|
resp, err := c.getParsedResponse("GET", link.String(), nil, nil, &threads)
|
|
return threads, resp, err
|
|
}
|
|
|
|
// ReadNotifications mark notification threads as read
|
|
func (c *Client) ReadNotifications(opt MarkNotificationOptions) (*Response, error) {
|
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil {
|
|
return nil, err
|
|
}
|
|
if err := opt.Validate(c); err != nil {
|
|
return nil, err
|
|
}
|
|
link, _ := url.Parse("/notifications")
|
|
link.RawQuery = opt.QueryEncode()
|
|
_, resp, err := c.getResponse("PUT", link.String(), nil, nil)
|
|
return resp, err
|
|
}
|
|
|
|
// ListRepoNotifications list users's notification threads on a specific repo
|
|
func (c *Client) ListRepoNotifications(owner, reponame string, opt ListNotificationOptions) ([]*NotificationThread, *Response, error) {
|
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil {
|
|
return nil, nil, err
|
|
}
|
|
if err := opt.Validate(c); err != nil {
|
|
return nil, nil, err
|
|
}
|
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/notifications", owner, reponame))
|
|
link.RawQuery = opt.QueryEncode()
|
|
threads := make([]*NotificationThread, 0, 10)
|
|
resp, err := c.getParsedResponse("GET", link.String(), nil, nil, &threads)
|
|
return threads, resp, err
|
|
}
|
|
|
|
// ReadRepoNotifications mark notification threads as read on a specific repo
|
|
func (c *Client) ReadRepoNotifications(owner, reponame string, opt MarkNotificationOptions) (*Response, error) {
|
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil {
|
|
return nil, err
|
|
}
|
|
if err := opt.Validate(c); err != nil {
|
|
return nil, err
|
|
}
|
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/notifications", owner, reponame))
|
|
link.RawQuery = opt.QueryEncode()
|
|
_, resp, err := c.getResponse("PUT", link.String(), nil, nil)
|
|
return resp, err
|
|
}
|