There is no oras pull --artifact-type

[ChristianCiach]

Code of Conduct

• I have read and agree to the ORAS' Code of Conduct

What part of document/web-page on oras.land is affected?

https://oras.land/docs/how_to_guides/format_output/ describes how to pull multiple artifacts using oras pull $REGISTRY/$REPO:$TAG --artifact-type ..., but there is no such option.

My ORAS version:

$ oras version
Version:    1.2.1+Homebrew
Go version: go1.23.4

I don't know if a previous version of ORAS had such an option, but looking at the releases-page, it doesn't seem this way.

It seems that pulling an artifact is actually a two-step process:

1. Use oras discover to find the digest of the artifact: oras discover $REGISTRY/$REPO:$TAG --artifact-type example/sbom
2. Use the digest of the artifact to pull it: oras pull $REGISTRY/$REPO@$ARTIFACT_DIGEST

It doesn't seem possible to pull multiple artifacts at once and use custom file names. So this section of the documentation should probably be fixed or removed altogether.

Additional comments?

No response