fix most of all the lint errors

gitea/admin_org.go

@@ -10,6 +10,7 @@ import (
 	"fmt"
 )
 
+// AdminCreateOrg create an organization
 func (c *Client) AdminCreateOrg(user string, opt CreateOrgOption) (*Organization, error) {
 	body, err := json.Marshal(&opt)
 	if err != nil {

gitea/admin_repo.go

@@ -10,6 +10,7 @@ import (
 	"fmt"
 )
 
+// AdminCreateRepo create a repo
 func (c *Client) AdminCreateRepo(user string, opt CreateRepoOption) (*Repository, error) {
 	body, err := json.Marshal(&opt)
 	if err != nil {

gitea/admin_user.go

@@ -10,6 +10,7 @@ import (
 	"fmt"
 )
 
+// CreateUserOption create user options
 type CreateUserOption struct {
 	SourceID   int64  `json:"source_id"`
 	LoginName  string `json:"login_name"`
@@ -20,6 +21,7 @@ type CreateUserOption struct {
 	SendNotify bool   `json:"send_notify"`
 }
 
+// AdminCreateUser create a user
 func (c *Client) AdminCreateUser(opt CreateUserOption) (*User, error) {
 	body, err := json.Marshal(&opt)
 	if err != nil {
@@ -29,6 +31,7 @@ func (c *Client) AdminCreateUser(opt CreateUserOption) (*User, error) {
 	return user, c.getParsedResponse("POST", "/admin/users", jsonHeader, bytes.NewReader(body), user)
 }
 
+// EditUserOption edit user options
 type EditUserOption struct {
 	SourceID         int64  `json:"source_id"`
 	LoginName        string `json:"login_name"`
@@ -44,6 +47,7 @@ type EditUserOption struct {
 	MaxRepoCreation  *int   `json:"max_repo_creation"`
 }
 
+// AdminEditUser modify user informations
 func (c *Client) AdminEditUser(user string, opt EditUserOption) error {
 	body, err := json.Marshal(&opt)
 	if err != nil {
@@ -53,11 +57,13 @@ func (c *Client) AdminEditUser(user string, opt EditUserOption) error {
 	return err
 }
 
+// AdminDeleteUser delete one user according name
 func (c *Client) AdminDeleteUser(user string) error {
 	_, err := c.getResponse("DELETE", fmt.Sprintf("/admin/users/%s", user), nil, nil)
 	return err
 }
 
+// AdminCreateUserPublicKey create one user with options
 func (c *Client) AdminCreateUserPublicKey(user string, opt CreateKeyOption) (*PublicKey, error) {
 	body, err := json.Marshal(&opt)
 	if err != nil {

gitea/gitea.go

@@ -13,6 +13,7 @@ import (
 	"strings"
 )
 
+// Version return the library version
 func Version() string {
 	return "0.12.3"
 }

gitea/issue.go

@@ -11,49 +11,58 @@ import (
 	"time"
 )
 
-type StateType string
+// PRStateType issue state type
+type PRStateType string
 
 const (
-	STATE_OPEN   StateType = "open"
-	STATE_CLOSED StateType = "closed"
+	// PRStateOpen pr is opend
+	PRStateOpen PRStateType = "open"
+	// PRStateClosed pr is closed
+	PRStateClosed PRStateType = "closed"
 )
 
+// PullRequestMeta PR info if an issue is a PR
 type PullRequestMeta struct {
 	HasMerged bool       `json:"merged"`
 	Merged    *time.Time `json:"merged_at"`
 }
 
+// Issue an issue to a repository
 type Issue struct {
-	ID        int64      `json:"id"`
-	Index     int64      `json:"number"`
-	Poster    *User      `json:"user"`
-	Title     string     `json:"title"`
-	Body      string     `json:"body"`
-	Labels    []*Label   `json:"labels"`
-	Milestone *Milestone `json:"milestone"`
-	Assignee  *User      `json:"assignee"`
-	State     StateType  `json:"state"`
-	Comments  int        `json:"comments"`
-	Created   time.Time  `json:"created_at"`
-	Updated   time.Time  `json:"updated_at"`
+	ID        int64       `json:"id"`
+	Index     int64       `json:"number"`
+	Poster    *User       `json:"user"`
+	Title     string      `json:"title"`
+	Body      string      `json:"body"`
+	Labels    []*Label    `json:"labels"`
+	Milestone *Milestone  `json:"milestone"`
+	Assignee  *User       `json:"assignee"`
+	State     PRStateType `json:"state"`
+	Comments  int         `json:"comments"`
+	Created   time.Time   `json:"created_at"`
+	Updated   time.Time   `json:"updated_at"`
 
 	PullRequest *PullRequestMeta `json:"pull_request"`
 }
 
+// ListIssueOption list issue options
 type ListIssueOption struct {
 	Page int
 }
 
+// ListRepoIssues list one repos' issues
 func (c *Client) ListRepoIssues(owner, repo string, opt ListIssueOption) ([]*Issue, error) {
 	issues := make([]*Issue, 0, 10)
 	return issues, c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/issues?page=%d", owner, repo, opt.Page), nil, nil, &issues)
 }
 
+// GetIssue get some one issue of repository
 func (c *Client) GetIssue(owner, repo string, index int64) (*Issue, error) {
 	issue := new(Issue)
 	return issue, c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/issues/%d", owner, repo, index), nil, nil, issue)
 }
 
+// CreateIssueOption options to create one issue
 type CreateIssueOption struct {
 	Title     string  `json:"title" binding:"Required"`
 	Body      string  `json:"body"`
@@ -63,6 +72,7 @@ type CreateIssueOption struct {
 	Closed    bool    `json:"closed"`
 }
 
+// CreateIssue create an issue with options
 func (c *Client) CreateIssue(owner, repo string, opt CreateIssueOption) (*Issue, error) {
 	body, err := json.Marshal(&opt)
 	if err != nil {
@@ -73,6 +83,7 @@ func (c *Client) CreateIssue(owner, repo string, opt CreateIssueOption) (*Issue,
 		jsonHeader, bytes.NewReader(body), issue)
 }
 
+// EditIssueOption edit issue options
 type EditIssueOption struct {
 	Title     string  `json:"title"`
 	Body      *string `json:"body"`
@@ -81,6 +92,7 @@ type EditIssueOption struct {
 	State     *string `json:"state"`
 }
 
+// EditIssue modify an issue of repository
 func (c *Client) EditIssue(owner, repo string, index int64, opt EditIssueOption) (*Issue, error) {
 	body, err := json.Marshal(&opt)
 	if err != nil {

gitea/issue_label.go

@@ -10,27 +10,33 @@ import (
 	"fmt"
 )
 
+// Label a label to an issue or a pr
 type Label struct {
 	ID    int64  `json:"id"`
 	Name  string `json:"name"`
 	Color string `json:"color"`
 }
 
+// ListRepoLabels list lables of one reppsitory
 func (c *Client) ListRepoLabels(owner, repo string) ([]*Label, error) {
 	labels := make([]*Label, 0, 10)
 	return labels, c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/labels", owner, repo), nil, nil, &labels)
 }
 
+// GetRepoLabel get one label of repository by repo it
+// TODO: maybe we need get a label by name
 func (c *Client) GetRepoLabel(owner, repo string, id int64) (*Label, error) {
 	label := new(Label)
 	return label, c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/labels/%d", owner, repo, id), nil, nil, label)
 }
 
+// CreateLabelOption create options when one label of repository
 type CreateLabelOption struct {
 	Name  string `json:"name" binding:"Required"`
 	Color string `json:"color" binding:"Required;Size(7)"`
 }
 
+// CreateLabel create one label of repository
 func (c *Client) CreateLabel(owner, repo string, opt CreateLabelOption) (*Label, error) {
 	body, err := json.Marshal(&opt)
 	if err != nil {
@@ -41,11 +47,13 @@ func (c *Client) CreateLabel(owner, repo string, opt CreateLabelOption) (*Label,
 		jsonHeader, bytes.NewReader(body), label)
 }
 
+// EditLabelOption edit label options
 type EditLabelOption struct {
 	Name  *string `json:"name"`
 	Color *string `json:"color"`
 }
 
+// EditLabel modify one label with options
 func (c *Client) EditLabel(owner, repo string, id int64, opt EditLabelOption) (*Label, error) {
 	body, err := json.Marshal(&opt)
 	if err != nil {
@@ -55,43 +63,52 @@ func (c *Client) EditLabel(owner, repo string, id int64, opt EditLabelOption) (*
 	return label, c.getParsedResponse("PATCH", fmt.Sprintf("/repos/%s/%s/labels/%d", owner, repo, id), jsonHeader, bytes.NewReader(body), label)
 }
 
+// DeleteLabel delete one label of repository by id
+// TODO: maybe we need delete by name
 func (c *Client) DeleteLabel(owner, repo string, id int64) error {
 	_, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/labels/%d", owner, repo, id), nil, nil)
 	return err
 }
 
+// IssueLabelsOption list one issue's labels options
 type IssueLabelsOption struct {
 	Labels []int64 `json:"labels"`
 }
 
+// GetIssueLabels get labels of one issue via issue id
 func (c *Client) GetIssueLabels(owner, repo string, index int64) ([]*Label, error) {
 	labels := make([]*Label, 0, 5)
 	return labels, c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/issues/%d/labels", owner, repo, index), nil, nil, &labels)
 }
 
+// AddIssueLabels add one or more labels to one issue
 func (c *Client) AddIssueLabels(owner, repo string, index int64, opt IssueLabelsOption) ([]*Label, error) {
 	body, err := json.Marshal(&opt)
 	if err != nil {
 		return nil, err
 	}
-	labels := make([]*Label, 0)
+	var labels []*Label
 	return labels, c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/issues/%d/labels", owner, repo, index), jsonHeader, bytes.NewReader(body), &labels)
 }
 
+// ReplaceIssueLabels replace old labels of issue with new labels
 func (c *Client) ReplaceIssueLabels(owner, repo string, index int64, opt IssueLabelsOption) ([]*Label, error) {
 	body, err := json.Marshal(&opt)
 	if err != nil {
 		return nil, err
 	}
-	labels := make([]*Label, 0)
+	var labels []*Label
 	return labels, c.getParsedResponse("PUT", fmt.Sprintf("/repos/%s/%s/issues/%d/labels", owner, repo, index), jsonHeader, bytes.NewReader(body), &labels)
 }
 
+// DeleteIssueLabel delete one label of one issue by issue id and label id
+// TODO: maybe we need delete by label name and issue id
 func (c *Client) DeleteIssueLabel(owner, repo string, index, label int64) error {
 	_, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/issues/%d/labels/%d", owner, repo, index, label), nil, nil)
 	return err
 }
 
+// ClearIssueLabels delete all the labels of one issue.
 func (c *Client) ClearIssueLabels(owner, repo string, index int64) error {
 	_, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/issues/%d/labels", owner, repo, index), nil, nil)
 	return err

gitea/issue_milestone.go

@@ -11,6 +11,7 @@ import (
 	"time"
 )
 
+// Milestone milestone is a collection of issues on one repository
 type Milestone struct {
 	ID           int64      `json:"id"`
 	Title        string     `json:"title"`
@@ -22,22 +23,26 @@ type Milestone struct {
 	Deadline     *time.Time `json:"due_on"`
 }
 
+// ListRepoMilestones list all the milestones of one repository
 func (c *Client) ListRepoMilestones(owner, repo string) ([]*Milestone, error) {
 	milestones := make([]*Milestone, 0, 10)
 	return milestones, c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/milestones", owner, repo), nil, nil, &milestones)
 }
 
+// GetMilestone get one milestone by repo name and milestone id
 func (c *Client) GetMilestone(owner, repo string, id int64) (*Milestone, error) {
 	milestone := new(Milestone)
 	return milestone, c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/milestones/%d", owner, repo, id), nil, nil, milestone)
 }
 
+// CreateMilestoneOption options when creating milestone
 type CreateMilestoneOption struct {
 	Title       string     `json:"title"`
 	Description string     `json:"description"`
 	Deadline    *time.Time `json:"due_on"`
 }
 
+// CreateMilestone create one milestone with options
 func (c *Client) CreateMilestone(owner, repo string, opt CreateMilestoneOption) (*Milestone, error) {
 	body, err := json.Marshal(&opt)
 	if err != nil {
@@ -47,13 +52,15 @@ func (c *Client) CreateMilestone(owner, repo string, opt CreateMilestoneOption)
 	return milestone, c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/milestones", owner, repo), jsonHeader, bytes.NewReader(body), milestone)
 }
 
+// EditMilestoneOption options when modify milestone
 type EditMilestoneOption struct {
 	Title       string     `json:"title"`
 	Description *string    `json:"description"`
 	State       *string    `json:"state"`
 	Deadline    *time.Time `json:"due_on"`
 }
 
+// EditMilestone modify milestone with options
 func (c *Client) EditMilestone(owner, repo string, id int64, opt EditMilestoneOption) (*Milestone, error) {
 	body, err := json.Marshal(&opt)
 	if err != nil {
@@ -63,6 +70,7 @@ func (c *Client) EditMilestone(owner, repo string, id int64, opt EditMilestoneOp
 	return milestone, c.getParsedResponse("PATCH", fmt.Sprintf("/repos/%s/%s/milestones/%d", owner, repo, id), jsonHeader, bytes.NewReader(body), milestone)
 }
 
+// DeleteMilestone delete one milestone by milestone id
 func (c *Client) DeleteMilestone(owner, repo string, id int64) error {
 	_, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/milestones/%d", owner, repo, id), nil, nil)
 	return err

gitea/miscellaneous.go

@@ -4,6 +4,7 @@
 
 package gitea
 
+// MarkdownOption markdown options
 type MarkdownOption struct {
 	Text    string
 	Mode    string

gitea/org.go

@@ -10,31 +10,36 @@ import (
 	"fmt"
 )
 
+// Organization a group of some repositories, users and teams
 type Organization struct {
 	ID          int64  `json:"id"`
 	UserName    string `json:"username"`
 	FullName    string `json:"full_name"`
-	AvatarUrl   string `json:"avatar_url"`
+	AvatarURL   string `json:"avatar_url"`
 	Description string `json:"description"`
 	Website     string `json:"website"`
 	Location    string `json:"location"`
 }
 
+// ListMyOrgs list all of current user's organizations
 func (c *Client) ListMyOrgs() ([]*Organization, error) {
 	orgs := make([]*Organization, 0, 5)
 	return orgs, c.getParsedResponse("GET", "/user/orgs", nil, nil, &orgs)
 }
 
+// ListUserOrgs list all of some user's organizations
 func (c *Client) ListUserOrgs(user string) ([]*Organization, error) {
 	orgs := make([]*Organization, 0, 5)
 	return orgs, c.getParsedResponse("GET", fmt.Sprintf("/users/%s/orgs", user), nil, nil, &orgs)
 }
 
+// GetOrg get one organization by name
 func (c *Client) GetOrg(orgname string) (*Organization, error) {
 	org := new(Organization)
 	return org, c.getParsedResponse("GET", fmt.Sprintf("/orgs/%s", orgname), nil, nil, org)
 }
 
+// CreateOrgOption create one organization options
 type CreateOrgOption struct {
 	UserName    string `json:"username" binding:"Required"`
 	FullName    string `json:"full_name"`
@@ -43,13 +48,15 @@ type CreateOrgOption struct {
 	Location    string `json:"location"`
 }
 
+// EditOrgOption edit one organization options
 type EditOrgOption struct {
 	FullName    string `json:"full_name"`
 	Description string `json:"description"`
 	Website     string `json:"website"`
 	Location    string `json:"location"`
 }
 
+// EditOrg modify one organization via options
 func (c *Client) EditOrg(orgname string, opt EditOrgOption) error {
 	body, err := json.Marshal(&opt)
 	if err != nil {