mirror of https://gitea.com/gitea/tea.git
128 lines
4.3 KiB
Go
128 lines
4.3 KiB
Go
// Copyright 2017 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 (
|
|
"bytes"
|
|
"encoding/json"
|
|
"fmt"
|
|
"time"
|
|
)
|
|
|
|
// TrackedTime worked time for an issue / pr
|
|
type TrackedTime struct {
|
|
ID int64 `json:"id"`
|
|
Created time.Time `json:"created"`
|
|
// Time in seconds
|
|
Time int64 `json:"time"`
|
|
// deprecated (only for backwards compatibility)
|
|
UserID int64 `json:"user_id"`
|
|
UserName string `json:"user_name"`
|
|
// deprecated (only for backwards compatibility)
|
|
IssueID int64 `json:"issue_id"`
|
|
Issue *Issue `json:"issue"`
|
|
}
|
|
|
|
// GetUserTrackedTimes list tracked times of a user
|
|
func (c *Client) GetUserTrackedTimes(owner, repo, user string) ([]*TrackedTime, *Response, error) {
|
|
if err := c.checkServerVersionGreaterThanOrEqual(version1_11_0); err != nil {
|
|
return nil, nil, err
|
|
}
|
|
times := make([]*TrackedTime, 0, 10)
|
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/times/%s", owner, repo, user), nil, nil, ×)
|
|
return times, resp, err
|
|
}
|
|
|
|
// GetRepoTrackedTimes list tracked times of a repository
|
|
func (c *Client) GetRepoTrackedTimes(owner, repo string) ([]*TrackedTime, *Response, error) {
|
|
if err := c.checkServerVersionGreaterThanOrEqual(version1_11_0); err != nil {
|
|
return nil, nil, err
|
|
}
|
|
times := make([]*TrackedTime, 0, 10)
|
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/times", owner, repo), nil, nil, ×)
|
|
return times, resp, err
|
|
}
|
|
|
|
// GetMyTrackedTimes list tracked times of the current user
|
|
func (c *Client) GetMyTrackedTimes() ([]*TrackedTime, *Response, error) {
|
|
if err := c.checkServerVersionGreaterThanOrEqual(version1_11_0); err != nil {
|
|
return nil, nil, err
|
|
}
|
|
times := make([]*TrackedTime, 0, 10)
|
|
resp, err := c.getParsedResponse("GET", "/user/times", nil, nil, ×)
|
|
return times, resp, err
|
|
}
|
|
|
|
// AddTimeOption options for adding time to an issue
|
|
type AddTimeOption struct {
|
|
// time in seconds
|
|
Time int64 `json:"time"`
|
|
// optional
|
|
Created time.Time `json:"created"`
|
|
// optional
|
|
User string `json:"user_name"`
|
|
}
|
|
|
|
// Validate the AddTimeOption struct
|
|
func (opt AddTimeOption) Validate() error {
|
|
if opt.Time == 0 {
|
|
return fmt.Errorf("no time to add")
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// AddTime adds time to issue with the given index
|
|
func (c *Client) AddTime(owner, repo string, index int64, opt AddTimeOption) (*TrackedTime, *Response, error) {
|
|
if err := c.checkServerVersionGreaterThanOrEqual(version1_11_0); err != nil {
|
|
return nil, nil, err
|
|
}
|
|
if err := opt.Validate(); err != nil {
|
|
return nil, nil, err
|
|
}
|
|
body, err := json.Marshal(&opt)
|
|
if err != nil {
|
|
return nil, nil, err
|
|
}
|
|
t := new(TrackedTime)
|
|
resp, err := c.getParsedResponse("POST",
|
|
fmt.Sprintf("/repos/%s/%s/issues/%d/times", owner, repo, index),
|
|
jsonHeader, bytes.NewReader(body), t)
|
|
return t, resp, err
|
|
}
|
|
|
|
// ListTrackedTimesOptions options for listing repository's tracked times
|
|
type ListTrackedTimesOptions struct {
|
|
ListOptions
|
|
}
|
|
|
|
// ListTrackedTimes list tracked times of a single issue for a given repository
|
|
func (c *Client) ListTrackedTimes(owner, repo string, index int64, opt ListTrackedTimesOptions) ([]*TrackedTime, *Response, error) {
|
|
if err := c.checkServerVersionGreaterThanOrEqual(version1_11_0); err != nil {
|
|
return nil, nil, err
|
|
}
|
|
opt.setDefaults()
|
|
times := make([]*TrackedTime, 0, opt.PageSize)
|
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/issues/%d/times?%s", owner, repo, index, opt.getURLQuery().Encode()), nil, nil, ×)
|
|
return times, resp, err
|
|
}
|
|
|
|
// ResetIssueTime reset tracked time of a single issue for a given repository
|
|
func (c *Client) ResetIssueTime(owner, repo string, index int64) (*Response, error) {
|
|
if err := c.checkServerVersionGreaterThanOrEqual(version1_11_0); err != nil {
|
|
return nil, err
|
|
}
|
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/issues/%d/times", owner, repo, index), nil, nil)
|
|
return resp, err
|
|
}
|
|
|
|
// DeleteTime delete a specific tracked time by id of a single issue for a given repository
|
|
func (c *Client) DeleteTime(owner, repo string, index, timeID int64) (*Response, error) {
|
|
if err := c.checkServerVersionGreaterThanOrEqual(version1_11_0); err != nil {
|
|
return nil, err
|
|
}
|
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/issues/%d/times/%d", owner, repo, index, timeID), nil, nil)
|
|
return resp, err
|
|
}
|