11e0aa8cd4
* Added assets (attachments) to the releases. - Added three new endpoints to the release api for attachments. - List assets: GET /repos/:owner/:repo/releases/:id/assets - Get single asset: GET /repos/:owner/:repo/releases/assets/:id - Get /repos/:owner/:repo/releases/latest` that gets the latest published full release for the repository. Draft releases and prereleases are not returned by this endpoint. Signed-off-by: Petrisor Lacatus <placatus@ptc.com>
130 lines
4.1 KiB
Go
130 lines
4.1 KiB
Go
// Copyright 2016 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"
|
|
)
|
|
|
|
// Release represents a repository release
|
|
type Release struct {
|
|
ID int64 `json:"id"`
|
|
TagName string `json:"tag_name"`
|
|
Target string `json:"target_commitish"`
|
|
Title string `json:"name"`
|
|
Note string `json:"body"`
|
|
URL string `json:"url"`
|
|
TarURL string `json:"tarball_url"`
|
|
ZipURL string `json:"zipball_url"`
|
|
IsDraft bool `json:"draft"`
|
|
IsPrerelease bool `json:"prerelease"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
PublishedAt time.Time `json:"published_at"`
|
|
Publisher *User `json:"author"`
|
|
Attachments []*Attachment `json:"assets"`
|
|
}
|
|
|
|
// ListReleases list releases of a repository
|
|
func (c *Client) ListReleases(user, repo string) ([]*Release, error) {
|
|
releases := make([]*Release, 0, 10)
|
|
err := c.getParsedResponse("GET",
|
|
fmt.Sprintf("/repos/%s/%s/releases", user, repo),
|
|
nil, nil, &releases)
|
|
return releases, err
|
|
}
|
|
|
|
// GetRelease get a release of a repository
|
|
func (c *Client) GetRelease(user, repo string, id int64) (*Release, error) {
|
|
r := new(Release)
|
|
err := c.getParsedResponse("GET",
|
|
fmt.Sprintf("/repos/%s/%s/releases/%d", user, repo, id),
|
|
nil, nil, &r)
|
|
return r, err
|
|
}
|
|
|
|
// ListReleaseAttachments gets all the assets of a release in a repository
|
|
func (c *Client) ListReleaseAttachments(user, repo string, id int64) ([]*Attachment, error) {
|
|
attachments := make([]*Attachment, 0, 10)
|
|
err := c.getParsedResponse("GET",
|
|
fmt.Sprintf("/repos/%s/%s/releases/%d/assets", user, repo, id),
|
|
nil, nil, &attachments)
|
|
return attachments, err
|
|
}
|
|
|
|
// GetReleaseAttachment gets a single attachment of a release in a repository
|
|
func (c *Client) GetReleaseAttachment(user, repo string, releaseID int64, attachmentID int64) (*Attachment, error) {
|
|
attachment := new(Attachment)
|
|
err := c.getParsedResponse("GET",
|
|
fmt.Sprintf("/repos/%s/%s/releases/%d/assets/%d", user, repo, releaseID, attachmentID),
|
|
nil, nil, &attachment)
|
|
return attachment, err
|
|
}
|
|
|
|
// GetLatestRelease gets the latest release in a repository. This cannot be a draft or prerelease
|
|
func (c *Client) GetLatestRelease(user, repo string) (*Release, error) {
|
|
r := new(Release)
|
|
err := c.getParsedResponse("GET",
|
|
fmt.Sprintf("/repos/%s/%s/releases/latest", user, repo),
|
|
nil, nil, &r)
|
|
return r, err
|
|
}
|
|
|
|
// CreateReleaseOption options when creating a release
|
|
type CreateReleaseOption struct {
|
|
TagName string `json:"tag_name" binding:"Required"`
|
|
Target string `json:"target_commitish"`
|
|
Title string `json:"name"`
|
|
Note string `json:"body"`
|
|
IsDraft bool `json:"draft"`
|
|
IsPrerelease bool `json:"prerelease"`
|
|
}
|
|
|
|
// CreateRelease create a release
|
|
func (c *Client) CreateRelease(user, repo string, form CreateReleaseOption) (*Release, error) {
|
|
body, err := json.Marshal(form)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
r := new(Release)
|
|
err = c.getParsedResponse("POST",
|
|
fmt.Sprintf("/repos/%s/%s/releases", user, repo),
|
|
jsonHeader, bytes.NewReader(body), r)
|
|
return r, err
|
|
}
|
|
|
|
// EditReleaseOption options when editing a release
|
|
type EditReleaseOption struct {
|
|
TagName string `json:"tag_name"`
|
|
Target string `json:"target_commitish"`
|
|
Title string `json:"name"`
|
|
Note string `json:"body"`
|
|
IsDraft *bool `json:"draft"`
|
|
IsPrerelease *bool `json:"prerelease"`
|
|
}
|
|
|
|
// EditRelease edit a release
|
|
func (c *Client) EditRelease(user, repo string, id int64, form EditReleaseOption) (*Release, error) {
|
|
body, err := json.Marshal(form)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
r := new(Release)
|
|
err = c.getParsedResponse("PATCH",
|
|
fmt.Sprintf("/repos/%s/%s/releases/%d", user, repo, id),
|
|
jsonHeader, bytes.NewReader(body), r)
|
|
return r, err
|
|
}
|
|
|
|
// DeleteRelease delete a release from a repository
|
|
func (c *Client) DeleteRelease(user, repo string, id int64) error {
|
|
_, err := c.getResponse("DELETE",
|
|
fmt.Sprintf("/repos/%s/%s/releases/%d", user, repo, id),
|
|
nil, nil)
|
|
return err
|
|
}
|