769e0a3ea6
* Use relative URLs * Notifications - Mark as read/unread * Feature of pinning a notification * On view issue, do not mark as read a pinned notification
1898 lines
50 KiB
Go
1898 lines
50 KiB
Go
// Copyright 2014 The Gogs 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 models
|
|
|
|
import (
|
|
"errors"
|
|
"fmt"
|
|
"io"
|
|
"mime/multipart"
|
|
"os"
|
|
"path"
|
|
"strings"
|
|
"time"
|
|
|
|
api "code.gitea.io/sdk/gitea"
|
|
"github.com/Unknwon/com"
|
|
"github.com/go-xorm/xorm"
|
|
gouuid "github.com/satori/go.uuid"
|
|
|
|
"code.gitea.io/gitea/modules/base"
|
|
"code.gitea.io/gitea/modules/log"
|
|
"code.gitea.io/gitea/modules/setting"
|
|
)
|
|
|
|
var (
|
|
errMissingIssueNumber = errors.New("No issue number specified")
|
|
)
|
|
|
|
// Issue represents an issue or pull request of repository.
|
|
type Issue struct {
|
|
ID int64 `xorm:"pk autoincr"`
|
|
RepoID int64 `xorm:"INDEX UNIQUE(repo_index)"`
|
|
Repo *Repository `xorm:"-"`
|
|
Index int64 `xorm:"UNIQUE(repo_index)"` // Index in one repository.
|
|
PosterID int64 `xorm:"INDEX"`
|
|
Poster *User `xorm:"-"`
|
|
Title string `xorm:"name"`
|
|
Content string `xorm:"TEXT"`
|
|
RenderedContent string `xorm:"-"`
|
|
Labels []*Label `xorm:"-"`
|
|
MilestoneID int64 `xorm:"INDEX"`
|
|
Milestone *Milestone `xorm:"-"`
|
|
Priority int
|
|
AssigneeID int64 `xorm:"INDEX"`
|
|
Assignee *User `xorm:"-"`
|
|
IsClosed bool `xorm:"INDEX"`
|
|
IsRead bool `xorm:"-"`
|
|
IsPull bool `xorm:"INDEX"` // Indicates whether is a pull request or not.
|
|
PullRequest *PullRequest `xorm:"-"`
|
|
NumComments int
|
|
|
|
Deadline time.Time `xorm:"-"`
|
|
DeadlineUnix int64 `xorm:"INDEX"`
|
|
Created time.Time `xorm:"-"`
|
|
CreatedUnix int64 `xorm:"INDEX"`
|
|
Updated time.Time `xorm:"-"`
|
|
UpdatedUnix int64 `xorm:"INDEX"`
|
|
|
|
Attachments []*Attachment `xorm:"-"`
|
|
Comments []*Comment `xorm:"-"`
|
|
}
|
|
|
|
// BeforeInsert is invoked from XORM before inserting an object of this type.
|
|
func (issue *Issue) BeforeInsert() {
|
|
issue.CreatedUnix = time.Now().Unix()
|
|
issue.UpdatedUnix = issue.CreatedUnix
|
|
}
|
|
|
|
// BeforeUpdate is invoked from XORM before updating this object.
|
|
func (issue *Issue) BeforeUpdate() {
|
|
issue.UpdatedUnix = time.Now().Unix()
|
|
issue.DeadlineUnix = issue.Deadline.Unix()
|
|
}
|
|
|
|
// AfterSet is invoked from XORM after setting the value of a field of
|
|
// this object.
|
|
func (issue *Issue) AfterSet(colName string, _ xorm.Cell) {
|
|
switch colName {
|
|
case "deadline_unix":
|
|
issue.Deadline = time.Unix(issue.DeadlineUnix, 0).Local()
|
|
case "created_unix":
|
|
issue.Created = time.Unix(issue.CreatedUnix, 0).Local()
|
|
case "updated_unix":
|
|
issue.Updated = time.Unix(issue.UpdatedUnix, 0).Local()
|
|
}
|
|
}
|
|
|
|
func (issue *Issue) loadRepo(e Engine) (err error) {
|
|
if issue.Repo == nil {
|
|
issue.Repo, err = getRepositoryByID(e, issue.RepoID)
|
|
if err != nil {
|
|
return fmt.Errorf("getRepositoryByID [%d]: %v", issue.RepoID, err)
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (issue *Issue) loadAttributes(e Engine) (err error) {
|
|
if err := issue.loadRepo(e); err != nil {
|
|
return err
|
|
}
|
|
|
|
if issue.Poster == nil {
|
|
issue.Poster, err = getUserByID(e, issue.PosterID)
|
|
if err != nil {
|
|
issue.PosterID = -1
|
|
issue.Poster = NewGhostUser()
|
|
if !IsErrUserNotExist(err) {
|
|
return fmt.Errorf("getUserByID.(poster) [%d]: %v", issue.PosterID, err)
|
|
}
|
|
err = nil
|
|
return
|
|
}
|
|
}
|
|
|
|
if issue.Labels == nil {
|
|
issue.Labels, err = getLabelsByIssueID(e, issue.ID)
|
|
if err != nil {
|
|
return fmt.Errorf("getLabelsByIssueID [%d]: %v", issue.ID, err)
|
|
}
|
|
}
|
|
|
|
if issue.Milestone == nil && issue.MilestoneID > 0 {
|
|
issue.Milestone, err = getMilestoneByRepoID(e, issue.RepoID, issue.MilestoneID)
|
|
if err != nil {
|
|
return fmt.Errorf("getMilestoneByRepoID [repo_id: %d, milestone_id: %d]: %v", issue.RepoID, issue.MilestoneID, err)
|
|
}
|
|
}
|
|
|
|
if issue.Assignee == nil && issue.AssigneeID > 0 {
|
|
issue.Assignee, err = getUserByID(e, issue.AssigneeID)
|
|
if err != nil {
|
|
return fmt.Errorf("getUserByID.(assignee) [%d]: %v", issue.AssigneeID, err)
|
|
}
|
|
}
|
|
|
|
if issue.IsPull && issue.PullRequest == nil {
|
|
// It is possible pull request is not yet created.
|
|
issue.PullRequest, err = getPullRequestByIssueID(e, issue.ID)
|
|
if err != nil && !IsErrPullRequestNotExist(err) {
|
|
return fmt.Errorf("getPullRequestByIssueID [%d]: %v", issue.ID, err)
|
|
}
|
|
}
|
|
|
|
if issue.Attachments == nil {
|
|
issue.Attachments, err = getAttachmentsByIssueID(e, issue.ID)
|
|
if err != nil {
|
|
return fmt.Errorf("getAttachmentsByIssueID [%d]: %v", issue.ID, err)
|
|
}
|
|
}
|
|
|
|
if issue.Comments == nil {
|
|
issue.Comments, err = getCommentsByIssueID(e, issue.ID)
|
|
if err != nil {
|
|
return fmt.Errorf("getCommentsByIssueID [%d]: %v", issue.ID, err)
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// LoadAttributes loads the attribute of this issue.
|
|
func (issue *Issue) LoadAttributes() error {
|
|
return issue.loadAttributes(x)
|
|
}
|
|
|
|
// HTMLURL returns the absolute URL to this issue.
|
|
func (issue *Issue) HTMLURL() string {
|
|
var path string
|
|
if issue.IsPull {
|
|
path = "pulls"
|
|
} else {
|
|
path = "issues"
|
|
}
|
|
return fmt.Sprintf("%s/%s/%d", issue.Repo.HTMLURL(), path, issue.Index)
|
|
}
|
|
|
|
// DiffURL returns the absolute URL to this diff
|
|
func (issue *Issue) DiffURL() string {
|
|
if issue.IsPull {
|
|
return fmt.Sprintf("%s/pulls/%d.diff", issue.Repo.HTMLURL(), issue.Index)
|
|
}
|
|
return ""
|
|
}
|
|
|
|
// PatchURL returns the absolute URL to this patch
|
|
func (issue *Issue) PatchURL() string {
|
|
if issue.IsPull {
|
|
return fmt.Sprintf("%s/pulls/%d.patch", issue.Repo.HTMLURL(), issue.Index)
|
|
}
|
|
return ""
|
|
}
|
|
|
|
// State returns string representation of issue status.
|
|
func (issue *Issue) State() api.StateType {
|
|
if issue.IsClosed {
|
|
return api.StateClosed
|
|
}
|
|
return api.StateOpen
|
|
}
|
|
|
|
// APIFormat assumes some fields assigned with values:
|
|
// Required - Poster, Labels,
|
|
// Optional - Milestone, Assignee, PullRequest
|
|
func (issue *Issue) APIFormat() *api.Issue {
|
|
apiLabels := make([]*api.Label, len(issue.Labels))
|
|
for i := range issue.Labels {
|
|
apiLabels[i] = issue.Labels[i].APIFormat()
|
|
}
|
|
|
|
apiIssue := &api.Issue{
|
|
ID: issue.ID,
|
|
Index: issue.Index,
|
|
Poster: issue.Poster.APIFormat(),
|
|
Title: issue.Title,
|
|
Body: issue.Content,
|
|
Labels: apiLabels,
|
|
State: issue.State(),
|
|
Comments: issue.NumComments,
|
|
Created: issue.Created,
|
|
Updated: issue.Updated,
|
|
}
|
|
|
|
if issue.Milestone != nil {
|
|
apiIssue.Milestone = issue.Milestone.APIFormat()
|
|
}
|
|
if issue.Assignee != nil {
|
|
apiIssue.Assignee = issue.Assignee.APIFormat()
|
|
}
|
|
if issue.IsPull {
|
|
apiIssue.PullRequest = &api.PullRequestMeta{
|
|
HasMerged: issue.PullRequest.HasMerged,
|
|
}
|
|
if issue.PullRequest.HasMerged {
|
|
apiIssue.PullRequest.Merged = &issue.PullRequest.Merged
|
|
}
|
|
}
|
|
|
|
return apiIssue
|
|
}
|
|
|
|
// HashTag returns unique hash tag for issue.
|
|
func (issue *Issue) HashTag() string {
|
|
return "issue-" + com.ToStr(issue.ID)
|
|
}
|
|
|
|
// IsPoster returns true if given user by ID is the poster.
|
|
func (issue *Issue) IsPoster(uid int64) bool {
|
|
return issue.PosterID == uid
|
|
}
|
|
|
|
func (issue *Issue) hasLabel(e Engine, labelID int64) bool {
|
|
return hasIssueLabel(e, issue.ID, labelID)
|
|
}
|
|
|
|
// HasLabel returns true if issue has been labeled by given ID.
|
|
func (issue *Issue) HasLabel(labelID int64) bool {
|
|
return issue.hasLabel(x, labelID)
|
|
}
|
|
|
|
func (issue *Issue) sendLabelUpdatedWebhook(doer *User) {
|
|
var err error
|
|
if issue.IsPull {
|
|
err = issue.PullRequest.LoadIssue()
|
|
if err != nil {
|
|
log.Error(4, "LoadIssue: %v", err)
|
|
return
|
|
}
|
|
err = PrepareWebhooks(issue.Repo, HookEventPullRequest, &api.PullRequestPayload{
|
|
Action: api.HookIssueLabelUpdated,
|
|
Index: issue.Index,
|
|
PullRequest: issue.PullRequest.APIFormat(),
|
|
Repository: issue.Repo.APIFormat(AccessModeNone),
|
|
Sender: doer.APIFormat(),
|
|
})
|
|
}
|
|
if err != nil {
|
|
log.Error(4, "PrepareWebhooks [is_pull: %v]: %v", issue.IsPull, err)
|
|
} else {
|
|
go HookQueue.Add(issue.RepoID)
|
|
}
|
|
}
|
|
|
|
func (issue *Issue) addLabel(e *xorm.Session, label *Label) error {
|
|
return newIssueLabel(e, issue, label)
|
|
}
|
|
|
|
// AddLabel adds a new label to the issue.
|
|
func (issue *Issue) AddLabel(doer *User, label *Label) error {
|
|
if err := NewIssueLabel(issue, label); err != nil {
|
|
return err
|
|
}
|
|
|
|
issue.sendLabelUpdatedWebhook(doer)
|
|
return nil
|
|
}
|
|
|
|
func (issue *Issue) addLabels(e *xorm.Session, labels []*Label) error {
|
|
return newIssueLabels(e, issue, labels)
|
|
}
|
|
|
|
// AddLabels adds a list of new labels to the issue.
|
|
func (issue *Issue) AddLabels(doer *User, labels []*Label) error {
|
|
if err := NewIssueLabels(issue, labels); err != nil {
|
|
return err
|
|
}
|
|
|
|
issue.sendLabelUpdatedWebhook(doer)
|
|
return nil
|
|
}
|
|
|
|
func (issue *Issue) getLabels(e Engine) (err error) {
|
|
if len(issue.Labels) > 0 {
|
|
return nil
|
|
}
|
|
|
|
issue.Labels, err = getLabelsByIssueID(e, issue.ID)
|
|
if err != nil {
|
|
return fmt.Errorf("getLabelsByIssueID: %v", err)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (issue *Issue) removeLabel(e *xorm.Session, label *Label) error {
|
|
return deleteIssueLabel(e, issue, label)
|
|
}
|
|
|
|
// RemoveLabel removes a label from issue by given ID.
|
|
func (issue *Issue) RemoveLabel(doer *User, label *Label) error {
|
|
if err := issue.loadRepo(x); err != nil {
|
|
return err
|
|
}
|
|
|
|
if has, err := HasAccess(doer, issue.Repo, AccessModeWrite); err != nil {
|
|
return err
|
|
} else if !has {
|
|
return ErrLabelNotExist{}
|
|
}
|
|
|
|
if err := DeleteIssueLabel(issue, label); err != nil {
|
|
return err
|
|
}
|
|
|
|
issue.sendLabelUpdatedWebhook(doer)
|
|
return nil
|
|
}
|
|
|
|
func (issue *Issue) clearLabels(e *xorm.Session) (err error) {
|
|
if err = issue.getLabels(e); err != nil {
|
|
return fmt.Errorf("getLabels: %v", err)
|
|
}
|
|
|
|
for i := range issue.Labels {
|
|
if err = issue.removeLabel(e, issue.Labels[i]); err != nil {
|
|
return fmt.Errorf("removeLabel: %v", err)
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// ClearLabels removes all issue labels as the given user.
|
|
// Triggers appropriate WebHooks, if any.
|
|
func (issue *Issue) ClearLabels(doer *User) (err error) {
|
|
sess := x.NewSession()
|
|
defer sessionRelease(sess)
|
|
if err = sess.Begin(); err != nil {
|
|
return err
|
|
}
|
|
|
|
if err := issue.loadRepo(sess); err != nil {
|
|
return err
|
|
}
|
|
|
|
if has, err := hasAccess(sess, doer, issue.Repo, AccessModeWrite); err != nil {
|
|
return err
|
|
} else if !has {
|
|
return ErrLabelNotExist{}
|
|
}
|
|
|
|
if err = issue.clearLabels(sess); err != nil {
|
|
return err
|
|
}
|
|
|
|
if err = sess.Commit(); err != nil {
|
|
return fmt.Errorf("Commit: %v", err)
|
|
}
|
|
|
|
if issue.IsPull {
|
|
err = issue.PullRequest.LoadIssue()
|
|
if err != nil {
|
|
log.Error(4, "LoadIssue: %v", err)
|
|
return
|
|
}
|
|
err = PrepareWebhooks(issue.Repo, HookEventPullRequest, &api.PullRequestPayload{
|
|
Action: api.HookIssueLabelCleared,
|
|
Index: issue.Index,
|
|
PullRequest: issue.PullRequest.APIFormat(),
|
|
Repository: issue.Repo.APIFormat(AccessModeNone),
|
|
Sender: doer.APIFormat(),
|
|
})
|
|
}
|
|
if err != nil {
|
|
log.Error(4, "PrepareWebhooks [is_pull: %v]: %v", issue.IsPull, err)
|
|
} else {
|
|
go HookQueue.Add(issue.RepoID)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// ReplaceLabels removes all current labels and add new labels to the issue.
|
|
// Triggers appropriate WebHooks, if any.
|
|
func (issue *Issue) ReplaceLabels(labels []*Label) (err error) {
|
|
sess := x.NewSession()
|
|
defer sessionRelease(sess)
|
|
if err = sess.Begin(); err != nil {
|
|
return err
|
|
}
|
|
|
|
if err = issue.clearLabels(sess); err != nil {
|
|
return fmt.Errorf("clearLabels: %v", err)
|
|
} else if err = issue.addLabels(sess, labels); err != nil {
|
|
return fmt.Errorf("addLabels: %v", err)
|
|
}
|
|
|
|
return sess.Commit()
|
|
}
|
|
|
|
// GetAssignee sets the Assignee attribute of this issue.
|
|
func (issue *Issue) GetAssignee() (err error) {
|
|
if issue.AssigneeID == 0 || issue.Assignee != nil {
|
|
return nil
|
|
}
|
|
|
|
issue.Assignee, err = GetUserByID(issue.AssigneeID)
|
|
if IsErrUserNotExist(err) {
|
|
return nil
|
|
}
|
|
return err
|
|
}
|
|
|
|
// ReadBy sets issue to be read by given user.
|
|
func (issue *Issue) ReadBy(userID int64) error {
|
|
if err := UpdateIssueUserByRead(userID, issue.ID); err != nil {
|
|
return err
|
|
}
|
|
|
|
if err := setNotificationStatusReadIfUnread(x, userID, issue.ID); err != nil {
|
|
return err
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
func updateIssueCols(e Engine, issue *Issue, cols ...string) error {
|
|
_, err := e.Id(issue.ID).Cols(cols...).Update(issue)
|
|
return err
|
|
}
|
|
|
|
// UpdateIssueCols only updates values of specific columns for given issue.
|
|
func UpdateIssueCols(issue *Issue, cols ...string) error {
|
|
return updateIssueCols(x, issue, cols...)
|
|
}
|
|
|
|
func (issue *Issue) changeStatus(e *xorm.Session, doer *User, repo *Repository, isClosed bool) (err error) {
|
|
// Nothing should be performed if current status is same as target status
|
|
if issue.IsClosed == isClosed {
|
|
return nil
|
|
}
|
|
issue.IsClosed = isClosed
|
|
|
|
if err = updateIssueCols(e, issue, "is_closed"); err != nil {
|
|
return err
|
|
} else if err = updateIssueUsersByStatus(e, issue.ID, isClosed); err != nil {
|
|
return err
|
|
}
|
|
|
|
// Update issue count of labels
|
|
if err = issue.getLabels(e); err != nil {
|
|
return err
|
|
}
|
|
for idx := range issue.Labels {
|
|
if issue.IsClosed {
|
|
issue.Labels[idx].NumClosedIssues++
|
|
} else {
|
|
issue.Labels[idx].NumClosedIssues--
|
|
}
|
|
if err = updateLabel(e, issue.Labels[idx]); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
// Update issue count of milestone
|
|
if err = changeMilestoneIssueStats(e, issue); err != nil {
|
|
return err
|
|
}
|
|
|
|
// New action comment
|
|
if _, err = createStatusComment(e, doer, repo, issue); err != nil {
|
|
return err
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// ChangeStatus changes issue status to open or closed.
|
|
func (issue *Issue) ChangeStatus(doer *User, repo *Repository, isClosed bool) (err error) {
|
|
sess := x.NewSession()
|
|
defer sessionRelease(sess)
|
|
if err = sess.Begin(); err != nil {
|
|
return err
|
|
}
|
|
|
|
if err = issue.changeStatus(sess, doer, repo, isClosed); err != nil {
|
|
return err
|
|
}
|
|
|
|
if err = sess.Commit(); err != nil {
|
|
return fmt.Errorf("Commit: %v", err)
|
|
}
|
|
|
|
if issue.IsPull {
|
|
// Merge pull request calls issue.changeStatus so we need to handle separately.
|
|
issue.PullRequest.Issue = issue
|
|
apiPullRequest := &api.PullRequestPayload{
|
|
Index: issue.Index,
|
|
PullRequest: issue.PullRequest.APIFormat(),
|
|
Repository: repo.APIFormat(AccessModeNone),
|
|
Sender: doer.APIFormat(),
|
|
}
|
|
if isClosed {
|
|
apiPullRequest.Action = api.HookIssueClosed
|
|
} else {
|
|
apiPullRequest.Action = api.HookIssueReOpened
|
|
}
|
|
err = PrepareWebhooks(repo, HookEventPullRequest, apiPullRequest)
|
|
}
|
|
if err != nil {
|
|
log.Error(4, "PrepareWebhooks [is_pull: %v, is_closed: %v]: %v", issue.IsPull, isClosed, err)
|
|
} else {
|
|
go HookQueue.Add(repo.ID)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// ChangeTitle changes the title of this issue, as the given user.
|
|
func (issue *Issue) ChangeTitle(doer *User, title string) (err error) {
|
|
oldTitle := issue.Title
|
|
issue.Title = title
|
|
if err = UpdateIssueCols(issue, "name"); err != nil {
|
|
return fmt.Errorf("UpdateIssueCols: %v", err)
|
|
}
|
|
|
|
if issue.IsPull {
|
|
issue.PullRequest.Issue = issue
|
|
err = PrepareWebhooks(issue.Repo, HookEventPullRequest, &api.PullRequestPayload{
|
|
Action: api.HookIssueEdited,
|
|
Index: issue.Index,
|
|
Changes: &api.ChangesPayload{
|
|
Title: &api.ChangesFromPayload{
|
|
From: oldTitle,
|
|
},
|
|
},
|
|
PullRequest: issue.PullRequest.APIFormat(),
|
|
Repository: issue.Repo.APIFormat(AccessModeNone),
|
|
Sender: doer.APIFormat(),
|
|
})
|
|
}
|
|
if err != nil {
|
|
log.Error(4, "PrepareWebhooks [is_pull: %v]: %v", issue.IsPull, err)
|
|
} else {
|
|
go HookQueue.Add(issue.RepoID)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// ChangeContent changes issue content, as the given user.
|
|
func (issue *Issue) ChangeContent(doer *User, content string) (err error) {
|
|
oldContent := issue.Content
|
|
issue.Content = content
|
|
if err = UpdateIssueCols(issue, "content"); err != nil {
|
|
return fmt.Errorf("UpdateIssueCols: %v", err)
|
|
}
|
|
|
|
if issue.IsPull {
|
|
issue.PullRequest.Issue = issue
|
|
err = PrepareWebhooks(issue.Repo, HookEventPullRequest, &api.PullRequestPayload{
|
|
Action: api.HookIssueEdited,
|
|
Index: issue.Index,
|
|
Changes: &api.ChangesPayload{
|
|
Body: &api.ChangesFromPayload{
|
|
From: oldContent,
|
|
},
|
|
},
|
|
PullRequest: issue.PullRequest.APIFormat(),
|
|
Repository: issue.Repo.APIFormat(AccessModeNone),
|
|
Sender: doer.APIFormat(),
|
|
})
|
|
}
|
|
if err != nil {
|
|
log.Error(4, "PrepareWebhooks [is_pull: %v]: %v", issue.IsPull, err)
|
|
} else {
|
|
go HookQueue.Add(issue.RepoID)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// ChangeAssignee changes the Asssignee field of this issue.
|
|
func (issue *Issue) ChangeAssignee(doer *User, assigneeID int64) (err error) {
|
|
issue.AssigneeID = assigneeID
|
|
if err = UpdateIssueUserByAssignee(issue); err != nil {
|
|
return fmt.Errorf("UpdateIssueUserByAssignee: %v", err)
|
|
}
|
|
|
|
issue.Assignee, err = GetUserByID(issue.AssigneeID)
|
|
if err != nil && !IsErrUserNotExist(err) {
|
|
log.Error(4, "GetUserByID [assignee_id: %v]: %v", issue.AssigneeID, err)
|
|
return nil
|
|
}
|
|
|
|
// Error not nil here means user does not exist, which is remove assignee.
|
|
isRemoveAssignee := err != nil
|
|
if issue.IsPull {
|
|
issue.PullRequest.Issue = issue
|
|
apiPullRequest := &api.PullRequestPayload{
|
|
Index: issue.Index,
|
|
PullRequest: issue.PullRequest.APIFormat(),
|
|
Repository: issue.Repo.APIFormat(AccessModeNone),
|
|
Sender: doer.APIFormat(),
|
|
}
|
|
if isRemoveAssignee {
|
|
apiPullRequest.Action = api.HookIssueUnassigned
|
|
} else {
|
|
apiPullRequest.Action = api.HookIssueAssigned
|
|
}
|
|
err = PrepareWebhooks(issue.Repo, HookEventPullRequest, apiPullRequest)
|
|
}
|
|
if err != nil {
|
|
log.Error(4, "PrepareWebhooks [is_pull: %v, remove_assignee: %v]: %v", issue.IsPull, isRemoveAssignee, err)
|
|
} else {
|
|
go HookQueue.Add(issue.RepoID)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// NewIssueOptions represents the options of a new issue.
|
|
type NewIssueOptions struct {
|
|
Repo *Repository
|
|
Issue *Issue
|
|
LableIDs []int64
|
|
Attachments []string // In UUID format.
|
|
IsPull bool
|
|
}
|
|
|
|
func newIssue(e *xorm.Session, opts NewIssueOptions) (err error) {
|
|
opts.Issue.Title = strings.TrimSpace(opts.Issue.Title)
|
|
opts.Issue.Index = opts.Repo.NextIssueIndex()
|
|
|
|
if opts.Issue.MilestoneID > 0 {
|
|
milestone, err := getMilestoneByRepoID(e, opts.Issue.RepoID, opts.Issue.MilestoneID)
|
|
if err != nil && !IsErrMilestoneNotExist(err) {
|
|
return fmt.Errorf("getMilestoneByID: %v", err)
|
|
}
|
|
|
|
// Assume milestone is invalid and drop silently.
|
|
opts.Issue.MilestoneID = 0
|
|
if milestone != nil {
|
|
opts.Issue.MilestoneID = milestone.ID
|
|
opts.Issue.Milestone = milestone
|
|
if err = changeMilestoneAssign(e, opts.Issue, -1); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
}
|
|
|
|
if opts.Issue.AssigneeID > 0 {
|
|
assignee, err := getUserByID(e, opts.Issue.AssigneeID)
|
|
if err != nil && !IsErrUserNotExist(err) {
|
|
return fmt.Errorf("getUserByID: %v", err)
|
|
}
|
|
|
|
// Assume assignee is invalid and drop silently.
|
|
opts.Issue.AssigneeID = 0
|
|
if assignee != nil {
|
|
valid, err := hasAccess(e, assignee, opts.Repo, AccessModeWrite)
|
|
if err != nil {
|
|
return fmt.Errorf("hasAccess [user_id: %d, repo_id: %d]: %v", assignee.ID, opts.Repo.ID, err)
|
|
}
|
|
if valid {
|
|
opts.Issue.AssigneeID = assignee.ID
|
|
opts.Issue.Assignee = assignee
|
|
}
|
|
}
|
|
}
|
|
|
|
// Milestone and assignee validation should happen before insert actual object.
|
|
if _, err = e.Insert(opts.Issue); err != nil {
|
|
return err
|
|
}
|
|
|
|
if opts.IsPull {
|
|
_, err = e.Exec("UPDATE `repository` SET num_pulls = num_pulls + 1 WHERE id = ?", opts.Issue.RepoID)
|
|
} else {
|
|
_, err = e.Exec("UPDATE `repository` SET num_issues = num_issues + 1 WHERE id = ?", opts.Issue.RepoID)
|
|
}
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
if len(opts.LableIDs) > 0 {
|
|
// During the session, SQLite3 driver cannot handle retrieve objects after update something.
|
|
// So we have to get all needed labels first.
|
|
labels := make([]*Label, 0, len(opts.LableIDs))
|
|
if err = e.In("id", opts.LableIDs).Find(&labels); err != nil {
|
|
return fmt.Errorf("find all labels [label_ids: %v]: %v", opts.LableIDs, err)
|
|
}
|
|
|
|
for _, label := range labels {
|
|
// Silently drop invalid labels.
|
|
if label.RepoID != opts.Repo.ID {
|
|
continue
|
|
}
|
|
|
|
if err = opts.Issue.addLabel(e, label); err != nil {
|
|
return fmt.Errorf("addLabel [id: %d]: %v", label.ID, err)
|
|
}
|
|
}
|
|
}
|
|
|
|
if err = newIssueUsers(e, opts.Repo, opts.Issue); err != nil {
|
|
return err
|
|
}
|
|
|
|
if len(opts.Attachments) > 0 {
|
|
attachments, err := getAttachmentsByUUIDs(e, opts.Attachments)
|
|
if err != nil {
|
|
return fmt.Errorf("getAttachmentsByUUIDs [uuids: %v]: %v", opts.Attachments, err)
|
|
}
|
|
|
|
for i := 0; i < len(attachments); i++ {
|
|
attachments[i].IssueID = opts.Issue.ID
|
|
if _, err = e.Id(attachments[i].ID).Update(attachments[i]); err != nil {
|
|
return fmt.Errorf("update attachment [id: %d]: %v", attachments[i].ID, err)
|
|
}
|
|
}
|
|
}
|
|
|
|
return opts.Issue.loadAttributes(e)
|
|
}
|
|
|
|
// NewIssue creates new issue with labels for repository.
|
|
func NewIssue(repo *Repository, issue *Issue, labelIDs []int64, uuids []string) (err error) {
|
|
sess := x.NewSession()
|
|
defer sessionRelease(sess)
|
|
if err = sess.Begin(); err != nil {
|
|
return err
|
|
}
|
|
|
|
if err = newIssue(sess, NewIssueOptions{
|
|
Repo: repo,
|
|
Issue: issue,
|
|
LableIDs: labelIDs,
|
|
Attachments: uuids,
|
|
}); err != nil {
|
|
return fmt.Errorf("newIssue: %v", err)
|
|
}
|
|
|
|
if err = sess.Commit(); err != nil {
|
|
return fmt.Errorf("Commit: %v", err)
|
|
}
|
|
|
|
if err = NotifyWatchers(&Action{
|
|
ActUserID: issue.Poster.ID,
|
|
ActUserName: issue.Poster.Name,
|
|
OpType: ActionCreateIssue,
|
|
Content: fmt.Sprintf("%d|%s", issue.Index, issue.Title),
|
|
RepoID: repo.ID,
|
|
RepoUserName: repo.Owner.Name,
|
|
RepoName: repo.Name,
|
|
IsPrivate: repo.IsPrivate,
|
|
}); err != nil {
|
|
log.Error(4, "NotifyWatchers: %v", err)
|
|
}
|
|
if err = issue.MailParticipants(); err != nil {
|
|
log.Error(4, "MailParticipants: %v", err)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// GetIssueByRef returns an Issue specified by a GFM reference.
|
|
// See https://help.github.com/articles/writing-on-github#references for more information on the syntax.
|
|
func GetIssueByRef(ref string) (*Issue, error) {
|
|
n := strings.IndexByte(ref, byte('#'))
|
|
if n == -1 {
|
|
return nil, errMissingIssueNumber
|
|
}
|
|
|
|
index, err := com.StrTo(ref[n+1:]).Int64()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
repo, err := GetRepositoryByRef(ref[:n])
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
issue, err := GetIssueByIndex(repo.ID, index)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return issue, issue.LoadAttributes()
|
|
}
|
|
|
|
// GetRawIssueByIndex returns raw issue without loading attributes by index in a repository.
|
|
func GetRawIssueByIndex(repoID, index int64) (*Issue, error) {
|
|
issue := &Issue{
|
|
RepoID: repoID,
|
|
Index: index,
|
|
}
|
|
has, err := x.Get(issue)
|
|
if err != nil {
|
|
return nil, err
|
|
} else if !has {
|
|
return nil, ErrIssueNotExist{0, repoID, index}
|
|
}
|
|
return issue, nil
|
|
}
|
|
|
|
// GetIssueByIndex returns issue by index in a repository.
|
|
func GetIssueByIndex(repoID, index int64) (*Issue, error) {
|
|
issue, err := GetRawIssueByIndex(repoID, index)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return issue, issue.LoadAttributes()
|
|
}
|
|
|
|
func getIssueByID(e Engine, id int64) (*Issue, error) {
|
|
issue := new(Issue)
|
|
has, err := e.Id(id).Get(issue)
|
|
if err != nil {
|
|
return nil, err
|
|
} else if !has {
|
|
return nil, ErrIssueNotExist{id, 0, 0}
|
|
}
|
|
return issue, issue.LoadAttributes()
|
|
}
|
|
|
|
// GetIssueByID returns an issue by given ID.
|
|
func GetIssueByID(id int64) (*Issue, error) {
|
|
return getIssueByID(x, id)
|
|
}
|
|
|
|
// IssuesOptions represents options of an issue.
|
|
type IssuesOptions struct {
|
|
RepoID int64
|
|
AssigneeID int64
|
|
PosterID int64
|
|
MentionedID int64
|
|
MilestoneID int64
|
|
RepoIDs []int64
|
|
Page int
|
|
IsClosed bool
|
|
IsPull bool
|
|
Labels string
|
|
SortType string
|
|
}
|
|
|
|
// sortIssuesSession sort an issues-related session based on the provided
|
|
// sortType string
|
|
func sortIssuesSession(sess *xorm.Session, sortType string) {
|
|
switch sortType {
|
|
case "oldest":
|
|
sess.Asc("issue.created_unix")
|
|
case "recentupdate":
|
|
sess.Desc("issue.updated_unix")
|
|
case "leastupdate":
|
|
sess.Asc("issue.updated_unix")
|
|
case "mostcomment":
|
|
sess.Desc("issue.num_comments")
|
|
case "leastcomment":
|
|
sess.Asc("issue.num_comments")
|
|
case "priority":
|
|
sess.Desc("issue.priority")
|
|
default:
|
|
sess.Desc("issue.created_unix")
|
|
}
|
|
}
|
|
|
|
// Issues returns a list of issues by given conditions.
|
|
func Issues(opts *IssuesOptions) ([]*Issue, error) {
|
|
if opts.Page <= 0 {
|
|
opts.Page = 1
|
|
}
|
|
|
|
sess := x.Limit(setting.UI.IssuePagingNum, (opts.Page-1)*setting.UI.IssuePagingNum)
|
|
|
|
if opts.RepoID > 0 {
|
|
sess.And("issue.repo_id=?", opts.RepoID)
|
|
} else if len(opts.RepoIDs) > 0 {
|
|
// In case repository IDs are provided but actually no repository has issue.
|
|
sess.In("issue.repo_id", opts.RepoIDs)
|
|
}
|
|
sess.And("issue.is_closed=?", opts.IsClosed)
|
|
|
|
if opts.AssigneeID > 0 {
|
|
sess.And("issue.assignee_id=?", opts.AssigneeID)
|
|
}
|
|
|
|
if opts.PosterID > 0 {
|
|
sess.And("issue.poster_id=?", opts.PosterID)
|
|
}
|
|
|
|
if opts.MentionedID > 0 {
|
|
sess.Join("INNER", "issue_user", "issue.id = issue_user.issue_id").
|
|
And("issue_user.is_mentioned = ?", true).
|
|
And("issue_user.uid = ?", opts.MentionedID)
|
|
}
|
|
|
|
if opts.MilestoneID > 0 {
|
|
sess.And("issue.milestone_id=?", opts.MilestoneID)
|
|
}
|
|
|
|
sess.And("issue.is_pull=?", opts.IsPull)
|
|
|
|
sortIssuesSession(sess, opts.SortType)
|
|
|
|
if len(opts.Labels) > 0 && opts.Labels != "0" {
|
|
labelIDs, err := base.StringsToInt64s(strings.Split(opts.Labels, ","))
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
if len(labelIDs) > 0 {
|
|
sess.
|
|
Join("INNER", "issue_label", "issue.id = issue_label.issue_id").
|
|
In("issue_label.label_id", labelIDs)
|
|
}
|
|
}
|
|
|
|
issues := make([]*Issue, 0, setting.UI.IssuePagingNum)
|
|
if err := sess.Find(&issues); err != nil {
|
|
return nil, fmt.Errorf("Find: %v", err)
|
|
}
|
|
|
|
// FIXME: use IssueList to improve performance.
|
|
for i := range issues {
|
|
if err := issues[i].LoadAttributes(); err != nil {
|
|
return nil, fmt.Errorf("LoadAttributes [%d]: %v", issues[i].ID, err)
|
|
}
|
|
}
|
|
|
|
return issues, nil
|
|
}
|
|
|
|
// .___ ____ ___
|
|
// | | ______ ________ __ ____ | | \______ ___________
|
|
// | |/ ___// ___/ | \_/ __ \| | / ___// __ \_ __ \
|
|
// | |\___ \ \___ \| | /\ ___/| | /\___ \\ ___/| | \/
|
|
// |___/____ >____ >____/ \___ >______//____ >\___ >__|
|
|
// \/ \/ \/ \/ \/
|
|
|
|
// IssueUser represents an issue-user relation.
|
|
type IssueUser struct {
|
|
ID int64 `xorm:"pk autoincr"`
|
|
UID int64 `xorm:"INDEX"` // User ID.
|
|
IssueID int64
|
|
RepoID int64 `xorm:"INDEX"`
|
|
MilestoneID int64
|
|
IsRead bool
|
|
IsAssigned bool
|
|
IsMentioned bool
|
|
IsPoster bool
|
|
IsClosed bool
|
|
}
|
|
|
|
func newIssueUsers(e *xorm.Session, repo *Repository, issue *Issue) error {
|
|
assignees, err := repo.getAssignees(e)
|
|
if err != nil {
|
|
return fmt.Errorf("getAssignees: %v", err)
|
|
}
|
|
|
|
// Poster can be anyone, append later if not one of assignees.
|
|
isPosterAssignee := false
|
|
|
|
// Leave a seat for poster itself to append later, but if poster is one of assignee
|
|
// and just waste 1 unit is cheaper than re-allocate memory once.
|
|
issueUsers := make([]*IssueUser, 0, len(assignees)+1)
|
|
for _, assignee := range assignees {
|
|
isPoster := assignee.ID == issue.PosterID
|
|
issueUsers = append(issueUsers, &IssueUser{
|
|
IssueID: issue.ID,
|
|
RepoID: repo.ID,
|
|
UID: assignee.ID,
|
|
IsPoster: isPoster,
|
|
IsAssigned: assignee.ID == issue.AssigneeID,
|
|
})
|
|
if !isPosterAssignee && isPoster {
|
|
isPosterAssignee = true
|
|
}
|
|
}
|
|
if !isPosterAssignee {
|
|
issueUsers = append(issueUsers, &IssueUser{
|
|
IssueID: issue.ID,
|
|
RepoID: repo.ID,
|
|
UID: issue.PosterID,
|
|
IsPoster: true,
|
|
})
|
|
}
|
|
|
|
if _, err = e.Insert(issueUsers); err != nil {
|
|
return err
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// NewIssueUsers adds new issue-user relations for new issue of repository.
|
|
func NewIssueUsers(repo *Repository, issue *Issue) (err error) {
|
|
sess := x.NewSession()
|
|
defer sessionRelease(sess)
|
|
if err = sess.Begin(); err != nil {
|
|
return err
|
|
}
|
|
|
|
if err = newIssueUsers(sess, repo, issue); err != nil {
|
|
return err
|
|
}
|
|
|
|
return sess.Commit()
|
|
}
|
|
|
|
// PairsContains returns true when pairs list contains given issue.
|
|
func PairsContains(ius []*IssueUser, issueID, uid int64) int {
|
|
for i := range ius {
|
|
if ius[i].IssueID == issueID &&
|
|
ius[i].UID == uid {
|
|
return i
|
|
}
|
|
}
|
|
return -1
|
|
}
|
|
|
|
// GetIssueUsers returns issue-user pairs by given repository and user.
|
|
func GetIssueUsers(rid, uid int64, isClosed bool) ([]*IssueUser, error) {
|
|
ius := make([]*IssueUser, 0, 10)
|
|
err := x.Where("is_closed=?", isClosed).Find(&ius, &IssueUser{RepoID: rid, UID: uid})
|
|
return ius, err
|
|
}
|
|
|
|
// GetIssueUserPairsByRepoIds returns issue-user pairs by given repository IDs.
|
|
func GetIssueUserPairsByRepoIds(rids []int64, isClosed bool, page int) ([]*IssueUser, error) {
|
|
if len(rids) == 0 {
|
|
return []*IssueUser{}, nil
|
|
}
|
|
|
|
ius := make([]*IssueUser, 0, 10)
|
|
sess := x.
|
|
Limit(20, (page-1)*20).
|
|
Where("is_closed=?", isClosed).
|
|
In("repo_id", rids)
|
|
err := sess.Find(&ius)
|
|
return ius, err
|
|
}
|
|
|
|
// GetIssueUserPairsByMode returns issue-user pairs by given repository and user.
|
|
func GetIssueUserPairsByMode(uid, rid int64, isClosed bool, page, filterMode int) ([]*IssueUser, error) {
|
|
ius := make([]*IssueUser, 0, 10)
|
|
sess := x.
|
|
Limit(20, (page-1)*20).
|
|
Where("uid=?", uid).
|
|
And("is_closed=?", isClosed)
|
|
if rid > 0 {
|
|
sess.And("repo_id=?", rid)
|
|
}
|
|
|
|
switch filterMode {
|
|
case FilterModeAssign:
|
|
sess.And("is_assigned=?", true)
|
|
case FilterModeCreate:
|
|
sess.And("is_poster=?", true)
|
|
default:
|
|
return ius, nil
|
|
}
|
|
err := sess.Find(&ius)
|
|
return ius, err
|
|
}
|
|
|
|
// UpdateIssueMentions extracts mentioned people from content and
|
|
// updates issue-user relations for them.
|
|
func UpdateIssueMentions(e Engine, issueID int64, mentions []string) error {
|
|
if len(mentions) == 0 {
|
|
return nil
|
|
}
|
|
|
|
for i := range mentions {
|
|
mentions[i] = strings.ToLower(mentions[i])
|
|
}
|
|
users := make([]*User, 0, len(mentions))
|
|
|
|
if err := e.In("lower_name", mentions).Asc("lower_name").Find(&users); err != nil {
|
|
return fmt.Errorf("find mentioned users: %v", err)
|
|
}
|
|
|
|
ids := make([]int64, 0, len(mentions))
|
|
for _, user := range users {
|
|
ids = append(ids, user.ID)
|
|
if !user.IsOrganization() || user.NumMembers == 0 {
|
|
continue
|
|
}
|
|
|
|
memberIDs := make([]int64, 0, user.NumMembers)
|
|
orgUsers, err := GetOrgUsersByOrgID(user.ID)
|
|
if err != nil {
|
|
return fmt.Errorf("GetOrgUsersByOrgID [%d]: %v", user.ID, err)
|
|
}
|
|
|
|
for _, orgUser := range orgUsers {
|
|
memberIDs = append(memberIDs, orgUser.ID)
|
|
}
|
|
|
|
ids = append(ids, memberIDs...)
|
|
}
|
|
|
|
if err := UpdateIssueUsersByMentions(e, issueID, ids); err != nil {
|
|
return fmt.Errorf("UpdateIssueUsersByMentions: %v", err)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// IssueStats represents issue statistic information.
|
|
type IssueStats struct {
|
|
OpenCount, ClosedCount int64
|
|
AllCount int64
|
|
AssignCount int64
|
|
CreateCount int64
|
|
MentionCount int64
|
|
}
|
|
|
|
// Filter modes.
|
|
const (
|
|
FilterModeAll = iota
|
|
FilterModeAssign
|
|
FilterModeCreate
|
|
FilterModeMention
|
|
)
|
|
|
|
func parseCountResult(results []map[string][]byte) int64 {
|
|
if len(results) == 0 {
|
|
return 0
|
|
}
|
|
for _, result := range results[0] {
|
|
return com.StrTo(string(result)).MustInt64()
|
|
}
|
|
return 0
|
|
}
|
|
|
|
// IssueStatsOptions contains parameters accepted by GetIssueStats.
|
|
type IssueStatsOptions struct {
|
|
RepoID int64
|
|
Labels string
|
|
MilestoneID int64
|
|
AssigneeID int64
|
|
MentionedID int64
|
|
PosterID int64
|
|
IsPull bool
|
|
}
|
|
|
|
// GetIssueStats returns issue statistic information by given conditions.
|
|
func GetIssueStats(opts *IssueStatsOptions) *IssueStats {
|
|
stats := &IssueStats{}
|
|
|
|
countSession := func(opts *IssueStatsOptions) *xorm.Session {
|
|
sess := x.
|
|
Where("issue.repo_id = ?", opts.RepoID).
|
|
And("is_pull = ?", opts.IsPull)
|
|
|
|
if len(opts.Labels) > 0 && opts.Labels != "0" {
|
|
labelIDs, err := base.StringsToInt64s(strings.Split(opts.Labels, ","))
|
|
if err != nil {
|
|
log.Warn("Malformed Labels argument: %s", opts.Labels)
|
|
} else if len(labelIDs) > 0 {
|
|
sess.Join("INNER", "issue_label", "issue.id = issue_id").
|
|
In("label_id", labelIDs)
|
|
}
|
|
}
|
|
|
|
if opts.MilestoneID > 0 {
|
|
sess.And("issue.milestone_id = ?", opts.MilestoneID)
|
|
}
|
|
|
|
if opts.AssigneeID > 0 {
|
|
sess.And("assignee_id = ?", opts.AssigneeID)
|
|
}
|
|
|
|
if opts.PosterID > 0 {
|
|
sess.And("poster_id = ?", opts.PosterID)
|
|
}
|
|
|
|
if opts.MentionedID > 0 {
|
|
sess.Join("INNER", "issue_user", "issue.id = issue_user.issue_id").
|
|
And("issue_user.uid = ?", opts.MentionedID).
|
|
And("issue_user.is_mentioned = ?", true)
|
|
}
|
|
|
|
return sess
|
|
}
|
|
|
|
stats.OpenCount, _ = countSession(opts).
|
|
And("is_closed = ?", false).
|
|
Count(&Issue{})
|
|
stats.ClosedCount, _ = countSession(opts).
|
|
And("is_closed = ?", true).
|
|
Count(&Issue{})
|
|
return stats
|
|
}
|
|
|
|
// GetUserIssueStats returns issue statistic information for dashboard by given conditions.
|
|
func GetUserIssueStats(repoID, uid int64, repoIDs []int64, filterMode int, isPull bool) *IssueStats {
|
|
stats := &IssueStats{}
|
|
|
|
countSession := func(isClosed, isPull bool, repoID int64, repoIDs []int64) *xorm.Session {
|
|
sess := x.
|
|
Where("issue.is_closed = ?", isClosed).
|
|
And("issue.is_pull = ?", isPull)
|
|
|
|
if repoID > 0 {
|
|
sess.And("repo_id = ?", repoID)
|
|
} else if len(repoIDs) > 0 {
|
|
sess.In("repo_id", repoIDs)
|
|
}
|
|
|
|
return sess
|
|
}
|
|
|
|
stats.AssignCount, _ = countSession(false, isPull, repoID, repoIDs).
|
|
And("assignee_id = ?", uid).
|
|
Count(&Issue{})
|
|
|
|
stats.CreateCount, _ = countSession(false, isPull, repoID, repoIDs).
|
|
And("poster_id = ?", uid).
|
|
Count(&Issue{})
|
|
|
|
openCountSession := countSession(false, isPull, repoID, repoIDs)
|
|
closedCountSession := countSession(true, isPull, repoID, repoIDs)
|
|
|
|
switch filterMode {
|
|
case FilterModeAssign:
|
|
openCountSession.And("assignee_id = ?", uid)
|
|
closedCountSession.And("assignee_id = ?", uid)
|
|
case FilterModeCreate:
|
|
openCountSession.And("poster_id = ?", uid)
|
|
closedCountSession.And("poster_id = ?", uid)
|
|
}
|
|
|
|
stats.OpenCount, _ = openCountSession.Count(&Issue{})
|
|
stats.ClosedCount, _ = closedCountSession.Count(&Issue{})
|
|
|
|
return stats
|
|
}
|
|
|
|
// GetRepoIssueStats returns number of open and closed repository issues by given filter mode.
|
|
func GetRepoIssueStats(repoID, uid int64, filterMode int, isPull bool) (numOpen int64, numClosed int64) {
|
|
countSession := func(isClosed, isPull bool, repoID int64) *xorm.Session {
|
|
sess := x.
|
|
Where("issue.repo_id = ?", isClosed).
|
|
And("is_pull = ?", isPull).
|
|
And("repo_id = ?", repoID)
|
|
|
|
return sess
|
|
}
|
|
|
|
openCountSession := countSession(false, isPull, repoID)
|
|
closedCountSession := countSession(true, isPull, repoID)
|
|
|
|
switch filterMode {
|
|
case FilterModeAssign:
|
|
openCountSession.And("assignee_id = ?", uid)
|
|
closedCountSession.And("assignee_id = ?", uid)
|
|
case FilterModeCreate:
|
|
openCountSession.And("poster_id = ?", uid)
|
|
closedCountSession.And("poster_id = ?", uid)
|
|
}
|
|
|
|
openResult, _ := openCountSession.Count(&Issue{})
|
|
closedResult, _ := closedCountSession.Count(&Issue{})
|
|
|
|
return openResult, closedResult
|
|
}
|
|
|
|
func updateIssue(e Engine, issue *Issue) error {
|
|
_, err := e.Id(issue.ID).AllCols().Update(issue)
|
|
return err
|
|
}
|
|
|
|
// UpdateIssue updates all fields of given issue.
|
|
func UpdateIssue(issue *Issue) error {
|
|
return updateIssue(x, issue)
|
|
}
|
|
|
|
func updateIssueUsersByStatus(e Engine, issueID int64, isClosed bool) error {
|
|
_, err := e.Exec("UPDATE `issue_user` SET is_closed=? WHERE issue_id=?", isClosed, issueID)
|
|
return err
|
|
}
|
|
|
|
// UpdateIssueUsersByStatus updates issue-user relations by issue status.
|
|
func UpdateIssueUsersByStatus(issueID int64, isClosed bool) error {
|
|
return updateIssueUsersByStatus(x, issueID, isClosed)
|
|
}
|
|
|
|
func updateIssueUserByAssignee(e *xorm.Session, issue *Issue) (err error) {
|
|
if _, err = e.Exec("UPDATE `issue_user` SET is_assigned = ? WHERE issue_id = ?", false, issue.ID); err != nil {
|
|
return err
|
|
}
|
|
|
|
// Assignee ID equals to 0 means clear assignee.
|
|
if issue.AssigneeID > 0 {
|
|
if _, err = e.Exec("UPDATE `issue_user` SET is_assigned = ? WHERE uid = ? AND issue_id = ?", true, issue.AssigneeID, issue.ID); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
return updateIssue(e, issue)
|
|
}
|
|
|
|
// UpdateIssueUserByAssignee updates issue-user relation for assignee.
|
|
func UpdateIssueUserByAssignee(issue *Issue) (err error) {
|
|
sess := x.NewSession()
|
|
defer sessionRelease(sess)
|
|
if err = sess.Begin(); err != nil {
|
|
return err
|
|
}
|
|
|
|
if err = updateIssueUserByAssignee(sess, issue); err != nil {
|
|
return err
|
|
}
|
|
|
|
return sess.Commit()
|
|
}
|
|
|
|
// UpdateIssueUserByRead updates issue-user relation for reading.
|
|
func UpdateIssueUserByRead(uid, issueID int64) error {
|
|
_, err := x.Exec("UPDATE `issue_user` SET is_read=? WHERE uid=? AND issue_id=?", true, uid, issueID)
|
|
return err
|
|
}
|
|
|
|
// UpdateIssueUsersByMentions updates issue-user pairs by mentioning.
|
|
func UpdateIssueUsersByMentions(e Engine, issueID int64, uids []int64) error {
|
|
for _, uid := range uids {
|
|
iu := &IssueUser{
|
|
UID: uid,
|
|
IssueID: issueID,
|
|
}
|
|
has, err := e.Get(iu)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
iu.IsMentioned = true
|
|
if has {
|
|
_, err = e.Id(iu.ID).AllCols().Update(iu)
|
|
} else {
|
|
_, err = e.Insert(iu)
|
|
}
|
|
if err != nil {
|
|
return err
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// _____ .__.__ __
|
|
// / \ |__| | ____ _______/ |_ ____ ____ ____
|
|
// / \ / \| | | _/ __ \ / ___/\ __\/ _ \ / \_/ __ \
|
|
// / Y \ | |_\ ___/ \___ \ | | ( <_> ) | \ ___/
|
|
// \____|__ /__|____/\___ >____ > |__| \____/|___| /\___ >
|
|
// \/ \/ \/ \/ \/
|
|
|
|
// Milestone represents a milestone of repository.
|
|
type Milestone struct {
|
|
ID int64 `xorm:"pk autoincr"`
|
|
RepoID int64 `xorm:"INDEX"`
|
|
Name string
|
|
Content string `xorm:"TEXT"`
|
|
RenderedContent string `xorm:"-"`
|
|
IsClosed bool
|
|
NumIssues int
|
|
NumClosedIssues int
|
|
NumOpenIssues int `xorm:"-"`
|
|
Completeness int // Percentage(1-100).
|
|
IsOverDue bool `xorm:"-"`
|
|
|
|
DeadlineString string `xorm:"-"`
|
|
Deadline time.Time `xorm:"-"`
|
|
DeadlineUnix int64
|
|
ClosedDate time.Time `xorm:"-"`
|
|
ClosedDateUnix int64
|
|
}
|
|
|
|
// BeforeInsert is invoked from XORM before inserting an object of this type.
|
|
func (m *Milestone) BeforeInsert() {
|
|
m.DeadlineUnix = m.Deadline.Unix()
|
|
}
|
|
|
|
// BeforeUpdate is invoked from XORM before updating this object.
|
|
func (m *Milestone) BeforeUpdate() {
|
|
if m.NumIssues > 0 {
|
|
m.Completeness = m.NumClosedIssues * 100 / m.NumIssues
|
|
} else {
|
|
m.Completeness = 0
|
|
}
|
|
|
|
m.DeadlineUnix = m.Deadline.Unix()
|
|
m.ClosedDateUnix = m.ClosedDate.Unix()
|
|
}
|
|
|
|
// AfterSet is invoked from XORM after setting the value of a field of
|
|
// this object.
|
|
func (m *Milestone) AfterSet(colName string, _ xorm.Cell) {
|
|
switch colName {
|
|
case "num_closed_issues":
|
|
m.NumOpenIssues = m.NumIssues - m.NumClosedIssues
|
|
|
|
case "deadline_unix":
|
|
m.Deadline = time.Unix(m.DeadlineUnix, 0).Local()
|
|
if m.Deadline.Year() == 9999 {
|
|
return
|
|
}
|
|
|
|
m.DeadlineString = m.Deadline.Format("2006-01-02")
|
|
if time.Now().Local().After(m.Deadline) {
|
|
m.IsOverDue = true
|
|
}
|
|
|
|
case "closed_date_unix":
|
|
m.ClosedDate = time.Unix(m.ClosedDateUnix, 0).Local()
|
|
}
|
|
}
|
|
|
|
// State returns string representation of milestone status.
|
|
func (m *Milestone) State() api.StateType {
|
|
if m.IsClosed {
|
|
return api.StateClosed
|
|
}
|
|
return api.StateOpen
|
|
}
|
|
|
|
// APIFormat returns this Milestone in API format.
|
|
func (m *Milestone) APIFormat() *api.Milestone {
|
|
apiMilestone := &api.Milestone{
|
|
ID: m.ID,
|
|
State: m.State(),
|
|
Title: m.Name,
|
|
Description: m.Content,
|
|
OpenIssues: m.NumOpenIssues,
|
|
ClosedIssues: m.NumClosedIssues,
|
|
}
|
|
if m.IsClosed {
|
|
apiMilestone.Closed = &m.ClosedDate
|
|
}
|
|
if m.Deadline.Year() < 9999 {
|
|
apiMilestone.Deadline = &m.Deadline
|
|
}
|
|
return apiMilestone
|
|
}
|
|
|
|
// NewMilestone creates new milestone of repository.
|
|
func NewMilestone(m *Milestone) (err error) {
|
|
sess := x.NewSession()
|
|
defer sessionRelease(sess)
|
|
if err = sess.Begin(); err != nil {
|
|
return err
|
|
}
|
|
|
|
if _, err = sess.Insert(m); err != nil {
|
|
return err
|
|
}
|
|
|
|
if _, err = sess.Exec("UPDATE `repository` SET num_milestones = num_milestones + 1 WHERE id = ?", m.RepoID); err != nil {
|
|
return err
|
|
}
|
|
return sess.Commit()
|
|
}
|
|
|
|
func getMilestoneByRepoID(e Engine, repoID, id int64) (*Milestone, error) {
|
|
m := &Milestone{
|
|
ID: id,
|
|
RepoID: repoID,
|
|
}
|
|
has, err := e.Get(m)
|
|
if err != nil {
|
|
return nil, err
|
|
} else if !has {
|
|
return nil, ErrMilestoneNotExist{id, repoID}
|
|
}
|
|
return m, nil
|
|
}
|
|
|
|
// GetMilestoneByRepoID returns the milestone in a repository.
|
|
func GetMilestoneByRepoID(repoID, id int64) (*Milestone, error) {
|
|
return getMilestoneByRepoID(x, repoID, id)
|
|
}
|
|
|
|
// GetMilestonesByRepoID returns all milestones of a repository.
|
|
func GetMilestonesByRepoID(repoID int64) ([]*Milestone, error) {
|
|
miles := make([]*Milestone, 0, 10)
|
|
return miles, x.Where("repo_id = ?", repoID).Find(&miles)
|
|
}
|
|
|
|
// GetMilestones returns a list of milestones of given repository and status.
|
|
func GetMilestones(repoID int64, page int, isClosed bool, sortType string) ([]*Milestone, error) {
|
|
miles := make([]*Milestone, 0, setting.UI.IssuePagingNum)
|
|
sess := x.Where("repo_id = ? AND is_closed = ?", repoID, isClosed)
|
|
if page > 0 {
|
|
sess = sess.Limit(setting.UI.IssuePagingNum, (page-1)*setting.UI.IssuePagingNum)
|
|
}
|
|
|
|
switch sortType {
|
|
case "furthestduedate":
|
|
sess.Desc("deadline_unix")
|
|
case "leastcomplete":
|
|
sess.Asc("completeness")
|
|
case "mostcomplete":
|
|
sess.Desc("completeness")
|
|
case "leastissues":
|
|
sess.Asc("num_issues")
|
|
case "mostissues":
|
|
sess.Desc("num_issues")
|
|
default:
|
|
sess.Asc("deadline_unix")
|
|
}
|
|
|
|
return miles, sess.Find(&miles)
|
|
}
|
|
|
|
func updateMilestone(e Engine, m *Milestone) error {
|
|
_, err := e.Id(m.ID).AllCols().Update(m)
|
|
return err
|
|
}
|
|
|
|
// UpdateMilestone updates information of given milestone.
|
|
func UpdateMilestone(m *Milestone) error {
|
|
return updateMilestone(x, m)
|
|
}
|
|
|
|
func countRepoMilestones(e Engine, repoID int64) int64 {
|
|
count, _ := e.
|
|
Where("repo_id=?", repoID).
|
|
Count(new(Milestone))
|
|
return count
|
|
}
|
|
|
|
// CountRepoMilestones returns number of milestones in given repository.
|
|
func CountRepoMilestones(repoID int64) int64 {
|
|
return countRepoMilestones(x, repoID)
|
|
}
|
|
|
|
func countRepoClosedMilestones(e Engine, repoID int64) int64 {
|
|
closed, _ := e.
|
|
Where("repo_id=? AND is_closed=?", repoID, true).
|
|
Count(new(Milestone))
|
|
return closed
|
|
}
|
|
|
|
// CountRepoClosedMilestones returns number of closed milestones in given repository.
|
|
func CountRepoClosedMilestones(repoID int64) int64 {
|
|
return countRepoClosedMilestones(x, repoID)
|
|
}
|
|
|
|
// MilestoneStats returns number of open and closed milestones of given repository.
|
|
func MilestoneStats(repoID int64) (open int64, closed int64) {
|
|
open, _ = x.
|
|
Where("repo_id=? AND is_closed=?", repoID, false).
|
|
Count(new(Milestone))
|
|
return open, CountRepoClosedMilestones(repoID)
|
|
}
|
|
|
|
// ChangeMilestoneStatus changes the milestone open/closed status.
|
|
func ChangeMilestoneStatus(m *Milestone, isClosed bool) (err error) {
|
|
repo, err := GetRepositoryByID(m.RepoID)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
sess := x.NewSession()
|
|
defer sessionRelease(sess)
|
|
if err = sess.Begin(); err != nil {
|
|
return err
|
|
}
|
|
|
|
m.IsClosed = isClosed
|
|
if err = updateMilestone(sess, m); err != nil {
|
|
return err
|
|
}
|
|
|
|
repo.NumMilestones = int(countRepoMilestones(sess, repo.ID))
|
|
repo.NumClosedMilestones = int(countRepoClosedMilestones(sess, repo.ID))
|
|
if _, err = sess.Id(repo.ID).AllCols().Update(repo); err != nil {
|
|
return err
|
|
}
|
|
return sess.Commit()
|
|
}
|
|
|
|
func changeMilestoneIssueStats(e *xorm.Session, issue *Issue) error {
|
|
if issue.MilestoneID == 0 {
|
|
return nil
|
|
}
|
|
|
|
m, err := getMilestoneByRepoID(e, issue.RepoID, issue.MilestoneID)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
if issue.IsClosed {
|
|
m.NumOpenIssues--
|
|
m.NumClosedIssues++
|
|
} else {
|
|
m.NumOpenIssues++
|
|
m.NumClosedIssues--
|
|
}
|
|
|
|
return updateMilestone(e, m)
|
|
}
|
|
|
|
// ChangeMilestoneIssueStats updates the open/closed issues counter and progress
|
|
// for the milestone associated with the given issue.
|
|
func ChangeMilestoneIssueStats(issue *Issue) (err error) {
|
|
sess := x.NewSession()
|
|
defer sessionRelease(sess)
|
|
if err = sess.Begin(); err != nil {
|
|
return err
|
|
}
|
|
|
|
if err = changeMilestoneIssueStats(sess, issue); err != nil {
|
|
return err
|
|
}
|
|
|
|
return sess.Commit()
|
|
}
|
|
|
|
func changeMilestoneAssign(e *xorm.Session, issue *Issue, oldMilestoneID int64) error {
|
|
if oldMilestoneID > 0 {
|
|
m, err := getMilestoneByRepoID(e, issue.RepoID, oldMilestoneID)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
m.NumIssues--
|
|
if issue.IsClosed {
|
|
m.NumClosedIssues--
|
|
}
|
|
|
|
if err = updateMilestone(e, m); err != nil {
|
|
return err
|
|
} else if _, err = e.Exec("UPDATE `issue_user` SET milestone_id = 0 WHERE issue_id = ?", issue.ID); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
if issue.MilestoneID > 0 {
|
|
m, err := getMilestoneByRepoID(e, issue.RepoID, issue.MilestoneID)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
m.NumIssues++
|
|
if issue.IsClosed {
|
|
m.NumClosedIssues++
|
|
}
|
|
|
|
if err = updateMilestone(e, m); err != nil {
|
|
return err
|
|
} else if _, err = e.Exec("UPDATE `issue_user` SET milestone_id = ? WHERE issue_id = ?", m.ID, issue.ID); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
return updateIssue(e, issue)
|
|
}
|
|
|
|
// ChangeMilestoneAssign changes assignment of milestone for issue.
|
|
func ChangeMilestoneAssign(issue *Issue, oldMilestoneID int64) (err error) {
|
|
sess := x.NewSession()
|
|
defer sess.Close()
|
|
if err = sess.Begin(); err != nil {
|
|
return err
|
|
}
|
|
|
|
if err = changeMilestoneAssign(sess, issue, oldMilestoneID); err != nil {
|
|
return err
|
|
}
|
|
return sess.Commit()
|
|
}
|
|
|
|
// DeleteMilestoneByRepoID deletes a milestone from a repository.
|
|
func DeleteMilestoneByRepoID(repoID, id int64) error {
|
|
m, err := GetMilestoneByRepoID(repoID, id)
|
|
if err != nil {
|
|
if IsErrMilestoneNotExist(err) {
|
|
return nil
|
|
}
|
|
return err
|
|
}
|
|
|
|
repo, err := GetRepositoryByID(m.RepoID)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
sess := x.NewSession()
|
|
defer sessionRelease(sess)
|
|
if err = sess.Begin(); err != nil {
|
|
return err
|
|
}
|
|
|
|
if _, err = sess.Id(m.ID).Delete(new(Milestone)); err != nil {
|
|
return err
|
|
}
|
|
|
|
repo.NumMilestones = int(countRepoMilestones(sess, repo.ID))
|
|
repo.NumClosedMilestones = int(countRepoClosedMilestones(sess, repo.ID))
|
|
if _, err = sess.Id(repo.ID).AllCols().Update(repo); err != nil {
|
|
return err
|
|
}
|
|
|
|
if _, err = sess.Exec("UPDATE `issue` SET milestone_id = 0 WHERE milestone_id = ?", m.ID); err != nil {
|
|
return err
|
|
} else if _, err = sess.Exec("UPDATE `issue_user` SET milestone_id = 0 WHERE milestone_id = ?", m.ID); err != nil {
|
|
return err
|
|
}
|
|
return sess.Commit()
|
|
}
|
|
|
|
// Attachment represent a attachment of issue/comment/release.
|
|
type Attachment struct {
|
|
ID int64 `xorm:"pk autoincr"`
|
|
UUID string `xorm:"uuid UNIQUE"`
|
|
IssueID int64 `xorm:"INDEX"`
|
|
CommentID int64
|
|
ReleaseID int64 `xorm:"INDEX"`
|
|
Name string
|
|
|
|
Created time.Time `xorm:"-"`
|
|
CreatedUnix int64
|
|
}
|
|
|
|
// BeforeInsert is invoked from XORM before inserting an object of this type.
|
|
func (a *Attachment) BeforeInsert() {
|
|
a.CreatedUnix = time.Now().Unix()
|
|
}
|
|
|
|
// AfterSet is invoked from XORM after setting the value of a field of
|
|
// this object.
|
|
func (a *Attachment) AfterSet(colName string, _ xorm.Cell) {
|
|
switch colName {
|
|
case "created_unix":
|
|
a.Created = time.Unix(a.CreatedUnix, 0).Local()
|
|
}
|
|
}
|
|
|
|
// AttachmentLocalPath returns where attachment is stored in local file
|
|
// system based on given UUID.
|
|
func AttachmentLocalPath(uuid string) string {
|
|
return path.Join(setting.AttachmentPath, uuid[0:1], uuid[1:2], uuid)
|
|
}
|
|
|
|
// LocalPath returns where attachment is stored in local file system.
|
|
func (a *Attachment) LocalPath() string {
|
|
return AttachmentLocalPath(a.UUID)
|
|
}
|
|
|
|
// NewAttachment creates a new attachment object.
|
|
func NewAttachment(name string, buf []byte, file multipart.File) (_ *Attachment, err error) {
|
|
attach := &Attachment{
|
|
UUID: gouuid.NewV4().String(),
|
|
Name: name,
|
|
}
|
|
|
|
localPath := attach.LocalPath()
|
|
if err = os.MkdirAll(path.Dir(localPath), os.ModePerm); err != nil {
|
|
return nil, fmt.Errorf("MkdirAll: %v", err)
|
|
}
|
|
|
|
fw, err := os.Create(localPath)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("Create: %v", err)
|
|
}
|
|
defer fw.Close()
|
|
|
|
if _, err = fw.Write(buf); err != nil {
|
|
return nil, fmt.Errorf("Write: %v", err)
|
|
} else if _, err = io.Copy(fw, file); err != nil {
|
|
return nil, fmt.Errorf("Copy: %v", err)
|
|
}
|
|
|
|
if _, err := x.Insert(attach); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return attach, nil
|
|
}
|
|
|
|
func getAttachmentByUUID(e Engine, uuid string) (*Attachment, error) {
|
|
attach := &Attachment{UUID: uuid}
|
|
has, err := x.Get(attach)
|
|
if err != nil {
|
|
return nil, err
|
|
} else if !has {
|
|
return nil, ErrAttachmentNotExist{0, uuid}
|
|
}
|
|
return attach, nil
|
|
}
|
|
|
|
func getAttachmentsByUUIDs(e Engine, uuids []string) ([]*Attachment, error) {
|
|
if len(uuids) == 0 {
|
|
return []*Attachment{}, nil
|
|
}
|
|
|
|
// Silently drop invalid uuids.
|
|
attachments := make([]*Attachment, 0, len(uuids))
|
|
return attachments, e.In("uuid", uuids).Find(&attachments)
|
|
}
|
|
|
|
// GetAttachmentByUUID returns attachment by given UUID.
|
|
func GetAttachmentByUUID(uuid string) (*Attachment, error) {
|
|
return getAttachmentByUUID(x, uuid)
|
|
}
|
|
|
|
func getAttachmentsByIssueID(e Engine, issueID int64) ([]*Attachment, error) {
|
|
attachments := make([]*Attachment, 0, 10)
|
|
return attachments, e.Where("issue_id = ? AND comment_id = 0", issueID).Find(&attachments)
|
|
}
|
|
|
|
// GetAttachmentsByIssueID returns all attachments of an issue.
|
|
func GetAttachmentsByIssueID(issueID int64) ([]*Attachment, error) {
|
|
return getAttachmentsByIssueID(x, issueID)
|
|
}
|
|
|
|
// GetAttachmentsByCommentID returns all attachments if comment by given ID.
|
|
func GetAttachmentsByCommentID(commentID int64) ([]*Attachment, error) {
|
|
attachments := make([]*Attachment, 0, 10)
|
|
return attachments, x.Where("comment_id=?", commentID).Find(&attachments)
|
|
}
|
|
|
|
// DeleteAttachment deletes the given attachment and optionally the associated file.
|
|
func DeleteAttachment(a *Attachment, remove bool) error {
|
|
_, err := DeleteAttachments([]*Attachment{a}, remove)
|
|
return err
|
|
}
|
|
|
|
// DeleteAttachments deletes the given attachments and optionally the associated files.
|
|
func DeleteAttachments(attachments []*Attachment, remove bool) (int, error) {
|
|
for i, a := range attachments {
|
|
if remove {
|
|
if err := os.Remove(a.LocalPath()); err != nil {
|
|
return i, err
|
|
}
|
|
}
|
|
|
|
if _, err := x.Delete(a); err != nil {
|
|
return i, err
|
|
}
|
|
}
|
|
|
|
return len(attachments), nil
|
|
}
|
|
|
|
// DeleteAttachmentsByIssue deletes all attachments associated with the given issue.
|
|
func DeleteAttachmentsByIssue(issueID int64, remove bool) (int, error) {
|
|
attachments, err := GetAttachmentsByIssueID(issueID)
|
|
|
|
if err != nil {
|
|
return 0, err
|
|
}
|
|
|
|
return DeleteAttachments(attachments, remove)
|
|
}
|
|
|
|
// DeleteAttachmentsByComment deletes all attachments associated with the given comment.
|
|
func DeleteAttachmentsByComment(commentID int64, remove bool) (int, error) {
|
|
attachments, err := GetAttachmentsByCommentID(commentID)
|
|
|
|
if err != nil {
|
|
return 0, err
|
|
}
|
|
|
|
return DeleteAttachments(attachments, remove)
|
|
}
|