// Package artifact provides the core artifact storage for goreleaser.
package artifact

//nolint:gosec
import (
	"bytes"
	"crypto/md5"
	"crypto/sha1"
	"crypto/sha256"
	"crypto/sha3"
	"crypto/sha512"
	"encoding/hex"
	"encoding/json"
	"fmt"
	"hash"
	"hash/crc32"
	"io"
	"maps"
	"os"
	"path/filepath"
	"slices"
	"strings"
	"sync"

	"github.com/caarlos0/log"
	"github.com/goreleaser/goreleaser/v2/internal/experimental"
	"golang.org/x/crypto/blake2b"
	"golang.org/x/crypto/blake2s"
	"lukechampine.com/blake3"
)

// Type defines the type of an artifact.
type Type int

// If you add more types, update TestArtifactTypeStringer!
const (
	// UploadableArchive a tar.gz/zip archive to be uploaded.
	UploadableArchive Type = iota + 1
	// UploadableBinary is a binary file to be uploaded.
	UploadableBinary
	// UploadableFile is any file that can be uploaded.
	UploadableFile
	// Binary is a binary (output of a gobuild).
	Binary
	// UniversalBinary is a binary that contains multiple binaries within.
	UniversalBinary
	// LinuxPackage is a linux package generated by nfpm.
	LinuxPackage
	// PublishableSnapcraft is a snap package yet to be published.
	PublishableSnapcraft
	// Snapcraft is a published snap package.
	Snapcraft
	// PublishableDockerImage is a Docker image yet to be published.
	PublishableDockerImage
	// DockerImage is a published Docker image.
	DockerImage
	// DockerManifest is a published Docker manifest.
	DockerManifest
	// Checksum is a checksums file.
	Checksum
	// Signature is a signature file.
	Signature
	// Certificate is a signing certificate file
	Certificate
	// UploadableSourceArchive is the archive with the current commit source code.
	UploadableSourceArchive
	// BrewFormula is an uploadable homebrew formula file.
	//
	// Deprecated: use [BrewCask] instead.
	BrewFormula
	// BrewCask is an uploadable homebrew cask file.
	BrewCask
	// Nixpkg is an uploadable nix package.
	Nixpkg
	// WingetInstaller winget installer file.
	WingetInstaller
	// WingetDefaultLocale winget default locale file.
	WingetDefaultLocale
	// WingetVersion winget version file.
	WingetVersion
	// WingetLocale winget additional locale file.
	WingetLocale
	// PkgBuild is an Arch Linux AUR PKGBUILD file.
	PkgBuild
	// SrcInfo is an Arch Linux AUR .SRCINFO file.
	SrcInfo
	// SourcePkgBuild is an Arch Linux AUR PKGBUILD file for a source build.
	SourcePkgBuild
	// SourceSrcInfo is an Arch Linux AUR .SRCINFO file for a source build.
	SourceSrcInfo
	// KrewPluginManifest is a krew plugin manifest file.
	KrewPluginManifest
	// ScoopManifest is an uploadable scoop manifest file.
	ScoopManifest
	// SBOM is a Software Bill of Materials file.
	SBOM
	// PublishableChocolatey is a chocolatey package yet to be published.
	PublishableChocolatey
	// Header is a C header file, generated for CGo library builds.
	Header
	// CArchive is a C static library, generated via a CGo build with buildmode=c-archive.
	CArchive
	// CShared is a C shared library, generated via a CGo build with buildmode=c-shared.
	CShared
	// PyWheel is a Python wheel package.
	PyWheel
	// PySdist is a Python source distribution package.
	PySdist
	// Metadata is an internal goreleaser metadata JSON file.
	Metadata
	// Makeself is a makeself self-extracting archive.
	Makeself
	// DockerImageV2 is a container image in OCI format.
	DockerImageV2
	// Flatpak is a Flatpak bundle.
	Flatpak
	// SourceRPM is a source RPM.
	SourceRPM
	// MSIX is a Windows MSIX package generated by nfpm.
	MSIX

	// XXX: if it is an uploadable kind of artifact, add it to UploadableTypes
	// below.

	// lastMarker is used in tests to denote the last valid type.
	// always add new types before this one.
	lastMarker
)

// ReleaseUploadableTypes returns the canonical list of artifact types that should be
// uploaded, checksummed, signed, and otherwise distributed.
// When adding a new artifact type that should be part of a release, add it
// here and all pipes that use this func will automatically include it.
//
// GoReleaser Pro has more formats: MSI, DMG, etc.
func ReleaseUploadableTypes() []Type {
	return []Type{
		UploadableArchive,
		UploadableBinary,
		UploadableFile,
		UploadableSourceArchive,
		Makeself,
		LinuxPackage,
		MSIX,
		Flatpak,
		SourceRPM,
		SBOM,
		PyWheel,
		PySdist,
		Checksum,
		Signature,
		Certificate,
	}
}

func (t Type) isUploadable() bool {
	switch t {
	case UniversalBinary, Binary, // See: [UploadableBinary].
		DockerImage,            // See: [PublishableDockerImage].
		Snapcraft,              // See [PublishableSnapcraft].
		Metadata,               // Local only.
		SrcInfo, SourceSrcInfo, // It's always named `.SRCINFO`
		PkgBuild, SourcePkgBuild: // It's always named `.PKGBUILD`
		return false
	default:
		return true
	}
}

func (t Type) String() string {
	switch t {
	case UploadableArchive:
		return "Archive"
	case UploadableFile:
		return "File"
	case UploadableBinary, Binary, UniversalBinary:
		return "Binary"
	case LinuxPackage:
		return "Linux Package"
	case MSIX:
		return "MSIX"
	case PublishableDockerImage, DockerImageV2:
		return "Docker Image"
	case DockerImage:
		return "Published Docker Image"
	case DockerManifest:
		return "Docker Manifest"
	case PublishableSnapcraft, Snapcraft:
		return "Snap"
	case Checksum:
		return "Checksum"
	case Signature:
		return "Signature"
	case Certificate:
		return "Certificate"
	case UploadableSourceArchive:
		return "Source"
	case BrewFormula:
		return "Homebrew Formula"
	case BrewCask:
		return "Homebrew Cask"
	case KrewPluginManifest:
		return "Krew Plugin Manifest"
	case ScoopManifest:
		return "Scoop Manifest"
	case SBOM:
		return "SBOM"
	case PkgBuild, SourcePkgBuild:
		return "PKGBUILD"
	case SrcInfo, SourceSrcInfo:
		return "SRCINFO"
	case PublishableChocolatey:
		return "Chocolatey"
	case Header:
		return "C Header"
	case CArchive:
		return "C Archive Library"
	case CShared:
		return "C Shared Library"
	case WingetInstaller, WingetDefaultLocale, WingetVersion, WingetLocale:
		return "Winget Manifest"
	case Nixpkg:
		return "Nixpkg"
	case Metadata:
		return "Metadata"
	case PyWheel:
		return "Wheel"
	case PySdist:
		return "Source Dist"
	case Makeself:
		return "Makeself Package"
	case Flatpak:
		return "Flatpak"
	case SourceRPM:
		return "Source RPM"
	default:
		return "unknown"
	}
}

// Extra field keys used across multiple pipes.
// If you add or change these, please update the documentation at
// www/content/customization/general/artifacts.md as well.
const (
	ExtraID         = "ID"
	ExtraBinary     = "Binary"
	ExtraExt        = "Ext" // should always have the preceding '.'
	ExtraFormat     = "Format"
	ExtraWrappedIn  = "WrappedIn"
	ExtraBinaries   = "Binaries"
	ExtraFiles      = "Files"
	ExtraRefresh    = "Refresh"
	ExtraReplaces   = "Replaces"
	ExtraDigest     = "Digest"
	ExtraSize       = "Size"
	ExtraChecksum   = "Checksum"
	ExtraChecksumOf = "ChecksumOf"
	ExtraBuilder    = "Builder"
	ExtranDynLink   = "DynamicallyLinked"
)

// Extras represents the extra fields in an artifact.
type Extras map[string]any

func (e Extras) MarshalJSON() ([]byte, error) {
	m := map[string]any{}
	for k, v := range e {
		if k == ExtraRefresh {
			// refresh is a func, so we can't serialize it.
			continue
		}
		m[k] = v
	}
	return json.Marshal(m)
}

// Artifact represents an artifact and its relevant info.
type Artifact struct {
	Name      string `json:"name,omitempty"`
	Path      string `json:"path,omitempty"`
	Goos      string `json:"goos,omitempty"`
	Goarch    string `json:"goarch,omitempty"`
	Goamd64   string `json:"goamd64,omitempty"`
	Go386     string `json:"go386,omitempty"`
	Goarm     string `json:"goarm,omitempty"`
	Goarm64   string `json:"goarm64,omitempty"`
	Gomips    string `json:"gomips,omitempty"`
	Goppc64   string `json:"goppc64,omitempty"`
	Goriscv64 string `json:"goriscv64,omitempty"`
	Target    string `json:"target,omitempty"`
	Type      Type   `json:"internal_type,omitempty"`
	TypeS     string `json:"type,omitempty"`
	Extra     Extras `json:"extra,omitempty"`
}

func (a Artifact) String() string {
	return a.Name
}

// tryCastExtra tries to cast the given type into T.
//
// If the extra value cannot be cast into the given type, it'll try to convert
// it to JSON and unmarshal it into the correct type after.
//
// If that fails as well, it'll error.
func tryCastExtra[T any](ex any) (T, error) {
	t, ok := ex.(T)
	if ok {
		return t, nil
	}

	bts, err := json.Marshal(ex)
	if err != nil {
		// this should never happen in theory
		return t, err
	}

	decoder := json.NewDecoder(bytes.NewReader(bts))
	decoder.DisallowUnknownFields()
	if err := decoder.Decode(&t); err != nil {
		// this should never happen in theory
		return t, err
	}
	return t, nil
}

// MustExtra tries to get the extra field with the given name, returning its
// value or panicking.
//
// If the value cannot be cast into the given type, it'll panic.
func MustExtra[T any](a Artifact, key string) T {
	got, ok := a.Extra[key]
	if !ok {
		panic(fmt.Errorf("extra: %s: key not present", key))
	}
	t, err := tryCastExtra[T](got)
	if err != nil {
		panic(fmt.Errorf("extra: %s: %w", key, err))
	}
	return t
}

// ExtraOr returns the Extra field with the given key or the or value specified
// if it is nil.
//
// This should only be used in places where the key might or might not be
// present.
//
// If the value cannot be cast into the given type, it'll panic.
func ExtraOr[T any](a Artifact, key string, or T) T {
	got, ok := a.Extra[key]
	if !ok {
		return or
	}
	t, err := tryCastExtra[T](got)
	if err != nil {
		panic(fmt.Errorf("extra: %s: %w", key, err))
	}
	return t
}

// Checksum calculates the checksum of the artifact and sets it's Extra field.
//
//nolint:gosec
func (a *Artifact) Checksum(algorithm string) (string, error) {
	log.Debugf("calculating checksum for %s", a.Path)
	file, err := os.Open(a.Path)
	if err != nil {
		return "", fmt.Errorf("failed to checksum: %w", err)
	}
	defer file.Close()
	var h hash.Hash
	switch algorithm {
	case "blake2b":
		h, err = blake2b.New512(nil)
		if err != nil {
			return "", fmt.Errorf("failed to checksum: %w", err)
		}
	case "blake2s":
		h, err = blake2s.New256(nil)
		if err != nil {
			return "", fmt.Errorf("failed to checksum: %w", err)
		}
	case "blake3":
		h = blake3.New(32, nil)
	case "crc32":
		h = crc32.NewIEEE()
	case "md5":
		h = md5.New()
	case "sha224":
		h = sha256.New224()
	case "sha384":
		h = sha512.New384()
	case "sha256":
		h = sha256.New()
	case "sha1":
		h = sha1.New()
	case "sha512":
		h = sha512.New()
	case "sha3-224":
		h = hash.Hash(sha3.New224())
	case "sha3-384":
		h = hash.Hash(sha3.New384())
	case "sha3-256":
		h = hash.Hash(sha3.New256())
	case "sha3-512":
		h = hash.Hash(sha3.New512())
	default:
		return "", fmt.Errorf("invalid algorithm: %s", algorithm)
	}

	if _, err := io.Copy(h, file); err != nil {
		return "", fmt.Errorf("failed to checksum: %w", err)
	}
	check := hex.EncodeToString(h.Sum(nil))
	if a.Extra == nil {
		a.Extra = make(Extras)
	}
	a.Extra[ExtraChecksum] = fmt.Sprintf("%s:%s", algorithm, check)
	return check, nil
}

var noRefresh = func() error { return nil }

// Refresh executes a Refresh extra function on artifacts, if it exists.
func (a Artifact) Refresh() error {
	// for now lets only do it for checksums, as we know for a fact that
	// they are the only ones that support this right now.
	if a.Type != Checksum {
		return nil
	}
	if err := ExtraOr(a, ExtraRefresh, noRefresh)(); err != nil {
		return fmt.Errorf("failed to refresh %q: %w", a.Name, err)
	}
	return nil
}

// ID returns the artifact ID if it exists, empty otherwise.
func (a Artifact) ID() string {
	return ExtraOr(a, ExtraID, "")
}

// Format returns the artifact Format if it exists, empty otherwise.
func (a Artifact) Format() string {
	return ExtraOr(a, ExtraFormat, "")
}

// Ext returns the artifact Ext if it exists, empty otherwise.
func (a Artifact) Ext() string {
	return ExtraOr(a, ExtraExt, "")
}

// Artifacts is a list of artifacts.
type Artifacts struct {
	items []*Artifact
	lock  *sync.Mutex
}

// New return a new list of artifacts.
func New() *Artifacts {
	return &Artifacts{
		items: []*Artifact{},
		lock:  &sync.Mutex{},
	}
}

// Refresh visits all artifacts and refreshes them.
func (artifacts *Artifacts) Refresh() error {
	return artifacts.Visit(func(a *Artifact) error {
		return a.Refresh()
	})
}

// List return the actual list of artifacts.
func (artifacts *Artifacts) List() []*Artifact {
	artifacts.lock.Lock()
	defer artifacts.lock.Unlock()
	return artifacts.items
}

// GroupByID groups the artifacts by their ID.
func (artifacts *Artifacts) GroupByID() map[string][]*Artifact {
	result := map[string][]*Artifact{}
	for _, a := range artifacts.List() {
		id := a.ID()
		if id == "" {
			continue
		}
		result[a.ID()] = append(result[a.ID()], a)
	}
	return result
}

// GroupByPlatform groups the artifacts by their platform.
func (artifacts *Artifacts) GroupByPlatform() map[string][]*Artifact {
	// we'll try to keep the most basic platform as group (goos+goarch).
	// we'll though group it further if we have multiple goarm, goamd64, or
	// gomips, to keep compatibility with previous versions of goreleaser.
	simpleResult := map[string][]*Artifact{}
	specificResult := map[string][]*Artifact{}
	goamd64s := map[string]struct{}{}
	gomipses := map[string]struct{}{}
	goarms := map[string]struct{}{}
	abis := map[string]struct{}{}
	for _, a := range artifacts.List() {
		plat := a.Goos + a.Goarch
		abi := ExtraOr(*a, "Abi", "")
		fullplat := plat + abi + a.Goarm + a.Gomips + a.Goamd64
		goamd64s[a.Goamd64] = struct{}{}
		gomipses[a.Gomips] = struct{}{}
		goarms[a.Goarm] = struct{}{}
		abis[abi] = struct{}{}
		simpleResult[plat] = append(simpleResult[plat], a)
		specificResult[fullplat] = append(specificResult[fullplat], a)
	}

	if len(nonEmpty(goamd64s)) > 1 ||
		len(nonEmpty(gomipses)) > 1 ||
		len(nonEmpty(goarms)) > 1 ||
		len(nonEmpty(abis)) > 1 {
		return specificResult
	}

	return simpleResult
}

func nonEmpty(m map[string]struct{}) []string {
	return slices.DeleteFunc(
		slices.Collect(maps.Keys(m)),
		func(s string) bool {
			return s == ""
		},
	)
}

func relPath(a *Artifact) (string, error) {
	cwd, err := os.Getwd()
	if err != nil {
		return "", err
	}
	if !strings.HasPrefix(a.Path, cwd) {
		return "", nil
	}
	return filepath.Rel(cwd, a.Path)
}

func shouldRelPath(a *Artifact) bool {
	switch a.Type {
	case DockerImage, DockerManifest, PublishableDockerImage, DockerImageV2:
		return false
	default:
		return filepath.IsAbs(a.Path)
	}
}

// Add safely adds a new artifact to an artifact list.
func (artifacts *Artifacts) Add(a *Artifact) {
	artifacts.lock.Lock()
	defer artifacts.lock.Unlock()
	a.Name = cleanName(*a)
	if shouldRelPath(a) {
		rel, err := relPath(a)
		if rel != "" && err == nil {
			a.Path = rel
		}
	}
	a.Path = filepath.ToSlash(a.Path)
	if a.Type.isUploadable() &&
		slices.ContainsFunc(artifacts.items, func(b *Artifact) bool {
			return a.Name == b.Name
		}) {
		log.WithField("name", a.Name).
			WithField("details", `this might cause errors when publishing
please make sure your configuration is correct`).
			Warn("artifact already present in the list")
	}
	artifacts.items = append(artifacts.items, a)
	log.WithField("name", a.Name).
		WithField("type", a.Type).
		WithField("path", a.Path).
		Debug("added new artifact")
}

// Remove removes artifacts that match the given filter from the original artifact list.
func (artifacts *Artifacts) Remove(filter Filter) error {
	if filter == nil {
		return nil
	}

	artifacts.lock.Lock()
	defer artifacts.lock.Unlock()

	result := New()
	for _, a := range artifacts.items {
		if filter(a) {
			log.WithField("name", a.Name).
				WithField("type", a.Type).
				WithField("path", a.Path).
				Debug("removing")
		} else {
			result.items = append(result.items, a)
		}
	}

	artifacts.items = result.items
	return nil
}

// Filter defines an artifact filter which can be used within the Filter
// function.
type Filter func(a *Artifact) bool

// OnlyReplacingUnibins removes universal binaries that did not replace the single-arch ones.
//
// This is useful specially on homebrew et al, where you'll want to use only either the single-arch or the universal binaries.
func OnlyReplacingUnibins(a *Artifact) bool {
	return ExtraOr(*a, ExtraReplaces, true)
}

// ByGoos is a predefined filter that filters by the given goos.
func ByGoos(s string) Filter {
	return func(a *Artifact) bool {
		return a.Goos == s
	}
}

// ByGooses is a predefined filter that filters by the given goos.
func ByGooses(in ...string) Filter {
	return autoOr(in, ByGoos)
}

// ByGoarch is a predefined filter that filters by the given goarch.
func ByGoarch(s string) Filter {
	return func(a *Artifact) bool {
		return a.Goarch == s
	}
}

// ByGoarches is a predefined filter that filters by the given goarch.
func ByGoarches(in ...string) Filter {
	return autoOr(in, ByGoarch)
}

// ByGoarm is a predefined filter that filters by the given goarm.
func ByGoarm(s string) Filter {
	return func(a *Artifact) bool {
		return s == a.Goarm ||
			(a.Goarch == "arm" && a.Goarm == "" && s == experimental.DefaultGOARM())
	}
}

// ByGoarms is a predefined filter that filters by the given goarm.
func ByGoarms(s ...string) Filter {
	return autoOr(s, ByGoarm)
}

// ByGoamd64 is a predefined filter that filters by the given goamd64.
func ByGoamd64(s string) Filter {
	return func(a *Artifact) bool {
		return s == a.Goamd64 ||
			(a.Goarch == "amd64" && a.Goamd64 == "" && s == "v1")
	}
}

// ByGoamd64s is a predefined filter that filters by the given goamd64.
func ByGoamd64s(s ...string) Filter {
	return autoOr(s, ByGoamd64)
}

// ByType is a predefined filter that filters by the given type.
func ByType(t Type) Filter {
	return func(a *Artifact) bool {
		return a.Type == t
	}
}

// ByTypes is a predefined filter that filters by the given type.
func ByTypes(types ...Type) Filter {
	return autoOr(types, ByType)
}

// ByFormat filters artifacts by a `Format` extra field.
func ByFormat(format string) Filter {
	return func(a *Artifact) bool {
		return a.Format() == format
	}
}

// ByFormats filters artifacts by a `Format` extra field.
func ByFormats(formats ...string) Filter {
	return autoOr(formats, ByFormat)
}

// Not negates the given filter.
func Not(filter Filter) Filter {
	return func(a *Artifact) bool {
		return !filter(a)
	}
}

// ByID filter artifacts by an `ID` extra field.
func ByID(id string) Filter {
	return func(a *Artifact) bool {
		// checksum and source archive are always for all artifacts, so return always true.
		return a.Type == Checksum ||
			a.Type == UploadableSourceArchive ||
			a.Type == UploadableFile ||
			a.Type == Metadata ||
			a.ID() == id
	}
}

// ByIDs filter artifacts by an `ID` extra field.
func ByIDs(ids ...string) Filter {
	return autoOr(ids, ByID)
}

// ByExt filter artifact by their 'Ext' extra field.
//
// The comp is done ignoring the preceding '.', so `ByExt("deb")` and
// `ByExt(".deb")` have the same result.
func ByExt(ext string) Filter {
	return func(a *Artifact) bool {
		return strings.TrimPrefix(a.Ext(), ".") == strings.TrimPrefix(ext, ".")
	}
}

// ByExts filter artifact by their 'Ext' extra field.
//
// The comp is done ignoring the preceding '.', so `ByExt("deb")` and
// `ByExt(".deb")` have the same result.
func ByExts(exts ...string) Filter {
	return autoOr(exts, ByExt)
}

// ByBinaryLikeArtifacts filter artifacts down to artifacts that are Binary, UploadableBinary, or UniversalBinary,
// deduplicating artifacts by path (preferring UploadableBinary over all others). Note: this filter is unique in the
// sense that it cannot act in isolation of the state of other artifacts; the filter requires the whole list of
// artifacts in advance to perform deduplication.
func ByBinaryLikeArtifacts(arts *Artifacts) Filter {
	// find all of the paths for any uploadable binary artifacts
	uploadableBins := arts.Filter(ByType(UploadableBinary)).List()
	uploadableBinPaths := map[string]struct{}{}
	for _, a := range uploadableBins {
		uploadableBinPaths[a.Path] = struct{}{}
	}

	// we want to keep any matching artifact that is not a binary that already has a path accounted for
	// by another uploadable binary. We always prefer uploadable binary artifacts over binary artifacts.
	deduplicateByPath := func(a *Artifact) bool {
		if a.Type == UploadableBinary {
			return true
		}
		_, ok := uploadableBinPaths[a.Path]
		return !ok
	}

	return And(
		// allow all of the binary-like artifacts as possible...
		ByTypes(
			Binary,
			UploadableBinary,
			UniversalBinary,
		),
		// ... but remove any duplicates found
		deduplicateByPath,
	)
}

// Or performs an OR between all given filters.
func Or(filters ...Filter) Filter {
	return func(a *Artifact) bool {
		for _, f := range filters {
			if f == nil || f(a) {
				return true
			}
		}
		return false
	}
}

// And performs an AND between all given filters.
func And(filters ...Filter) Filter {
	return func(a *Artifact) bool {
		for _, f := range filters {
			if f != nil && !f(a) {
				return false
			}
		}
		return true
	}
}

// Filter filters the artifact list, returning a new instance.
// There are some pre-defined filters but anything of the Type Filter
// is accepted.
// You can compose filters by using the And and Or filters.
func (artifacts *Artifacts) Filter(filter Filter) *Artifacts {
	if filter == nil {
		return artifacts
	}

	result := New()
	for _, a := range artifacts.List() {
		if filter(a) {
			result.items = append(result.items, a)
		}
	}
	return result
}

// Paths returns the artifact.Path of the current artifact list.
func (artifacts *Artifacts) Paths() []string {
	var result []string
	for _, artifact := range artifacts.List() {
		result = append(result, artifact.Path)
	}
	return result
}

// VisitFn is a function that can be executed against each artifact in a list.
type VisitFn func(a *Artifact) error

// Visit executes the given function for each artifact in the list.
func (artifacts *Artifacts) Visit(fn VisitFn) error {
	for _, artifact := range artifacts.List() {
		if err := fn(artifact); err != nil {
			return err
		}
	}
	return nil
}

func cleanName(a Artifact) string {
	name := a.Name
	ext := filepath.Ext(name)
	result := strings.TrimSpace(strings.TrimSuffix(name, ext)) + ext
	if name != result {
		log.WithField("name", a.Name).
			WithField("new name", result).
			WithField("type", a.Type).
			WithField("path", a.Path).
			Warn("removed trailing whitespaces from artifact name")
	}
	return result
}

// autoOr automatically creates an [Or] filter with the given input and the
// given [Filter].
//
// If the input is empty, it'll return nil.
// If the inputs's length is 1, it'll return [Filter] with it as input.
// Otherwise, it'll return the filter for each item in the input, wrapped in an
// [Or] filter.
//
// Basically, these two statements are the same:
//
//	Or(ByGoos("linux"), ByGoos("darwin"))
//	autoOr([]string{"linux", "darwin"}, ByGoos)
//	ByGooses("linux", "darwin")
//
// This should help reducing the amount of handling around that in the codebase.
func autoOr[T any](input []T, filter func(T) Filter) Filter {
	switch len(input) {
	case 0:
		return nil
	case 1:
		return filter(input[0])
	default:
		filters := make([]Filter, 0, len(input))
		for _, s := range input {
			filters = append(filters, filter(s))
		}
		return Or(filters...)
	}
}
