You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

issue_label.go 23KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831
  1. // Copyright 2016 The Gogs Authors. All rights reserved.
  2. // Copyright 2020 The Gitea Authors.
  3. // Use of this source code is governed by a MIT-style
  4. // license that can be found in the LICENSE file.
  5. package models
  6. import (
  7. "context"
  8. "fmt"
  9. "html/template"
  10. "math"
  11. "regexp"
  12. "strconv"
  13. "strings"
  14. "code.gitea.io/gitea/models/db"
  15. user_model "code.gitea.io/gitea/models/user"
  16. "code.gitea.io/gitea/modules/timeutil"
  17. "xorm.io/builder"
  18. )
  19. // LabelColorPattern is a regexp witch can validate LabelColor
  20. var LabelColorPattern = regexp.MustCompile("^#[0-9a-fA-F]{6}$")
  21. // Label represents a label of repository for issues.
  22. type Label struct {
  23. ID int64 `xorm:"pk autoincr"`
  24. RepoID int64 `xorm:"INDEX"`
  25. OrgID int64 `xorm:"INDEX"`
  26. Name string
  27. Description string
  28. Color string `xorm:"VARCHAR(7)"`
  29. NumIssues int
  30. NumClosedIssues int
  31. CreatedUnix timeutil.TimeStamp `xorm:"INDEX created"`
  32. UpdatedUnix timeutil.TimeStamp `xorm:"INDEX updated"`
  33. NumOpenIssues int `xorm:"-"`
  34. NumOpenRepoIssues int64 `xorm:"-"`
  35. IsChecked bool `xorm:"-"`
  36. QueryString string `xorm:"-"`
  37. IsSelected bool `xorm:"-"`
  38. IsExcluded bool `xorm:"-"`
  39. }
  40. func init() {
  41. db.RegisterModel(new(Label))
  42. db.RegisterModel(new(IssueLabel))
  43. }
  44. // GetLabelTemplateFile loads the label template file by given name,
  45. // then parses and returns a list of name-color pairs and optionally description.
  46. func GetLabelTemplateFile(name string) ([][3]string, error) {
  47. data, err := GetRepoInitFile("label", name)
  48. if err != nil {
  49. return nil, ErrIssueLabelTemplateLoad{name, fmt.Errorf("GetRepoInitFile: %v", err)}
  50. }
  51. lines := strings.Split(string(data), "\n")
  52. list := make([][3]string, 0, len(lines))
  53. for i := 0; i < len(lines); i++ {
  54. line := strings.TrimSpace(lines[i])
  55. if len(line) == 0 {
  56. continue
  57. }
  58. parts := strings.SplitN(line, ";", 2)
  59. fields := strings.SplitN(parts[0], " ", 2)
  60. if len(fields) != 2 {
  61. return nil, ErrIssueLabelTemplateLoad{name, fmt.Errorf("line is malformed: %s", line)}
  62. }
  63. color := strings.Trim(fields[0], " ")
  64. if len(color) == 6 {
  65. color = "#" + color
  66. }
  67. if !LabelColorPattern.MatchString(color) {
  68. return nil, ErrIssueLabelTemplateLoad{name, fmt.Errorf("bad HTML color code in line: %s", line)}
  69. }
  70. var description string
  71. if len(parts) > 1 {
  72. description = strings.TrimSpace(parts[1])
  73. }
  74. fields[1] = strings.TrimSpace(fields[1])
  75. list = append(list, [3]string{fields[1], color, description})
  76. }
  77. return list, nil
  78. }
  79. // CalOpenIssues sets the number of open issues of a label based on the already stored number of closed issues.
  80. func (label *Label) CalOpenIssues() {
  81. label.NumOpenIssues = label.NumIssues - label.NumClosedIssues
  82. }
  83. // CalOpenOrgIssues calculates the open issues of a label for a specific repo
  84. func (label *Label) CalOpenOrgIssues(repoID, labelID int64) {
  85. repoIDs := []int64{repoID}
  86. labelIDs := []int64{labelID}
  87. counts, _ := CountIssuesByRepo(&IssuesOptions{
  88. RepoIDs: repoIDs,
  89. LabelIDs: labelIDs,
  90. })
  91. for _, count := range counts {
  92. label.NumOpenRepoIssues += count
  93. }
  94. }
  95. // LoadSelectedLabelsAfterClick calculates the set of selected labels when a label is clicked
  96. func (label *Label) LoadSelectedLabelsAfterClick(currentSelectedLabels []int64) {
  97. var labelQuerySlice []string
  98. labelSelected := false
  99. labelID := strconv.FormatInt(label.ID, 10)
  100. for _, s := range currentSelectedLabels {
  101. if s == label.ID {
  102. labelSelected = true
  103. } else if -s == label.ID {
  104. labelSelected = true
  105. label.IsExcluded = true
  106. } else if s != 0 {
  107. labelQuerySlice = append(labelQuerySlice, strconv.FormatInt(s, 10))
  108. }
  109. }
  110. if !labelSelected {
  111. labelQuerySlice = append(labelQuerySlice, labelID)
  112. }
  113. label.IsSelected = labelSelected
  114. label.QueryString = strings.Join(labelQuerySlice, ",")
  115. }
  116. // BelongsToOrg returns true if label is an organization label
  117. func (label *Label) BelongsToOrg() bool {
  118. return label.OrgID > 0
  119. }
  120. // BelongsToRepo returns true if label is a repository label
  121. func (label *Label) BelongsToRepo() bool {
  122. return label.RepoID > 0
  123. }
  124. // SrgbToLinear converts a component of an sRGB color to its linear intensity
  125. // See: https://en.wikipedia.org/wiki/SRGB#The_reverse_transformation_(sRGB_to_CIE_XYZ)
  126. func SrgbToLinear(color uint8) float64 {
  127. flt := float64(color) / 255
  128. if flt <= 0.04045 {
  129. return flt / 12.92
  130. }
  131. return math.Pow((flt+0.055)/1.055, 2.4)
  132. }
  133. // Luminance returns the luminance of an sRGB color
  134. func Luminance(color uint32) float64 {
  135. r := SrgbToLinear(uint8(0xFF & (color >> 16)))
  136. g := SrgbToLinear(uint8(0xFF & (color >> 8)))
  137. b := SrgbToLinear(uint8(0xFF & color))
  138. // luminance ratios for sRGB
  139. return 0.2126*r + 0.7152*g + 0.0722*b
  140. }
  141. // LuminanceThreshold is the luminance at which white and black appear to have the same contrast
  142. // i.e. x such that 1.05 / (x + 0.05) = (x + 0.05) / 0.05
  143. // i.e. math.Sqrt(1.05*0.05) - 0.05
  144. const LuminanceThreshold float64 = 0.179
  145. // ForegroundColor calculates the text color for labels based
  146. // on their background color.
  147. func (label *Label) ForegroundColor() template.CSS {
  148. if strings.HasPrefix(label.Color, "#") {
  149. if color, err := strconv.ParseUint(label.Color[1:], 16, 64); err == nil {
  150. // NOTE: see web_src/js/components/ContextPopup.vue for similar implementation
  151. luminance := Luminance(uint32(color))
  152. // prefer white or black based upon contrast
  153. if luminance < LuminanceThreshold {
  154. return template.CSS("#fff")
  155. }
  156. return template.CSS("#000")
  157. }
  158. }
  159. // default to black
  160. return template.CSS("#000")
  161. }
  162. // .____ ___. .__
  163. // | | _____ \_ |__ ____ | |
  164. // | | \__ \ | __ \_/ __ \| |
  165. // | |___ / __ \| \_\ \ ___/| |__
  166. // >_______ (____ /___ /\___ >____/
  167. func loadLabels(labelTemplate string) ([]string, error) {
  168. list, err := GetLabelTemplateFile(labelTemplate)
  169. if err != nil {
  170. return nil, err
  171. }
  172. labels := make([]string, len(list))
  173. for i := 0; i < len(list); i++ {
  174. labels[i] = list[i][0]
  175. }
  176. return labels, nil
  177. }
  178. // LoadLabelsFormatted loads the labels' list of a template file as a string separated by comma
  179. func LoadLabelsFormatted(labelTemplate string) (string, error) {
  180. labels, err := loadLabels(labelTemplate)
  181. return strings.Join(labels, ", "), err
  182. }
  183. func initializeLabels(e db.Engine, id int64, labelTemplate string, isOrg bool) error {
  184. list, err := GetLabelTemplateFile(labelTemplate)
  185. if err != nil {
  186. return err
  187. }
  188. labels := make([]*Label, len(list))
  189. for i := 0; i < len(list); i++ {
  190. labels[i] = &Label{
  191. Name: list[i][0],
  192. Description: list[i][2],
  193. Color: list[i][1],
  194. }
  195. if isOrg {
  196. labels[i].OrgID = id
  197. } else {
  198. labels[i].RepoID = id
  199. }
  200. }
  201. for _, label := range labels {
  202. if err = newLabel(e, label); err != nil {
  203. return err
  204. }
  205. }
  206. return nil
  207. }
  208. // InitializeLabels adds a label set to a repository using a template
  209. func InitializeLabels(ctx context.Context, repoID int64, labelTemplate string, isOrg bool) error {
  210. return initializeLabels(db.GetEngine(ctx), repoID, labelTemplate, isOrg)
  211. }
  212. func newLabel(e db.Engine, label *Label) error {
  213. _, err := e.Insert(label)
  214. return err
  215. }
  216. // NewLabel creates a new label
  217. func NewLabel(label *Label) error {
  218. if !LabelColorPattern.MatchString(label.Color) {
  219. return fmt.Errorf("bad color code: %s", label.Color)
  220. }
  221. return newLabel(db.GetEngine(db.DefaultContext), label)
  222. }
  223. // NewLabels creates new labels
  224. func NewLabels(labels ...*Label) error {
  225. ctx, committer, err := db.TxContext()
  226. if err != nil {
  227. return err
  228. }
  229. defer committer.Close()
  230. for _, label := range labels {
  231. if !LabelColorPattern.MatchString(label.Color) {
  232. return fmt.Errorf("bad color code: %s", label.Color)
  233. }
  234. if err := newLabel(db.GetEngine(ctx), label); err != nil {
  235. return err
  236. }
  237. }
  238. return committer.Commit()
  239. }
  240. // UpdateLabel updates label information.
  241. func UpdateLabel(l *Label) error {
  242. if !LabelColorPattern.MatchString(l.Color) {
  243. return fmt.Errorf("bad color code: %s", l.Color)
  244. }
  245. return updateLabelCols(db.GetEngine(db.DefaultContext), l, "name", "description", "color")
  246. }
  247. // DeleteLabel delete a label
  248. func DeleteLabel(id, labelID int64) error {
  249. label, err := GetLabelByID(labelID)
  250. if err != nil {
  251. if IsErrLabelNotExist(err) {
  252. return nil
  253. }
  254. return err
  255. }
  256. ctx, committer, err := db.TxContext()
  257. if err != nil {
  258. return err
  259. }
  260. defer committer.Close()
  261. sess := db.GetEngine(ctx)
  262. if label.BelongsToOrg() && label.OrgID != id {
  263. return nil
  264. }
  265. if label.BelongsToRepo() && label.RepoID != id {
  266. return nil
  267. }
  268. if _, err = sess.ID(labelID).Delete(new(Label)); err != nil {
  269. return err
  270. } else if _, err = sess.
  271. Where("label_id = ?", labelID).
  272. Delete(new(IssueLabel)); err != nil {
  273. return err
  274. }
  275. // delete comments about now deleted label_id
  276. if _, err = sess.Where("label_id = ?", labelID).Cols("label_id").Delete(&Comment{}); err != nil {
  277. return err
  278. }
  279. return committer.Commit()
  280. }
  281. // getLabelByID returns a label by label id
  282. func getLabelByID(e db.Engine, labelID int64) (*Label, error) {
  283. if labelID <= 0 {
  284. return nil, ErrLabelNotExist{labelID}
  285. }
  286. l := &Label{}
  287. has, err := e.ID(labelID).Get(l)
  288. if err != nil {
  289. return nil, err
  290. } else if !has {
  291. return nil, ErrLabelNotExist{l.ID}
  292. }
  293. return l, nil
  294. }
  295. // GetLabelByID returns a label by given ID.
  296. func GetLabelByID(id int64) (*Label, error) {
  297. return getLabelByID(db.GetEngine(db.DefaultContext), id)
  298. }
  299. // GetLabelsByIDs returns a list of labels by IDs
  300. func GetLabelsByIDs(labelIDs []int64) ([]*Label, error) {
  301. labels := make([]*Label, 0, len(labelIDs))
  302. return labels, db.GetEngine(db.DefaultContext).Table("label").
  303. In("id", labelIDs).
  304. Asc("name").
  305. Cols("id", "repo_id", "org_id").
  306. Find(&labels)
  307. }
  308. // __________ .__ __
  309. // \______ \ ____ ______ ____ _____|__|/ |_ ___________ ___.__.
  310. // | _// __ \\____ \ / _ \/ ___/ \ __\/ _ \_ __ < | |
  311. // | | \ ___/| |_> > <_> )___ \| || | ( <_> ) | \/\___ |
  312. // |____|_ /\___ > __/ \____/____ >__||__| \____/|__| / ____|
  313. // \/ \/|__| \/ \/
  314. // getLabelInRepoByName returns a label by Name in given repository.
  315. func getLabelInRepoByName(e db.Engine, repoID int64, labelName string) (*Label, error) {
  316. if len(labelName) == 0 || repoID <= 0 {
  317. return nil, ErrRepoLabelNotExist{0, repoID}
  318. }
  319. l := &Label{
  320. Name: labelName,
  321. RepoID: repoID,
  322. }
  323. has, err := e.Get(l)
  324. if err != nil {
  325. return nil, err
  326. } else if !has {
  327. return nil, ErrRepoLabelNotExist{0, l.RepoID}
  328. }
  329. return l, nil
  330. }
  331. // getLabelInRepoByID returns a label by ID in given repository.
  332. func getLabelInRepoByID(e db.Engine, repoID, labelID int64) (*Label, error) {
  333. if labelID <= 0 || repoID <= 0 {
  334. return nil, ErrRepoLabelNotExist{labelID, repoID}
  335. }
  336. l := &Label{
  337. ID: labelID,
  338. RepoID: repoID,
  339. }
  340. has, err := e.Get(l)
  341. if err != nil {
  342. return nil, err
  343. } else if !has {
  344. return nil, ErrRepoLabelNotExist{l.ID, l.RepoID}
  345. }
  346. return l, nil
  347. }
  348. // GetLabelInRepoByName returns a label by name in given repository.
  349. func GetLabelInRepoByName(repoID int64, labelName string) (*Label, error) {
  350. return getLabelInRepoByName(db.GetEngine(db.DefaultContext), repoID, labelName)
  351. }
  352. // GetLabelIDsInRepoByNames returns a list of labelIDs by names in a given
  353. // repository.
  354. // it silently ignores label names that do not belong to the repository.
  355. func GetLabelIDsInRepoByNames(repoID int64, labelNames []string) ([]int64, error) {
  356. labelIDs := make([]int64, 0, len(labelNames))
  357. return labelIDs, db.GetEngine(db.DefaultContext).Table("label").
  358. Where("repo_id = ?", repoID).
  359. In("name", labelNames).
  360. Asc("name").
  361. Cols("id").
  362. Find(&labelIDs)
  363. }
  364. // BuildLabelNamesIssueIDsCondition returns a builder where get issue ids match label names
  365. func BuildLabelNamesIssueIDsCondition(labelNames []string) *builder.Builder {
  366. return builder.Select("issue_label.issue_id").
  367. From("issue_label").
  368. InnerJoin("label", "label.id = issue_label.label_id").
  369. Where(
  370. builder.In("label.name", labelNames),
  371. ).
  372. GroupBy("issue_label.issue_id")
  373. }
  374. // GetLabelInRepoByID returns a label by ID in given repository.
  375. func GetLabelInRepoByID(repoID, labelID int64) (*Label, error) {
  376. return getLabelInRepoByID(db.GetEngine(db.DefaultContext), repoID, labelID)
  377. }
  378. // GetLabelsInRepoByIDs returns a list of labels by IDs in given repository,
  379. // it silently ignores label IDs that do not belong to the repository.
  380. func GetLabelsInRepoByIDs(repoID int64, labelIDs []int64) ([]*Label, error) {
  381. labels := make([]*Label, 0, len(labelIDs))
  382. return labels, db.GetEngine(db.DefaultContext).
  383. Where("repo_id = ?", repoID).
  384. In("id", labelIDs).
  385. Asc("name").
  386. Find(&labels)
  387. }
  388. func getLabelsByRepoID(e db.Engine, repoID int64, sortType string, listOptions db.ListOptions) ([]*Label, error) {
  389. if repoID <= 0 {
  390. return nil, ErrRepoLabelNotExist{0, repoID}
  391. }
  392. labels := make([]*Label, 0, 10)
  393. sess := e.Where("repo_id = ?", repoID)
  394. switch sortType {
  395. case "reversealphabetically":
  396. sess.Desc("name")
  397. case "leastissues":
  398. sess.Asc("num_issues")
  399. case "mostissues":
  400. sess.Desc("num_issues")
  401. default:
  402. sess.Asc("name")
  403. }
  404. if listOptions.Page != 0 {
  405. sess = db.SetSessionPagination(sess, &listOptions)
  406. }
  407. return labels, sess.Find(&labels)
  408. }
  409. // GetLabelsByRepoID returns all labels that belong to given repository by ID.
  410. func GetLabelsByRepoID(repoID int64, sortType string, listOptions db.ListOptions) ([]*Label, error) {
  411. return getLabelsByRepoID(db.GetEngine(db.DefaultContext), repoID, sortType, listOptions)
  412. }
  413. // CountLabelsByRepoID count number of all labels that belong to given repository by ID.
  414. func CountLabelsByRepoID(repoID int64) (int64, error) {
  415. return db.GetEngine(db.DefaultContext).Where("repo_id = ?", repoID).Count(&Label{})
  416. }
  417. // ________
  418. // \_____ \_______ ____
  419. // / | \_ __ \/ ___\
  420. // / | \ | \/ /_/ >
  421. // \_______ /__| \___ /
  422. // \/ /_____/
  423. // getLabelInOrgByName returns a label by Name in given organization
  424. func getLabelInOrgByName(e db.Engine, orgID int64, labelName string) (*Label, error) {
  425. if len(labelName) == 0 || orgID <= 0 {
  426. return nil, ErrOrgLabelNotExist{0, orgID}
  427. }
  428. l := &Label{
  429. Name: labelName,
  430. OrgID: orgID,
  431. }
  432. has, err := e.Get(l)
  433. if err != nil {
  434. return nil, err
  435. } else if !has {
  436. return nil, ErrOrgLabelNotExist{0, l.OrgID}
  437. }
  438. return l, nil
  439. }
  440. // getLabelInOrgByID returns a label by ID in given organization.
  441. func getLabelInOrgByID(e db.Engine, orgID, labelID int64) (*Label, error) {
  442. if labelID <= 0 || orgID <= 0 {
  443. return nil, ErrOrgLabelNotExist{labelID, orgID}
  444. }
  445. l := &Label{
  446. ID: labelID,
  447. OrgID: orgID,
  448. }
  449. has, err := e.Get(l)
  450. if err != nil {
  451. return nil, err
  452. } else if !has {
  453. return nil, ErrOrgLabelNotExist{l.ID, l.OrgID}
  454. }
  455. return l, nil
  456. }
  457. // GetLabelInOrgByName returns a label by name in given organization.
  458. func GetLabelInOrgByName(orgID int64, labelName string) (*Label, error) {
  459. return getLabelInOrgByName(db.GetEngine(db.DefaultContext), orgID, labelName)
  460. }
  461. // GetLabelIDsInOrgByNames returns a list of labelIDs by names in a given
  462. // organization.
  463. func GetLabelIDsInOrgByNames(orgID int64, labelNames []string) ([]int64, error) {
  464. if orgID <= 0 {
  465. return nil, ErrOrgLabelNotExist{0, orgID}
  466. }
  467. labelIDs := make([]int64, 0, len(labelNames))
  468. return labelIDs, db.GetEngine(db.DefaultContext).Table("label").
  469. Where("org_id = ?", orgID).
  470. In("name", labelNames).
  471. Asc("name").
  472. Cols("id").
  473. Find(&labelIDs)
  474. }
  475. // GetLabelInOrgByID returns a label by ID in given organization.
  476. func GetLabelInOrgByID(orgID, labelID int64) (*Label, error) {
  477. return getLabelInOrgByID(db.GetEngine(db.DefaultContext), orgID, labelID)
  478. }
  479. // GetLabelsInOrgByIDs returns a list of labels by IDs in given organization,
  480. // it silently ignores label IDs that do not belong to the organization.
  481. func GetLabelsInOrgByIDs(orgID int64, labelIDs []int64) ([]*Label, error) {
  482. labels := make([]*Label, 0, len(labelIDs))
  483. return labels, db.GetEngine(db.DefaultContext).
  484. Where("org_id = ?", orgID).
  485. In("id", labelIDs).
  486. Asc("name").
  487. Find(&labels)
  488. }
  489. func getLabelsByOrgID(e db.Engine, orgID int64, sortType string, listOptions db.ListOptions) ([]*Label, error) {
  490. if orgID <= 0 {
  491. return nil, ErrOrgLabelNotExist{0, orgID}
  492. }
  493. labels := make([]*Label, 0, 10)
  494. sess := e.Where("org_id = ?", orgID)
  495. switch sortType {
  496. case "reversealphabetically":
  497. sess.Desc("name")
  498. case "leastissues":
  499. sess.Asc("num_issues")
  500. case "mostissues":
  501. sess.Desc("num_issues")
  502. default:
  503. sess.Asc("name")
  504. }
  505. if listOptions.Page != 0 {
  506. sess = db.SetSessionPagination(sess, &listOptions)
  507. }
  508. return labels, sess.Find(&labels)
  509. }
  510. // GetLabelsByOrgID returns all labels that belong to given organization by ID.
  511. func GetLabelsByOrgID(orgID int64, sortType string, listOptions db.ListOptions) ([]*Label, error) {
  512. return getLabelsByOrgID(db.GetEngine(db.DefaultContext), orgID, sortType, listOptions)
  513. }
  514. // CountLabelsByOrgID count all labels that belong to given organization by ID.
  515. func CountLabelsByOrgID(orgID int64) (int64, error) {
  516. return db.GetEngine(db.DefaultContext).Where("org_id = ?", orgID).Count(&Label{})
  517. }
  518. // .___
  519. // | | ______ ________ __ ____
  520. // | |/ ___// ___/ | \_/ __ \
  521. // | |\___ \ \___ \| | /\ ___/
  522. // |___/____ >____ >____/ \___ |
  523. // \/ \/ \/
  524. func getLabelsByIssueID(e db.Engine, issueID int64) ([]*Label, error) {
  525. var labels []*Label
  526. return labels, e.Where("issue_label.issue_id = ?", issueID).
  527. Join("LEFT", "issue_label", "issue_label.label_id = label.id").
  528. Asc("label.name").
  529. Find(&labels)
  530. }
  531. // GetLabelsByIssueID returns all labels that belong to given issue by ID.
  532. func GetLabelsByIssueID(issueID int64) ([]*Label, error) {
  533. return getLabelsByIssueID(db.GetEngine(db.DefaultContext), issueID)
  534. }
  535. func updateLabelCols(e db.Engine, l *Label, cols ...string) error {
  536. _, err := e.ID(l.ID).
  537. SetExpr("num_issues",
  538. builder.Select("count(*)").From("issue_label").
  539. Where(builder.Eq{"label_id": l.ID}),
  540. ).
  541. SetExpr("num_closed_issues",
  542. builder.Select("count(*)").From("issue_label").
  543. InnerJoin("issue", "issue_label.issue_id = issue.id").
  544. Where(builder.Eq{
  545. "issue_label.label_id": l.ID,
  546. "issue.is_closed": true,
  547. }),
  548. ).
  549. Cols(cols...).Update(l)
  550. return err
  551. }
  552. // .___ .____ ___. .__
  553. // | | ______ ________ __ ____ | | _____ \_ |__ ____ | |
  554. // | |/ ___// ___/ | \_/ __ \| | \__ \ | __ \_/ __ \| |
  555. // | |\___ \ \___ \| | /\ ___/| |___ / __ \| \_\ \ ___/| |__
  556. // |___/____ >____ >____/ \___ >_______ (____ /___ /\___ >____/
  557. // \/ \/ \/ \/ \/ \/ \/
  558. // IssueLabel represents an issue-label relation.
  559. type IssueLabel struct {
  560. ID int64 `xorm:"pk autoincr"`
  561. IssueID int64 `xorm:"UNIQUE(s)"`
  562. LabelID int64 `xorm:"UNIQUE(s)"`
  563. }
  564. func hasIssueLabel(e db.Engine, issueID, labelID int64) bool {
  565. has, _ := e.Where("issue_id = ? AND label_id = ?", issueID, labelID).Get(new(IssueLabel))
  566. return has
  567. }
  568. // HasIssueLabel returns true if issue has been labeled.
  569. func HasIssueLabel(issueID, labelID int64) bool {
  570. return hasIssueLabel(db.GetEngine(db.DefaultContext), issueID, labelID)
  571. }
  572. // newIssueLabel this function creates a new label it does not check if the label is valid for the issue
  573. // YOU MUST CHECK THIS BEFORE THIS FUNCTION
  574. func newIssueLabel(ctx context.Context, issue *Issue, label *Label, doer *user_model.User) (err error) {
  575. e := db.GetEngine(ctx)
  576. if _, err = e.Insert(&IssueLabel{
  577. IssueID: issue.ID,
  578. LabelID: label.ID,
  579. }); err != nil {
  580. return err
  581. }
  582. if err = issue.loadRepo(e); err != nil {
  583. return
  584. }
  585. opts := &CreateCommentOptions{
  586. Type: CommentTypeLabel,
  587. Doer: doer,
  588. Repo: issue.Repo,
  589. Issue: issue,
  590. Label: label,
  591. Content: "1",
  592. }
  593. if _, err = createComment(ctx, opts); err != nil {
  594. return err
  595. }
  596. return updateLabelCols(e, label, "num_issues", "num_closed_issue")
  597. }
  598. // NewIssueLabel creates a new issue-label relation.
  599. func NewIssueLabel(issue *Issue, label *Label, doer *user_model.User) (err error) {
  600. if HasIssueLabel(issue.ID, label.ID) {
  601. return nil
  602. }
  603. ctx, committer, err := db.TxContext()
  604. if err != nil {
  605. return err
  606. }
  607. defer committer.Close()
  608. sess := db.GetEngine(ctx)
  609. if err = issue.loadRepo(sess); err != nil {
  610. return err
  611. }
  612. // Do NOT add invalid labels
  613. if issue.RepoID != label.RepoID && issue.Repo.OwnerID != label.OrgID {
  614. return nil
  615. }
  616. if err = newIssueLabel(ctx, issue, label, doer); err != nil {
  617. return err
  618. }
  619. issue.Labels = nil
  620. if err = issue.loadLabels(sess); err != nil {
  621. return err
  622. }
  623. return committer.Commit()
  624. }
  625. // newIssueLabels add labels to an issue. It will check if the labels are valid for the issue
  626. func newIssueLabels(ctx context.Context, issue *Issue, labels []*Label, doer *user_model.User) (err error) {
  627. e := db.GetEngine(ctx)
  628. if err = issue.loadRepo(e); err != nil {
  629. return err
  630. }
  631. for _, label := range labels {
  632. // Don't add already present labels and invalid labels
  633. if hasIssueLabel(e, issue.ID, label.ID) ||
  634. (label.RepoID != issue.RepoID && label.OrgID != issue.Repo.OwnerID) {
  635. continue
  636. }
  637. if err = newIssueLabel(ctx, issue, label, doer); err != nil {
  638. return fmt.Errorf("newIssueLabel: %v", err)
  639. }
  640. }
  641. return nil
  642. }
  643. // NewIssueLabels creates a list of issue-label relations.
  644. func NewIssueLabels(issue *Issue, labels []*Label, doer *user_model.User) (err error) {
  645. ctx, committer, err := db.TxContext()
  646. if err != nil {
  647. return err
  648. }
  649. defer committer.Close()
  650. if err = newIssueLabels(ctx, issue, labels, doer); err != nil {
  651. return err
  652. }
  653. issue.Labels = nil
  654. if err = issue.loadLabels(db.GetEngine(ctx)); err != nil {
  655. return err
  656. }
  657. return committer.Commit()
  658. }
  659. func deleteIssueLabel(ctx context.Context, issue *Issue, label *Label, doer *user_model.User) (err error) {
  660. e := db.GetEngine(ctx)
  661. if count, err := e.Delete(&IssueLabel{
  662. IssueID: issue.ID,
  663. LabelID: label.ID,
  664. }); err != nil {
  665. return err
  666. } else if count == 0 {
  667. return nil
  668. }
  669. if err = issue.loadRepo(e); err != nil {
  670. return
  671. }
  672. opts := &CreateCommentOptions{
  673. Type: CommentTypeLabel,
  674. Doer: doer,
  675. Repo: issue.Repo,
  676. Issue: issue,
  677. Label: label,
  678. }
  679. if _, err = createComment(ctx, opts); err != nil {
  680. return err
  681. }
  682. return updateLabelCols(e, label, "num_issues", "num_closed_issue")
  683. }
  684. // DeleteIssueLabel deletes issue-label relation.
  685. func DeleteIssueLabel(issue *Issue, label *Label, doer *user_model.User) (err error) {
  686. ctx, committer, err := db.TxContext()
  687. if err != nil {
  688. return err
  689. }
  690. defer committer.Close()
  691. if err = deleteIssueLabel(ctx, issue, label, doer); err != nil {
  692. return err
  693. }
  694. issue.Labels = nil
  695. if err = issue.loadLabels(db.GetEngine(ctx)); err != nil {
  696. return err
  697. }
  698. return committer.Commit()
  699. }
  700. func deleteLabelsByRepoID(sess db.Engine, repoID int64) error {
  701. deleteCond := builder.Select("id").From("label").Where(builder.Eq{"label.repo_id": repoID})
  702. if _, err := sess.In("label_id", deleteCond).
  703. Delete(&IssueLabel{}); err != nil {
  704. return err
  705. }
  706. _, err := sess.Delete(&Label{RepoID: repoID})
  707. return err
  708. }