gitapi

package module
v1.6.4 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 1, 2025 License: MIT Imports: 9 Imported by: 2

README

go-gitapi Paypal donate

Golang Github/Gitea api library.

Table Of Content
Features
  • API action
    • Do
    • Get
    • Del
    • Patch
    • Post
    • Put
gitApi.go
  • type GitApiReq struct
  • func (gaReq *GitApiReq) UrlValInit()
  • type GitApiRes struct
  • func (gaRes *GitApiRes) Ok() bool
  • type GitApi struct
  • func GitApiNew(
  • func (ga *GitApi) Ok() bool
  • func (ga *GitApi) Output() *string
  • func (ga *GitApi) Err() *string
  • func (ga *GitApi) EndpointUserRepos() *GitApi
  • func (ga *GitApi) EndpointRepos() *GitApi
  • func (ga *GitApi) EndpointReposTopics() *GitApi
  • func (ga *GitApi) EndpointReposSecrets() *GitApi
  • func (ga *GitApi) EndpointReposSecretsPubkey() *GitApi
  • func (ga *GitApi) HeaderGithub() *GitApi
  • func (ga *GitApi) HeaderInit() *GitApi
  • func (ga *GitApi) Do() *GitApi
  • func (ga *GitApi) Get() *GitApi
  • func (ga *GitApi) Del() *GitApi
  • func (ga *GitApi) Patch() *GitApi
  • func (ga *GitApi) Post() *GitApi
  • func (ga *GitApi) Put() *GitApi
  • func (ga *GitApi) SetGet() *GitApi
  • func (ga *GitApi) SetDel() *GitApi
  • func (ga *GitApi) SetPatch() *GitApi
  • func (ga *GitApi) SetPost() *GitApi
  • func (ga *GitApi) SetPut() *GitApi
  • func (ga *GitApi) ProcessOutput() *GitApi
  • func (ga *GitApi) ProcessOutputError() *GitApi
  • func (ga *GitApi) ProcessError() *GitApi
gitApiDataStruct.go
  • type RepoEncryptedPair struct
  • func (rEncryptedPair *RepoEncryptedPair) StringP() *string
  • func (rEncryptedPair *RepoEncryptedPair) String() string
  • type RepoPublicKey struct
  • func (rPKey *RepoPublicKey) StringP() *string
  • func (rPKey *RepoPublicKey) String() string
  • type RepoPrivate struct
  • func (rPrivate *RepoPrivate) StringP() *string
  • func (rPrivate *RepoPrivate) String() string
  • type RepoVisibility struct
  • func (rVisibility *RepoVisibility) StringP() *string
  • func (rVisibility *RepoVisibility) String() string
  • type RepoDescription struct
  • func (rDesc *RepoDescription) StringP() *string
  • func (rDesc *RepoDescription) String() string
  • type RepoTopics struct
  • func (rTopics *RepoTopics) StringP() *string
  • func (rTopics *RepoTopics) String() string
  • type RepoInfo struct
  • func (rInfo *RepoInfo) StringP() *string
  • func (rInfo *RepoInfo) String() string
  • type RepoError struct
  • func (rError *RepoError) StringP() *string
  • func (rError *RepoError) String() string
  • type RepoInfoList []RepoInfo
  • func (rInfoList *RepoInfoList) StringP() *string
  • func (rInfoList *RepoInfoList) String() string
  • type NilType struct
  • func (nilT *NilType) StringP() *string
  • func (nilT *NilType) String() string
  • func Nil() *NilType
  • type GitApiInfo interface
Pro
  • Easy to extend
  • Small size
Doc
Dependency
Supported git repository services
  • gitea
  • github
  • gogs
Usage Example

Following is code to create a new repository:

  1. Prepare a GitApi data structure

    var info gitapi.RepoInfo
info.Name = "test"
info.Private = remote.Private

  2. Setup and execute

    // Get instance
gitApi := gitapi.GitApiNew(
  "Test",   // Connection name for debug print out purpose
  "01234567890123456789012345678912", // API token,
  "https://api.github.com", // API entrypoint
  "User",  // user
  "github", // vendor/brand
  &info)    // data for request
// Setup endpoint
gitApi.EndpointRepos()
// Setup Github header
gitApi.HeaderGithub()
// Set http method: Post
gitApi.SetPost()
// Do request
success := gitApi.Do().Ok()

  3. Print out using helper function

    helper.ReportStatus(success, gitApi.Name, false, true)
helper.Report(gitApi.Output(), gitApi.Name, false, true)
Debug

Enable debug

helper.Debug = true
Used By Project
Repository
Contributors
Change Log
  • v1.0.0
    • Feature complete
  • v1.0.1
    • Fix data struct *.StringP() output
  • v1.1.0
    • Consolidate output processing
  • v1.2.0
    • GitApiOut
      • move output from GitApi
      • add Success GitApi struct
      • Change Header to non-pointer
      • Use path and url package to handle endpoint and url
      • Add HeaderGithub()
  • v1.2.4
    • Update go-helper package for bug fix
  • v1.2.5
    • GitApiIn
      • Add UrlVal(url.Values)
  • v1.2.6
    • Update go-helper package for bug fix
  • v1.3.0
    • All GitApi methods reutrn self pointer
    • Interface GitApiInfo remove type restrictions
    • Member GitApi.In -> GitApi.Req
    • Member GitApi.Out -> GitApi.Res
    • Type GitApiIn -> GitApiReq
    • Type GitApiOut -> GitApiRes
  • v1.3.1
    • Improve README.md
  • v1.3.2
    • Fix GitApi.Do() wiping GitApi.Req.Data if GitApi.Info is nil
  • v1.4.0
    • upgrade helper to 1.1.6
    • GitApi struct and GitApiMew()
      • add SkipVerify to support self-signed cert
  • v1.4.1
    • GitApi.ProcessOutput() - Fix output for full info
    • Use proper receiver name
  • v1.5.0
    • Add RepoError struct
    • Handle http error: ProcessError()
    • Handle API error: ProcessOutputError()
  • v1.6.0
    • gitApi.go
      • Move Method(http) from GitApiReq -> GitApi
      • GitApi struct
        • Add SetGet(), SetDel(), SetPatch(), SetPost(), SetPut()
        • Add .Res wrapper func Err(), Ok(), Output()
  • v1.6.1
    • Update go-helper
  • v1.6.2
    • Update go-helper/v2
  • v1.6.3
    • Update go-helper/v2
  • v1.6.4
    • Update go-helper/v2
    • Add GitApi.New()
    • Breaking: Standardize package level GitApiNew() -> New()
License

The MIT License (MIT)

Copyright © 2025 John, Sing Dao, Siu [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Documentation

Index

Constants

View Source 
const (
	Vendor_Github = "github"
	Vendor_Gitea  = "gitea"
	Vendor_Gogs   = "gogs"
)

GitApi supperted vendors

Variables

This section is empty.

Functions

This section is empty.

Types

type GitApi 

type GitApi struct {
	Method     string     `json:"Method"`     // Http request method
	SkipVerify bool       `json:"skipverify"` // Api request skip cert verify (allow self-signed cert)
	Vendor     string     `json:"Vendor"`     // github/gitea
	Name       string     `json:"Name"`       // Name of connection
	Repo       string     `json:"Repo"`       // Repository name
	User       string     `json:"User"`       // Api username
	Req        GitApiReq  `json:"In"`         // Api http input
	Res        GitApiRes  `json:"Out"`        // Api http output
	Info       GitApiInfo `json:"Info"`       // Pointer to structure. Use NilType.Nil() for nil pointer
}

GitApi

func New added in v1.6.4 

func New(name string, token string, entrypoint string, user string, vendor string, skipVerify bool, repo string, info GitApiInfo) *GitApi

Setup a *GitApi

func (*GitApi) Body added in v1.6.1 

func (ga *GitApi) Body() *string

Return Res.Body

func (*GitApi) Del 

func (ga *GitApi) Del() *GitApi

GitApi Del action wrapper

func (*GitApi) Do 

func (ga *GitApi) Do() *GitApi

Execute http request using info in GitApi.Req. Then put response info in GitApi.Res. 

GitApi.Info, if not nil, will be
		- auto marshal for send other than "GET"
		- auto unmarshal from http response body

func (*GitApi) EndpointRepos 

func (ga *GitApi) EndpointRepos() *GitApi

Initialize endpoint /repos/OWNER/REPO

Use current directory if GitApi.Repo is empty

func (*GitApi) EndpointReposSecrets 

func (ga *GitApi) EndpointReposSecrets() *GitApi

Initialize endpoint /repos/OWNER/REPO/actions/secrets

func (*GitApi) EndpointReposSecretsPubkey 

func (ga *GitApi) EndpointReposSecretsPubkey() *GitApi

Initialize endpoint /repos/OWNER/REPO/actions/secrets/public-key

func (*GitApi) EndpointReposTopics 

func (ga *GitApi) EndpointReposTopics() *GitApi

Initialize endpoint /repos/OWNER/REPO/topics

func (*GitApi) EndpointUserRepos 

func (ga *GitApi) EndpointUserRepos() *GitApi

Initialize endpoint /user/repos

func (*GitApi) Err added in v1.6.0 

func (ga *GitApi) Err() *string

Return Res.Err

func (*GitApi) Get 

func (ga *GitApi) Get() *GitApi

GitApi Get action wrapper

func (*GitApi) HeaderGithub added in v1.2.0 

func (ga *GitApi) HeaderGithub() *GitApi

Set github/gitea header

GitApi.Req.Token, if empty, authorization header will not be set.

func (*GitApi) HeaderInit added in v1.2.5 

func (ga *GitApi) HeaderInit() *GitApi

Setup empty API header

func (*GitApi) New added in v1.6.4 

func (ga *GitApi) New(name string, token string, entrypoint string, user string, vendor string, skipVerify bool, repo string, info GitApiInfo) *GitApi

Setup a *GitApi

func (*GitApi) Ok added in v1.6.0 

func (ga *GitApi) Ok() bool

Return Res.Ok()

func (*GitApi) Output 

func (ga *GitApi) Output() *string

Return Res.Output

func (*GitApi) Patch 

func (ga *GitApi) Patch() *GitApi

GitApi Patch action wrapper

func (*GitApi) Post 

func (ga *GitApi) Post() *GitApi

GitApi Post action wrapper

func (*GitApi) ProcessError added in v1.5.0 

func (ga *GitApi) ProcessError() *GitApi

Print HTTP Body Err into string pointer

func (*GitApi) ProcessOutput added in v1.1.0 

func (ga *GitApi) ProcessOutput() *GitApi

Print HTTP Body into string pointer

func (*GitApi) ProcessOutputError added in v1.5.0 

func (ga *GitApi) ProcessOutputError() *GitApi

Print HTTP Body into string pointer

func (*GitApi) Put 

func (ga *GitApi) Put() *GitApi

GitApi Put action wrapper

func (*GitApi) SetDel added in v1.6.0 

func (ga *GitApi) SetDel() *GitApi

GitApi set http Del

func (*GitApi) SetGet added in v1.6.0 

func (ga *GitApi) SetGet() *GitApi

func (*GitApi) SetPatch added in v1.6.0 

func (ga *GitApi) SetPatch() *GitApi

GitApi set http Patch

func (*GitApi) SetPost added in v1.6.0 

func (ga *GitApi) SetPost() *GitApi

GitApi set http Post

func (*GitApi) SetPut added in v1.6.0 

func (ga *GitApi) SetPut() *GitApi

GitApi set http Put

type GitApiInfo 

type GitApiInfo interface {
	// *RepoEncryptedPair |
	// *RepoPublicKey |
	// *RepoPrivate |
	// *RepoVisibility |
	// *RepoDescription |
	// *RepoTopics |
	// *RepoInfo |
	// *RepoInfoList |
	// *NilType
	StringP() *string
	String() string
}

GitApi structures interface

type GitApiReq added in v1.3.0 

type GitApiReq struct {
	Entrypoint string       `json:"Entrypoint"` // Api base url
	Endpoint   string       `json:"Endpoint"`   // Api endpoint
	Token      string       `json:"Token"`      // Api auth token
	Header     *http.Header `json:"Header"`     // Http request header
	UrlVal     *url.Values  `json:"UrlVal"`     // Api url values
	Data       string       `json:"Data"`       // Json marshaled Info
}

GitApi http input structure

func (*GitApiReq) UrlValInit added in v1.3.0 

func (gaReq *GitApiReq) UrlValInit()

Setup empty API url values

type GitApiRes added in v1.3.0 

type GitApiRes struct {
	Url    *url.URL     `json:"Url"`    // In.Uri + In.Endpoint
	Header *http.Header `json:"Header"` // Http response header
	Status string       `json:"Status"` // Http response status
	Body   *[]byte      `json:"Body"`
	Output *string      `json:"Output"` // Api response body in string
	Err    string       `json:"Err"`
}

GitApi http output structure

func (*GitApiRes) Ok added in v1.3.0 

func (gaRes *GitApiRes) Ok() bool

Check response status == 2xx

type NilType 

type NilType struct {
	Nil *byte // Dummy pointer
}

This is used as a dummy type for nil GitApiInfo parameter

func Nil 

func Nil() *NilType

Return a *NilType(nil) dummy pointer

func (*NilType) String 

func (nilT *NilType) String() string

func (*NilType) StringP 

func (nilT *NilType) StringP() *string

type RepoDescription 

type RepoDescription struct {
	Description string `json:"description"`
}

Github repository description structure

func (*RepoDescription) String 

func (rDesc *RepoDescription) String() string

func (*RepoDescription) StringP 

func (rDesc *RepoDescription) StringP() *string

type RepoEncryptedPair 

type RepoEncryptedPair struct {
	Encrypted_value string `json:"encrypted_value"` // Encrypted value
	Key_id          string `json:"key_id"`          // Public key id
}

Github repository action secret structure

func (*RepoEncryptedPair) String 

func (rEncryptedPair *RepoEncryptedPair) String() string

func (*RepoEncryptedPair) StringP 

func (rEncryptedPair *RepoEncryptedPair) StringP() *string

type RepoError added in v1.5.0 

type RepoError struct {
	Errors  string `json:"errors"`
	Message string `json:"message"`
	Status  string `json:"status"`
}

Github uses message and status. Gitea uses message and errors.

func (*RepoError) String added in v1.5.0 

func (rError *RepoError) String() string

func (*RepoError) StringP added in v1.5.0 

func (rError *RepoError) StringP() *string

type RepoInfo 

type RepoInfo struct {
	Name    string `json:"name"`
	Private bool   `json:"private"`
}

Github repository(creation) info structure

func (*RepoInfo) String 

func (rInfo *RepoInfo) String() string

func (*RepoInfo) StringP 

func (rInfo *RepoInfo) StringP() *string

type RepoInfoList 

type RepoInfoList []RepoInfo

Github repository(creation) info array

func (*RepoInfoList) String 

func (rInfoList *RepoInfoList) String() string

func (*RepoInfoList) StringP 

func (rInfoList *RepoInfoList) StringP() *string

type RepoPrivate 

type RepoPrivate struct {
	Private bool `json:"private"`
}

Github repository private structure

func (*RepoPrivate) String 

func (rPrivate *RepoPrivate) String() string

func (*RepoPrivate) StringP 

func (rPrivate *RepoPrivate) StringP() *string

type RepoPublicKey 

type RepoPublicKey struct {
	Key_id string `json:"key_id"`
	Key    string `json:"key"`
}

Github repository public key structure

func (*RepoPublicKey) String 

func (rPKey *RepoPublicKey) String() string

func (*RepoPublicKey) StringP 

func (rPKey *RepoPublicKey) StringP() *string

type RepoTopics 

type RepoTopics struct {
	Topics *[]string `json:"topics"` // Github topics is "Topics"
	Names  *[]string `json:"names"`  // Gitea topics is "Names"
}

Github repository topics structure

func (*RepoTopics) String 

func (rTopics *RepoTopics) String() string

func (*RepoTopics) StringP 

func (rTopics *RepoTopics) StringP() *string

type RepoVisibility 

type RepoVisibility struct {
	Visibility string `json:"visibility"`
}

Github repository visibility structure

func (*RepoVisibility) String 

func (rVisibility *RepoVisibility) String() string

func (*RepoVisibility) StringP 

func (rVisibility *RepoVisibility) StringP() *string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.