Method update

src/packagedcode/models.py:1707–1818

Update this Package with data from the ``package_data`` PackageData. If a field does not have a value and the ``package_data`` field has a value, set this package field to the ``package_data`` field value. If there is a value on both side, update the value accordin

(
        self,
        package_data,
        datafile_path,
        check_compatible=True,
        replace=False,
        include_version=True,
        include_qualifiers=False,
        include_subpath=False,
        ignore_name_check=False,
        default_relation='AND',
        licensing=Licensing(),
    )

        )

    def update(
        self,
        package_data,
        datafile_path,
        check_compatible=True,
        replace=False,
        include_version=True,
        include_qualifiers=False,
        include_subpath=False,
        ignore_name_check=False,
        default_relation='AND',
        licensing=Licensing(),
    ):
        """
        Update this Package with data from the ``package_data`` PackageData.

        If a field does not have a value and the ``package_data`` field has a
        value, set this package field to the ``package_data`` field value.

        If there is a value on both side, update the value according to the
        ``replace`` flag.

        If ``replace`` is True, replace a value with the ``package_data`` value.
        Otherwise existing, non-empty values are left unchanged.

        List of values are merged, keeping the original order and avoiding duplicates.

        Return True if update is successful.

        Return False if there is a type, name or version mismatch between this
        package and the provided ``package_data``
        """
        if not package_data:
            return

        if isinstance(package_data, dict):
            package_data = PackageData.from_dict(package_data)

        if check_compatible and not is_compatible(
            purl1=self,
            purl2=package_data,
            include_version=include_version,
            include_qualifiers=include_qualifiers,
            include_subpath=include_subpath,
            ignore_name_check=ignore_name_check,
        ):
            if TRACE_UPDATE:
                logger_debug(f'update: skipping: {self.purl} is not compatible with: {package_data.purl}')
            return False

        # always append these new items
        self.datasource_ids.append(package_data.datasource_id)
        self.datafile_paths.append(datafile_path)

        existing = self.to_package_data().to_dict()
        new_package_data = package_data.to_dict()

        # update for these means combining lists of items from both sides