issues

package
v3.1.22 Latest Latest
Warning

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

 Go to latest Published: Jan 21, 2026 License: MIT Imports: 39 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	FilterModeAll = iota
	FilterModeAssign
	FilterModeCreate
	FilterModeMention
	FilterModeReviewRequested
	FilterModeReviewed
	FilterModeYourRepositories
)

Filter modes.

View Source 
const (
	// MaxQueryParameters represents the max query parameters
	// When queries are broken down in parts because of the number
	// of parameters, attempt to break by this amount
	MaxQueryParameters = 300
)
View Source 
const ScopeSortPrefix = "scope-"

Variables

View Source 
var ErrCommentAlreadyChanged = util.NewInvalidArgumentErrorf("the comment is already changed")
View Source 
var ErrIssueAlreadyChanged = util.NewInvalidArgumentErrorf("the issue is already changed")
View Source 
var ErrIssueMaxPinReached = util.NewInvalidArgumentErrorf("the max number of pinned issues has been readched")
View Source 
var ErrMustCollaborator = util.NewPermissionDeniedErrorf("user must be a collaborator")

Functions

func AddDeletePRBranchComment 

func AddDeletePRBranchComment(ctx context.Context, doer *user_model.User, repo *repo_model.Repository, issueID int64, branchName string) error

AddDeletePRBranchComment adds delete branch comment for pull request issue

func BuildLabelNamesIssueIDsCondition 

func BuildLabelNamesIssueIDsCondition(labelNames []string) *builder.Builder

BuildLabelNamesIssueIDsCondition returns a builder where get issue ids match label names

func CanMaintainerWriteToBranch 

func CanMaintainerWriteToBranch(ctx context.Context, p access_model.Permission, branch string, user *user_model.User) bool

CanMaintainerWriteToBranch check whether user is a maintainer and could write to the branch

func CanMarkConversation 

func CanMarkConversation(ctx context.Context, issue *Issue, doer *user_model.User) (permResult bool, err error)

CanMarkConversation Add or remove Conversation mark for a code comment permission check the PR writer , official reviewer and poster can do it

func CancelStopwatch 

func CancelStopwatch(ctx context.Context, user *user_model.User, issue *Issue) (ok bool, err error)

CancelStopwatch removes the given stopwatch and logs it into issue's timeline.

func ChangeIssueContent 

func ChangeIssueContent(ctx context.Context, issue *Issue, doer *user_model.User, content string, contentVersion int) (err error)

ChangeIssueContent changes issue content, as the given user.

func ChangeIssueRef 

func ChangeIssueRef(ctx context.Context, issue *Issue, doer *user_model.User, oldRef string) (err error)

ChangeIssueRef changes the branch of this issue, as the given user.

func ChangeIssueTimeEstimate 

func ChangeIssueTimeEstimate(ctx context.Context, issue *Issue, doer *user_model.User, timeEstimate int64) error

ChangeIssueTimeEstimate changes the plan time of this issue, as the given user.

func ChangeIssueTitle 

func ChangeIssueTitle(ctx context.Context, issue *Issue, doer *user_model.User, oldTitle string) (err error)

ChangeIssueTitle changes the title of this issue, as the given user.

func ChangeMilestoneStatus 

func ChangeMilestoneStatus(ctx context.Context, m *Milestone, isClosed bool) (err error)

ChangeMilestoneStatus changes the milestone open/closed status.

func ChangeMilestoneStatusByRepoIDAndID 

func ChangeMilestoneStatusByRepoIDAndID(ctx context.Context, repoID, milestoneID int64, isClosed bool) error

ChangeMilestoneStatusByRepoIDAndID changes a milestone open/closed status if the milestone ID is in the repo.

func CheckIssueWatch 

func CheckIssueWatch(ctx context.Context, user *user_model.User, issue *Issue) (bool, error)

CheckIssueWatch check if an user is watching an issue it takes participants and repo watch into account

func ClearIssueLabels 

func ClearIssueLabels(ctx context.Context, issue *Issue, doer *user_model.User) (err error)

ClearIssueLabels removes all issue labels as the given user. Triggers appropriate WebHooks, if any.

func CommentHashTag 

func CommentHashTag(id int64) string

CommentHashTag returns unique hash tag for comment id.

func CommentTypeIsRef 

func CommentTypeIsRef(t CommentType) bool

CommentTypeIsRef returns true if CommentType is a reference from another issue

func CountCommentTypeLabelWithEmptyLabel 

func CountCommentTypeLabelWithEmptyLabel(ctx context.Context) (int64, error)

CountCommentTypeLabelWithEmptyLabel count label comments with empty label

func CountCommentTypeLabelWithOutsideLabels 

func CountCommentTypeLabelWithOutsideLabels(ctx context.Context) (int64, error)

CountCommentTypeLabelWithOutsideLabels count label comments with outside label

func CountComments 

func CountComments(ctx context.Context, opts *FindCommentsOptions) (int64, error)

CountComments count all comments according options by ignoring pagination

func CountIssueLabelWithOutsideLabels 

func CountIssueLabelWithOutsideLabels(ctx context.Context) (int64, error)

CountIssueLabelWithOutsideLabels count label comments with outside label

func CountIssueWatchers 

func CountIssueWatchers(ctx context.Context, issueID int64) (int64, error)

CountIssueWatchers count watchers/unwatchers of a given issue

func CountIssues 

func CountIssues(ctx context.Context, opts *IssuesOptions, otherConds ...builder.Cond) (int64, error)

CountIssues number return of issues by given conditions.

func CountIssuesByRepo 

func CountIssuesByRepo(ctx context.Context, opts *IssuesOptions) (map[int64]int64, error)

CountIssuesByRepo map from repoID to number of issues matching the options

func CountLabelsByOrgID 

func CountLabelsByOrgID(ctx context.Context, orgID int64) (int64, error)

CountLabelsByOrgID count all labels that belong to given organization by ID.

func CountLabelsByRepoID 

func CountLabelsByRepoID(ctx context.Context, repoID int64) (int64, error)

CountLabelsByRepoID count number of all labels that belong to given repository by ID.

func CountMilestonesMap 

func CountMilestonesMap(ctx context.Context, opts FindMilestoneOptions) (map[int64]int64, error)

CountMilestonesByRepoCondAndKw map from repo conditions and the keyword of milestones' name to number of milestones matching the options`

func CountOrphanedIssueLabels 

func CountOrphanedIssueLabels(ctx context.Context) (int64, error)

CountOrphanedIssueLabels return count of IssueLabels witch have no label behind anymore

func CountOrphanedIssues 

func CountOrphanedIssues(ctx context.Context) (int64, error)

CountOrphanedIssues count issues without a repo

func CountOrphanedLabels 

func CountOrphanedLabels(ctx context.Context) (int64, error)

CountOrphanedLabels return count of labels witch are broken and not accessible via ui anymore

func CountReviews 

func CountReviews(ctx context.Context, opts FindReviewOptions) (int64, error)

CountReviews returns count of reviews passing FindReviewOptions

func CountTrackedTimes 

func CountTrackedTimes(ctx context.Context, opts *FindTrackedTimesOptions) (int64, error)

CountTrackedTimes returns count of tracked times that fit to the given options.

func CountUserStopwatches 

func CountUserStopwatches(ctx context.Context, userID int64) (int64, error)

CountUserStopwatches return count of the user's all stopwatches

func CreateIssueDependency 

func CreateIssueDependency(ctx context.Context, user *user_model.User, issue, dep *Issue) error

CreateIssueDependency creates a new dependency for an issue

func CreateIssueStopwatch 

func CreateIssueStopwatch(ctx context.Context, user *user_model.User, issue *Issue) (ok bool, err error)

CreateIssueStopwatch creates a stopwatch if the issue doesn't have the user's stopwatch. It also stops any other stopwatch that might be running for the user.

func CreateOrUpdateIssueWatch 

func CreateOrUpdateIssueWatch(ctx context.Context, userID, issueID int64, isWatching bool) error

CreateOrUpdateIssueWatch set watching for a user and issue

func DecrRepoIssueNumbers 

func DecrRepoIssueNumbers(ctx context.Context, repoID int64, isPull, includeTotal, includeClosed bool) error

DecrRepoIssueNumbers decrements repository issue numbers.

func DeleteComment 

func DeleteComment(ctx context.Context, comment *Comment) error

DeleteComment deletes the comment

func DeleteCommentReaction 

func DeleteCommentReaction(ctx context.Context, doerID, issueID, commentID int64, content string) error

DeleteCommentReaction deletes a reaction on comment.

func DeleteIssueLabel 

func DeleteIssueLabel(ctx context.Context, issue *Issue, label *Label, doer *user_model.User) error

DeleteIssueLabel deletes issue-label relation.

func DeleteIssueReaction 

func DeleteIssueReaction(ctx context.Context, doerID, issueID int64, content string) error

DeleteIssueReaction deletes a reaction on issue.

func DeleteIssueUserTimes 

func DeleteIssueUserTimes(ctx context.Context, issue *Issue, user *user_model.User) error

DeleteIssueUserTimes deletes times for issue

func DeleteLabel 

func DeleteLabel(ctx context.Context, id, labelID int64) error

DeleteLabel delete a label

func DeleteLabelsByRepoID 

func DeleteLabelsByRepoID(ctx context.Context, repoID int64) error

DeleteLabelsByRepoID deletes labels of some repository

func DeleteMilestoneByRepoID 

func DeleteMilestoneByRepoID(ctx context.Context, repoID, id int64) error

DeleteMilestoneByRepoID deletes a milestone from a repository.

func DeleteOrphanedIssueLabels 

func DeleteOrphanedIssueLabels(ctx context.Context) error

DeleteOrphanedIssueLabels delete IssueLabels witch have no label behind anymore

func DeleteOrphanedLabels 

func DeleteOrphanedLabels(ctx context.Context) error

DeleteOrphanedLabels delete labels witch are broken and not accessible via ui anymore

func DeletePullsByBaseRepoID 

func DeletePullsByBaseRepoID(ctx context.Context, repoID int64) error

DeletePullsByBaseRepoID deletes all pull requests by the base repository ID

func DeleteReaction 

func DeleteReaction(ctx context.Context, opts *ReactionOptions) error

DeleteReaction deletes reaction for issue or comment.

func DeleteReview 

func DeleteReview(ctx context.Context, r *Review) error

DeleteReview delete a review and it's code comments

func DeleteTime 

func DeleteTime(ctx context.Context, t *TrackedTime) error

DeleteTime delete a specific Time

func DismissReview 

func DismissReview(ctx context.Context, review *Review, isDismiss bool) (err error)

DismissReview change the dismiss status of a review

func FindAndUpdateIssueMentions 

func FindAndUpdateIssueMentions(ctx context.Context, issue *Issue, doer *user_model.User, content string) (mentions []*user_model.User, err error)

FindAndUpdateIssueMentions finds users mentioned in the given content string, and saves them in the database.

func FinishIssueStopwatch 

func FinishIssueStopwatch(ctx context.Context, user *user_model.User, issue *Issue) (ok bool, err error)

FinishIssueStopwatch if stopwatch exists, then finish it.

func FixCommentTypeLabelWithEmptyLabel 

func FixCommentTypeLabelWithEmptyLabel(ctx context.Context) (int64, error)

FixCommentTypeLabelWithEmptyLabel count label comments with empty label

func FixCommentTypeLabelWithOutsideLabels 

func FixCommentTypeLabelWithOutsideLabels(ctx context.Context) (int64, error)

FixCommentTypeLabelWithOutsideLabels count label comments with outside label

func FixIssueLabelWithOutsideLabels 

func FixIssueLabelWithOutsideLabels(ctx context.Context) (int64, error)

FixIssueLabelWithOutsideLabels fix label comments with outside label

func GetAssigneeIDsByIssue 

func GetAssigneeIDsByIssue(ctx context.Context, issueID int64) ([]int64, error)

GetAssigneeIDsByIssue returns the IDs of users assigned to an issue but skips joining with `user` for performance reasons. User permissions must be verified elsewhere if required.

func GetGrantedApprovalsCount 

func GetGrantedApprovalsCount(ctx context.Context, protectBranch *git_model.ProtectedBranch, pr *PullRequest) int64

GetGrantedApprovalsCount returns the number of granted approvals for pr. A granted approval must be authored by a user in an approval whitelist.

func GetIssueIDsByRepoID 

func GetIssueIDsByRepoID(ctx context.Context, repoID int64) ([]int64, error)

GetIssueIDsByRepoID returns all issue ids by repo id

func GetIssueMentionIDs 

func GetIssueMentionIDs(ctx context.Context, issueID int64) ([]int64, error)

GetIssueMentionIDs returns all mentioned user IDs of an issue.

func GetIssueTotalTrackedTime 

func GetIssueTotalTrackedTime(ctx context.Context, opts *IssuesOptions, isClosed optional.Option[bool]) (int64, error)

GetIssueTotalTrackedTime returns the total tracked time for issues by given conditions.

func GetIssueWatchersIDs 

func GetIssueWatchersIDs(ctx context.Context, issueID int64, watching bool) ([]int64, error)

GetIssueWatchersIDs returns IDs of subscribers or explicit unsubscribers to a given issue id but avoids joining with `user` for performance reasons User permissions must be verified elsewhere if required

func GetLabelIDsByNames 

func GetLabelIDsByNames(ctx context.Context, labelNames []string) ([]int64, error)

GetLabelIDsByNames returns a list of labelIDs by names. It doesn't filter them by repo or org, so it could return labels belonging to different repos/orgs. It's used for filtering issues via indexer, otherwise it would be useless. Since it could return labels with the same name, so the length of returned ids could be more than the length of names.

func GetLabelIDsInOrgByNames 

func GetLabelIDsInOrgByNames(ctx context.Context, orgID int64, labelNames []string) ([]int64, error)

GetLabelIDsInOrgByNames returns a list of labelIDs by names in a given org.

func GetLabelIDsInRepoByNames 

func GetLabelIDsInRepoByNames(ctx context.Context, repoID int64, labelNames []string) ([]int64, error)

GetLabelIDsInRepoByNames returns a list of labelIDs by names in a given repository. it silently ignores label names that do not belong to the repository.

func GetMilestoneIDsByNames 

func GetMilestoneIDsByNames(ctx context.Context, names []string) ([]int64, error)

GetMilestoneIDsByNames returns a list of milestone ids by given names. It doesn't filter them by repo, so it could return milestones belonging to different repos. It's used for filtering issues via indexer, otherwise it would be useless. Since it could return milestones with the same name, so the length of returned ids could be more than the length of names.

func GetOrphanedIssueRepoIDs 

func GetOrphanedIssueRepoIDs(ctx context.Context) ([]int64, error)

func GetParticipantsIDsByIssueID 

func GetParticipantsIDsByIssueID(ctx context.Context, issueID int64) ([]int64, error)

GetParticipantsIDsByIssueID returns the IDs of all users who participated in comments of an issue, but skips joining with `user` for performance reasons. User permissions must be verified elsewhere if required.

func GetPinnedIssueIDs 

func GetPinnedIssueIDs(ctx context.Context, repoID int64, isPull bool) ([]int64, error)

func GetPullRequestIDsByCheckStatus 

func GetPullRequestIDsByCheckStatus(ctx context.Context, status PullRequestStatus) ([]int64, error)

GetPullRequestIDsByCheckStatus returns all pull requests according the special checking status.

func GetTrackedSeconds 

func GetTrackedSeconds(ctx context.Context, opts FindTrackedTimesOptions) (trackedSeconds int64, err error)

GetTrackedSeconds return sum of seconds

func HasEnoughApprovals 

func HasEnoughApprovals(ctx context.Context, protectBranch *git_model.ProtectedBranch, pr *PullRequest) bool

HasEnoughApprovals returns true if pr has enough granted approvals.

func HasIssueContentHistory 

func HasIssueContentHistory(dbCtx context.Context, issueID, commentID int64) (bool, error)

HasIssueContentHistory check if a ContentHistory entry exists

func HasIssueLabel 

func HasIssueLabel(ctx context.Context, issueID, labelID int64) bool

HasIssueLabel returns true if issue has been labeled.

func HasMergedPullRequestInRepo 

func HasMergedPullRequestInRepo(ctx context.Context, repoID, posterID int64) (bool, error)

HasMergedPullRequestInRepo returns whether the user(poster) has merged pull-request in the repo

func HasMergedPullRequestInRepoBefore 

func HasMergedPullRequestInRepoBefore(ctx context.Context, repoID, posterID int64, beforeUnix timeutil.TimeStamp, excludePullID int64) (bool, error)

HasMergedPullRequestInRepoBefore returns whether the user has a merged PR before a timestamp (0 = no limit)

func HasMilestoneByRepoID 

func HasMilestoneByRepoID(ctx context.Context, repoID, id int64) (bool, error)

HasMilestoneByRepoID returns if the milestone exists in the repository.

func HasUnmergedPullRequestsByHeadInfo 

func HasUnmergedPullRequestsByHeadInfo(ctx context.Context, repoID int64, branch string) (bool, error)

HasUnmergedPullRequestsByHeadInfo checks if there are open and not merged pull request by given head information (repo and branch)

func HasUserStopwatch 

func HasUserStopwatch(ctx context.Context, userID int64) (exists bool, sw *Stopwatch, issue *Issue, err error)

HasUserStopwatch returns true if the user has a stopwatch

func HasWorkInProgressPrefix 

func HasWorkInProgressPrefix(title string) bool

HasWorkInProgressPrefix determines if the given PR title has a Work In Progress prefix

func IncrRepoIssueNumbers 

func IncrRepoIssueNumbers(ctx context.Context, repoID int64, isPull, totalOrClosed bool) error

IncrRepoIssueNumbers increments repository issue numbers.

func InsertIssueComments 

func InsertIssueComments(ctx context.Context, comments []*Comment) error

InsertIssueComments inserts many comments of issues.

func InsertIssues 

func InsertIssues(ctx context.Context, issues ...*Issue) error

InsertIssues insert issues to database

func InsertMilestones 

func InsertMilestones(ctx context.Context, ms ...*Milestone) (err error)

InsertMilestones creates milestones of repository.

func InsertPullRequests 

func InsertPullRequests(ctx context.Context, prs ...*PullRequest) error

InsertPullRequests inserted pull requests

func InsertReviews 

func InsertReviews(ctx context.Context, reviews []*Review) error

InsertReviews inserts review and review comments

func IsContentEmptyErr 

func IsContentEmptyErr(err error) bool

IsContentEmptyErr returns true if err is a ContentEmptyErr

func IsErrCircularDependency 

func IsErrCircularDependency(err error) bool

IsErrCircularDependency checks if an error is a ErrCircularDependency.

func IsErrCommentNotExist 

func IsErrCommentNotExist(err error) bool

IsErrCommentNotExist checks if an error is a ErrCommentNotExist.

func IsErrDependenciesLeft 

func IsErrDependenciesLeft(err error) bool

IsErrDependenciesLeft checks if an error is a ErrDependenciesLeft.

func IsErrDependencyExists 

func IsErrDependencyExists(err error) bool

IsErrDependencyExists checks if an error is a ErrDependencyExists.

func IsErrDependencyNotExists 

func IsErrDependencyNotExists(err error) bool

IsErrDependencyNotExists checks if an error is a ErrDependencyExists.

func IsErrForbiddenIssueReaction 

func IsErrForbiddenIssueReaction(err error) bool

IsErrForbiddenIssueReaction checks if an error is a ErrForbiddenIssueReaction.

func IsErrIssueIsClosed 

func IsErrIssueIsClosed(err error) bool

IsErrIssueIsClosed checks if an error is a ErrIssueIsClosed.

func IsErrIssueIsOpen 

func IsErrIssueIsOpen(err error) bool

IsErrIssueIsOpen checks if an error is a ErrIssueIsOpen.

func IsErrIssueMaxPinReached 

func IsErrIssueMaxPinReached(err error) bool

IsErrIssueMaxPinReached returns if the error is, that the User can't pin more Issues

func IsErrIssueNotExist 

func IsErrIssueNotExist(err error) bool

IsErrIssueNotExist checks if an error is a ErrIssueNotExist.

func IsErrLabelNotExist 

func IsErrLabelNotExist(err error) bool

IsErrLabelNotExist checks if an error is a ErrLabelNotExist.

func IsErrMilestoneNotExist 

func IsErrMilestoneNotExist(err error) bool

IsErrMilestoneNotExist checks if an error is a ErrMilestoneNotExist.

func IsErrNewIssueInsert 

func IsErrNewIssueInsert(err error) bool

IsErrNewIssueInsert checks if an error is a ErrNewIssueInsert.

func IsErrNotValidReviewRequest 

func IsErrNotValidReviewRequest(err error) bool

IsErrNotValidReviewRequest checks if an error is a ErrNotValidReviewRequest.

func IsErrOrgLabelNotExist 

func IsErrOrgLabelNotExist(err error) bool

IsErrOrgLabelNotExist checks if an error is a OrgErrLabelNotExist.

func IsErrPullRequestAlreadyExists 

func IsErrPullRequestAlreadyExists(err error) bool

IsErrPullRequestAlreadyExists checks if an error is a ErrPullRequestAlreadyExists.

func IsErrPullRequestNotExist 

func IsErrPullRequestNotExist(err error) bool

IsErrPullRequestNotExist checks if an error is a ErrPullRequestNotExist.

func IsErrReactionAlreadyExist 

func IsErrReactionAlreadyExist(err error) bool

IsErrReactionAlreadyExist checks if an error is a ErrReactionAlreadyExist.

func IsErrRepoLabelNotExist 

func IsErrRepoLabelNotExist(err error) bool

IsErrRepoLabelNotExist checks if an error is a RepoErrLabelNotExist.

func IsErrReviewNotExist 

func IsErrReviewNotExist(err error) bool

IsErrReviewNotExist checks if an error is a ErrReviewNotExist.

func IsErrReviewRequestOnClosedPR 

func IsErrReviewRequestOnClosedPR(err error) bool

IsErrReviewRequestOnClosedPR checks if an error is an ErrReviewRequestOnClosedPR.

func IsErrUnknownDependencyType 

func IsErrUnknownDependencyType(err error) bool

IsErrUnknownDependencyType checks if an error is ErrUnknownDependencyType

func IsNewPinAllowed 

func IsNewPinAllowed(ctx context.Context, repoID int64, isPull bool) (bool, error)

IsNewPinAllowed returns if a new Issue or Pull request can be pinned

func IsOfficialReviewer 

func IsOfficialReviewer(ctx context.Context, issue *Issue, reviewer *user_model.User) (bool, error)

IsOfficialReviewer check if at least one of the provided reviewers can make official reviews in issue (counts towards required approvals)

func IsOfficialReviewerTeam 

func IsOfficialReviewerTeam(ctx context.Context, issue *Issue, team *organization.Team) (bool, error)

IsOfficialReviewerTeam check if reviewer in this team can make official reviews in issue (counts towards required approvals)

func IsUserAssignedToIssue 

func IsUserAssignedToIssue(ctx context.Context, issue *Issue, user *user_model.User) (isAssigned bool, err error)

IsUserAssignedToIssue returns true when the user is assigned to the issue

func IsUserParticipantsOfIssue 

func IsUserParticipantsOfIssue(ctx context.Context, user *user_model.User, issue *Issue) bool

IsUserParticipantsOfIssue return true if user is participants of an issue

func IssueAssignOrRemoveProject 

func IssueAssignOrRemoveProject(ctx context.Context, issue *Issue, doer *user_model.User, newProjectID, newColumnID int64) error

IssueAssignOrRemoveProject changes the project associated with an issue If newProjectID is 0, the issue is removed from the project

func IssueIDs 

func IssueIDs(ctx context.Context, opts *IssuesOptions, otherConds ...builder.Cond) ([]int64, int64, error)

IssueIDs returns a list of issue ids by given conditions.

func IssueNoDependenciesLeft 

func IssueNoDependenciesLeft(ctx context.Context, issue *Issue) (bool, error)

IssueNoDependenciesLeft checks if issue can be closed

func KeepLimitedContentHistory 

func KeepLimitedContentHistory(ctx context.Context, issueID, commentID int64, limit int)

KeepLimitedContentHistory keeps at most `limit` history revisions, it will hard delete out-dated revisions, sorting by revision interval we can ignore all errors in this function, so we just log them

func LoadProjectIssueColumnMap 

func LoadProjectIssueColumnMap(ctx context.Context, projectID, defaultColumnID int64) (map[int64]int64, error)

func LockIssue 

func LockIssue(ctx context.Context, opts *IssueLockOptions) error

LockIssue locks an issue. This would limit commenting abilities to users with write access to the repo

func MakeIDsFromAPIAssigneesToAdd 

func MakeIDsFromAPIAssigneesToAdd(ctx context.Context, oneAssignee string, multipleAssignees []string) (assigneeIDs []int64, err error)

MakeIDsFromAPIAssigneesToAdd returns an array with all assignee IDs

func MarkConversation 

func MarkConversation(ctx context.Context, comment *Comment, doer *user_model.User, isResolve bool) (err error)

MarkConversation Add or remove Conversation mark for a code comment

func MarkReviewsAsNotStale 

func MarkReviewsAsNotStale(ctx context.Context, issueID int64, commitID string) (err error)

MarkReviewsAsNotStale marks existing reviews as not stale for a giving commit SHA

func MarkReviewsAsStale 

func MarkReviewsAsStale(ctx context.Context, issueID int64) (err error)

MarkReviewsAsStale marks existing reviews as stale

func MergeBlockedByOfficialReviewRequests 

func MergeBlockedByOfficialReviewRequests(ctx context.Context, protectBranch *git_model.ProtectedBranch, pr *PullRequest) bool

MergeBlockedByOfficialReviewRequests block merge because of some review request to official reviewer of from official review

func MergeBlockedByOutdatedBranch 

func MergeBlockedByOutdatedBranch(protectBranch *git_model.ProtectedBranch, pr *PullRequest) bool

MergeBlockedByOutdatedBranch returns true if merge is blocked by an outdated head branch

func MergeBlockedByRejectedReview 

func MergeBlockedByRejectedReview(ctx context.Context, protectBranch *git_model.ProtectedBranch, pr *PullRequest) bool

MergeBlockedByRejectedReview returns true if merge is blocked by rejected reviews

func MovePin 

func MovePin(ctx context.Context, issue *Issue, newPosition int) error

MovePin moves a Pinned Issue to a new Position

func NewIssue 

func NewIssue(ctx context.Context, repo *repo_model.Repository, issue *Issue, labelIDs []int64, uuids []string) (err error)

NewIssue creates new issue with labels for repository. The title will be cut off at 255 characters if it's longer than 255 characters.

func NewIssueLabel 

func NewIssueLabel(ctx context.Context, issue *Issue, label *Label, doer *user_model.User) (err error)

NewIssueLabel creates a new issue-label relation.

func NewIssueLabels 

func NewIssueLabels(ctx context.Context, issue *Issue, labels []*Label, doer *user_model.User) (err error)

NewIssueLabels creates a list of issue-label relations.

func NewIssueUsers 

func NewIssueUsers(ctx context.Context, repo *repo_model.Repository, issue *Issue) error

NewIssueUsers inserts an issue related users

func NewIssueWithIndex 

func NewIssueWithIndex(ctx context.Context, doer *user_model.User, opts NewIssueOptions) (err error)

NewIssueWithIndex creates issue with given index

func NewLabel 

func NewLabel(ctx context.Context, l *Label) error

NewLabel creates a new label

func NewLabels 

func NewLabels(ctx context.Context, labels ...*Label) error

NewLabels creates new labels

func NewMilestone 

func NewMilestone(ctx context.Context, m *Milestone) (err error)

NewMilestone creates new milestone of repository.

func NewPullRequest 

func NewPullRequest(ctx context.Context, repo *repo_model.Repository, issue *Issue, labelIDs []int64, uuids []string, pr *PullRequest) (err error)

NewPullRequest creates new pull request with labels for repository.

func PinIssue 

func PinIssue(ctx context.Context, issue *Issue, user *user_model.User) error

Pin pins a Issue

func QueryIssueContentHistoryEditedCountMap 

func QueryIssueContentHistoryEditedCountMap(dbCtx context.Context, issueID int64) (map[int64]int, error)

QueryIssueContentHistoryEditedCountMap query related history count of each comment (comment_id = 0 means the main issue) only return the count map for "edited" (history revision count > 1) issues or comments.

func RecalculateIssueIndexForRepo 

func RecalculateIssueIndexForRepo(ctx context.Context, repoID int64) error

RecalculateIssueIndexForRepo create issue_index for repo if not exist and update it based on highest index of existing issues assigned to a repo

func RemoveDuplicateExclusiveIssueLabels 

func RemoveDuplicateExclusiveIssueLabels(ctx context.Context, issue *Issue, label *Label, doer *user_model.User) (err error)

Remove all issue labels in the given exclusive scope

func RemoveIssueDependency 

func RemoveIssueDependency(ctx context.Context, user *user_model.User, issue, dep *Issue, depType DependencyType) (err error)

RemoveIssueDependency removes a dependency from an issue

func RemoveIssueWatchersByRepoID 

func RemoveIssueWatchersByRepoID(ctx context.Context, userID, repoID int64) error

RemoveIssueWatchersByRepoID remove issue watchers by repoID

func ReplaceIssueLabels 

func ReplaceIssueLabels(ctx context.Context, issue *Issue, labels []*Label, doer *user_model.User) (err error)

ReplaceIssueLabels removes all current labels and add new labels to the issue. Triggers appropriate WebHooks, if any.

func ResolveIssueMentionsByVisibility 

func ResolveIssueMentionsByVisibility(ctx context.Context, issue *Issue, doer *user_model.User, mentions []string) (users []*user_model.User, err error)

ResolveIssueMentionsByVisibility returns the users mentioned in an issue, removing those that don't have access to reading it. Teams are expanded into their users, but organizations are ignored.

func ReviewExists 

func ReviewExists(ctx context.Context, issue *Issue, treePath string, line int64) (bool, error)

ReviewExists returns whether a review exists for a particular line of code in the PR

func SaveIssueContentHistory 

func SaveIssueContentHistory(ctx context.Context, posterID, issueID, commentID int64, editTime timeutil.TimeStamp, contentText string, isFirstCreated bool) error

SaveIssueContentHistory save history

func SoftDeleteIssueContentHistory 

func SoftDeleteIssueContentHistory(dbCtx context.Context, historyID int64) error

SoftDeleteIssueContentHistory soft delete

func StopwatchExists 

func StopwatchExists(ctx context.Context, userID, issueID int64) bool

StopwatchExists returns true if the stopwatch exists

func SubmitReview 

func SubmitReview(ctx context.Context, doer *user_model.User, issue *Issue, reviewType ReviewType, content, commitID string, stale bool, attachmentUUIDs []string) (*Review, *Comment, error)

SubmitReview creates a review out of the existing pending review or creates a new one if no pending review exist

func TokenizeCodeOwnersLine 

func TokenizeCodeOwnersLine(line string) []string

func TotalTimesForEachUser 

func TotalTimesForEachUser(ctx context.Context, options *FindTrackedTimesOptions) (map[*user_model.User]int64, error)

TotalTimesForEachUser returns the spent time in seconds for each user by an issue

func UnlockIssue 

func UnlockIssue(ctx context.Context, opts *IssueLockOptions) error

UnlockIssue unlocks a previously locked issue.

func UnpinIssue 

func UnpinIssue(ctx context.Context, issue *Issue, user *user_model.User) error

UnpinIssue unpins a Issue

func UpdateAllowEdits 

func UpdateAllowEdits(ctx context.Context, pr *PullRequest) error

UpdateAllowEdits update if PR can be edited from maintainers

func UpdateComment 

func UpdateComment(ctx context.Context, c *Comment, contentVersion int, doer *user_model.User) error

UpdateComment updates information of comment.

func UpdateCommentAttachments 

func UpdateCommentAttachments(ctx context.Context, c *Comment, uuids []string) error

UpdateCommentAttachments update attachments by UUIDs for the comment

func UpdateCommentInvalidate 

func UpdateCommentInvalidate(ctx context.Context, c *Comment) error

UpdateCommentInvalidate updates comment invalidated column

func UpdateCommentsMigrationsByType 

func UpdateCommentsMigrationsByType(ctx context.Context, tp structs.GitServiceType, originalAuthorID string, posterID int64) error

UpdateCommentsMigrationsByType updates comments' migrations information via given git service type and original id and poster id

func UpdateIssueAttachments 

func UpdateIssueAttachments(ctx context.Context, issueID int64, uuids []string) (err error)

UpdateIssueAttachments update attachments by UUIDs for the issue

func UpdateIssueCols 

func UpdateIssueCols(ctx context.Context, issue *Issue, cols ...string) error

UpdateIssueCols updates cols of issue

func UpdateIssueDeadline 

func UpdateIssueDeadline(ctx context.Context, issue *Issue, deadlineUnix timeutil.TimeStamp, doer *user_model.User) (err error)

UpdateIssueDeadline updates an issue deadline and adds comments. Setting a deadline to 0 means deleting it.

func UpdateIssueMentions 

func UpdateIssueMentions(ctx context.Context, issueID int64, mentions []*user_model.User) error

UpdateIssueMentions updates issue-user relations for mentioned users.

func UpdateIssueNumComments 

func UpdateIssueNumComments(ctx context.Context, issueID int64) error

func UpdateIssueNumCommentsBuilder 

func UpdateIssueNumCommentsBuilder(issueID int64) *builder.Builder

func UpdateIssueUserByRead 

func UpdateIssueUserByRead(ctx context.Context, uid, issueID int64) error

UpdateIssueUserByRead updates issue-user relation for reading.

func UpdateIssueUsersByMentions 

func UpdateIssueUsersByMentions(ctx context.Context, issueID int64, uids []int64) error

UpdateIssueUsersByMentions updates issue-user pairs by mentioning.

func UpdateIssuesMigrationsByType 

func UpdateIssuesMigrationsByType(ctx context.Context, gitServiceType api.GitServiceType, originalAuthorID string, posterID int64) error

UpdateIssuesMigrationsByType updates all migrated repositories' issues from gitServiceType to replace originalAuthorID to posterID

func UpdateLabel 

func UpdateLabel(ctx context.Context, l *Label) error

UpdateLabel updates label information.

func UpdateMilestone 

func UpdateMilestone(ctx context.Context, m *Milestone, oldIsClosed bool) error

UpdateMilestone updates information of given milestone.

func UpdateMilestoneCounters 

func UpdateMilestoneCounters(ctx context.Context, id int64) error

UpdateMilestoneCounters calculates NumIssues, NumClosesIssues and Completeness

func UpdateReactionsMigrationsByType 

func UpdateReactionsMigrationsByType(ctx context.Context, gitServiceType api.GitServiceType, originalAuthorID string, userID int64) error

UpdateReactionsMigrationsByType updates all migrated repositories' reactions from gitServiceType to replace originalAuthorID to posterID

func UpdateReviewsMigrationsByType 

func UpdateReviewsMigrationsByType(ctx context.Context, tp structs.GitServiceType, originalAuthorID string, posterID int64) error

UpdateReviewsMigrationsByType updates reviews' migrations information via given git service type and original id and poster id

Types

type AssignedIssuesOptions 

type AssignedIssuesOptions struct {
	db.ListOptions
	AssigneeID  int64
	RepoOwnerID int64
}

func (*AssignedIssuesOptions) ToConds 

func (opts *AssignedIssuesOptions) ToConds() builder.Cond

type CodeComments 

type CodeComments map[string]map[int64][]*Comment

CodeComments represents comments on code by using this structure: FILENAME -> LINE (+ == proposed; - == previous) -> COMMENTS

func FetchCodeComments 

func FetchCodeComments(ctx context.Context, issue *Issue, currentUser *user_model.User, showOutdatedComments bool) (CodeComments, error)

FetchCodeComments will return a 2d-map: ["Path"]["Line"] = Comments at line

type CodeOwnerRule 

type CodeOwnerRule struct {
	Rule     *regexp.Regexp
	Negative bool
	Users    []*user_model.User
	Teams    []*org_model.Team
}

func GetCodeOwnersFromContent 

func GetCodeOwnersFromContent(ctx context.Context, data string) ([]*CodeOwnerRule, []string)

GetCodeOwnersFromContent returns the code owners configuration Return empty slice if files missing Return warning messages on parsing errors We're trying to do the best we can when parsing a file. Invalid lines are skipped. Non-existent users and teams too.

func ParseCodeOwnersLine 

func ParseCodeOwnersLine(ctx context.Context, tokens []string) (*CodeOwnerRule, []string)

type Comment 

type Comment struct {
	ID               int64            `xorm:"pk autoincr"`
	Type             CommentType      `xorm:"INDEX"`
	PosterID         int64            `xorm:"INDEX"`
	Poster           *user_model.User `xorm:"-"`
	OriginalAuthor   string
	OriginalAuthorID int64
	IssueID          int64  `xorm:"INDEX"`
	Issue            *Issue `xorm:"-"`
	LabelID          int64
	Label            *Label   `xorm:"-"`
	AddedLabels      []*Label `xorm:"-"`
	RemovedLabels    []*Label `xorm:"-"`
	OldProjectID     int64
	ProjectID        int64
	OldProject       *project_model.Project `xorm:"-"`
	Project          *project_model.Project `xorm:"-"`
	OldMilestoneID   int64
	MilestoneID      int64
	OldMilestone     *Milestone `xorm:"-"`
	Milestone        *Milestone `xorm:"-"`
	TimeID           int64
	Time             *TrackedTime `xorm:"-"`
	AssigneeID       int64
	RemovedAssignee  bool
	Assignee         *user_model.User   `xorm:"-"`
	AssigneeTeamID   int64              `xorm:"NOT NULL DEFAULT 0"`
	AssigneeTeam     *organization.Team `xorm:"-"`
	ResolveDoerID    int64
	ResolveDoer      *user_model.User `xorm:"-"`
	OldTitle         string
	NewTitle         string
	OldRef           string
	NewRef           string
	DependentIssueID int64  `xorm:"index"` // This is used by issue_service.deleteIssue
	DependentIssue   *Issue `xorm:"-"`

	CommitID        int64
	Line            int64         // - previous line / + proposed line
	TreePath        string        `xorm:"VARCHAR(4000)"` // SQLServer only supports up to 4000
	Content         string        `xorm:"LONGTEXT"`
	ContentVersion  int           `xorm:"NOT NULL DEFAULT 0"`
	RenderedContent template.HTML `xorm:"-"`

	// Path represents the 4 lines of code cemented by this comment
	Patch       string `xorm:"-"`
	PatchQuoted string `xorm:"LONGTEXT patch"`

	CreatedUnix timeutil.TimeStamp `xorm:"INDEX created"`
	UpdatedUnix timeutil.TimeStamp `xorm:"INDEX updated"`

	// Reference issue in commit message
	CommitSHA string `xorm:"VARCHAR(64)"`

	Attachments []*repo_model.Attachment `xorm:"-"`
	Reactions   ReactionList             `xorm:"-"`

	// For view issue page.
	ShowRole RoleDescriptor `xorm:"-"`

	Review      *Review `xorm:"-"`
	ReviewID    int64   `xorm:"index"`
	Invalidated bool

	// Reference an issue or pull from another comment, issue or PR
	// All information is about the origin of the reference
	RefRepoID    int64                 `xorm:"index"` // Repo where the referencing
	RefIssueID   int64                 `xorm:"index"`
	RefCommentID int64                 `xorm:"index"`    // 0 if origin is Issue title or content (or PR's)
	RefAction    references.XRefAction `xorm:"SMALLINT"` // What happens if RefIssueID resolves
	RefIsPull    bool

	CommentMetaData *CommentMetaData `xorm:"JSON TEXT"` // put all non-index metadata in a single field

	RefRepo    *repo_model.Repository `xorm:"-"`
	RefIssue   *Issue                 `xorm:"-"`
	RefComment *Comment               `xorm:"-"`

	Commits     []*git_model.SignCommitWithStatuses `xorm:"-"`
	OldCommit   string                              `xorm:"-"`
	NewCommit   string                              `xorm:"-"`
	CommitsNum  int64                               `xorm:"-"`
	IsForcePush bool                                `xorm:"-"`
}

Comment represents a comment in commit and issue page.

func AddReviewRequest 

func AddReviewRequest(ctx context.Context, issue *Issue, reviewer, doer *user_model.User) (*Comment, error)

AddReviewRequest add a review request from one reviewer

func AddTeamReviewRequest 

func AddTeamReviewRequest(ctx context.Context, issue *Issue, reviewer *organization.Team, doer *user_model.User) (*Comment, error)

AddTeamReviewRequest add a review request from one team

func CloseIssue 

func CloseIssue(ctx context.Context, issue *Issue, doer *user_model.User) (*Comment, error)

CloseIssue changes issue status to closed.

func CreateAutoMergeComment 

func CreateAutoMergeComment(ctx context.Context, typ CommentType, pr *PullRequest, doer *user_model.User) (comment *Comment, err error)

CreateAutoMergeComment is a internal function, only use it for CommentTypePRScheduledToAutoMerge and CommentTypePRUnScheduledToAutoMerge CommentTypes

func CreateComment 

func CreateComment(ctx context.Context, opts *CreateCommentOptions) (_ *Comment, err error)

CreateComment creates comment with context

func GetCommentByID 

func GetCommentByID(ctx context.Context, id int64) (*Comment, error)

GetCommentByID returns the comment by given ID.

func RemoveReviewRequest 

func RemoveReviewRequest(ctx context.Context, issue *Issue, reviewer, doer *user_model.User) (*Comment, error)

RemoveReviewRequest remove a review request from one reviewer

func RemoveTeamReviewRequest 

func RemoveTeamReviewRequest(ctx context.Context, issue *Issue, reviewer *organization.Team, doer *user_model.User) (*Comment, error)

RemoveTeamReviewRequest remove a review request from one team

func ReopenIssue 

func ReopenIssue(ctx context.Context, issue *Issue, doer *user_model.User) (*Comment, error)

ReopenIssue changes issue status to open.

func SetIssueAsClosed 

func SetIssueAsClosed(ctx context.Context, issue *Issue, doer *user_model.User, isMergePull bool) (*Comment, error)

func ToggleIssueAssignee 

func ToggleIssueAssignee(ctx context.Context, issue *Issue, doer *user_model.User, assigneeID int64) (removed bool, comment *Comment, err error)

ToggleIssueAssignee changes a user between assigned and not assigned for this issue, and make issue comment for it.

func (*Comment) APIURL 

func (c *Comment) APIURL(ctx context.Context) string

APIURL formats a API-string to the issue-comment

func (*Comment) AddCrossReferences 

func (c *Comment) AddCrossReferences(stdCtx context.Context, doer *user_model.User, removeOld bool) error

AddCrossReferences add cross references

func (*Comment) AfterDelete 

func (c *Comment) AfterDelete(ctx context.Context)

AfterDelete is invoked from XORM after the object is deleted.

func (*Comment) AfterLoad 

func (c *Comment) AfterLoad()

AfterLoad is invoked from XORM after setting the values of all fields of this object.

func (*Comment) BeforeInsert 

func (c *Comment) BeforeInsert()

BeforeInsert will be invoked by XORM before inserting a record

func (*Comment) BeforeUpdate 

func (c *Comment) BeforeUpdate()

BeforeUpdate will be invoked by XORM before updating a record 

func (c *Comment) CodeCommentLink(ctx context.Context) string

CodeCommentLink returns the url to a comment in code

func (*Comment) DiffSide 

func (c *Comment) DiffSide() string

DiffSide returns "previous" if Comment.Line is a LOC of the previous changes and "proposed" if it is a LOC of the proposed changes.

func (*Comment) EventTag 

func (c *Comment) EventTag() string

EventTag returns unique event hash tag for comment.

func (*Comment) GetExternalID 

func (c *Comment) GetExternalID() int64

GetExternalID ExternalUserRemappable interface

func (*Comment) GetExternalName 

func (c *Comment) GetExternalName() string

GetExternalName ExternalUserRemappable interface

func (*Comment) GetUserID 

func (c *Comment) GetUserID() int64

GetUserID ExternalUserRemappable interface

func (*Comment) HTMLURL 

func (c *Comment) HTMLURL(ctx context.Context) string

HTMLURL formats a URL-string to the issue-comment

func (*Comment) HasOriginalAuthor 

func (c *Comment) HasOriginalAuthor() bool

HasOriginalAuthor returns if a comment was migrated and has an original author.

func (*Comment) HashTag 

func (c *Comment) HashTag() string

HashTag returns unique hash tag for comment.

func (*Comment) IsResolved 

func (c *Comment) IsResolved() bool

IsResolved check if an code comment is resolved

func (*Comment) IssueURL 

func (c *Comment) IssueURL(ctx context.Context) string

IssueURL formats a URL-string to the issue 

func (c *Comment) Link(ctx context.Context) string

Link formats a relative URL-string to the issue-comment

func (*Comment) LoadAssigneeUserAndTeam 

func (c *Comment) LoadAssigneeUserAndTeam(ctx context.Context) error

LoadAssigneeUserAndTeam if comment.Type is CommentTypeAssignees, then load assignees

func (*Comment) LoadAttachments 

func (c *Comment) LoadAttachments(ctx context.Context) error

LoadAttachments loads attachments (it never returns error, the error during `GetAttachmentsByCommentIDCtx` is ignored)

func (*Comment) LoadDepIssueDetails 

func (c *Comment) LoadDepIssueDetails(ctx context.Context) (err error)

LoadDepIssueDetails loads Dependent Issue Details

func (*Comment) LoadIssue 

func (c *Comment) LoadIssue(ctx context.Context) (err error)

LoadIssue loads the issue reference for the comment

func (*Comment) LoadLabel 

func (c *Comment) LoadLabel(ctx context.Context) error

LoadLabel if comment.Type is CommentTypeLabel, then load Label

func (*Comment) LoadMilestone 

func (c *Comment) LoadMilestone(ctx context.Context) error

LoadMilestone if comment.Type is CommentTypeMilestone, then load milestone

func (*Comment) LoadPoster 

func (c *Comment) LoadPoster(ctx context.Context) (err error)

LoadPoster loads comment poster

func (*Comment) LoadProject 

func (c *Comment) LoadProject(ctx context.Context) error

LoadProject if comment.Type is CommentTypeProject, then load project.

func (*Comment) LoadReactions 

func (c *Comment) LoadReactions(ctx context.Context, repo *repo_model.Repository) (err error)

LoadReactions loads comment reactions

func (*Comment) LoadRefComment 

func (c *Comment) LoadRefComment(ctx context.Context) (err error)

LoadRefComment loads comment that created this reference from database

func (*Comment) LoadRefIssue 

func (c *Comment) LoadRefIssue(ctx context.Context) (err error)

LoadRefIssue loads comment that created this reference from database

func (*Comment) LoadResolveDoer 

func (c *Comment) LoadResolveDoer(ctx context.Context) (err error)

LoadResolveDoer if comment.Type is CommentTypeCode and ResolveDoerID not zero, then load resolveDoer

func (*Comment) LoadReview 

func (c *Comment) LoadReview(ctx context.Context) (err error)

LoadReview loads the associated review

func (*Comment) LoadTime 

func (c *Comment) LoadTime(ctx context.Context) error

LoadTime loads the associated time for a CommentTypeAddTimeManual

func (*Comment) PRURL 

func (c *Comment) PRURL(ctx context.Context) string

PRURL formats a URL-string to the pull-request 

func (c *Comment) RefCommentLink(ctx context.Context) string

RefCommentLink returns the relative URL for the comment that created this reference

func (*Comment) RefIssueIdent 

func (c *Comment) RefIssueIdent(ctx context.Context) string

RefIssueIdent returns the user friendly identity (e.g. "#1234") of the issue where this reference was created 

func (c *Comment) RefIssueLink(ctx context.Context) string

RefIssueLink returns the relative URL of the issue where this reference was created

func (*Comment) RefIssueTitle 

func (c *Comment) RefIssueTitle(ctx context.Context) string

RefIssueTitle returns the title of the issue where this reference was created

func (*Comment) RemapExternalUser 

func (c *Comment) RemapExternalUser(externalName string, externalID, userID int64) error

RemapExternalUser ExternalUserRemappable interface

func (*Comment) UnsignedLine 

func (c *Comment) UnsignedLine() uint64

UnsignedLine returns the LOC of the code comment without + or -

type CommentList 

type CommentList []*Comment

CommentList defines a list of comments

func FetchCodeCommentsByLine 

func FetchCodeCommentsByLine(ctx context.Context, issue *Issue, currentUser *user_model.User, treePath string, line int64, showOutdatedComments bool) (CommentList, error)

FetchCodeCommentsByLine fetches the code comments for a given treePath and line number

func FindComments 

func FindComments(ctx context.Context, opts *FindCommentsOptions) (CommentList, error)

FindComments returns all comments according options

func (CommentList) Issues 

func (comments CommentList) Issues() IssueList

Issues returns all the issues of comments

func (CommentList) LoadAttachments 

func (comments CommentList) LoadAttachments(ctx context.Context) (err error)

LoadAttachments loads attachments

func (CommentList) LoadAttachmentsByIssue 

func (comments CommentList) LoadAttachmentsByIssue(ctx context.Context) error

LoadAttachmentsByIssue loads attachments by issue id

func (CommentList) LoadAttributes 

func (comments CommentList) LoadAttributes(ctx context.Context) (err error)

LoadAttributes loads attributes of the comments, except for attachments and comments

func (CommentList) LoadIssues 

func (comments CommentList) LoadIssues(ctx context.Context) error

LoadIssues loads issues of comments

func (CommentList) LoadPosters 

func (comments CommentList) LoadPosters(ctx context.Context) error

LoadPosters loads posters

type CommentMetaData 

type CommentMetaData struct {
	ProjectColumnID    int64  `json:"project_column_id,omitempty"`
	ProjectColumnTitle string `json:"project_column_title,omitempty"`
	ProjectTitle       string `json:"project_title,omitempty"`
}

CommentMetaData stores metadata for a comment, these data will not be changed once inserted into database

type CommentType 

type CommentType int

CommentType defines whether a comment is just a simple comment, an action (like close) or a reference. 

const (
	CommentTypeComment CommentType = iota // 0 Plain comment, can be associated with a commit (CommitID > 0) and a line (LineNum > 0)

	CommentTypeReopen // 1
	CommentTypeClose  // 2

	CommentTypeIssueRef   // 3 References.
	CommentTypeCommitRef  // 4 Reference from a commit (not part of a pull request)
	CommentTypeCommentRef // 5 Reference from a comment
	CommentTypePullRef    // 6 Reference from a pull request

	CommentTypeLabel        // 7 Labels changed
	CommentTypeMilestone    // 8 Milestone changed
	CommentTypeAssignees    // 9 Assignees changed
	CommentTypeChangeTitle  // 10 Change Title
	CommentTypeDeleteBranch // 11 Delete Branch

	CommentTypeStartTracking    // 12 Start a stopwatch for time tracking
	CommentTypeStopTracking     // 13 Stop a stopwatch for time tracking
	CommentTypeAddTimeManual    // 14 Add time manual for time tracking
	CommentTypeCancelTracking   // 15 Cancel a stopwatch for time tracking
	CommentTypeAddedDeadline    // 16 Added a due date
	CommentTypeModifiedDeadline // 17 Modified the due date
	CommentTypeRemovedDeadline  // 18 Removed a due date

	CommentTypeAddDependency    // 19 Dependency added
	CommentTypeRemoveDependency // 20 Dependency removed

	CommentTypeCode   // 21 Comment a line of code
	CommentTypeReview // 22 Reviews a pull request by giving general feedback

	CommentTypeLock   // 23 Lock an issue, giving only collaborators access
	CommentTypeUnlock // 24 Unlocks a previously locked issue

	CommentTypeChangeTargetBranch // 25 Change pull request's target branch

	CommentTypeDeleteTimeManual // 26 Delete time manual for time tracking

	CommentTypeReviewRequest   // 27 add or remove Request from one
	CommentTypeMergePull       // 28 merge pull request
	CommentTypePullRequestPush // 29 push to PR head branch

	CommentTypeProject       // 30 Project changed
	CommentTypeProjectColumn // 31 Project column changed

	CommentTypeDismissReview // 32 Dismiss Review

	CommentTypeChangeIssueRef // 33 Change issue ref

	CommentTypePRScheduledToAutoMerge   // 34 pr was scheduled to auto merge when checks succeed
	CommentTypePRUnScheduledToAutoMerge // 35 pr was un scheduled to auto merge when checks succeed

	CommentTypePin   // 36 pin Issue/PullRequest
	CommentTypeUnpin // 37 unpin Issue/PullRequest

	CommentTypeChangeTimeEstimate // 38 Change time estimate
)
const CommentTypeUndefined CommentType = -1

CommentTypeUndefined is used to search for comments of any type

func AsCommentType 

func AsCommentType(typeName string) CommentType

func ConversationCountedCommentType 

func ConversationCountedCommentType() []CommentType

ConversationCountedCommentType returns the comment types that are counted as a conversation

func (CommentType) CountedAsConversation 

func (t CommentType) CountedAsConversation() bool

func (CommentType) HasAttachmentSupport 

func (t CommentType) HasAttachmentSupport() bool

func (CommentType) HasContentSupport 

func (t CommentType) HasContentSupport() bool

func (CommentType) HasMailReplySupport 

func (t CommentType) HasMailReplySupport() bool

func (CommentType) String 

func (t CommentType) String() string

type ContentEmptyErr 

type ContentEmptyErr struct{}

ContentEmptyErr represents an content empty error

func (ContentEmptyErr) Error 

func (ContentEmptyErr) Error() string

type ContentHistory 

type ContentHistory struct {
	ID             int64 `xorm:"pk autoincr"`
	PosterID       int64
	IssueID        int64              `xorm:"INDEX"`
	CommentID      int64              `xorm:"INDEX"`
	EditedUnix     timeutil.TimeStamp `xorm:"INDEX"`
	ContentText    string             `xorm:"LONGTEXT"`
	IsFirstCreated bool
	IsDeleted      bool
}

ContentHistory save issue/comment content history revisions.

func GetIssueContentHistoryAndPrev 

func GetIssueContentHistoryAndPrev(dbCtx context.Context, issueID, id int64) (history, prevHistory *ContentHistory, err error)

GetIssueContentHistoryAndPrev get a history and the previous non-deleted history (to compare)

func GetIssueContentHistoryByID 

func GetIssueContentHistoryByID(dbCtx context.Context, id int64) (*ContentHistory, error)

GetIssueContentHistoryByID get issue content history

func (*ContentHistory) TableName 

func (m *ContentHistory) TableName() string

TableName provides the real table name

type CreateCommentOptions 

type CreateCommentOptions struct {
	Type  CommentType
	Doer  *user_model.User
	Repo  *repo_model.Repository
	Issue *Issue
	Label *Label

	DependentIssueID   int64
	OldMilestoneID     int64
	MilestoneID        int64
	OldProjectID       int64
	ProjectID          int64
	ProjectTitle       string
	ProjectColumnID    int64
	ProjectColumnTitle string
	TimeID             int64
	AssigneeID         int64
	AssigneeTeamID     int64
	RemovedAssignee    bool
	OldTitle           string
	NewTitle           string
	OldRef             string
	NewRef             string
	CommitID           int64
	CommitSHA          string
	Patch              string
	LineNum            int64
	TreePath           string
	ReviewID           int64
	Content            string
	Attachments        []string // UUIDs of attachments
	RefRepoID          int64
	RefIssueID         int64
	RefCommentID       int64
	RefAction          references.XRefAction
	RefIsPull          bool
	IsForcePush        bool
	Invalidated        bool
}

CreateCommentOptions defines options for creating comment

type CreateReviewOptions 

type CreateReviewOptions struct {
	Content      string
	Type         ReviewType
	Issue        *Issue
	Reviewer     *user_model.User
	ReviewerTeam *organization.Team
	Official     bool
	CommitID     string
	Stale        bool
}

CreateReviewOptions represent the options to create a review. Type, Issue and Reviewer are required.

type DependencyInfo 

type DependencyInfo struct {
	Issue                 `xorm:"extends"`
	repo_model.