terraform/internal/deprecation/deprecation.go

// Copyright (c) HashiCorp, Inc.
// SPDX-License-Identifier: BUSL-1.1

package deprecation

import (
	"sync"

	"github.com/hashicorp/hcl/v2"
	"github.com/hashicorp/terraform/internal/addrs"
	"github.com/hashicorp/terraform/internal/lang/marks"
	"github.com/hashicorp/terraform/internal/tfdiags"
	"github.com/zclconf/go-cty/cty"
)

// Deprecations keeps track of meta-information related to deprecation, e.g. which module calls
// suppress deprecation warnings.
type Deprecations struct {
	// Must hold this lock when accessing all fields after this one.
	mu sync.Mutex

	suppressedModules addrs.Set[addrs.Module]
}

func NewDeprecations() *Deprecations {
	return &Deprecations{
		suppressedModules: addrs.MakeSet[addrs.Module](),
	}
}

func (d *Deprecations) SuppressModuleCallDeprecation(addr addrs.Module) {
	d.mu.Lock()
	defer d.mu.Unlock()

	d.suppressedModules.Add(addr)
}

func (d *Deprecations) Validate(value cty.Value, module addrs.Module, rng *hcl.Range) (cty.Value, tfdiags.Diagnostics) {
	var diags tfdiags.Diagnostics
	deprecationMarks := marks.GetDeprecationMarks(value)
	if len(deprecationMarks) == 0 {
		return value, diags
	}

	notDeprecatedValue := marks.RemoveDeprecationMarks(value)

	// Check if we need to suppress deprecation warnings for this module call.
	if d.IsModuleCallDeprecationSuppressed(module) {
		return notDeprecatedValue, diags
	}

	for _, depMark := range deprecationMarks {
		diag := &hcl.Diagnostic{
			Severity: hcl.DiagWarning,
			Summary:  "Deprecated value used",
			Detail:   depMark.Message,
			Subject:  rng,
		}
		if depMark.Origin != nil {
			origin := *depMark.Origin
			sourceRange := tfdiags.SourceRangeFromHCL(origin)
			diag.Extra = &tfdiags.DeprecationOriginDiagnosticExtra{
				Origin: &sourceRange,
			}
		}
		diags = diags.Append(diag)
	}

	return notDeprecatedValue, diags
}

func (d *Deprecations) ValidateAsConfig(value cty.Value, module addrs.Module) tfdiags.Diagnostics {
	var diags tfdiags.Diagnostics
	_, pvms := value.UnmarkDeepWithPaths()

	if len(pvms) == 0 || d.IsModuleCallDeprecationSuppressed(module) {
		return diags
	}

	for _, pvm := range pvms {
		for m := range pvm.Marks {
			if depMark, ok := m.(marks.DeprecationMark); ok {
				diag := tfdiags.AttributeValue(
					tfdiags.Warning,
					"Deprecated value used",
					depMark.Message,
					pvm.Path,
				)
				origin := depMark.Origin
				if origin != nil {
					diag = tfdiags.Override(
						diag,
						tfdiags.Warning, // We just want to override the extra info
						func() tfdiags.DiagnosticExtraWrapper {
							sourceRange := tfdiags.SourceRangeFromHCL(*origin)
							return &tfdiags.DeprecationOriginDiagnosticExtra{
								Origin: &sourceRange,
							}
						})
				}

				diags = diags.Append(diag)

			}
		}
	}
	return diags
}

func (d *Deprecations) IsModuleCallDeprecationSuppressed(addr addrs.Module) bool {
	d.mu.Lock()
	defer d.mu.Unlock()
	for _, mod := range d.suppressedModules {
		if mod.TargetContains(addr) {
			return true
		}
	}
	return false
}