Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Follow CycloneDX 1.4 spec for SPDX license expressions for npm. #690

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

ansonallard
Copy link
Contributor

Support spdx expressions for CycloneDX 1.4 Spec

@prabhu
Copy link
Collaborator

prabhu commented Nov 2, 2023

@ansonallard any ideas about the test failures?

@ansonallard
Copy link
Contributor Author

@prabhu Is there a way to see what the inputs were to the test that failed? I just see that the schema validation failed, but I don't have the data to determine why.

@prabhu
Copy link
Collaborator

prabhu commented Nov 2, 2023

@ansonallard I could never get the jsonschema to return that information. Usually I would run the same test locally and use jq :(

@@ -234,7 +236,9 @@ export function getLicenses(pkg, format = "xml") {
}
return licenseContent;
})
.map((l) => ({ license: l }));
.map((l) =>
l.expression ? { expression: l.expression } : { license: l }
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think there can be only one expression, so possible we are returning multiple.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The licenses list supports multiple schemas in the array. I'm not certain if the spec requires all data to be the same schema in the list. Spec

Copy link
Contributor Author

@ansonallard ansonallard Nov 2, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That appears to be the difference between CycloneDX 1.4 and 1.5. It seems 1.4 allows for a list of SPDX expressions (which seems wrong anyways), whereas, like you said, 1.5 requires a list of licenses or a single expression.

1.4 Spec

1.5 Spec

Does this match your understanding of the specs?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh yeah. Looks like that is new 1.5 restriction. I remember the rationale for enforcing a single expression. We may have to try to fix this bug in index.js or elsewhere.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are a few situations that I can think of:

  1. A component has multiple licenses and a SPDX expression
  2. A component has multiple SPDX expressions and multiple licenses
  3. A component has multiple licenses, no SPDX expressions
  4. A component has one SPDX expression

For 1, it may make sense to ignore the license list and serve the single SPDX expression (the expression takes precedence).

For 2, one would have to choose which expression to persist. It could be simple, but arbitrary, like choosing the first entry, or more complex, like choosing the most permissive or open.

For 3 and 4, those behaviors are known.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. If there are legitimately multiple expressions (with a space or bracket), then we can use the first one and show a warning.

@prabhu
Copy link
Collaborator

prabhu commented Nov 28, 2023

@ansonallard, could you kindly rebase since we have refactored things a bit. Also, could you take a look at the new known-licenses.json to see if this bug could be resolved with an entry there?

@validide
Copy link
Contributor

validide commented Apr 13, 2024

Is there any progress on this?

If not I would like move the changes to a new branch and try to fix it.

@prabhu
Copy link
Collaborator

prabhu commented Apr 13, 2024

@validide New branches are better. Also why are people still using 1.4?

@validide
Copy link
Contributor

It's not just 1.4 I think. I just created an SBOM to test and got the following:

image
image

I hope to have this done over the weekend.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants