repo.go 68 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311
  1. // Copyright 2014 The Gogs Authors. All rights reserved.
  2. // Use of this source code is governed by a MIT-style
  3. // license that can be found in the LICENSE file.
  4. package models
  5. import (
  6. "bytes"
  7. "fmt"
  8. "html/template"
  9. "io/ioutil"
  10. "os"
  11. "os/exec"
  12. "path"
  13. "path/filepath"
  14. "regexp"
  15. "sort"
  16. "strings"
  17. "time"
  18. "github.com/Unknwon/cae/zip"
  19. "github.com/Unknwon/com"
  20. "github.com/go-xorm/xorm"
  21. "github.com/mcuadros/go-version"
  22. log "gopkg.in/clog.v1"
  23. "gopkg.in/ini.v1"
  24. git "github.com/gogits/git-module"
  25. api "github.com/gogits/go-gogs-client"
  26. "github.com/gogits/gogs/models/errors"
  27. "github.com/gogits/gogs/modules/bindata"
  28. "github.com/gogits/gogs/modules/markdown"
  29. "github.com/gogits/gogs/modules/process"
  30. "github.com/gogits/gogs/modules/setting"
  31. "github.com/gogits/gogs/modules/sync"
  32. )
  33. var repoWorkingPool = sync.NewExclusivePool()
  34. var (
  35. Gitignores, Licenses, Readmes, LabelTemplates []string
  36. // Maximum items per page in forks, watchers and stars of a repo
  37. ItemsPerPage = 40
  38. )
  39. func LoadRepoConfig() {
  40. // Load .gitignore and license files and readme templates.
  41. types := []string{"gitignore", "license", "readme", "label"}
  42. typeFiles := make([][]string, 4)
  43. for i, t := range types {
  44. files, err := bindata.AssetDir("conf/" + t)
  45. if err != nil {
  46. log.Fatal(4, "Fail to get %s files: %v", t, err)
  47. }
  48. customPath := path.Join(setting.CustomPath, "conf", t)
  49. if com.IsDir(customPath) {
  50. customFiles, err := com.StatDir(customPath)
  51. if err != nil {
  52. log.Fatal(4, "Fail to get custom %s files: %v", t, err)
  53. }
  54. for _, f := range customFiles {
  55. if !com.IsSliceContainsStr(files, f) {
  56. files = append(files, f)
  57. }
  58. }
  59. }
  60. typeFiles[i] = files
  61. }
  62. Gitignores = typeFiles[0]
  63. Licenses = typeFiles[1]
  64. Readmes = typeFiles[2]
  65. LabelTemplates = typeFiles[3]
  66. sort.Strings(Gitignores)
  67. sort.Strings(Licenses)
  68. sort.Strings(Readmes)
  69. sort.Strings(LabelTemplates)
  70. // Filter out invalid names and promote preferred licenses.
  71. sortedLicenses := make([]string, 0, len(Licenses))
  72. for _, name := range setting.Repository.PreferredLicenses {
  73. if com.IsSliceContainsStr(Licenses, name) {
  74. sortedLicenses = append(sortedLicenses, name)
  75. }
  76. }
  77. for _, name := range Licenses {
  78. if !com.IsSliceContainsStr(setting.Repository.PreferredLicenses, name) {
  79. sortedLicenses = append(sortedLicenses, name)
  80. }
  81. }
  82. Licenses = sortedLicenses
  83. }
  84. func NewRepoContext() {
  85. zip.Verbose = false
  86. // Check Git installation.
  87. if _, err := exec.LookPath("git"); err != nil {
  88. log.Fatal(4, "Fail to test 'git' command: %v (forgotten install?)", err)
  89. }
  90. // Check Git version.
  91. var err error
  92. setting.Git.Version, err = git.BinVersion()
  93. if err != nil {
  94. log.Fatal(4, "Fail to get Git version: %v", err)
  95. }
  96. log.Info("Git Version: %s", setting.Git.Version)
  97. if version.Compare("1.7.1", setting.Git.Version, ">") {
  98. log.Fatal(4, "Gogs requires Git version greater or equal to 1.7.1")
  99. }
  100. git.HookDir = "custom_hooks"
  101. git.HookSampleDir = "hooks"
  102. git.DefaultCommitsPageSize = setting.UI.User.CommitsPagingNum
  103. // Git requires setting user.name and user.email in order to commit changes.
  104. for configKey, defaultValue := range map[string]string{"user.name": "Gogs", "user.email": "gogs@fake.local"} {
  105. if stdout, stderr, err := process.Exec("NewRepoContext(get setting)", "git", "config", "--get", configKey); err != nil || strings.TrimSpace(stdout) == "" {
  106. // ExitError indicates this config is not set
  107. if _, ok := err.(*exec.ExitError); ok || strings.TrimSpace(stdout) == "" {
  108. if _, stderr, gerr := process.Exec("NewRepoContext(set "+configKey+")", "git", "config", "--global", configKey, defaultValue); gerr != nil {
  109. log.Fatal(4, "Fail to set git %s(%s): %s", configKey, gerr, stderr)
  110. }
  111. log.Info("Git config %s set to %s", configKey, defaultValue)
  112. } else {
  113. log.Fatal(4, "Fail to get git %s(%s): %s", configKey, err, stderr)
  114. }
  115. }
  116. }
  117. // Set git some configurations.
  118. if _, stderr, err := process.Exec("NewRepoContext(git config --global core.quotepath false)",
  119. "git", "config", "--global", "core.quotepath", "false"); err != nil {
  120. log.Fatal(4, "Fail to execute 'git config --global core.quotepath false': %s", stderr)
  121. }
  122. RemoveAllWithNotice("Clean up repository temporary data", filepath.Join(setting.AppDataPath, "tmp"))
  123. }
  124. // Repository contains information of a repository.
  125. type Repository struct {
  126. ID int64 `xorm:"pk autoincr"`
  127. OwnerID int64 `xorm:"UNIQUE(s)"`
  128. Owner *User `xorm:"-"`
  129. LowerName string `xorm:"UNIQUE(s) INDEX NOT NULL"`
  130. Name string `xorm:"INDEX NOT NULL"`
  131. Description string
  132. Website string
  133. DefaultBranch string
  134. Size int64 `xorm:"NOT NULL DEFAULT 0"`
  135. NumWatches int
  136. NumStars int
  137. NumForks int
  138. NumIssues int
  139. NumClosedIssues int
  140. NumOpenIssues int `xorm:"-"`
  141. NumPulls int
  142. NumClosedPulls int
  143. NumOpenPulls int `xorm:"-"`
  144. NumMilestones int `xorm:"NOT NULL DEFAULT 0"`
  145. NumClosedMilestones int `xorm:"NOT NULL DEFAULT 0"`
  146. NumOpenMilestones int `xorm:"-"`
  147. NumTags int `xorm:"-"`
  148. IsPrivate bool
  149. IsBare bool
  150. IsMirror bool
  151. *Mirror `xorm:"-"`
  152. // Advanced settings
  153. EnableWiki bool `xorm:"NOT NULL DEFAULT true"`
  154. EnableExternalWiki bool
  155. ExternalWikiURL string
  156. EnableIssues bool `xorm:"NOT NULL DEFAULT true"`
  157. EnableExternalTracker bool
  158. ExternalTrackerURL string
  159. ExternalTrackerFormat string
  160. ExternalTrackerStyle string
  161. ExternalMetas map[string]string `xorm:"-"`
  162. EnablePulls bool `xorm:"NOT NULL DEFAULT true"`
  163. IsFork bool `xorm:"NOT NULL DEFAULT false"`
  164. ForkID int64
  165. BaseRepo *Repository `xorm:"-"`
  166. Created time.Time `xorm:"-"`
  167. CreatedUnix int64
  168. Updated time.Time `xorm:"-"`
  169. UpdatedUnix int64
  170. }
  171. func (repo *Repository) BeforeInsert() {
  172. repo.CreatedUnix = time.Now().Unix()
  173. repo.UpdatedUnix = repo.CreatedUnix
  174. }
  175. func (repo *Repository) BeforeUpdate() {
  176. repo.UpdatedUnix = time.Now().Unix()
  177. }
  178. func (repo *Repository) AfterSet(colName string, _ xorm.Cell) {
  179. switch colName {
  180. case "default_branch":
  181. // FIXME: use models migration to solve all at once.
  182. if len(repo.DefaultBranch) == 0 {
  183. repo.DefaultBranch = "master"
  184. }
  185. case "num_closed_issues":
  186. repo.NumOpenIssues = repo.NumIssues - repo.NumClosedIssues
  187. case "num_closed_pulls":
  188. repo.NumOpenPulls = repo.NumPulls - repo.NumClosedPulls
  189. case "num_closed_milestones":
  190. repo.NumOpenMilestones = repo.NumMilestones - repo.NumClosedMilestones
  191. case "external_tracker_style":
  192. if len(repo.ExternalTrackerStyle) == 0 {
  193. repo.ExternalTrackerStyle = markdown.ISSUE_NAME_STYLE_NUMERIC
  194. }
  195. case "created_unix":
  196. repo.Created = time.Unix(repo.CreatedUnix, 0).Local()
  197. case "updated_unix":
  198. repo.Updated = time.Unix(repo.UpdatedUnix, 0)
  199. }
  200. }
  201. func (repo *Repository) loadAttributes(e Engine) (err error) {
  202. if repo.Owner == nil {
  203. repo.Owner, err = getUserByID(e, repo.OwnerID)
  204. if err != nil {
  205. return fmt.Errorf("getUserByID [%d]: %v", repo.OwnerID, err)
  206. }
  207. }
  208. if repo.IsFork && repo.BaseRepo == nil {
  209. repo.BaseRepo, err = getRepositoryByID(e, repo.ForkID)
  210. if err != nil {
  211. if errors.IsRepoNotExist(err) {
  212. repo.IsFork = false
  213. repo.ForkID = 0
  214. } else {
  215. return fmt.Errorf("getRepositoryByID [%d]: %v", repo.ForkID, err)
  216. }
  217. }
  218. }
  219. return nil
  220. }
  221. func (repo *Repository) LoadAttributes() error {
  222. return repo.loadAttributes(x)
  223. }
  224. // MustOwner always returns a valid *User object to avoid
  225. // conceptually impossible error handling.
  226. // It creates a fake object that contains error deftail
  227. // when error occurs.
  228. func (repo *Repository) MustOwner() *User {
  229. return repo.mustOwner(x)
  230. }
  231. func (repo *Repository) FullName() string {
  232. return repo.MustOwner().Name + "/" + repo.Name
  233. }
  234. func (repo *Repository) HTMLURL() string {
  235. return setting.AppUrl + repo.FullName()
  236. }
  237. // Arguments that are allowed to be nil: permission
  238. func (repo *Repository) APIFormat(permission *api.Permission) *api.Repository {
  239. cloneLink := repo.CloneLink()
  240. return &api.Repository{
  241. ID: repo.ID,
  242. Owner: repo.Owner.APIFormat(),
  243. Name: repo.Name,
  244. FullName: repo.FullName(),
  245. Description: repo.Description,
  246. Private: repo.IsPrivate,
  247. Fork: repo.IsFork,
  248. HTMLURL: repo.HTMLURL(),
  249. SSHURL: cloneLink.SSH,
  250. CloneURL: cloneLink.HTTPS,
  251. Website: repo.Website,
  252. Stars: repo.NumStars,
  253. Forks: repo.NumForks,
  254. Watchers: repo.NumWatches,
  255. OpenIssues: repo.NumOpenIssues,
  256. DefaultBranch: repo.DefaultBranch,
  257. Created: repo.Created,
  258. Updated: repo.Updated,
  259. Permissions: permission,
  260. }
  261. }
  262. func (repo *Repository) getOwner(e Engine) (err error) {
  263. if repo.Owner != nil {
  264. return nil
  265. }
  266. repo.Owner, err = getUserByID(e, repo.OwnerID)
  267. return err
  268. }
  269. func (repo *Repository) GetOwner() error {
  270. return repo.getOwner(x)
  271. }
  272. func (repo *Repository) mustOwner(e Engine) *User {
  273. if err := repo.getOwner(e); err != nil {
  274. return &User{
  275. Name: "error",
  276. FullName: err.Error(),
  277. }
  278. }
  279. return repo.Owner
  280. }
  281. func (repo *Repository) UpdateSize() error {
  282. countObject, err := git.GetRepoSize(repo.RepoPath())
  283. if err != nil {
  284. return fmt.Errorf("GetRepoSize: %v", err)
  285. }
  286. repo.Size = countObject.Size + countObject.SizePack
  287. if _, err = x.Id(repo.ID).Cols("size").Update(repo); err != nil {
  288. return fmt.Errorf("update size: %v", err)
  289. }
  290. return nil
  291. }
  292. // ComposeMetas composes a map of metas for rendering external issue tracker URL.
  293. func (repo *Repository) ComposeMetas() map[string]string {
  294. if !repo.EnableExternalTracker {
  295. return nil
  296. } else if repo.ExternalMetas == nil {
  297. repo.ExternalMetas = map[string]string{
  298. "format": repo.ExternalTrackerFormat,
  299. "user": repo.MustOwner().Name,
  300. "repo": repo.Name,
  301. }
  302. switch repo.ExternalTrackerStyle {
  303. case markdown.ISSUE_NAME_STYLE_ALPHANUMERIC:
  304. repo.ExternalMetas["style"] = markdown.ISSUE_NAME_STYLE_ALPHANUMERIC
  305. default:
  306. repo.ExternalMetas["style"] = markdown.ISSUE_NAME_STYLE_NUMERIC
  307. }
  308. }
  309. return repo.ExternalMetas
  310. }
  311. // DeleteWiki removes the actual and local copy of repository wiki.
  312. func (repo *Repository) DeleteWiki() {
  313. wikiPaths := []string{repo.WikiPath(), repo.LocalWikiPath()}
  314. for _, wikiPath := range wikiPaths {
  315. RemoveAllWithNotice("Delete repository wiki", wikiPath)
  316. }
  317. }
  318. // getUsersWithAccesMode returns users that have at least given access mode to the repository.
  319. func (repo *Repository) getUsersWithAccesMode(e Engine, mode AccessMode) (_ []*User, err error) {
  320. if err = repo.getOwner(e); err != nil {
  321. return nil, err
  322. }
  323. accesses := make([]*Access, 0, 10)
  324. if err = e.Where("repo_id = ? AND mode >= ?", repo.ID, mode).Find(&accesses); err != nil {
  325. return nil, err
  326. }
  327. // Leave a seat for owner itself to append later, but if owner is an organization
  328. // and just waste 1 unit is cheaper than re-allocate memory once.
  329. users := make([]*User, 0, len(accesses)+1)
  330. if len(accesses) > 0 {
  331. userIDs := make([]int64, len(accesses))
  332. for i := 0; i < len(accesses); i++ {
  333. userIDs[i] = accesses[i].UserID
  334. }
  335. if err = e.In("id", userIDs).Find(&users); err != nil {
  336. return nil, err
  337. }
  338. }
  339. if !repo.Owner.IsOrganization() {
  340. users = append(users, repo.Owner)
  341. }
  342. return users, nil
  343. }
  344. // getAssignees returns a list of users who can be assigned to issues in this repository.
  345. func (repo *Repository) getAssignees(e Engine) (_ []*User, err error) {
  346. return repo.getUsersWithAccesMode(e, ACCESS_MODE_READ)
  347. }
  348. // GetAssignees returns all users that have read access and can be assigned to issues
  349. // of the repository,
  350. func (repo *Repository) GetAssignees() (_ []*User, err error) {
  351. return repo.getAssignees(x)
  352. }
  353. // GetAssigneeByID returns the user that has write access of repository by given ID.
  354. func (repo *Repository) GetAssigneeByID(userID int64) (*User, error) {
  355. return GetAssigneeByID(repo, userID)
  356. }
  357. // GetWriters returns all users that have write access to the repository.
  358. func (repo *Repository) GetWriters() (_ []*User, err error) {
  359. return repo.getUsersWithAccesMode(x, ACCESS_MODE_WRITE)
  360. }
  361. // GetMilestoneByID returns the milestone belongs to repository by given ID.
  362. func (repo *Repository) GetMilestoneByID(milestoneID int64) (*Milestone, error) {
  363. return GetMilestoneByRepoID(repo.ID, milestoneID)
  364. }
  365. // IssueStats returns number of open and closed repository issues by given filter mode.
  366. func (repo *Repository) IssueStats(userID int64, filterMode FilterMode, isPull bool) (int64, int64) {
  367. return GetRepoIssueStats(repo.ID, userID, filterMode, isPull)
  368. }
  369. func (repo *Repository) GetMirror() (err error) {
  370. repo.Mirror, err = GetMirrorByRepoID(repo.ID)
  371. return err
  372. }
  373. func (repo *Repository) repoPath(e Engine) string {
  374. return RepoPath(repo.mustOwner(e).Name, repo.Name)
  375. }
  376. func (repo *Repository) RepoPath() string {
  377. return repo.repoPath(x)
  378. }
  379. func (repo *Repository) GitConfigPath() string {
  380. return filepath.Join(repo.RepoPath(), "config")
  381. }
  382. func (repo *Repository) RelLink() string {
  383. return "/" + repo.FullName()
  384. }
  385. func (repo *Repository) Link() string {
  386. return setting.AppSubUrl + "/" + repo.FullName()
  387. }
  388. func (repo *Repository) ComposeCompareURL(oldCommitID, newCommitID string) string {
  389. return fmt.Sprintf("%s/%s/compare/%s...%s", repo.MustOwner().Name, repo.Name, oldCommitID, newCommitID)
  390. }
  391. func (repo *Repository) HasAccess(userID int64) bool {
  392. has, _ := HasAccess(userID, repo, ACCESS_MODE_READ)
  393. return has
  394. }
  395. func (repo *Repository) IsOwnedBy(userID int64) bool {
  396. return repo.OwnerID == userID
  397. }
  398. // CanBeForked returns true if repository meets the requirements of being forked.
  399. func (repo *Repository) CanBeForked() bool {
  400. return !repo.IsBare
  401. }
  402. // CanEnablePulls returns true if repository meets the requirements of accepting pulls.
  403. func (repo *Repository) CanEnablePulls() bool {
  404. return !repo.IsMirror && !repo.IsBare
  405. }
  406. // AllowPulls returns true if repository meets the requirements of accepting pulls and has them enabled.
  407. func (repo *Repository) AllowsPulls() bool {
  408. return repo.CanEnablePulls() && repo.EnablePulls
  409. }
  410. func (repo *Repository) IsBranchRequirePullRequest(name string) bool {
  411. return IsBranchOfRepoRequirePullRequest(repo.ID, name)
  412. }
  413. // CanEnableEditor returns true if repository meets the requirements of web editor.
  414. func (repo *Repository) CanEnableEditor() bool {
  415. return !repo.IsMirror
  416. }
  417. // FIXME: should have a mutex to prevent producing same index for two issues that are created
  418. // closely enough.
  419. func (repo *Repository) NextIssueIndex() int64 {
  420. return int64(repo.NumIssues+repo.NumPulls) + 1
  421. }
  422. var (
  423. DescPattern = regexp.MustCompile(`https?://\S+`)
  424. )
  425. // DescriptionHtml does special handles to description and return HTML string.
  426. func (repo *Repository) DescriptionHtml() template.HTML {
  427. sanitize := func(s string) string {
  428. return fmt.Sprintf(`<a href="%[1]s" target="_blank">%[1]s</a>`, s)
  429. }
  430. return template.HTML(DescPattern.ReplaceAllStringFunc(markdown.Sanitizer.Sanitize(repo.Description), sanitize))
  431. }
  432. func (repo *Repository) LocalCopyPath() string {
  433. return path.Join(setting.AppDataPath, "tmp/local-repo", com.ToStr(repo.ID))
  434. }
  435. // UpdateLocalCopy fetches latest changes of given branch from repoPath to localPath.
  436. // It creates a new clone if local copy does not exist, but does not checks out to a
  437. // specific branch if the local copy belongs to a wiki.
  438. // For existing local copy, it checks out to target branch by default, and safe to
  439. // assume subsequent operations are against target branch when caller has confidence
  440. // about no race condition.
  441. func UpdateLocalCopyBranch(repoPath, localPath, branch string, isWiki bool) (err error) {
  442. if !com.IsExist(localPath) {
  443. // Checkout to a specific branch fails when wiki is an empty repository.
  444. if isWiki {
  445. branch = ""
  446. }
  447. if err = git.Clone(repoPath, localPath, git.CloneRepoOptions{
  448. Timeout: time.Duration(setting.Git.Timeout.Clone) * time.Second,
  449. Branch: branch,
  450. }); err != nil {
  451. return fmt.Errorf("git clone %s: %v", branch, err)
  452. }
  453. } else {
  454. if err = git.Fetch(localPath, git.FetchRemoteOptions{
  455. Prune: true,
  456. }); err != nil {
  457. return fmt.Errorf("git fetch: %v", err)
  458. }
  459. if err = git.Checkout(localPath, git.CheckoutOptions{
  460. Branch: branch,
  461. }); err != nil {
  462. return fmt.Errorf("git checkout %s: %v", branch, err)
  463. }
  464. // Reset to align with remote in case of force push.
  465. if err = git.ResetHEAD(localPath, true, "origin/"+branch); err != nil {
  466. return fmt.Errorf("git reset --hard origin/%s: %v", branch, err)
  467. }
  468. }
  469. return nil
  470. }
  471. // UpdateLocalCopyBranch makes sure local copy of repository in given branch is up-to-date.
  472. func (repo *Repository) UpdateLocalCopyBranch(branch string) error {
  473. return UpdateLocalCopyBranch(repo.RepoPath(), repo.LocalCopyPath(), branch, false)
  474. }
  475. // PatchPath returns corresponding patch file path of repository by given issue ID.
  476. func (repo *Repository) PatchPath(index int64) (string, error) {
  477. if err := repo.GetOwner(); err != nil {
  478. return "", err
  479. }
  480. return filepath.Join(RepoPath(repo.Owner.Name, repo.Name), "pulls", com.ToStr(index)+".patch"), nil
  481. }
  482. // SavePatch saves patch data to corresponding location by given issue ID.
  483. func (repo *Repository) SavePatch(index int64, patch []byte) error {
  484. patchPath, err := repo.PatchPath(index)
  485. if err != nil {
  486. return fmt.Errorf("PatchPath: %v", err)
  487. }
  488. os.MkdirAll(filepath.Dir(patchPath), os.ModePerm)
  489. if err = ioutil.WriteFile(patchPath, patch, 0644); err != nil {
  490. return fmt.Errorf("WriteFile: %v", err)
  491. }
  492. return nil
  493. }
  494. func isRepositoryExist(e Engine, u *User, repoName string) (bool, error) {
  495. has, err := e.Get(&Repository{
  496. OwnerID: u.ID,
  497. LowerName: strings.ToLower(repoName),
  498. })
  499. return has && com.IsDir(RepoPath(u.Name, repoName)), err
  500. }
  501. // IsRepositoryExist returns true if the repository with given name under user has already existed.
  502. func IsRepositoryExist(u *User, repoName string) (bool, error) {
  503. return isRepositoryExist(x, u, repoName)
  504. }
  505. // CloneLink represents different types of clone URLs of repository.
  506. type CloneLink struct {
  507. SSH string
  508. HTTPS string
  509. Git string
  510. }
  511. // ComposeHTTPSCloneURL returns HTTPS clone URL based on given owner and repository name.
  512. func ComposeHTTPSCloneURL(owner, repo string) string {
  513. return fmt.Sprintf("%s%s/%s.git", setting.AppUrl, owner, repo)
  514. }
  515. func (repo *Repository) cloneLink(isWiki bool) *CloneLink {
  516. repoName := repo.Name
  517. if isWiki {
  518. repoName += ".wiki"
  519. }
  520. repo.Owner = repo.MustOwner()
  521. cl := new(CloneLink)
  522. if setting.SSH.Port != 22 {
  523. cl.SSH = fmt.Sprintf("ssh://%s@%s:%d/%s/%s.git", setting.RunUser, setting.SSH.Domain, setting.SSH.Port, repo.Owner.Name, repoName)
  524. } else {
  525. cl.SSH = fmt.Sprintf("%s@%s:%s/%s.git", setting.RunUser, setting.SSH.Domain, repo.Owner.Name, repoName)
  526. }
  527. cl.HTTPS = ComposeHTTPSCloneURL(repo.Owner.Name, repoName)
  528. return cl
  529. }
  530. // CloneLink returns clone URLs of repository.
  531. func (repo *Repository) CloneLink() (cl *CloneLink) {
  532. return repo.cloneLink(false)
  533. }
  534. type MigrateRepoOptions struct {
  535. Name string
  536. Description string
  537. IsPrivate bool
  538. IsMirror bool
  539. RemoteAddr string
  540. }
  541. /*
  542. GitHub, GitLab, Gogs: *.wiki.git
  543. BitBucket: *.git/wiki
  544. */
  545. var commonWikiURLSuffixes = []string{".wiki.git", ".git/wiki"}
  546. // wikiRemoteURL returns accessible repository URL for wiki if exists.
  547. // Otherwise, it returns an empty string.
  548. func wikiRemoteURL(remote string) string {
  549. remote = strings.TrimSuffix(remote, ".git")
  550. for _, suffix := range commonWikiURLSuffixes {
  551. wikiURL := remote + suffix
  552. if git.IsRepoURLAccessible(git.NetworkOptions{
  553. URL: wikiURL,
  554. }) {
  555. return wikiURL
  556. }
  557. }
  558. return ""
  559. }
  560. // MigrateRepository migrates a existing repository from other project hosting.
  561. func MigrateRepository(doer, owner *User, opts MigrateRepoOptions) (*Repository, error) {
  562. repo, err := CreateRepository(doer, owner, CreateRepoOptions{
  563. Name: opts.Name,
  564. Description: opts.Description,
  565. IsPrivate: opts.IsPrivate,
  566. IsMirror: opts.IsMirror,
  567. })
  568. if err != nil {
  569. return nil, err
  570. }
  571. repoPath := RepoPath(owner.Name, opts.Name)
  572. wikiPath := WikiPath(owner.Name, opts.Name)
  573. if owner.IsOrganization() {
  574. t, err := owner.GetOwnerTeam()
  575. if err != nil {
  576. return nil, err
  577. }
  578. repo.NumWatches = t.NumMembers
  579. } else {
  580. repo.NumWatches = 1
  581. }
  582. migrateTimeout := time.Duration(setting.Git.Timeout.Migrate) * time.Second
  583. RemoveAllWithNotice("Repository path erase before creation", repoPath)
  584. if err = git.Clone(opts.RemoteAddr, repoPath, git.CloneRepoOptions{
  585. Mirror: true,
  586. Quiet: true,
  587. Timeout: migrateTimeout,
  588. }); err != nil {
  589. return repo, fmt.Errorf("Clone: %v", err)
  590. }
  591. wikiRemotePath := wikiRemoteURL(opts.RemoteAddr)
  592. if len(wikiRemotePath) > 0 {
  593. RemoveAllWithNotice("Repository wiki path erase before creation", wikiPath)
  594. if err = git.Clone(wikiRemotePath, wikiPath, git.CloneRepoOptions{
  595. Mirror: true,
  596. Quiet: true,
  597. Timeout: migrateTimeout,
  598. }); err != nil {
  599. log.Trace("Fail to clone wiki: %v", err)
  600. RemoveAllWithNotice("Delete repository wiki for initialization failure", wikiPath)
  601. }
  602. }
  603. // Check if repository is empty.
  604. _, stderr, err := com.ExecCmdDir(repoPath, "git", "log", "-1")
  605. if err != nil {
  606. if strings.Contains(stderr, "fatal: bad default revision 'HEAD'") {
  607. repo.IsBare = true
  608. } else {
  609. return repo, fmt.Errorf("check bare: %v - %s", err, stderr)
  610. }
  611. }
  612. if !repo.IsBare {
  613. // Try to get HEAD branch and set it as default branch.
  614. gitRepo, err := git.OpenRepository(repoPath)
  615. if err != nil {
  616. return repo, fmt.Errorf("OpenRepository: %v", err)
  617. }
  618. headBranch, err := gitRepo.GetHEADBranch()
  619. if err != nil {
  620. return repo, fmt.Errorf("GetHEADBranch: %v", err)
  621. }
  622. if headBranch != nil {
  623. repo.DefaultBranch = headBranch.Name
  624. }
  625. }
  626. if opts.IsMirror {
  627. if _, err = x.InsertOne(&Mirror{
  628. RepoID: repo.ID,
  629. Interval: setting.Mirror.DefaultInterval,
  630. EnablePrune: true,
  631. NextUpdate: time.Now().Add(time.Duration(setting.Mirror.DefaultInterval) * time.Hour),
  632. }); err != nil {
  633. return repo, fmt.Errorf("InsertOne: %v", err)
  634. }
  635. repo.IsMirror = true
  636. return repo, UpdateRepository(repo, false)
  637. }
  638. return CleanUpMigrateInfo(repo)
  639. }
  640. // cleanUpMigrateGitConfig removes mirror info which prevents "push --all".
  641. // This also removes possible user credentials.
  642. func cleanUpMigrateGitConfig(configPath string) error {
  643. cfg, err := ini.Load(configPath)
  644. if err != nil {
  645. return fmt.Errorf("open config file: %v", err)
  646. }
  647. cfg.DeleteSection("remote \"origin\"")
  648. if err = cfg.SaveToIndent(configPath, "\t"); err != nil {
  649. return fmt.Errorf("save config file: %v", err)
  650. }
  651. return nil
  652. }
  653. var hooksTpls = map[string]string{
  654. "pre-receive": "#!/usr/bin/env %s\n\"%s\" hook --config='%s' pre-receive\n",
  655. "update": "#!/usr/bin/env %s\n\"%s\" hook --config='%s' update $1 $2 $3\n",
  656. "post-receive": "#!/usr/bin/env %s\n\"%s\" hook --config='%s' post-receive\n",
  657. }
  658. func createDelegateHooks(repoPath string) (err error) {
  659. for _, name := range git.HookNames {
  660. hookPath := filepath.Join(repoPath, "hooks", name)
  661. if err = ioutil.WriteFile(hookPath,
  662. []byte(fmt.Sprintf(hooksTpls[name], setting.ScriptType, setting.AppPath, setting.CustomConf)),
  663. os.ModePerm); err != nil {
  664. return fmt.Errorf("create delegate hook '%s': %v", hookPath, err)
  665. }
  666. }
  667. return nil
  668. }
  669. // Finish migrating repository and/or wiki with things that don't need to be done for mirrors.
  670. func CleanUpMigrateInfo(repo *Repository) (*Repository, error) {
  671. repoPath := repo.RepoPath()
  672. if err := createDelegateHooks(repoPath); err != nil {
  673. return repo, fmt.Errorf("createDelegateHooks: %v", err)
  674. }
  675. if repo.HasWiki() {
  676. if err := createDelegateHooks(repo.WikiPath()); err != nil {
  677. return repo, fmt.Errorf("createDelegateHooks.(wiki): %v", err)
  678. }
  679. }
  680. if err := cleanUpMigrateGitConfig(repo.GitConfigPath()); err != nil {
  681. return repo, fmt.Errorf("cleanUpMigrateGitConfig: %v", err)
  682. }
  683. if repo.HasWiki() {
  684. if err := cleanUpMigrateGitConfig(path.Join(repo.WikiPath(), "config")); err != nil {
  685. return repo, fmt.Errorf("cleanUpMigrateGitConfig.(wiki): %v", err)
  686. }
  687. }
  688. return repo, UpdateRepository(repo, false)
  689. }
  690. // initRepoCommit temporarily changes with work directory.
  691. func initRepoCommit(tmpPath string, sig *git.Signature) (err error) {
  692. var stderr string
  693. if _, stderr, err = process.ExecDir(-1,
  694. tmpPath, fmt.Sprintf("initRepoCommit (git add): %s", tmpPath),
  695. "git", "add", "--all"); err != nil {
  696. return fmt.Errorf("git add: %s", stderr)
  697. }
  698. if _, stderr, err = process.ExecDir(-1,
  699. tmpPath, fmt.Sprintf("initRepoCommit (git commit): %s", tmpPath),
  700. "git", "commit", fmt.Sprintf("--author='%s <%s>'", sig.Name, sig.Email),
  701. "-m", "Initial commit"); err != nil {
  702. return fmt.Errorf("git commit: %s", stderr)
  703. }
  704. if _, stderr, err = process.ExecDir(-1,
  705. tmpPath, fmt.Sprintf("initRepoCommit (git push): %s", tmpPath),
  706. "git", "push", "origin", "master"); err != nil {
  707. return fmt.Errorf("git push: %s", stderr)
  708. }
  709. return nil
  710. }
  711. type CreateRepoOptions struct {
  712. Name string
  713. Description string
  714. Gitignores string
  715. License string
  716. Readme string
  717. IsPrivate bool
  718. IsMirror bool
  719. AutoInit bool
  720. }
  721. func getRepoInitFile(tp, name string) ([]byte, error) {
  722. relPath := path.Join("conf", tp, strings.TrimLeft(name, "./"))
  723. // Use custom file when available.
  724. customPath := path.Join(setting.CustomPath, relPath)
  725. if com.IsFile(customPath) {
  726. return ioutil.ReadFile(customPath)
  727. }
  728. return bindata.Asset(relPath)
  729. }
  730. func prepareRepoCommit(repo *Repository, tmpDir, repoPath string, opts CreateRepoOptions) error {
  731. // Clone to temprory path and do the init commit.
  732. _, stderr, err := process.Exec(
  733. fmt.Sprintf("initRepository(git clone): %s", repoPath), "git", "clone", repoPath, tmpDir)
  734. if err != nil {
  735. return fmt.Errorf("git clone: %v - %s", err, stderr)
  736. }
  737. // README
  738. data, err := getRepoInitFile("readme", opts.Readme)
  739. if err != nil {
  740. return fmt.Errorf("getRepoInitFile[%s]: %v", opts.Readme, err)
  741. }
  742. cloneLink := repo.CloneLink()
  743. match := map[string]string{
  744. "Name": repo.Name,
  745. "Description": repo.Description,
  746. "CloneURL.SSH": cloneLink.SSH,
  747. "CloneURL.HTTPS": cloneLink.HTTPS,
  748. }
  749. if err = ioutil.WriteFile(filepath.Join(tmpDir, "README.md"),
  750. []byte(com.Expand(string(data), match)), 0644); err != nil {
  751. return fmt.Errorf("write README.md: %v", err)
  752. }
  753. // .gitignore
  754. if len(opts.Gitignores) > 0 {
  755. var buf bytes.Buffer
  756. names := strings.Split(opts.Gitignores, ",")
  757. for _, name := range names {
  758. data, err = getRepoInitFile("gitignore", name)
  759. if err != nil {
  760. return fmt.Errorf("getRepoInitFile[%s]: %v", name, err)
  761. }
  762. buf.WriteString("# ---> " + name + "\n")
  763. buf.Write(data)
  764. buf.WriteString("\n")
  765. }
  766. if buf.Len() > 0 {
  767. if err = ioutil.WriteFile(filepath.Join(tmpDir, ".gitignore"), buf.Bytes(), 0644); err != nil {
  768. return fmt.Errorf("write .gitignore: %v", err)
  769. }
  770. }
  771. }
  772. // LICENSE
  773. if len(opts.License) > 0 {
  774. data, err = getRepoInitFile("license", opts.License)
  775. if err != nil {
  776. return fmt.Errorf("getRepoInitFile[%s]: %v", opts.License, err)
  777. }
  778. if err = ioutil.WriteFile(filepath.Join(tmpDir, "LICENSE"), data, 0644); err != nil {
  779. return fmt.Errorf("write LICENSE: %v", err)
  780. }
  781. }
  782. return nil
  783. }
  784. // initRepository performs initial commit with chosen setup files on behave of doer.
  785. func initRepository(e Engine, repoPath string, doer *User, repo *Repository, opts CreateRepoOptions) (err error) {
  786. // Somehow the directory could exist.
  787. if com.IsExist(repoPath) {
  788. return fmt.Errorf("initRepository: path already exists: %s", repoPath)
  789. }
  790. // Init bare new repository.
  791. if err = git.InitRepository(repoPath, true); err != nil {
  792. return fmt.Errorf("InitRepository: %v", err)
  793. } else if err = createDelegateHooks(repoPath); err != nil {
  794. return fmt.Errorf("createDelegateHooks: %v", err)
  795. }
  796. tmpDir := filepath.Join(os.TempDir(), "gogs-"+repo.Name+"-"+com.ToStr(time.Now().Nanosecond()))
  797. // Initialize repository according to user's choice.
  798. if opts.AutoInit {
  799. os.MkdirAll(tmpDir, os.ModePerm)
  800. defer RemoveAllWithNotice("Delete repository for auto-initialization", tmpDir)
  801. if err = prepareRepoCommit(repo, tmpDir, repoPath, opts); err != nil {
  802. return fmt.Errorf("prepareRepoCommit: %v", err)
  803. }
  804. // Apply changes and commit.
  805. if err = initRepoCommit(tmpDir, doer.NewGitSig()); err != nil {
  806. return fmt.Errorf("initRepoCommit: %v", err)
  807. }
  808. }
  809. // Re-fetch the repository from database before updating it (else it would
  810. // override changes that were done earlier with sql)
  811. if repo, err = getRepositoryByID(e, repo.ID); err != nil {
  812. return fmt.Errorf("getRepositoryByID: %v", err)
  813. }
  814. if !opts.AutoInit {
  815. repo.IsBare = true
  816. }
  817. repo.DefaultBranch = "master"
  818. if err = updateRepository(e, repo, false); err != nil {
  819. return fmt.Errorf("updateRepository: %v", err)
  820. }
  821. return nil
  822. }
  823. var (
  824. reservedRepoNames = []string{".", ".."}
  825. reservedRepoPatterns = []string{"*.git", "*.wiki"}
  826. )
  827. // IsUsableRepoName return an error if given name is a reserved name or pattern.
  828. func IsUsableRepoName(name string) error {
  829. return isUsableName(reservedRepoNames, reservedRepoPatterns, name)
  830. }
  831. func createRepository(e *xorm.Session, doer, owner *User, repo *Repository) (err error) {
  832. if err = IsUsableRepoName(repo.Name); err != nil {
  833. return err
  834. }
  835. has, err := isRepositoryExist(e, owner, repo.Name)
  836. if err != nil {
  837. return fmt.Errorf("IsRepositoryExist: %v", err)
  838. } else if has {
  839. return ErrRepoAlreadyExist{owner.Name, repo.Name}
  840. }
  841. if _, err = e.Insert(repo); err != nil {
  842. return err
  843. }
  844. owner.NumRepos++
  845. // Remember visibility preference.
  846. owner.LastRepoVisibility = repo.IsPrivate
  847. if err = updateUser(e, owner); err != nil {
  848. return fmt.Errorf("updateUser: %v", err)
  849. }
  850. // Give access to all members in owner team.
  851. if owner.IsOrganization() {
  852. t, err := owner.getOwnerTeam(e)
  853. if err != nil {
  854. return fmt.Errorf("getOwnerTeam: %v", err)
  855. } else if err = t.addRepository(e, repo); err != nil {
  856. return fmt.Errorf("addRepository: %v", err)
  857. }
  858. } else {
  859. // Organization automatically called this in addRepository method.
  860. if err = repo.recalculateAccesses(e); err != nil {
  861. return fmt.Errorf("recalculateAccesses: %v", err)
  862. }
  863. }
  864. if err = watchRepo(e, owner.ID, repo.ID, true); err != nil {
  865. return fmt.Errorf("watchRepo: %v", err)
  866. } else if err = newRepoAction(e, doer, owner, repo); err != nil {
  867. return fmt.Errorf("newRepoAction: %v", err)
  868. }
  869. return nil
  870. }
  871. // CreateRepository creates a repository for given user or organization.
  872. func CreateRepository(doer, owner *User, opts CreateRepoOptions) (_ *Repository, err error) {
  873. if !owner.CanCreateRepo() {
  874. return nil, ErrReachLimitOfRepo{owner.MaxRepoCreation}
  875. }
  876. repo := &Repository{
  877. OwnerID: owner.ID,
  878. Owner: owner,
  879. Name: opts.Name,
  880. LowerName: strings.ToLower(opts.Name),
  881. Description: opts.Description,
  882. IsPrivate: opts.IsPrivate,
  883. EnableWiki: true,
  884. EnableIssues: true,
  885. EnablePulls: true,
  886. }
  887. sess := x.NewSession()
  888. defer sessionRelease(sess)
  889. if err = sess.Begin(); err != nil {
  890. return nil, err
  891. }
  892. if err = createRepository(sess, doer, owner, repo); err != nil {
  893. return nil, err
  894. }
  895. // No need for init mirror.
  896. if !opts.IsMirror {
  897. repoPath := RepoPath(owner.Name, repo.Name)
  898. if err = initRepository(sess, repoPath, doer, repo, opts); err != nil {
  899. RemoveAllWithNotice("Delete repository for initialization failure", repoPath)
  900. return nil, fmt.Errorf("initRepository: %v", err)
  901. }
  902. _, stderr, err := process.ExecDir(-1,
  903. repoPath, fmt.Sprintf("CreateRepository 'git update-server-info': %s", repoPath),
  904. "git", "update-server-info")
  905. if err != nil {
  906. return nil, fmt.Errorf("CreateRepository 'git update-server-info': %s", stderr)
  907. }
  908. }
  909. return repo, sess.Commit()
  910. }
  911. func countRepositories(userID int64, private bool) int64 {
  912. sess := x.Where("id > 0")
  913. if userID > 0 {
  914. sess.And("owner_id = ?", userID)
  915. }
  916. if !private {
  917. sess.And("is_private=?", false)
  918. }
  919. count, err := sess.Count(new(Repository))
  920. if err != nil {
  921. log.Error(4, "countRepositories: %v", err)
  922. }
  923. return count
  924. }
  925. // CountRepositories returns number of repositories.
  926. // Argument private only takes effect when it is false,
  927. // set it true to count all repositories.
  928. func CountRepositories(private bool) int64 {
  929. return countRepositories(-1, private)
  930. }
  931. // CountUserRepositories returns number of repositories user owns.
  932. // Argument private only takes effect when it is false,
  933. // set it true to count all repositories.
  934. func CountUserRepositories(userID int64, private bool) int64 {
  935. return countRepositories(userID, private)
  936. }
  937. func Repositories(page, pageSize int) (_ []*Repository, err error) {
  938. repos := make([]*Repository, 0, pageSize)
  939. return repos, x.Limit(pageSize, (page-1)*pageSize).Asc("id").Find(&repos)
  940. }
  941. // RepositoriesWithUsers returns number of repos in given page.
  942. func RepositoriesWithUsers(page, pageSize int) (_ []*Repository, err error) {
  943. repos, err := Repositories(page, pageSize)
  944. if err != nil {
  945. return nil, fmt.Errorf("Repositories: %v", err)
  946. }
  947. for i := range repos {
  948. if err = repos[i].GetOwner(); err != nil {
  949. return nil, err
  950. }
  951. }
  952. return repos, nil
  953. }
  954. // FilterRepositoryWithIssues selects repositories that are using interal issue tracker
  955. // and has disabled external tracker from given set.
  956. // It returns nil if result set is empty.
  957. func FilterRepositoryWithIssues(repoIDs []int64) ([]int64, error) {
  958. if len(repoIDs) == 0 {
  959. return nil, nil
  960. }
  961. repos := make([]*Repository, 0, len(repoIDs))
  962. if err := x.Where("enable_issues=?", true).
  963. And("enable_external_tracker=?", false).
  964. In("id", repoIDs).
  965. Cols("id").
  966. Find(&repos); err != nil {
  967. return nil, fmt.Errorf("filter valid repositories %v: %v", repoIDs, err)
  968. }
  969. if len(repos) == 0 {
  970. return nil, nil
  971. }
  972. repoIDs = make([]int64, len(repos))
  973. for i := range repos {
  974. repoIDs[i] = repos[i].ID
  975. }
  976. return repoIDs, nil
  977. }
  978. // RepoPath returns repository path by given user and repository name.
  979. func RepoPath(userName, repoName string) string {
  980. return filepath.Join(UserPath(userName), strings.ToLower(repoName)+".git")
  981. }
  982. // TransferOwnership transfers all corresponding setting from old user to new one.
  983. func TransferOwnership(doer *User, newOwnerName string, repo *Repository) error {
  984. newOwner, err := GetUserByName(newOwnerName)
  985. if err != nil {
  986. return fmt.Errorf("get new owner '%s': %v", newOwnerName, err)
  987. }
  988. // Check if new owner has repository with same name.
  989. has, err := IsRepositoryExist(newOwner, repo.Name)
  990. if err != nil {
  991. return fmt.Errorf("IsRepositoryExist: %v", err)
  992. } else if has {
  993. return ErrRepoAlreadyExist{newOwnerName, repo.Name}
  994. }
  995. sess := x.NewSession()
  996. defer sessionRelease(sess)
  997. if err = sess.Begin(); err != nil {
  998. return fmt.Errorf("sess.Begin: %v", err)
  999. }
  1000. owner := repo.Owner
  1001. // Note: we have to set value here to make sure recalculate accesses is based on
  1002. // new owner.
  1003. repo.OwnerID = newOwner.ID
  1004. repo.Owner = newOwner
  1005. // Update repository.
  1006. if _, err := sess.Id(repo.ID).Update(repo); err != nil {
  1007. return fmt.Errorf("update owner: %v", err)
  1008. }
  1009. // Remove redundant collaborators.
  1010. collaborators, err := repo.getCollaborators(sess)
  1011. if err != nil {
  1012. return fmt.Errorf("getCollaborators: %v", err)
  1013. }
  1014. // Dummy object.
  1015. collaboration := &Collaboration{RepoID: repo.ID}
  1016. for _, c := range collaborators {
  1017. collaboration.UserID = c.ID
  1018. if c.ID == newOwner.ID || newOwner.IsOrgMember(c.ID) {
  1019. if _, err = sess.Delete(collaboration); err != nil {
  1020. return fmt.Errorf("remove collaborator '%d': %v", c.ID, err)
  1021. }
  1022. }
  1023. }
  1024. // Remove old team-repository relations.
  1025. if owner.IsOrganization() {
  1026. if err = owner.getTeams(sess); err != nil {
  1027. return fmt.Errorf("getTeams: %v", err)
  1028. }
  1029. for _, t := range owner.Teams {
  1030. if !t.hasRepository(sess, repo.ID) {
  1031. continue
  1032. }
  1033. t.NumRepos--
  1034. if _, err := sess.Id(t.ID).AllCols().Update(t); err != nil {
  1035. return fmt.Errorf("decrease team repository count '%d': %v", t.ID, err)
  1036. }
  1037. }
  1038. if err = owner.removeOrgRepo(sess, repo.ID); err != nil {
  1039. return fmt.Errorf("removeOrgRepo: %v", err)
  1040. }
  1041. }
  1042. if newOwner.IsOrganization() {
  1043. t, err := newOwner.getOwnerTeam(sess)
  1044. if err != nil {
  1045. return fmt.Errorf("getOwnerTeam: %v", err)
  1046. } else if err = t.addRepository(sess, repo); err != nil {
  1047. return fmt.Errorf("add to owner team: %v", err)
  1048. }
  1049. } else {
  1050. // Organization called this in addRepository method.
  1051. if err = repo.recalculateAccesses(sess); err != nil {
  1052. return fmt.Errorf("recalculateAccesses: %v", err)
  1053. }
  1054. }
  1055. // Update repository count.
  1056. if _, err = sess.Exec("UPDATE `user` SET num_repos=num_repos+1 WHERE id=?", newOwner.ID); err != nil {
  1057. return fmt.Errorf("increase new owner repository count: %v", err)
  1058. } else if _, err = sess.Exec("UPDATE `user` SET num_repos=num_repos-1 WHERE id=?", owner.ID); err != nil {
  1059. return fmt.Errorf("decrease old owner repository count: %v", err)
  1060. }
  1061. if err = watchRepo(sess, newOwner.ID, repo.ID, true); err != nil {
  1062. return fmt.Errorf("watchRepo: %v", err)
  1063. } else if err = transferRepoAction(sess, doer, owner, repo); err != nil {
  1064. return fmt.Errorf("transferRepoAction: %v", err)
  1065. }
  1066. // Rename remote repository to new path and delete local copy.
  1067. os.MkdirAll(UserPath(newOwner.Name), os.ModePerm)
  1068. if err = os.Rename(RepoPath(owner.Name, repo.Name), RepoPath(newOwner.Name, repo.Name)); err != nil {
  1069. return fmt.Errorf("rename repository directory: %v", err)
  1070. }
  1071. RemoveAllWithNotice("Delete repository local copy", repo.LocalCopyPath())
  1072. // Rename remote wiki repository to new path and delete local copy.
  1073. wikiPath := WikiPath(owner.Name, repo.Name)
  1074. if com.IsExist(wikiPath) {
  1075. RemoveAllWithNotice("Delete repository wiki local copy", repo.LocalWikiPath())
  1076. if err = os.Rename(wikiPath, WikiPath(newOwner.Name, repo.Name)); err != nil {
  1077. return fmt.Errorf("rename repository wiki: %v", err)
  1078. }
  1079. }
  1080. return sess.Commit()
  1081. }
  1082. // ChangeRepositoryName changes all corresponding setting from old repository name to new one.
  1083. func ChangeRepositoryName(u *User, oldRepoName, newRepoName string) (err error) {
  1084. oldRepoName = strings.ToLower(oldRepoName)
  1085. newRepoName = strings.ToLower(newRepoName)
  1086. if err = IsUsableRepoName(newRepoName); err != nil {
  1087. return err
  1088. }
  1089. has, err := IsRepositoryExist(u, newRepoName)
  1090. if err != nil {
  1091. return fmt.Errorf("IsRepositoryExist: %v", err)
  1092. } else if has {
  1093. return ErrRepoAlreadyExist{u.Name, newRepoName}
  1094. }
  1095. repo, err := GetRepositoryByName(u.ID, oldRepoName)
  1096. if err != nil {
  1097. return fmt.Errorf("GetRepositoryByName: %v", err)
  1098. }
  1099. // Change repository directory name
  1100. if err = os.Rename(repo.RepoPath(), RepoPath(u.Name, newRepoName)); err != nil {
  1101. return fmt.Errorf("rename repository directory: %v", err)
  1102. }
  1103. wikiPath := repo.WikiPath()
  1104. if com.IsExist(wikiPath) {
  1105. if err = os.Rename(wikiPath, WikiPath(u.Name, newRepoName)); err != nil {
  1106. return fmt.Errorf("rename repository wiki: %v", err)
  1107. }
  1108. RemoveAllWithNotice("Delete repository wiki local copy", repo.LocalWikiPath())
  1109. }
  1110. RemoveAllWithNotice("Delete repository local copy", repo.LocalCopyPath())
  1111. return nil
  1112. }
  1113. func getRepositoriesByForkID(e Engine, forkID int64) ([]*Repository, error) {
  1114. repos := make([]*Repository, 0, 10)
  1115. return repos, e.Where("fork_id=?", forkID).Find(&repos)
  1116. }
  1117. // GetRepositoriesByForkID returns all repositories with given fork ID.
  1118. func GetRepositoriesByForkID(forkID int64) ([]*Repository, error) {
  1119. return getRepositoriesByForkID(x, forkID)
  1120. }
  1121. func updateRepository(e Engine, repo *Repository, visibilityChanged bool) (err error) {
  1122. repo.LowerName = strings.ToLower(repo.Name)
  1123. if len(repo.Description) > 255 {
  1124. repo.Description = repo.Description[:255]
  1125. }
  1126. if len(repo.Website) > 255 {
  1127. repo.Website = repo.Website[:255]
  1128. }
  1129. if _, err = e.Id(repo.ID).AllCols().Update(repo); err != nil {
  1130. return fmt.Errorf("update: %v", err)
  1131. }
  1132. if visibilityChanged {
  1133. if err = repo.getOwner(e); err != nil {
  1134. return fmt.Errorf("getOwner: %v", err)
  1135. }
  1136. if repo.Owner.IsOrganization() {
  1137. // Organization repository need to recalculate access table when visivility is changed.
  1138. if err = repo.recalculateTeamAccesses(e, 0); err != nil {
  1139. return fmt.Errorf("recalculateTeamAccesses: %v", err)
  1140. }
  1141. }
  1142. // Create/Remove git-daemon-export-ok for git-daemon...
  1143. daemonExportFile := path.Join(repo.RepoPath(), `git-daemon-export-ok`)
  1144. if repo.IsPrivate && com.IsExist(daemonExportFile) {
  1145. if err = os.Remove(daemonExportFile); err != nil {
  1146. log.Error(4, "Failed to remove %s: %v", daemonExportFile, err)
  1147. }
  1148. } else if !repo.IsPrivate && !com.IsExist(daemonExportFile) {
  1149. if f, err := os.Create(daemonExportFile); err != nil {
  1150. log.Error(4, "Failed to create %s: %v", daemonExportFile, err)
  1151. } else {
  1152. f.Close()
  1153. }
  1154. }
  1155. forkRepos, err := getRepositoriesByForkID(e, repo.ID)
  1156. if err != nil {
  1157. return fmt.Errorf("getRepositoriesByForkID: %v", err)
  1158. }
  1159. for i := range forkRepos {
  1160. forkRepos[i].IsPrivate = repo.IsPrivate
  1161. if err = updateRepository(e, forkRepos[i], true); err != nil {
  1162. return fmt.Errorf("updateRepository[%d]: %v", forkRepos[i].ID, err)
  1163. }
  1164. }
  1165. }
  1166. return nil
  1167. }
  1168. func UpdateRepository(repo *Repository, visibilityChanged bool) (err error) {
  1169. sess := x.NewSession()
  1170. defer sessionRelease(sess)
  1171. if err = sess.Begin(); err != nil {
  1172. return err
  1173. }
  1174. if err = updateRepository(x, repo, visibilityChanged); err != nil {
  1175. return fmt.Errorf("updateRepository: %v", err)
  1176. }
  1177. return sess.Commit()
  1178. }
  1179. // DeleteRepository deletes a repository for a user or organization.
  1180. func DeleteRepository(uid, repoID int64) error {
  1181. repo := &Repository{ID: repoID, OwnerID: uid}
  1182. has, err := x.Get(repo)
  1183. if err != nil {
  1184. return err
  1185. } else if !has {
  1186. return errors.RepoNotExist{repoID, uid, ""}
  1187. }
  1188. // In case is a organization.
  1189. org, err := GetUserByID(uid)
  1190. if err != nil {
  1191. return err
  1192. }
  1193. if org.IsOrganization() {
  1194. if err = org.GetTeams(); err != nil {
  1195. return err
  1196. }
  1197. }
  1198. sess := x.NewSession()
  1199. defer sessionRelease(sess)
  1200. if err = sess.Begin(); err != nil {
  1201. return err
  1202. }
  1203. if org.IsOrganization() {
  1204. for _, t := range org.Teams {
  1205. if !t.hasRepository(sess, repoID) {
  1206. continue
  1207. } else if err = t.removeRepository(sess, repo, false); err != nil {
  1208. return err
  1209. }
  1210. }
  1211. }
  1212. if err = deleteBeans(sess,
  1213. &Repository{ID: repoID},
  1214. &Access{RepoID: repo.ID},
  1215. &Action{RepoID: repo.ID},
  1216. &Watch{RepoID: repoID},
  1217. &Star{RepoID: repoID},
  1218. &Mirror{RepoID: repoID},
  1219. &IssueUser{RepoID: repoID},
  1220. &Milestone{RepoID: repoID},
  1221. &Release{RepoID: repoID},
  1222. &Collaboration{RepoID: repoID},
  1223. &PullRequest{BaseRepoID: repoID},
  1224. &ProtectBranch{RepoID: repoID},
  1225. &ProtectBranchWhitelist{RepoID: repoID},
  1226. ); err != nil {
  1227. return fmt.Errorf("deleteBeans: %v", err)
  1228. }
  1229. // Delete comments and attachments.
  1230. issues := make([]*Issue, 0, 25)
  1231. attachmentPaths := make([]string, 0, len(issues))
  1232. if err = sess.Where("repo_id=?", repoID).Find(&issues); err != nil {
  1233. return err
  1234. }
  1235. for i := range issues {
  1236. if _, err = sess.Delete(&Comment{IssueID: issues[i].ID}); err != nil {
  1237. return err
  1238. }
  1239. attachments := make([]*Attachment, 0, 5)
  1240. if err = sess.Where("issue_id=?", issues[i].ID).Find(&attachments); err != nil {
  1241. return err
  1242. }
  1243. for j := range attachments {
  1244. attachmentPaths = append(attachmentPaths, attachments[j].LocalPath())
  1245. }
  1246. if _, err = sess.Delete(&Attachment{IssueID: issues[i].ID}); err != nil {
  1247. return err
  1248. }
  1249. }
  1250. if _, err = sess.Delete(&Issue{RepoID: repoID}); err != nil {
  1251. return err
  1252. }
  1253. if repo.IsFork {
  1254. if _, err = sess.Exec("UPDATE `repository` SET num_forks=num_forks-1 WHERE id=?", repo.ForkID); err != nil {
  1255. return fmt.Errorf("decrease fork count: %v", err)
  1256. }
  1257. }
  1258. if _, err = sess.Exec("UPDATE `user` SET num_repos=num_repos-1 WHERE id=?", uid); err != nil {
  1259. return err
  1260. }
  1261. if err = sess.Commit(); err != nil {
  1262. return fmt.Errorf("Commit: %v", err)
  1263. }
  1264. // Remove repository files.
  1265. repoPath := repo.RepoPath()
  1266. RemoveAllWithNotice("Delete repository files", repoPath)
  1267. repo.DeleteWiki()
  1268. // Remove attachment files.
  1269. for i := range attachmentPaths {
  1270. RemoveAllWithNotice("Delete attachment", attachmentPaths[i])
  1271. }
  1272. if repo.NumForks > 0 {
  1273. if _, err = x.Exec("UPDATE `repository` SET fork_id=0,is_fork=? WHERE fork_id=?", false, repo.ID); err != nil {
  1274. log.Error(4, "reset 'fork_id' and 'is_fork': %v", err)
  1275. }
  1276. }
  1277. return nil
  1278. }
  1279. // GetRepositoryByRef returns a Repository specified by a GFM reference.
  1280. // See https://help.github.com/articles/writing-on-github#references for more information on the syntax.
  1281. func GetRepositoryByRef(ref string) (*Repository, error) {
  1282. n := strings.IndexByte(ref, byte('/'))
  1283. if n < 2 {
  1284. return nil, errors.InvalidRepoReference{ref}
  1285. }
  1286. userName, repoName := ref[:n], ref[n+1:]
  1287. user, err := GetUserByName(userName)
  1288. if err != nil {
  1289. return nil, err
  1290. }
  1291. return GetRepositoryByName(user.ID, repoName)
  1292. }
  1293. // GetRepositoryByName returns the repository by given name under user if exists.
  1294. func GetRepositoryByName(ownerID int64, name string) (*Repository, error) {
  1295. repo := &Repository{
  1296. OwnerID: ownerID,
  1297. LowerName: strings.ToLower(name),
  1298. }
  1299. has, err := x.Get(repo)
  1300. if err != nil {
  1301. return nil, err
  1302. } else if !has {
  1303. return nil, errors.RepoNotExist{0, ownerID, name}
  1304. }
  1305. return repo, repo.LoadAttributes()
  1306. }
  1307. func getRepositoryByID(e Engine, id int64) (*Repository, error) {
  1308. repo := new(Repository)
  1309. has, err := e.Id(id).Get(repo)
  1310. if err != nil {
  1311. return nil, err
  1312. } else if !has {
  1313. return nil, errors.RepoNotExist{id, 0, ""}
  1314. }
  1315. return repo, repo.loadAttributes(e)
  1316. }
  1317. // GetRepositoryByID returns the repository by given id if exists.
  1318. func GetRepositoryByID(id int64) (*Repository, error) {
  1319. return getRepositoryByID(x, id)
  1320. }
  1321. type UserRepoOptions struct {
  1322. UserID int64
  1323. Private bool
  1324. Page int
  1325. PageSize int
  1326. }
  1327. // GetUserRepositories returns a list of repositories of given user.
  1328. func GetUserRepositories(opts *UserRepoOptions) ([]*Repository, error) {
  1329. sess := x.Where("owner_id=?", opts.UserID).Desc("updated_unix")
  1330. if !opts.Private {
  1331. sess.And("is_private=?", false)
  1332. }
  1333. if opts.Page <= 0 {
  1334. opts.Page = 1
  1335. }
  1336. sess.Limit(opts.PageSize, (opts.Page-1)*opts.PageSize)
  1337. repos := make([]*Repository, 0, opts.PageSize)
  1338. return repos, sess.Find(&repos)
  1339. }
  1340. // GetUserRepositories returns a list of mirror repositories of given user.
  1341. func GetUserMirrorRepositories(userID int64) ([]*Repository, error) {
  1342. repos := make([]*Repository, 0, 10)
  1343. return repos, x.Where("owner_id = ?", userID).And("is_mirror = ?", true).Find(&repos)
  1344. }
  1345. // GetRecentUpdatedRepositories returns the list of repositories that are recently updated.
  1346. func GetRecentUpdatedRepositories(page, pageSize int) (repos []*Repository, err error) {
  1347. return repos, x.Limit(pageSize, (page-1)*pageSize).
  1348. Where("is_private=?", false).Limit(pageSize).Desc("updated_unix").Find(&repos)
  1349. }
  1350. // GetUserAndCollaborativeRepositories returns list of repositories the user owns and collaborates.
  1351. func GetUserAndCollaborativeRepositories(userID int64) ([]*Repository, error) {
  1352. repos := make([]*Repository, 0, 10)
  1353. if err := x.Alias("repo").
  1354. Join("INNER", "collaboration", "collaboration.repo_id = repo.id").
  1355. Where("collaboration.user_id = ?", userID).
  1356. Find(&repos); err != nil {
  1357. return nil, fmt.Errorf("select collaborative repositories: %v", err)
  1358. }
  1359. ownRepos := make([]*Repository, 0, 10)
  1360. if err := x.Where("owner_id = ?", userID).Find(&ownRepos); err != nil {
  1361. return nil, fmt.Errorf("select own repositories: %v", err)
  1362. }
  1363. return append(repos, ownRepos...), nil
  1364. }
  1365. func getRepositoryCount(e Engine, u *User) (int64, error) {
  1366. return x.Count(&Repository{OwnerID: u.ID})
  1367. }
  1368. // GetRepositoryCount returns the total number of repositories of user.
  1369. func GetRepositoryCount(u *User) (int64, error) {
  1370. return getRepositoryCount(x, u)
  1371. }
  1372. type SearchRepoOptions struct {
  1373. Keyword string
  1374. OwnerID int64
  1375. UserID int64 // When set results will contain all public/private repositories user has access to
  1376. OrderBy string
  1377. Private bool // Include private repositories in results
  1378. Page int
  1379. PageSize int // Can be smaller than or equal to setting.ExplorePagingNum
  1380. }
  1381. // SearchRepositoryByName takes keyword and part of repository name to search,
  1382. // it returns results in given range and number of total results.
  1383. func SearchRepositoryByName(opts *SearchRepoOptions) (repos []*Repository, _ int64, _ error) {
  1384. if opts.Page <= 0 {
  1385. opts.Page = 1
  1386. }
  1387. repos = make([]*Repository, 0, opts.PageSize)
  1388. sess := x.Alias("repo")
  1389. // Attempt to find repositories that opts.UserID has access to,
  1390. // this does not include other people's private repositories even if opts.UserID is an admin.
  1391. if !opts.Private && opts.UserID > 0 {
  1392. sess.Join("LEFT", "access", "access.repo_id = repo.id").
  1393. Where("(repo.owner_id = ? OR access.user_id = ? OR repo.is_private = ?)", opts.UserID, opts.UserID, false)
  1394. } else {
  1395. // Only return public repositories if opts.Private is not set
  1396. if !opts.Private {
  1397. sess.And("repo.is_private = ?", false)
  1398. }
  1399. }
  1400. if len(opts.Keyword) > 0 {
  1401. sess.And("repo.lower_name LIKE ?", "%"+strings.ToLower(opts.Keyword)+"%")
  1402. }
  1403. if opts.OwnerID > 0 {
  1404. sess.And("repo.owner_id = ?", opts.OwnerID)
  1405. }
  1406. var countSess xorm.Session
  1407. countSess = *sess
  1408. count, err := countSess.Count(new(Repository))
  1409. if err != nil {
  1410. return nil, 0, fmt.Errorf("Count: %v", err)
  1411. }
  1412. if len(opts.OrderBy) > 0 {
  1413. sess.OrderBy("repo." + opts.OrderBy)
  1414. }
  1415. return repos, count, sess.Limit(opts.PageSize, (opts.Page-1)*opts.PageSize).Find(&repos)
  1416. }
  1417. func DeleteOldRepositoryArchives() {
  1418. if taskStatusTable.IsRunning(_CLEAN_OLD_ARCHIVES) {
  1419. return
  1420. }
  1421. taskStatusTable.Start(_CLEAN_OLD_ARCHIVES)
  1422. defer taskStatusTable.Stop(_CLEAN_OLD_ARCHIVES)
  1423. log.Trace("Doing: DeleteOldRepositoryArchives")
  1424. formats := []string{"zip", "targz"}
  1425. oldestTime := time.Now().Add(-setting.Cron.RepoArchiveCleanup.OlderThan)
  1426. if err := x.Where("id > 0").Iterate(new(Repository),
  1427. func(idx int, bean interface{}) error {
  1428. repo := bean.(*Repository)
  1429. basePath := filepath.Join(repo.RepoPath(), "archives")
  1430. for _, format := range formats {
  1431. dirPath := filepath.Join(basePath, format)
  1432. if !com.IsDir(dirPath) {
  1433. continue
  1434. }
  1435. dir, err := os.Open(dirPath)
  1436. if err != nil {
  1437. log.Error(3, "Fail to open directory '%s': %v", dirPath, err)
  1438. continue
  1439. }
  1440. fis, err := dir.Readdir(0)
  1441. dir.Close()
  1442. if err != nil {
  1443. log.Error(3, "Fail to read directory '%s': %v", dirPath, err)
  1444. continue
  1445. }
  1446. for _, fi := range fis {
  1447. if fi.IsDir() || fi.ModTime().After(oldestTime) {
  1448. continue
  1449. }
  1450. archivePath := filepath.Join(dirPath, fi.Name())
  1451. if err = os.Remove(archivePath); err != nil {
  1452. desc := fmt.Sprintf("Fail to health delete archive '%s': %v", archivePath, err)
  1453. log.Warn(desc)
  1454. if err = CreateRepositoryNotice(desc); err != nil {
  1455. log.Error(3, "CreateRepositoryNotice: %v", err)
  1456. }
  1457. }
  1458. }
  1459. }
  1460. return nil
  1461. }); err != nil {
  1462. log.Error(2, "DeleteOldRepositoryArchives: %v", err)
  1463. }
  1464. }
  1465. // DeleteRepositoryArchives deletes all repositories' archives.
  1466. func DeleteRepositoryArchives() error {
  1467. if taskStatusTable.IsRunning(_CLEAN_OLD_ARCHIVES) {
  1468. return nil
  1469. }
  1470. taskStatusTable.Start(_CLEAN_OLD_ARCHIVES)
  1471. defer taskStatusTable.Stop(_CLEAN_OLD_ARCHIVES)
  1472. return x.Where("id > 0").Iterate(new(Repository),
  1473. func(idx int, bean interface{}) error {
  1474. repo := bean.(*Repository)
  1475. return os.RemoveAll(filepath.Join(repo.RepoPath(), "archives"))
  1476. })
  1477. }
  1478. func gatherMissingRepoRecords() ([]*Repository, error) {
  1479. repos := make([]*Repository, 0, 10)
  1480. if err := x.Where("id > 0").Iterate(new(Repository),
  1481. func(idx int, bean interface{}) error {
  1482. repo := bean.(*Repository)
  1483. if !com.IsDir(repo.RepoPath()) {
  1484. repos = append(repos, repo)
  1485. }
  1486. return nil
  1487. }); err != nil {
  1488. if err2 := CreateRepositoryNotice(fmt.Sprintf("gatherMissingRepoRecords: %v", err)); err2 != nil {
  1489. return nil, fmt.Errorf("CreateRepositoryNotice: %v", err)
  1490. }
  1491. }
  1492. return repos, nil
  1493. }
  1494. // DeleteMissingRepositories deletes all repository records that lost Git files.
  1495. func DeleteMissingRepositories() error {
  1496. repos, err := gatherMissingRepoRecords()
  1497. if err != nil {
  1498. return fmt.Errorf("gatherMissingRepoRecords: %v", err)
  1499. }
  1500. if len(repos) == 0 {
  1501. return nil
  1502. }
  1503. for _, repo := range repos {
  1504. log.Trace("Deleting %d/%d...", repo.OwnerID, repo.ID)
  1505. if err := DeleteRepository(repo.OwnerID, repo.ID); err != nil {
  1506. if err2 := CreateRepositoryNotice(fmt.Sprintf("DeleteRepository [%d]: %v", repo.ID, err)); err2 != nil {
  1507. return fmt.Errorf("CreateRepositoryNotice: %v", err)
  1508. }
  1509. }
  1510. }
  1511. return nil
  1512. }
  1513. // ReinitMissingRepositories reinitializes all repository records that lost Git files.
  1514. func ReinitMissingRepositories() error {
  1515. repos, err := gatherMissingRepoRecords()
  1516. if err != nil {
  1517. return fmt.Errorf("gatherMissingRepoRecords: %v", err)
  1518. }
  1519. if len(repos) == 0 {
  1520. return nil
  1521. }
  1522. for _, repo := range repos {
  1523. log.Trace("Initializing %d/%d...", repo.OwnerID, repo.ID)
  1524. if err := git.InitRepository(repo.RepoPath(), true); err != nil {
  1525. if err2 := CreateRepositoryNotice(fmt.Sprintf("InitRepository [%d]: %v", repo.ID, err)); err2 != nil {
  1526. return fmt.Errorf("CreateRepositoryNotice: %v", err)
  1527. }
  1528. }
  1529. }
  1530. return nil
  1531. }
  1532. // SyncRepositoryHooks rewrites all repositories' pre-receive, update and post-receive hooks
  1533. // to make sure the binary and custom conf path are up-to-date.
  1534. func SyncRepositoryHooks() error {
  1535. return x.Where("id > 0").Iterate(new(Repository),
  1536. func(idx int, bean interface{}) error {
  1537. repo := bean.(*Repository)
  1538. if err := createDelegateHooks(repo.RepoPath()); err != nil {
  1539. return err
  1540. }
  1541. if repo.HasWiki() {
  1542. return createDelegateHooks(repo.WikiPath())
  1543. }
  1544. return nil
  1545. })
  1546. }
  1547. // Prevent duplicate running tasks.
  1548. var taskStatusTable = sync.NewStatusTable()
  1549. const (
  1550. _MIRROR_UPDATE = "mirror_update"
  1551. _GIT_FSCK = "git_fsck"
  1552. _CHECK_REPO_STATS = "check_repos_stats"
  1553. _CLEAN_OLD_ARCHIVES = "clean_old_archives"
  1554. )
  1555. // GitFsck calls 'git fsck' to check repository health.
  1556. func GitFsck() {
  1557. if taskStatusTable.IsRunning(_GIT_FSCK) {
  1558. return
  1559. }
  1560. taskStatusTable.Start(_GIT_FSCK)
  1561. defer taskStatusTable.Stop(_GIT_FSCK)
  1562. log.Trace("Doing: GitFsck")
  1563. if err := x.Where("id>0").Iterate(new(Repository),
  1564. func(idx int, bean interface{}) error {
  1565. repo := bean.(*Repository)
  1566. repoPath := repo.RepoPath()
  1567. if err := git.Fsck(repoPath, setting.Cron.RepoHealthCheck.Timeout, setting.Cron.RepoHealthCheck.Args...); err != nil {
  1568. desc := fmt.Sprintf("Fail to health check repository '%s': %v", repoPath, err)
  1569. log.Warn(desc)
  1570. if err = CreateRepositoryNotice(desc); err != nil {
  1571. log.Error(3, "CreateRepositoryNotice: %v", err)
  1572. }
  1573. }
  1574. return nil
  1575. }); err != nil {
  1576. log.Error(2, "GitFsck: %v", err)
  1577. }
  1578. }
  1579. func GitGcRepos() error {
  1580. args := append([]string{"gc"}, setting.Git.GCArgs...)
  1581. return x.Where("id > 0").Iterate(new(Repository),
  1582. func(idx int, bean interface{}) error {
  1583. repo := bean.(*Repository)
  1584. if err := repo.GetOwner(); err != nil {
  1585. return err
  1586. }
  1587. _, stderr, err := process.ExecDir(
  1588. time.Duration(setting.Git.Timeout.GC)*time.Second,
  1589. RepoPath(repo.Owner.Name, repo.Name), "Repository garbage collection",
  1590. "git", args...)
  1591. if err != nil {
  1592. return fmt.Errorf("%v: %v", err, stderr)
  1593. }
  1594. return nil
  1595. })
  1596. }
  1597. type repoChecker struct {
  1598. querySQL, correctSQL string
  1599. desc string
  1600. }
  1601. func repoStatsCheck(checker *repoChecker) {
  1602. results, err := x.Query(checker.querySQL)
  1603. if err != nil {
  1604. log.Error(2, "Select %s: %v", checker.desc, err)
  1605. return
  1606. }
  1607. for _, result := range results {
  1608. id := com.StrTo(result["id"]).MustInt64()
  1609. log.Trace("Updating %s: %d", checker.desc, id)
  1610. _, err = x.Exec(checker.correctSQL, id, id)
  1611. if err != nil {
  1612. log.Error(2, "Update %s[%d]: %v", checker.desc, id, err)
  1613. }
  1614. }
  1615. }
  1616. func CheckRepoStats() {
  1617. if taskStatusTable.IsRunning(_CHECK_REPO_STATS) {
  1618. return
  1619. }
  1620. taskStatusTable.Start(_CHECK_REPO_STATS)
  1621. defer taskStatusTable.Stop(_CHECK_REPO_STATS)
  1622. log.Trace("Doing: CheckRepoStats")
  1623. checkers := []*repoChecker{
  1624. // Repository.NumWatches
  1625. {
  1626. "SELECT repo.id FROM `repository` repo WHERE repo.num_watches!=(SELECT COUNT(*) FROM `watch` WHERE repo_id=repo.id)",
  1627. "UPDATE `repository` SET num_watches=(SELECT COUNT(*) FROM `watch` WHERE repo_id=?) WHERE id=?",
  1628. "repository count 'num_watches'",
  1629. },
  1630. // Repository.NumStars
  1631. {
  1632. "SELECT repo.id FROM `repository` repo WHERE repo.num_stars!=(SELECT COUNT(*) FROM `star` WHERE repo_id=repo.id)",
  1633. "UPDATE `repository` SET num_stars=(SELECT COUNT(*) FROM `star` WHERE repo_id=?) WHERE id=?",
  1634. "repository count 'num_stars'",
  1635. },
  1636. // Label.NumIssues
  1637. {
  1638. "SELECT label.id FROM `label` WHERE label.num_issues!=(SELECT COUNT(*) FROM `issue_label` WHERE label_id=label.id)",
  1639. "UPDATE `label` SET num_issues=(SELECT COUNT(*) FROM `issue_label` WHERE label_id=?) WHERE id=?",
  1640. "label count 'num_issues'",
  1641. },
  1642. // User.NumRepos
  1643. {
  1644. "SELECT `user`.id FROM `user` WHERE `user`.num_repos!=(SELECT COUNT(*) FROM `repository` WHERE owner_id=`user`.id)",
  1645. "UPDATE `user` SET num_repos=(SELECT COUNT(*) FROM `repository` WHERE owner_id=?) WHERE id=?",
  1646. "user count 'num_repos'",
  1647. },
  1648. // Issue.NumComments
  1649. {
  1650. "SELECT `issue`.id FROM `issue` WHERE `issue`.num_comments!=(SELECT COUNT(*) FROM `comment` WHERE issue_id=`issue`.id AND type=0)",
  1651. "UPDATE `issue` SET num_comments=(SELECT COUNT(*) FROM `comment` WHERE issue_id=? AND type=0) WHERE id=?",
  1652. "issue count 'num_comments'",
  1653. },
  1654. }
  1655. for i := range checkers {
  1656. repoStatsCheck(checkers[i])
  1657. }
  1658. // ***** START: Repository.NumClosedIssues *****
  1659. desc := "repository count 'num_closed_issues'"
  1660. results, err := x.Query("SELECT repo.id FROM `repository` repo WHERE repo.num_closed_issues!=(SELECT COUNT(*) FROM `issue` WHERE repo_id=repo.id AND is_closed=? AND is_pull=?)", true, false)
  1661. if err != nil {
  1662. log.Error(2, "Select %s: %v", desc, err)
  1663. } else {
  1664. for _, result := range results {
  1665. id := com.StrTo(result["id"]).MustInt64()
  1666. log.Trace("Updating %s: %d", desc, id)
  1667. _, err = x.Exec("UPDATE `repository` SET num_closed_issues=(SELECT COUNT(*) FROM `issue` WHERE repo_id=? AND is_closed=? AND is_pull=?) WHERE id=?", id, true, false, id)
  1668. if err != nil {
  1669. log.Error(2, "Update %s[%d]: %v", desc, id, err)
  1670. }
  1671. }
  1672. }
  1673. // ***** END: Repository.NumClosedIssues *****
  1674. // FIXME: use checker when stop supporting old fork repo format.
  1675. // ***** START: Repository.NumForks *****
  1676. results, err = x.Query("SELECT repo.id FROM `repository` repo WHERE repo.num_forks!=(SELECT COUNT(*) FROM `repository` WHERE fork_id=repo.id)")
  1677. if err != nil {
  1678. log.Error(2, "Select repository count 'num_forks': %v", err)
  1679. } else {
  1680. for _, result := range results {
  1681. id := com.StrTo(result["id"]).MustInt64()
  1682. log.Trace("Updating repository count 'num_forks': %d", id)
  1683. repo, err := GetRepositoryByID(id)
  1684. if err != nil {
  1685. log.Error(2, "GetRepositoryByID[%d]: %v", id, err)
  1686. continue
  1687. }
  1688. rawResult, err := x.Query("SELECT COUNT(*) FROM `repository` WHERE fork_id=?", repo.ID)
  1689. if err != nil {
  1690. log.Error(2, "Select count of forks[%d]: %v", repo.ID, err)
  1691. continue
  1692. }
  1693. repo.NumForks = int(parseCountResult(rawResult))
  1694. if err = UpdateRepository(repo, false); err != nil {
  1695. log.Error(2, "UpdateRepository[%d]: %v", id, err)
  1696. continue
  1697. }
  1698. }
  1699. }
  1700. // ***** END: Repository.NumForks *****
  1701. }
  1702. type RepositoryList []*Repository
  1703. func (repos RepositoryList) loadAttributes(e Engine) error {
  1704. if len(repos) == 0 {
  1705. return nil
  1706. }
  1707. // Load owners
  1708. set := make(map[int64]*User)
  1709. for i := range repos {
  1710. set[repos[i].OwnerID] = nil
  1711. }
  1712. userIDs := make([]int64, 0, len(set))
  1713. for userID := range set {
  1714. userIDs = append(userIDs, userID)
  1715. }
  1716. users := make([]*User, 0, len(userIDs))
  1717. if err := e.Where("id > 0").In("id", userIDs).Find(&users); err != nil {
  1718. return fmt.Errorf("find users: %v", err)
  1719. }
  1720. for i := range users {
  1721. set[users[i].ID] = users[i]
  1722. }
  1723. for i := range repos {
  1724. repos[i].Owner = set[repos[i].OwnerID]
  1725. }
  1726. return nil
  1727. }
  1728. func (repos RepositoryList) LoadAttributes() error {
  1729. return repos.loadAttributes(x)
  1730. }
  1731. type MirrorRepositoryList []*Repository
  1732. func (repos MirrorRepositoryList) loadAttributes(e Engine) error {
  1733. if len(repos) == 0 {
  1734. return nil
  1735. }
  1736. // Load mirrors.
  1737. repoIDs := make([]int64, 0, len(repos))
  1738. for i := range repos {
  1739. if !repos[i].IsMirror {
  1740. continue
  1741. }
  1742. repoIDs = append(repoIDs, repos[i].ID)
  1743. }
  1744. mirrors := make([]*Mirror, 0, len(repoIDs))
  1745. if err := e.Where("id > 0").In("repo_id", repoIDs).Find(&mirrors); err != nil {
  1746. return fmt.Errorf("find mirrors: %v", err)
  1747. }
  1748. set := make(map[int64]*Mirror)
  1749. for i := range mirrors {
  1750. set[mirrors[i].RepoID] = mirrors[i]
  1751. }
  1752. for i := range repos {
  1753. repos[i].Mirror = set[repos[i].ID]
  1754. }
  1755. return nil
  1756. }
  1757. func (repos MirrorRepositoryList) LoadAttributes() error {
  1758. return repos.loadAttributes(x)
  1759. }
  1760. // __ __ __ .__
  1761. // / \ / \_____ _/ |_ ____ | |__
  1762. // \ \/\/ /\__ \\ __\/ ___\| | \
  1763. // \ / / __ \| | \ \___| Y \
  1764. // \__/\ / (____ /__| \___ >___| /
  1765. // \/ \/ \/ \/
  1766. // Watch is connection request for receiving repository notification.
  1767. type Watch struct {
  1768. ID int64 `xorm:"pk autoincr"`
  1769. UserID int64 `xorm:"UNIQUE(watch)"`
  1770. RepoID int64 `xorm:"UNIQUE(watch)"`
  1771. }
  1772. func isWatching(e Engine, userID, repoID int64) bool {
  1773. has, _ := e.Get(&Watch{0, userID, repoID})
  1774. return has
  1775. }
  1776. // IsWatching checks if user has watched given repository.
  1777. func IsWatching(userID, repoID int64) bool {
  1778. return isWatching(x, userID, repoID)
  1779. }
  1780. func watchRepo(e Engine, userID, repoID int64, watch bool) (err error) {
  1781. if watch {
  1782. if isWatching(e, userID, repoID) {
  1783. return nil
  1784. }
  1785. if _, err = e.Insert(&Watch{RepoID: repoID, UserID: userID}); err != nil {
  1786. return err
  1787. }
  1788. _, err = e.Exec("UPDATE `repository` SET num_watches = num_watches + 1 WHERE id = ?", repoID)
  1789. } else {
  1790. if !isWatching(e, userID, repoID) {
  1791. return nil
  1792. }
  1793. if _, err = e.Delete(&Watch{0, userID, repoID}); err != nil {
  1794. return err
  1795. }
  1796. _, err = e.Exec("UPDATE `repository` SET num_watches = num_watches - 1 WHERE id = ?", repoID)
  1797. }
  1798. return err
  1799. }
  1800. // Watch or unwatch repository.
  1801. func WatchRepo(userID, repoID int64, watch bool) (err error) {
  1802. return watchRepo(x, userID, repoID, watch)
  1803. }
  1804. func getWatchers(e Engine, repoID int64) ([]*Watch, error) {
  1805. watches := make([]*Watch, 0, 10)
  1806. return watches, e.Find(&watches, &Watch{RepoID: repoID})
  1807. }
  1808. // GetWatchers returns all watchers of given repository.
  1809. func GetWatchers(repoID int64) ([]*Watch, error) {
  1810. return getWatchers(x, repoID)
  1811. }
  1812. // Repository.GetWatchers returns range of users watching given repository.
  1813. func (repo *Repository) GetWatchers(page int) ([]*User, error) {
  1814. users := make([]*User, 0, ItemsPerPage)
  1815. sess := x.Limit(ItemsPerPage, (page-1)*ItemsPerPage).Where("watch.repo_id=?", repo.ID)
  1816. if setting.UsePostgreSQL {
  1817. sess = sess.Join("LEFT", "watch", `"user".id=watch.user_id`)
  1818. } else {
  1819. sess = sess.Join("LEFT", "watch", "user.id=watch.user_id")
  1820. }
  1821. return users, sess.Find(&users)
  1822. }
  1823. func notifyWatchers(e Engine, act *Action) error {
  1824. // Add feeds for user self and all watchers.
  1825. watchers, err := getWatchers(e, act.RepoID)
  1826. if err != nil {
  1827. return fmt.Errorf("getWatchers: %v", err)
  1828. }
  1829. // Reset ID to reuse Action object
  1830. act.ID = 0
  1831. // Add feed for actioner.
  1832. act.UserID = act.ActUserID
  1833. if _, err = e.Insert(act); err != nil {
  1834. return fmt.Errorf("insert new action: %v", err)
  1835. }
  1836. for i := range watchers {
  1837. if act.ActUserID == watchers[i].UserID {
  1838. continue
  1839. }
  1840. act.ID = 0
  1841. act.UserID = watchers[i].UserID
  1842. if _, err = e.Insert(act); err != nil {
  1843. return fmt.Errorf("insert new action: %v", err)
  1844. }
  1845. }
  1846. return nil
  1847. }
  1848. // NotifyWatchers creates batch of actions for every watcher.
  1849. func NotifyWatchers(act *Action) error {
  1850. return notifyWatchers(x, act)
  1851. }
  1852. // _________ __
  1853. // / _____// |______ _______
  1854. // \_____ \\ __\__ \\_ __ \
  1855. // / \| | / __ \| | \/
  1856. // /_______ /|__| (____ /__|
  1857. // \/ \/
  1858. type Star struct {
  1859. ID int64 `xorm:"pk autoincr"`
  1860. UID int64 `xorm:"UNIQUE(s)"`
  1861. RepoID int64 `xorm:"UNIQUE(s)"`
  1862. }
  1863. // Star or unstar repository.
  1864. func StarRepo(userID, repoID int64, star bool) (err error) {
  1865. if star {
  1866. if IsStaring(userID, repoID) {
  1867. return nil
  1868. }
  1869. if _, err = x.Insert(&Star{UID: userID, RepoID: repoID}); err != nil {
  1870. return err
  1871. } else if _, err = x.Exec("UPDATE `repository` SET num_stars = num_stars + 1 WHERE id = ?", repoID); err != nil {
  1872. return err
  1873. }
  1874. _, err = x.Exec("UPDATE `user` SET num_stars = num_stars + 1 WHERE id = ?", userID)
  1875. } else {
  1876. if !IsStaring(userID, repoID) {
  1877. return nil
  1878. }
  1879. if _, err = x.Delete(&Star{0, userID, repoID}); err != nil {
  1880. return err
  1881. } else if _, err = x.Exec("UPDATE `repository` SET num_stars = num_stars - 1 WHERE id = ?", repoID); err != nil {
  1882. return err
  1883. }
  1884. _, err = x.Exec("UPDATE `user` SET num_stars = num_stars - 1 WHERE id = ?", userID)
  1885. }
  1886. return err
  1887. }
  1888. // IsStaring checks if user has starred given repository.
  1889. func IsStaring(userID, repoID int64) bool {
  1890. has, _ := x.Get(&Star{0, userID, repoID})
  1891. return has
  1892. }
  1893. func (repo *Repository) GetStargazers(page int) ([]*User, error) {
  1894. users := make([]*User, 0, ItemsPerPage)
  1895. sess := x.Limit(ItemsPerPage, (page-1)*ItemsPerPage).Where("star.repo_id=?", repo.ID)
  1896. if setting.UsePostgreSQL {
  1897. sess = sess.Join("LEFT", "star", `"user".id=star.uid`)
  1898. } else {
  1899. sess = sess.Join("LEFT", "star", "user.id=star.uid")
  1900. }
  1901. return users, sess.Find(&users)
  1902. }
  1903. // ___________ __
  1904. // \_ _____/__________| | __
  1905. // | __)/ _ \_ __ \ |/ /
  1906. // | \( <_> ) | \/ <
  1907. // \___ / \____/|__| |__|_ \
  1908. // \/ \/
  1909. // HasForkedRepo checks if given user has already forked a repository.
  1910. // When user has already forked, it returns true along with the repository.
  1911. func HasForkedRepo(ownerID, repoID int64) (*Repository, bool) {
  1912. repo := new(Repository)
  1913. has, _ := x.Where("owner_id = ? AND fork_id = ?", ownerID, repoID).Get(repo)
  1914. return repo, has
  1915. }
  1916. // ForkRepository creates a fork of target repository under another user domain.
  1917. func ForkRepository(doer, owner *User, baseRepo *Repository, name, desc string) (_ *Repository, err error) {
  1918. repo := &Repository{
  1919. OwnerID: owner.ID,
  1920. Owner: owner,
  1921. Name: name,
  1922. LowerName: strings.ToLower(name),
  1923. Description: desc,
  1924. DefaultBranch: baseRepo.DefaultBranch,
  1925. IsPrivate: baseRepo.IsPrivate,
  1926. IsFork: true,
  1927. ForkID: baseRepo.ID,
  1928. }
  1929. sess := x.NewSession()
  1930. defer sessionRelease(sess)
  1931. if err = sess.Begin(); err != nil {
  1932. return nil, err
  1933. }
  1934. if err = createRepository(sess, doer, owner, repo); err != nil {
  1935. return nil, err
  1936. } else if _, err = sess.Exec("UPDATE `repository` SET num_forks=num_forks+1 WHERE id=?", baseRepo.ID); err != nil {
  1937. return nil, err
  1938. }
  1939. repoPath := repo.repoPath(sess)
  1940. _, stderr, err := process.ExecTimeout(10*time.Minute,
  1941. fmt.Sprintf("ForkRepository 'git clone': %s/%s", owner.Name, repo.Name),
  1942. "git", "clone", "--bare", baseRepo.RepoPath(), repoPath)
  1943. if err != nil {
  1944. return nil, fmt.Errorf("git clone: %v", stderr)
  1945. }
  1946. _, stderr, err = process.ExecDir(-1,
  1947. repoPath, fmt.Sprintf("ForkRepository 'git update-server-info': %s", repoPath),
  1948. "git", "update-server-info")
  1949. if err != nil {
  1950. return nil, fmt.Errorf("git update-server-info: %v", err)
  1951. }
  1952. if err = createDelegateHooks(repoPath); err != nil {
  1953. return nil, fmt.Errorf("createDelegateHooks: %v", err)
  1954. } else if err = prepareWebhooks(sess, baseRepo, HOOK_EVENT_FORK, &api.ForkPayload{
  1955. Forkee: repo.APIFormat(nil),
  1956. Repo: baseRepo.APIFormat(nil),
  1957. Sender: doer.APIFormat(),
  1958. }); err != nil {
  1959. return nil, fmt.Errorf("prepareWebhooks: %v", err)
  1960. }
  1961. return repo, sess.Commit()
  1962. }
  1963. func (repo *Repository) GetForks() ([]*Repository, error) {
  1964. forks := make([]*Repository, 0, repo.NumForks)
  1965. return forks, x.Find(&forks, &Repository{ForkID: repo.ID})
  1966. }
  1967. // __________ .__
  1968. // \______ \____________ ____ ____ | |__
  1969. // | | _/\_ __ \__ \ / \_/ ___\| | \
  1970. // | | \ | | \// __ \| | \ \___| Y \
  1971. // |______ / |__| (____ /___| /\___ >___| /
  1972. // \/ \/ \/ \/ \/
  1973. //
  1974. func (repo *Repository) CreateNewBranch(doer *User, oldBranchName, branchName string) (err error) {
  1975. repoWorkingPool.CheckIn(com.ToStr(repo.ID))
  1976. defer repoWorkingPool.CheckOut(com.ToStr(repo.ID))
  1977. localPath := repo.LocalCopyPath()
  1978. if err = discardLocalRepoBranchChanges(localPath, oldBranchName); err != nil {
  1979. return fmt.Errorf("discardLocalRepoChanges: %v", err)
  1980. } else if err = repo.UpdateLocalCopyBranch(oldBranchName); err != nil {
  1981. return fmt.Errorf("UpdateLocalCopyBranch: %v", err)
  1982. }
  1983. if err = repo.CheckoutNewBranch(oldBranchName, branchName); err != nil {
  1984. return fmt.Errorf("CreateNewBranch: %v", err)
  1985. }
  1986. if err = git.Push(localPath, "origin", branchName); err != nil {
  1987. return fmt.Errorf("Push: %v", err)
  1988. }
  1989. return nil
  1990. }