Revisit file.PackFiles()

[Wwwsylvia]

file.PackFiles() allows users to add files and pack a manifest quickly. But the current design might not be perfect.
We should revisit it and think about if we should keep/refactor/deprecate it in oras-go v2.0.0.

oras-go/content/file/file.go

Lines 429 to 443 in 1969551

	func (s *Store) PackFiles(ctx context.Context, names []string) (ocispec.Descriptor, error) {
	if s.isClosedSet() {
	return ocispec.Descriptor{}, ErrStoreClosed
	}
	var layers []ocispec.Descriptor
	for _, name := range names {
	desc, err := s.Add(ctx, name, "", "")
	if err != nil {
	return ocispec.Descriptor{}, fmt.Errorf("failed to add %s: %w", name, err)
	}
	layers = append(layers, desc)
	}
	return oras.Pack(ctx, s, "", layers, oras.PackOptions{})

[Wwwsylvia]

One use case of this function can be found here.

[shizhMSFT]

@Wwwsylvia I suggest removing this function, and adding an example instead.

[sajayantony]

+1 to an example with just one file add to show how someone can generate a manifest and to keep the lines of code less.