output

type ErrorHandler interface {
	// handle an error that happens when we try to write a resource
	HandleWriteError(resource ezkube.Object, err error)

	// handle an error that happens when we try to delete a resource
	HandleDeleteError(resource ezkube.Object, err error)

	// handle an error that happens when we try list resources in a cluster
	HandleListError(err error)
}

type ErrorHandlerFuncs struct {
	// handle an error that happens when we try to write a resource
	HandleWriteErrorFunc func(resource ezkube.Object, err error)

	// handle an error that happens when we try to delete a resource
	HandleDeleteErrorFunc func(resource ezkube.Object, err error)

	// handle an error that happens when we try list resources in a cluster
	HandleListErrorFunc func(err error)
}

type ResourceList struct {
	// the desired resources should share the given labels
	Resources []ezkube.Object

	// list function that will be used to compare the given resources to the currently existing state.
	// if the resources in the list do not match those returned by the list func,
	// the differences will be reconciled by applying the snapshot.
	// if this function is nil, no garbage collection will be done.
	ListFunc func(ctx context.Context, cli client.Client) ([]ezkube.Object, error)

	// name of resource Kind, used for debugging only
	ResourceKind string
}

type Snapshot struct {
	// name of the snapshot, used for metrics
	Name string

	// the clusters across which the snapshot should be synced.
	// only relevant for multicluster syncing.
	Clusters []string

	// the lists of resources to sync, partitioned by resource type
	// and ListFunc (typically a set of labels)
	ListsToSync []ResourceList
}