globalize get dependency helper

- create a dependency helper replacing repetative parts of code
- update template to use it

Author: eshulman2

cmd/scaffold-controller/data/controller/actuator.go.template

@@ -25,9 +25,6 @@ import (
 
 	"{{ .GophercloudModule }}"
 	corev1 "k8s.io/api/core/v1"
-{{- if len .ImportDependencies }}
-	apierrors "k8s.io/apimachinery/pkg/api/errors"
-{{- end }}
 	"k8s.io/utils/ptr"
 	ctrl "sigs.k8s.io/controller-runtime"
 	"sigs.k8s.io/controller-runtime/pkg/client"
@@ -37,6 +34,9 @@ import (
 	"github.com/k-orc/openstack-resource-controller/v2/internal/controllers/generic/progress"
 	"github.com/k-orc/openstack-resource-controller/v2/internal/logging"
 	"github.com/k-orc/openstack-resource-controller/v2/internal/osclients"
+{{- if len .ImportDependencies }}
+	"github.com/k-orc/openstack-resource-controller/v2/internal/util/dependency"
+{{- end }}
 	orcerrors "github.com/k-orc/openstack-resource-controller/v2/internal/util/errors"
 )
 
@@ -106,24 +106,12 @@ func (actuator {{ .PackageName }}Actuator) ListOSResourcesForImport(ctx context.
 	var reconcileStatus progress.ReconcileStatus
 {{- range .ImportDependencies }}
 {{ $depNameCamelCase := . | camelCase }}
-	{{ $depNameCamelCase }} := &orcv1alpha1.{{ . }}{}
-	if filter.{{ . }}Ref != nil {
-		{{ $depNameCamelCase }}Key := client.ObjectKey{Name: string(*filter.{{ . }}Ref), Namespace: obj.Namespace}
-		if err := actuator.k8sClient.Get(ctx, {{ $depNameCamelCase }}Key, {{ $depNameCamelCase }}); err != nil {
-			if apierrors.IsNotFound(err) {
-				reconcileStatus = reconcileStatus.WithReconcileStatus(
-					progress.WaitingOnObject("{{ . }}", {{ $depNameCamelCase }}Key.Name, progress.WaitingOnCreation))
-			} else {
-				reconcileStatus = reconcileStatus.WithReconcileStatus(
-					progress.WrapError(fmt.Errorf("fetching {{ $depNameCamelCase }} %s: %w", {{ $depNameCamelCase }}Key.Name, err)))
-			}
-		} else {
-			if !orcv1alpha1.IsAvailable({{ $depNameCamelCase }}) || {{ $depNameCamelCase }}.Status.ID == nil {
-				reconcileStatus = reconcileStatus.WithReconcileStatus(
-					progress.WaitingOnObject("{{ . }}", {{ $depNameCamelCase }}Key.Name, progress.WaitingOnReady))
-			}
-		}
-	}
+	{{ $depNameCamelCase }}, rs := dependency.FetchDependency(
+		ctx, actuator.k8sClient, obj.Namespace,
+		filter.{{ . }}Ref, "{{ . }}",
+		func(dep *orcv1alpha1.{{ . }}) bool { return orcv1alpha1.IsAvailable(dep) && dep.Status.ID != nil },
+	)
+	reconcileStatus = reconcileStatus.WithReconcileStatus(rs)
 {{- end }}
 
 	if needsReschedule, _ := reconcileStatus.NeedsReschedule(); needsReschedule {
@@ -135,12 +123,12 @@ func (actuator {{ .PackageName }}Actuator) ListOSResourcesForImport(ctx context.
 		Name:        string(ptr.Deref(filter.Name, "")),
 		Description: string(ptr.Deref(filter.Description, "")),
 {{- range .ImportDependencies }}
-		{{ . }}:  ptr.Deref({{ . | camelCase }}.Status.ID, ""),
+		{{ . }}ID:  ptr.Deref({{ . | camelCase }}.Status.ID, ""),
 {{- end }}
 		// TODO(scaffolding): Add more import filters
 	}
 
-	return actuator.osClient.List{{ .Kind }}s(ctx, listOpts), nil
+	return actuator.osClient.List{{ .Kind }}s(ctx, listOpts), {{ if len .ImportDependencies }}reconcileStatus{{ else }}nil{{ end }}
 }
 
 func (actuator {{ .PackageName }}Actuator) CreateResource(ctx context.Context, obj orcObjectPT) (*osResourceT, progress.ReconcileStatus) {

internal/util/dependency/helpers.go

@@ -0,0 +1,67 @@
+/*
+Copyright 2025 The ORC Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+	http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package dependency
+
+import (
+	"context"
+	"fmt"
+
+	apierrors "k8s.io/apimachinery/pkg/api/errors"
+	"sigs.k8s.io/controller-runtime/pkg/client"
+
+	orcv1alpha1 "github.com/k-orc/openstack-resource-controller/v2/api/v1alpha1"
+	"github.com/k-orc/openstack-resource-controller/v2/internal/controllers/generic/progress"
+)
+
+// FetchDependency fetches a resource by name and checks if it's ready.
+// Unlike GetDependency on DeletionGuardDependency, this doesn't add finalizers
+// and is suitable for one-off lookups like resolving refs in import filters.
+//
+// Always returns an object (empty struct if not found/ready/error) for safe field access.
+//
+// Returns:
+//   - The fetched object (empty struct if name is nil, not found, not ready, or on error)
+//   - ReconcileStatus indicating wait state or error (nil only if name is nil or object is ready)
+func FetchDependency[TP DependencyType[T], T any](
+	ctx context.Context,
+	k8sClient client.Client,
+	namespace string,
+	name *orcv1alpha1.KubernetesNameRef,
+	kind string,
+	isReady func(TP) bool,
+) (TP, progress.ReconcileStatus) {
+	var obj TP = new(T)
+
+	if name == nil {
+		return obj, nil
+	}
+
+	objectKey := client.ObjectKey{Name: string(*name), Namespace: namespace}
+
+	if err := k8sClient.Get(ctx, objectKey, obj); err != nil {
+		if apierrors.IsNotFound(err) {
+			return obj, progress.NewReconcileStatus().WaitingOnObject(kind, string(*name), progress.WaitingOnCreation)
+		}
+		return obj, progress.WrapError(fmt.Errorf("fetching %s %s: %w", kind, string(*name), err))
+	}
+
+	if !isReady(obj) {
+		return obj, progress.NewReconcileStatus().WaitingOnObject(kind, string(*name), progress.WaitingOnReady)
+	}
+
+	return obj, nil
+}