Method LoadUserDefaults

core/modulesource.go:1054–1089

LoadUserDefaults loads and merges environment files for local module defaults. It combines the inner .env file (from the module's source root) with relevant entries from the outer .env file (found via find-up from the host), filtered by the module name and original module name as prefixes. Example:

(ctx context.Context)

// Outer .env (found via find-up): MYMODULE_BAZ=qux, OTHER_VAR=ignored
// Result: FOO=bar, BAZ=qux (prefix "MYMODULE_" removed from outer entries)
func (src *ModuleSource) LoadUserDefaults(ctx context.Context) (rerr error) {
	ctx, span := Tracer(ctx).Start(ctx, "loading user defaults", telemetry.Internal())
	defer telemetry.EndWithCause(span, &rerr)
	// For local module sources, ensure we have the right client context for filesystem access.
	// Modules run as their own clients, but need access to the original caller's filesystem.
	// NonModuleParentClientMetadata is idempotent, so this is safe to call multiple times.
	if src.Kind == ModuleSourceKindLocal {
		query, err := CurrentQuery(ctx)
		if err != nil {
			return fmt.Errorf("failed to get current query: %w", err)
		}
		localSourceClientMetadata, err := query.NonModuleParentClientMetadata(ctx)
		if err != nil {
			return fmt.Errorf("failed to get client metadata: %w", err)
		}
		ctx = engine.ContextWithClientMetadata(ctx, localSourceClientMetadata)
	}
	innerEnvFile, _, err := src.innerEnvFile(ctx)
	if err != nil {
		return err
	}
	outerEnvFile, _, err := src.outerEnvFile(ctx)
	if err != nil {
		return err
	}
	outerForName, err := outerEnvFile.Namespace(ctx, src.ModuleName)
	if err != nil {
		return err
	}
	outerForOriginalName, err := outerEnvFile.Namespace(ctx, src.ModuleOriginalName)
	if err != nil {
		return err
	}
	src.UserDefaults = NewEnvFile(true).WithEnvFiles(innerEnvFile, outerForName, outerForOriginalName)
	return nil
}

// we mix this into digest hashes to ensure they don't accidentally collide
// with any others