Repository URL to install this package:
Version:
1.10.1 ▾
|
# -*- coding: utf-8 -*-
#
# Copyright (c) the purl authors
# SPDX-License-Identifier: MIT
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in all
# copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.
# Visit https://github.com/package-url/packageurl-python for support and
# download.
from django.core.exceptions import ValidationError
from django.db import models
from django.utils.translation import gettext_lazy as _
from packageurl import PackageURL
from packageurl.contrib.django.utils import purl_to_lookups
class PackageURLQuerySetMixin:
"""
Add Package URL filtering methods to a django.db.models.QuerySet.
"""
def for_package_url(self, purl_str, encode=True):
"""
Filter the QuerySet with the provided Package URL string.
The purl string is validated and transformed into filtering lookups.
"""
lookups = purl_to_lookups(purl_str=purl_str, encode=encode)
if lookups:
return self.filter(**lookups)
return self.none()
def empty_package_url(self):
"""
Return objects with empty Package URL.
"""
return self.filter(models.Q(type="") | models.Q(name=""))
class PackageURLQuerySet(PackageURLQuerySetMixin, models.QuerySet):
pass
class PackageURLMixin(models.Model):
"""
Abstract Model for Package URL "purl" fields support.
"""
type = models.CharField(
max_length=16,
blank=True,
help_text=_(
"A short code to identify the type of this package. "
"For example: gem for a Rubygem, docker for a container, "
"pypi for a Python Wheel or Egg, maven for a Maven Jar, "
"deb for a Debian package, etc."
),
)
namespace = models.CharField(
max_length=255,
blank=True,
help_text=_(
"Package name prefix, such as Maven groupid, Docker image owner, "
"GitHub user or organization, etc."
),
)
name = models.CharField(
max_length=100,
blank=True,
help_text=_("Name of the package."),
)
version = models.CharField(
max_length=100,
blank=True,
help_text=_("Version of the package."),
)
qualifiers = models.CharField(
max_length=1024,
blank=True,
help_text=_(
"Extra qualifying data for a package such as the name of an OS, "
"architecture, distro, etc."
),
)
subpath = models.CharField(
max_length=200,
blank=True,
help_text=_("Extra subpath within a package, relative to the package root."),
)
objects = PackageURLQuerySet.as_manager()
class Meta:
abstract = True
@property
def package_url(self):
"""
Return the Package URL "purl" string.
"""
try:
package_url = self.get_package_url()
except ValueError:
return ""
return str(package_url)
def get_package_url(self):
"""
Get the PackageURL instance.
"""
return PackageURL(
self.type,
self.namespace,
self.name,
self.version,
self.qualifiers,
self.subpath,
)
def set_package_url(self, package_url):
"""
Set each field values to the values of the provided `package_url` string
or PackageURL object.
Existing values are always overwritten, forcing the new value or an
empty string on all the `package_url` fields since we do not want to
keep any previous values.
"""
if not isinstance(package_url, PackageURL):
package_url = PackageURL.from_string(package_url)
package_url_dict = package_url.to_dict(encode=True, empty="")
for field_name, value in package_url_dict.items():
model_field = self._meta.get_field(field_name)
if value and len(value) > model_field.max_length:
message = _(f'Value too long for field "{field_name}".')
raise ValidationError(message)
setattr(self, field_name, value)