Method list

runtime/catalog_cache.go:162–214

list returns a list of resources in the catalog. It optionally supports filtering by kind, path, and soft-deleted status. The returned list is not sorted. The returned list is always safe to manipulate (e.g. sort/filter), but the resource pointers must not be edited unless clone=true. Unlike other c

(kind, path string, withDeleted, clone bool)

// The returned list is always safe to manipulate (e.g. sort/filter), but the resource pointers must not be edited unless clone=true.
// Unlike other catalog functions, it is safe to call list concurrently with calls to get and flush (i.e. under a read lock).
func (c *catalogCache) list(kind, path string, withDeleted, clone bool) []*runtimev1.Resource {
	// Estimate number of resources to list
	n := 0
	if path != "" {
		n = 1
	} else if kind == "" {
		for _, rs := range c.resources {
			n += len(rs)
		}
	} else {
		n = len(c.resources[kind])
	}

	// Alloc slice for resources
	res := make([]*runtimev1.Resource, 0, n)

	// Find resources matching the filters and append to slice
	for k, rs := range c.resources {
		// Skip if doesn't match kind filter
		if kind != "" && k != kind {
			continue
		}

		for _, r := range rs {
			// Skip if doesn't match withDeleted filter
			if !withDeleted && r.Meta.DeletedOn != nil {
				continue
			}

			// Skip if doesn't match path filter
			if path != "" {
				found := false
				for _, p := range r.Meta.FilePaths {
					if p == path {
						found = true
						break
					}
				}
				if !found {
					continue
				}
			}

			// Append to res
			if clone {
				r = c.clone(r)
			}
			res = append(res, r)
		}
	}

	return res
}

// create creates a resource in the catalog.
// It will error if a resource with the same name already exists.