🌱 Add ctrl.{LoggerFrom, LoggerInto}

Renames the current (unreleased at the time of writing)
LoggerFromContext to LoggerFrom, and adds a new alias named LoggerInto.

From a user standpoint these new aliases are really clear and
straightfoward, example:
```go
func (r *Reconciler) Reconcile(ctx context.Context, req ctrl.Request) {
  log := ctrl.LoggerFrom(ctx)
```

This reads much better than ctrl.LoggerFromContext(ctx) which repeats
the context.

Another use case that this change solves is to enrich the logger with
more values, example:

```go
ctx = ctrl.LoggerInto(ctx, log.WithValues(...))
```

allows the ctx to still be the de-facto context, and the logger for the
inner reconciler function to still only accept ctx, without adding any
more parameters.

Signed-off-by: Vince Prignano <[email protected]>

Author: vincepri

alias.go

@@ -125,10 +125,15 @@ var (
 	// get any actual logging.
 	Log = log.Log
 
-	// LoggerFromContext returns a logger with predefined values from a context.Context.
+	// LoggerFrom returns a logger with predefined values from a context.Context.
 	//
 	// This is meant to be used with the context supplied in a struct that satisfies the Reconciler interface.
-	LoggerFromContext = log.FromContext
+	LoggerFrom = log.FromContext
+
+	// LoggerInto takes a context and sets the logger as one of its keys.
+	//
+	// This is meant to be used in reconcilers to enrich the logger within a context with additional values.
+	LoggerInto = log.IntoContext
 
 	// SetLogger sets a concrete logging implementation for all deferred Loggers.
 	SetLogger = log.SetLogger