mirror of
				https://gitee.com/gitea/gitea
				synced 2025-11-04 08:30:25 +08:00 
			
		
		
		
	Add Package Registry (#16510)
* Added package store settings. * Added models. * Added generic package registry. * Added tests. * Added NuGet package registry. * Moved service index to api file. * Added NPM package registry. * Added Maven package registry. * Added PyPI package registry. * Summary is deprecated. * Changed npm name. * Sanitize project url. * Allow only scoped packages. * Added user interface. * Changed method name. * Added missing migration file. * Set page info. * Added documentation. * Added documentation links. * Fixed wrong error message. * Lint template files. * Fixed merge errors. * Fixed unit test storage path. * Switch to json module. * Added suggestions. * Added package webhook. * Add package api. * Fixed swagger file. * Fixed enum and comments. * Fixed NuGet pagination. * Print test names. * Added api tests. * Fixed access level. * Fix User unmarshal. * Added RubyGems package registry. * Fix lint. * Implemented io.Writer. * Added support for sha256/sha512 checksum files. * Improved maven-metadata.xml support. * Added support for symbol package uploads. * Added tests. * Added overview docs. * Added npm dependencies and keywords. * Added no-packages information. * Display file size. * Display asset count. * Fixed filter alignment. * Added package icons. * Formatted instructions. * Allow anonymous package downloads. * Fixed comments. * Fixed postgres test. * Moved file. * Moved models to models/packages. * Use correct error response format per client. * Use simpler search form. * Fixed IsProd. * Restructured data model. * Prevent empty filename. * Fix swagger. * Implemented user/org registry. * Implemented UI. * Use GetUserByIDCtx. * Use table for dependencies. * make svg * Added support for unscoped npm packages. * Add support for npm dist tags. * Added tests for npm tags. * Unlink packages if repository gets deleted. * Prevent user/org delete if a packages exist. * Use package unlink in repository service. * Added support for composer packages. * Restructured package docs. * Added missing tests. * Fixed generic content page. * Fixed docs. * Fixed swagger. * Added missing type. * Fixed ambiguous column. * Organize content store by sha256 hash. * Added admin package management. * Added support for sorting. * Add support for multiple identical versions/files. * Added missing repository unlink. * Added file properties. * make fmt * lint * Added Conan package registry. * Updated docs. * Unify package names. * Added swagger enum. * Use longer TEXT column type. * Removed version composite key. * Merged package and container registry. * Removed index. * Use dedicated package router. * Moved files to new location. * Updated docs. * Fixed JOIN order. * Fixed GROUP BY statement. * Fixed GROUP BY #2. * Added symbol server support. * Added more tests. * Set NOT NULL. * Added setting to disable package registries. * Moved auth into service. * refactor * Use ctx everywhere. * Added package cleanup task. * Changed packages path. * Added container registry. * Refactoring * Updated comparison. * Fix swagger. * Fixed table order. * Use token auth for npm routes. * Enabled ReverseProxy auth. * Added packages link for orgs. * Fixed anonymous org access. * Enable copy button for setup instructions. * Merge error * Added suggestions. * Fixed merge. * Handle "generic". * Added link for TODO. * Added suggestions. * Changed temporary buffer filename. * Added suggestions. * Apply suggestions from code review Co-authored-by: Thomas Boerger <thomas@webhippie.de> * Update docs/content/doc/packages/nuget.en-us.md Co-authored-by: wxiaoguang <wxiaoguang@gmail.com> Co-authored-by: Thomas Boerger <thomas@webhippie.de>
This commit is contained in:
		
							
								
								
									
										316
									
								
								models/packages/package_version.go
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										316
									
								
								models/packages/package_version.go
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,316 @@
 | 
			
		||||
// Copyright 2021 The Gitea Authors. All rights reserved.
 | 
			
		||||
// Use of this source code is governed by a MIT-style
 | 
			
		||||
// license that can be found in the LICENSE file.
 | 
			
		||||
 | 
			
		||||
package packages
 | 
			
		||||
 | 
			
		||||
import (
 | 
			
		||||
	"context"
 | 
			
		||||
	"errors"
 | 
			
		||||
	"strconv"
 | 
			
		||||
	"strings"
 | 
			
		||||
 | 
			
		||||
	"code.gitea.io/gitea/models/db"
 | 
			
		||||
	"code.gitea.io/gitea/modules/timeutil"
 | 
			
		||||
 | 
			
		||||
	"xorm.io/builder"
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
var (
 | 
			
		||||
	// ErrDuplicatePackageVersion indicates a duplicated package version error
 | 
			
		||||
	ErrDuplicatePackageVersion = errors.New("Package version does exist already")
 | 
			
		||||
	// ErrPackageVersionNotExist indicates a package version not exist error
 | 
			
		||||
	ErrPackageVersionNotExist = errors.New("Package version does not exist")
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
func init() {
 | 
			
		||||
	db.RegisterModel(new(PackageVersion))
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// PackageVersion represents a package version
 | 
			
		||||
type PackageVersion struct {
 | 
			
		||||
	ID            int64              `xorm:"pk autoincr"`
 | 
			
		||||
	PackageID     int64              `xorm:"UNIQUE(s) INDEX NOT NULL"`
 | 
			
		||||
	CreatorID     int64              `xorm:"NOT NULL DEFAULT 0"`
 | 
			
		||||
	Version       string             `xorm:"NOT NULL"`
 | 
			
		||||
	LowerVersion  string             `xorm:"UNIQUE(s) INDEX NOT NULL"`
 | 
			
		||||
	CreatedUnix   timeutil.TimeStamp `xorm:"created INDEX NOT NULL"`
 | 
			
		||||
	IsInternal    bool               `xorm:"INDEX NOT NULL DEFAULT false"`
 | 
			
		||||
	MetadataJSON  string             `xorm:"metadata_json TEXT"`
 | 
			
		||||
	DownloadCount int64              `xorm:"NOT NULL DEFAULT 0"`
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// GetOrInsertVersion inserts a version. If the same version exist already ErrDuplicatePackageVersion is returned
 | 
			
		||||
func GetOrInsertVersion(ctx context.Context, pv *PackageVersion) (*PackageVersion, error) {
 | 
			
		||||
	e := db.GetEngine(ctx)
 | 
			
		||||
 | 
			
		||||
	key := &PackageVersion{
 | 
			
		||||
		PackageID:    pv.PackageID,
 | 
			
		||||
		LowerVersion: pv.LowerVersion,
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	has, err := e.Get(key)
 | 
			
		||||
	if err != nil {
 | 
			
		||||
		return nil, err
 | 
			
		||||
	}
 | 
			
		||||
	if has {
 | 
			
		||||
		return key, ErrDuplicatePackageVersion
 | 
			
		||||
	}
 | 
			
		||||
	if _, err = e.Insert(pv); err != nil {
 | 
			
		||||
		return nil, err
 | 
			
		||||
	}
 | 
			
		||||
	return pv, nil
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// UpdateVersion updates a version
 | 
			
		||||
func UpdateVersion(ctx context.Context, pv *PackageVersion) error {
 | 
			
		||||
	_, err := db.GetEngine(ctx).ID(pv.ID).Update(pv)
 | 
			
		||||
	return err
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// IncrementDownloadCounter increments the download counter of a version
 | 
			
		||||
func IncrementDownloadCounter(ctx context.Context, versionID int64) error {
 | 
			
		||||
	_, err := db.GetEngine(ctx).Exec("UPDATE `package_version` SET `download_count` = `download_count` + 1 WHERE `id` = ?", versionID)
 | 
			
		||||
	return err
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// GetVersionByID gets a version by id
 | 
			
		||||
func GetVersionByID(ctx context.Context, versionID int64) (*PackageVersion, error) {
 | 
			
		||||
	pv := &PackageVersion{}
 | 
			
		||||
 | 
			
		||||
	has, err := db.GetEngine(ctx).ID(versionID).Get(pv)
 | 
			
		||||
	if err != nil {
 | 
			
		||||
		return nil, err
 | 
			
		||||
	}
 | 
			
		||||
	if !has {
 | 
			
		||||
		return nil, ErrPackageNotExist
 | 
			
		||||
	}
 | 
			
		||||
	return pv, nil
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// GetVersionByNameAndVersion gets a version by name and version number
 | 
			
		||||
func GetVersionByNameAndVersion(ctx context.Context, ownerID int64, packageType Type, name, version string) (*PackageVersion, error) {
 | 
			
		||||
	return getVersionByNameAndVersion(ctx, ownerID, packageType, name, version, false)
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// GetInternalVersionByNameAndVersion gets a version by name and version number
 | 
			
		||||
func GetInternalVersionByNameAndVersion(ctx context.Context, ownerID int64, packageType Type, name, version string) (*PackageVersion, error) {
 | 
			
		||||
	return getVersionByNameAndVersion(ctx, ownerID, packageType, name, version, true)
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
func getVersionByNameAndVersion(ctx context.Context, ownerID int64, packageType Type, name, version string, isInternal bool) (*PackageVersion, error) {
 | 
			
		||||
	var cond builder.Cond = builder.Eq{
 | 
			
		||||
		"package.owner_id":            ownerID,
 | 
			
		||||
		"package.type":                packageType,
 | 
			
		||||
		"package.lower_name":          strings.ToLower(name),
 | 
			
		||||
		"package_version.is_internal": isInternal,
 | 
			
		||||
	}
 | 
			
		||||
	pv := &PackageVersion{
 | 
			
		||||
		LowerVersion: strings.ToLower(version),
 | 
			
		||||
	}
 | 
			
		||||
	has, err := db.GetEngine(ctx).
 | 
			
		||||
		Join("INNER", "package", "package.id = package_version.package_id").
 | 
			
		||||
		Where(cond).
 | 
			
		||||
		Get(pv)
 | 
			
		||||
	if err != nil {
 | 
			
		||||
		return nil, err
 | 
			
		||||
	}
 | 
			
		||||
	if !has {
 | 
			
		||||
		return nil, ErrPackageNotExist
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	return pv, nil
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// GetVersionsByPackageType gets all versions of a specific type
 | 
			
		||||
func GetVersionsByPackageType(ctx context.Context, ownerID int64, packageType Type) ([]*PackageVersion, error) {
 | 
			
		||||
	var cond builder.Cond = builder.Eq{
 | 
			
		||||
		"package.owner_id":            ownerID,
 | 
			
		||||
		"package.type":                packageType,
 | 
			
		||||
		"package_version.is_internal": false,
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	pvs := make([]*PackageVersion, 0, 10)
 | 
			
		||||
	return pvs, db.GetEngine(ctx).
 | 
			
		||||
		Where(cond).
 | 
			
		||||
		Join("INNER", "package", "package.id = package_version.package_id").
 | 
			
		||||
		Find(&pvs)
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// GetVersionsByPackageName gets all versions of a specific package
 | 
			
		||||
func GetVersionsByPackageName(ctx context.Context, ownerID int64, packageType Type, name string) ([]*PackageVersion, error) {
 | 
			
		||||
	var cond builder.Cond = builder.Eq{
 | 
			
		||||
		"package.owner_id":            ownerID,
 | 
			
		||||
		"package.type":                packageType,
 | 
			
		||||
		"package.lower_name":          strings.ToLower(name),
 | 
			
		||||
		"package_version.is_internal": false,
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	pvs := make([]*PackageVersion, 0, 10)
 | 
			
		||||
	return pvs, db.GetEngine(ctx).
 | 
			
		||||
		Where(cond).
 | 
			
		||||
		Join("INNER", "package", "package.id = package_version.package_id").
 | 
			
		||||
		Find(&pvs)
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// GetVersionsByFilename gets all versions which are linked to a filename
 | 
			
		||||
func GetVersionsByFilename(ctx context.Context, ownerID int64, packageType Type, filename string) ([]*PackageVersion, error) {
 | 
			
		||||
	var cond builder.Cond = builder.Eq{
 | 
			
		||||
		"package.owner_id":            ownerID,
 | 
			
		||||
		"package.type":                packageType,
 | 
			
		||||
		"package_file.lower_name":     strings.ToLower(filename),
 | 
			
		||||
		"package_version.is_internal": false,
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	pvs := make([]*PackageVersion, 0, 10)
 | 
			
		||||
	return pvs, db.GetEngine(ctx).
 | 
			
		||||
		Where(cond).
 | 
			
		||||
		Join("INNER", "package_file", "package_file.version_id = package_version.id").
 | 
			
		||||
		Join("INNER", "package", "package.id = package_version.package_id").
 | 
			
		||||
		Find(&pvs)
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// DeleteVersionByID deletes a version by id
 | 
			
		||||
func DeleteVersionByID(ctx context.Context, versionID int64) error {
 | 
			
		||||
	_, err := db.GetEngine(ctx).ID(versionID).Delete(&PackageVersion{})
 | 
			
		||||
	return err
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// HasVersionFileReferences checks if there are associated files
 | 
			
		||||
func HasVersionFileReferences(ctx context.Context, versionID int64) (bool, error) {
 | 
			
		||||
	return db.GetEngine(ctx).Get(&PackageFile{
 | 
			
		||||
		VersionID: versionID,
 | 
			
		||||
	})
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// PackageSearchOptions are options for SearchXXX methods
 | 
			
		||||
type PackageSearchOptions struct {
 | 
			
		||||
	OwnerID      int64
 | 
			
		||||
	RepoID       int64
 | 
			
		||||
	Type         string
 | 
			
		||||
	PackageID    int64
 | 
			
		||||
	QueryName    string
 | 
			
		||||
	QueryVersion string
 | 
			
		||||
	Properties   map[string]string
 | 
			
		||||
	Sort         string
 | 
			
		||||
	db.Paginator
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
func (opts *PackageSearchOptions) toConds() builder.Cond {
 | 
			
		||||
	var cond builder.Cond = builder.Eq{"package_version.is_internal": false}
 | 
			
		||||
 | 
			
		||||
	if opts.OwnerID != 0 {
 | 
			
		||||
		cond = cond.And(builder.Eq{"package.owner_id": opts.OwnerID})
 | 
			
		||||
	}
 | 
			
		||||
	if opts.RepoID != 0 {
 | 
			
		||||
		cond = cond.And(builder.Eq{"package.repo_id": opts.RepoID})
 | 
			
		||||
	}
 | 
			
		||||
	if opts.Type != "" && opts.Type != "all" {
 | 
			
		||||
		cond = cond.And(builder.Eq{"package.type": opts.Type})
 | 
			
		||||
	}
 | 
			
		||||
	if opts.PackageID != 0 {
 | 
			
		||||
		cond = cond.And(builder.Eq{"package.id": opts.PackageID})
 | 
			
		||||
	}
 | 
			
		||||
	if opts.QueryName != "" {
 | 
			
		||||
		cond = cond.And(builder.Like{"package.lower_name", strings.ToLower(opts.QueryName)})
 | 
			
		||||
	}
 | 
			
		||||
	if opts.QueryVersion != "" {
 | 
			
		||||
		cond = cond.And(builder.Like{"package_version.lower_version", strings.ToLower(opts.QueryVersion)})
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	if len(opts.Properties) != 0 {
 | 
			
		||||
		var propsCond builder.Cond = builder.Eq{
 | 
			
		||||
			"package_property.ref_type": PropertyTypeVersion,
 | 
			
		||||
		}
 | 
			
		||||
		propsCond = propsCond.And(builder.Expr("package_property.ref_id = package_version.id"))
 | 
			
		||||
 | 
			
		||||
		propsCondBlock := builder.NewCond()
 | 
			
		||||
		for name, value := range opts.Properties {
 | 
			
		||||
			propsCondBlock = propsCondBlock.Or(builder.Eq{
 | 
			
		||||
				"package_property.name":  name,
 | 
			
		||||
				"package_property.value": value,
 | 
			
		||||
			})
 | 
			
		||||
		}
 | 
			
		||||
		propsCond = propsCond.And(propsCondBlock)
 | 
			
		||||
 | 
			
		||||
		cond = cond.And(builder.Eq{
 | 
			
		||||
			strconv.Itoa(len(opts.Properties)): builder.Select("COUNT(*)").Where(propsCond).From("package_property"),
 | 
			
		||||
		})
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	return cond
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
func (opts *PackageSearchOptions) configureOrderBy(e db.Engine) {
 | 
			
		||||
	switch opts.Sort {
 | 
			
		||||
	case "alphabetically":
 | 
			
		||||
		e.Asc("package.name")
 | 
			
		||||
	case "reversealphabetically":
 | 
			
		||||
		e.Desc("package.name")
 | 
			
		||||
	case "highestversion":
 | 
			
		||||
		e.Desc("package_version.version")
 | 
			
		||||
	case "lowestversion":
 | 
			
		||||
		e.Asc("package_version.version")
 | 
			
		||||
	case "oldest":
 | 
			
		||||
		e.Asc("package_version.created_unix")
 | 
			
		||||
	default:
 | 
			
		||||
		e.Desc("package_version.created_unix")
 | 
			
		||||
	}
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// SearchVersions gets all versions of packages matching the search options
 | 
			
		||||
func SearchVersions(ctx context.Context, opts *PackageSearchOptions) ([]*PackageVersion, int64, error) {
 | 
			
		||||
	sess := db.GetEngine(ctx).
 | 
			
		||||
		Where(opts.toConds()).
 | 
			
		||||
		Table("package_version").
 | 
			
		||||
		Join("INNER", "package", "package.id = package_version.package_id")
 | 
			
		||||
 | 
			
		||||
	opts.configureOrderBy(sess)
 | 
			
		||||
 | 
			
		||||
	if opts.Paginator != nil {
 | 
			
		||||
		sess = db.SetSessionPagination(sess, opts)
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	pvs := make([]*PackageVersion, 0, 10)
 | 
			
		||||
	count, err := sess.FindAndCount(&pvs)
 | 
			
		||||
	return pvs, count, err
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// SearchLatestVersions gets the latest version of every package matching the search options
 | 
			
		||||
func SearchLatestVersions(ctx context.Context, opts *PackageSearchOptions) ([]*PackageVersion, int64, error) {
 | 
			
		||||
	cond := opts.toConds().
 | 
			
		||||
		And(builder.Expr("pv2.id IS NULL"))
 | 
			
		||||
 | 
			
		||||
	sess := db.GetEngine(ctx).
 | 
			
		||||
		Table("package_version").
 | 
			
		||||
		Join("LEFT", "package_version pv2", "package_version.package_id = pv2.package_id AND (package_version.created_unix < pv2.created_unix OR (package_version.created_unix = pv2.created_unix AND package_version.id < pv2.id))").
 | 
			
		||||
		Join("INNER", "package", "package.id = package_version.package_id").
 | 
			
		||||
		Where(cond)
 | 
			
		||||
 | 
			
		||||
	opts.configureOrderBy(sess)
 | 
			
		||||
 | 
			
		||||
	if opts.Paginator != nil {
 | 
			
		||||
		sess = db.SetSessionPagination(sess, opts)
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	pvs := make([]*PackageVersion, 0, 10)
 | 
			
		||||
	count, err := sess.FindAndCount(&pvs)
 | 
			
		||||
	return pvs, count, err
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// FindVersionsByPropertyNameAndValue gets all package versions which are associated with a specific property + value
 | 
			
		||||
func FindVersionsByPropertyNameAndValue(ctx context.Context, packageID int64, name, value string) ([]*PackageVersion, error) {
 | 
			
		||||
	var cond builder.Cond = builder.Eq{
 | 
			
		||||
		"package_property.ref_type":   PropertyTypeVersion,
 | 
			
		||||
		"package_property.name":       name,
 | 
			
		||||
		"package_property.value":      value,
 | 
			
		||||
		"package_version.package_id":  packageID,
 | 
			
		||||
		"package_version.is_internal": false,
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	pvs := make([]*PackageVersion, 0, 5)
 | 
			
		||||
	return pvs, db.GetEngine(ctx).
 | 
			
		||||
		Where(cond).
 | 
			
		||||
		Join("INNER", "package_property", "package_property.ref_id = package_version.id").
 | 
			
		||||
		Find(&pvs)
 | 
			
		||||
}
 | 
			
		||||
		Reference in New Issue
	
	Block a user