mirror of
https://github.com/woodpecker-ci/woodpecker.git
synced 2024-12-18 08:26:45 +02:00
220 lines
7.7 KiB
Go
220 lines
7.7 KiB
Go
|
// Copyright 2013 The go-github AUTHORS. All rights reserved.
|
||
|
//
|
||
|
// Use of this source code is governed by a BSD-style
|
||
|
// license that can be found in the LICENSE file.
|
||
|
|
||
|
// Repository contents API methods.
|
||
|
// http://developer.github.com/v3/repos/contents/
|
||
|
|
||
|
package github
|
||
|
|
||
|
import (
|
||
|
"encoding/base64"
|
||
|
"encoding/json"
|
||
|
"errors"
|
||
|
"fmt"
|
||
|
"net/http"
|
||
|
"net/url"
|
||
|
)
|
||
|
|
||
|
// RepositoryContent represents a file or directory in a github repository.
|
||
|
type RepositoryContent struct {
|
||
|
Type *string `json:"type,omitempty"`
|
||
|
Encoding *string `json:"encoding,omitempty"`
|
||
|
Size *int `json:"size,omitempty"`
|
||
|
Name *string `json:"name,omitempty"`
|
||
|
Path *string `json:"path,omitempty"`
|
||
|
Content *string `json:"content,omitempty"`
|
||
|
SHA *string `json:"sha,omitempty"`
|
||
|
URL *string `json:"url,omitempty"`
|
||
|
GitURL *string `json:"giturl,omitempty"`
|
||
|
HTMLURL *string `json:"htmlurl,omitempty"`
|
||
|
}
|
||
|
|
||
|
// RepositoryContentResponse holds the parsed response from CreateFile, UpdateFile, and DeleteFile.
|
||
|
type RepositoryContentResponse struct {
|
||
|
Content *RepositoryContent `json:"content,omitempty"`
|
||
|
Commit `json:"commit,omitempty"`
|
||
|
}
|
||
|
|
||
|
// RepositoryContentFileOptions specifies optional parameters for CreateFile, UpdateFile, and DeleteFile.
|
||
|
type RepositoryContentFileOptions struct {
|
||
|
Message *string `json:"message,omitempty"`
|
||
|
Content []byte `json:"content,omitempty"`
|
||
|
SHA *string `json:"sha,omitempty"`
|
||
|
Branch *string `json:"branch,omitempty"`
|
||
|
Author *CommitAuthor `json:"author,omitempty"`
|
||
|
Committer *CommitAuthor `json:"committer,omitempty"`
|
||
|
}
|
||
|
|
||
|
// RepositoryContentGetOptions represents an optional ref parameter, which can be a SHA,
|
||
|
// branch, or tag
|
||
|
type RepositoryContentGetOptions struct {
|
||
|
Ref string `url:"ref,omitempty"`
|
||
|
}
|
||
|
|
||
|
func (r RepositoryContent) String() string {
|
||
|
return Stringify(r)
|
||
|
}
|
||
|
|
||
|
// Decode decodes the file content if it is base64 encoded.
|
||
|
func (r *RepositoryContent) Decode() ([]byte, error) {
|
||
|
if *r.Encoding != "base64" {
|
||
|
return nil, errors.New("cannot decode non-base64")
|
||
|
}
|
||
|
o, err := base64.StdEncoding.DecodeString(*r.Content)
|
||
|
if err != nil {
|
||
|
return nil, err
|
||
|
}
|
||
|
return o, nil
|
||
|
}
|
||
|
|
||
|
// GetReadme gets the Readme file for the repository.
|
||
|
//
|
||
|
// GitHub API docs: http://developer.github.com/v3/repos/contents/#get-the-readme
|
||
|
func (s *RepositoriesService) GetReadme(owner, repo string, opt *RepositoryContentGetOptions) (*RepositoryContent, *Response, error) {
|
||
|
u := fmt.Sprintf("repos/%v/%v/readme", owner, repo)
|
||
|
u, err := addOptions(u, opt)
|
||
|
if err != nil {
|
||
|
return nil, nil, err
|
||
|
}
|
||
|
req, err := s.client.NewRequest("GET", u, nil)
|
||
|
if err != nil {
|
||
|
return nil, nil, err
|
||
|
}
|
||
|
readme := new(RepositoryContent)
|
||
|
resp, err := s.client.Do(req, readme)
|
||
|
if err != nil {
|
||
|
return nil, resp, err
|
||
|
}
|
||
|
return readme, resp, err
|
||
|
}
|
||
|
|
||
|
// GetContents can return either the metadata and content of a single file
|
||
|
// (when path references a file) or the metadata of all the files and/or
|
||
|
// subdirectories of a directory (when path references a directory). To make it
|
||
|
// easy to distinguish between both result types and to mimic the API as much
|
||
|
// as possible, both result types will be returned but only one will contain a
|
||
|
// value and the other will be nil.
|
||
|
//
|
||
|
// GitHub API docs: http://developer.github.com/v3/repos/contents/#get-contents
|
||
|
func (s *RepositoriesService) GetContents(owner, repo, path string, opt *RepositoryContentGetOptions) (fileContent *RepositoryContent,
|
||
|
directoryContent []*RepositoryContent, resp *Response, err error) {
|
||
|
u := fmt.Sprintf("repos/%s/%s/contents/%s", owner, repo, path)
|
||
|
u, err = addOptions(u, opt)
|
||
|
if err != nil {
|
||
|
return nil, nil, nil, err
|
||
|
}
|
||
|
req, err := s.client.NewRequest("GET", u, nil)
|
||
|
if err != nil {
|
||
|
return nil, nil, nil, err
|
||
|
}
|
||
|
var rawJSON json.RawMessage
|
||
|
resp, err = s.client.Do(req, &rawJSON)
|
||
|
if err != nil {
|
||
|
return nil, nil, resp, err
|
||
|
}
|
||
|
fileUnmarshalError := json.Unmarshal(rawJSON, &fileContent)
|
||
|
if fileUnmarshalError == nil {
|
||
|
return fileContent, nil, resp, fileUnmarshalError
|
||
|
}
|
||
|
directoryUnmarshalError := json.Unmarshal(rawJSON, &directoryContent)
|
||
|
if directoryUnmarshalError == nil {
|
||
|
return nil, directoryContent, resp, directoryUnmarshalError
|
||
|
}
|
||
|
return nil, nil, resp, fmt.Errorf("unmarshalling failed for both file and directory content: %s and %s ", fileUnmarshalError, directoryUnmarshalError)
|
||
|
}
|
||
|
|
||
|
// CreateFile creates a new file in a repository at the given path and returns
|
||
|
// the commit and file metadata.
|
||
|
//
|
||
|
// GitHub API docs: http://developer.github.com/v3/repos/contents/#create-a-file
|
||
|
func (s *RepositoriesService) CreateFile(owner, repo, path string, opt *RepositoryContentFileOptions) (*RepositoryContentResponse, *Response, error) {
|
||
|
u := fmt.Sprintf("repos/%s/%s/contents/%s", owner, repo, path)
|
||
|
req, err := s.client.NewRequest("PUT", u, opt)
|
||
|
if err != nil {
|
||
|
return nil, nil, err
|
||
|
}
|
||
|
createResponse := new(RepositoryContentResponse)
|
||
|
resp, err := s.client.Do(req, createResponse)
|
||
|
if err != nil {
|
||
|
return nil, resp, err
|
||
|
}
|
||
|
return createResponse, resp, err
|
||
|
}
|
||
|
|
||
|
// UpdateFile updates a file in a repository at the given path and returns the
|
||
|
// commit and file metadata. Requires the blob SHA of the file being updated.
|
||
|
//
|
||
|
// GitHub API docs: http://developer.github.com/v3/repos/contents/#update-a-file
|
||
|
func (s *RepositoriesService) UpdateFile(owner, repo, path string, opt *RepositoryContentFileOptions) (*RepositoryContentResponse, *Response, error) {
|
||
|
u := fmt.Sprintf("repos/%s/%s/contents/%s", owner, repo, path)
|
||
|
req, err := s.client.NewRequest("PUT", u, opt)
|
||
|
if err != nil {
|
||
|
return nil, nil, err
|
||
|
}
|
||
|
updateResponse := new(RepositoryContentResponse)
|
||
|
resp, err := s.client.Do(req, updateResponse)
|
||
|
if err != nil {
|
||
|
return nil, resp, err
|
||
|
}
|
||
|
return updateResponse, resp, err
|
||
|
}
|
||
|
|
||
|
// DeleteFile deletes a file from a repository and returns the commit.
|
||
|
// Requires the blob SHA of the file to be deleted.
|
||
|
//
|
||
|
// GitHub API docs: http://developer.github.com/v3/repos/contents/#delete-a-file
|
||
|
func (s *RepositoriesService) DeleteFile(owner, repo, path string, opt *RepositoryContentFileOptions) (*RepositoryContentResponse, *Response, error) {
|
||
|
u := fmt.Sprintf("repos/%s/%s/contents/%s", owner, repo, path)
|
||
|
req, err := s.client.NewRequest("DELETE", u, opt)
|
||
|
if err != nil {
|
||
|
return nil, nil, err
|
||
|
}
|
||
|
deleteResponse := new(RepositoryContentResponse)
|
||
|
resp, err := s.client.Do(req, deleteResponse)
|
||
|
if err != nil {
|
||
|
return nil, resp, err
|
||
|
}
|
||
|
return deleteResponse, resp, err
|
||
|
}
|
||
|
|
||
|
// archiveFormat is used to define the archive type when calling GetArchiveLink.
|
||
|
type archiveFormat string
|
||
|
|
||
|
const (
|
||
|
// Tarball specifies an archive in gzipped tar format.
|
||
|
Tarball archiveFormat = "tarball"
|
||
|
|
||
|
// Zipball specifies an archive in zip format.
|
||
|
Zipball archiveFormat = "zipball"
|
||
|
)
|
||
|
|
||
|
// GetArchiveLink returns an URL to download a tarball or zipball archive for a
|
||
|
// repository. The archiveFormat can be specified by either the github.Tarball
|
||
|
// or github.Zipball constant.
|
||
|
//
|
||
|
// GitHub API docs: http://developer.github.com/v3/repos/contents/#get-archive-link
|
||
|
func (s *RepositoriesService) GetArchiveLink(owner, repo string, archiveformat archiveFormat, opt *RepositoryContentGetOptions) (*url.URL, *Response, error) {
|
||
|
u := fmt.Sprintf("repos/%s/%s/%s", owner, repo, archiveformat)
|
||
|
if opt != nil && opt.Ref != "" {
|
||
|
u += fmt.Sprintf("/%s", opt.Ref)
|
||
|
}
|
||
|
req, err := s.client.NewRequest("GET", u, nil)
|
||
|
if err != nil {
|
||
|
return nil, nil, err
|
||
|
}
|
||
|
var resp *http.Response
|
||
|
// Use http.DefaultTransport if no custom Transport is configured
|
||
|
if s.client.client.Transport == nil {
|
||
|
resp, err = http.DefaultTransport.RoundTrip(req)
|
||
|
} else {
|
||
|
resp, err = s.client.client.Transport.RoundTrip(req)
|
||
|
}
|
||
|
if err != nil || resp.StatusCode != http.StatusFound {
|
||
|
return nil, newResponse(resp), err
|
||
|
}
|
||
|
parsedURL, err := url.Parse(resp.Header.Get("Location"))
|
||
|
return parsedURL, newResponse(resp), err
|
||
|
}
|