tags

package
v1.16.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 2, 2026 License: Apache-2.0 Imports: 3 Imported by: 0

Documentation

Overview

Package tags provides helpers for Cloudflare DNS record tags.

The helpers here implement Cloudflare-shaped tag semantics shared by API-side verification and setter-side reconciliation. The expected snapshot for these semantics was adopted on 2026-03-22; update that date only when the Cloudflare DNS record attributes case in scripts/github-actions/cloudflare-doc-watch/cases.go changes:

  • tag names are canonicalized case-insensitively
  • tag values remain case-sensitive
  • representation-only differences such as order or duplicate canonical forms do not change semantic equality

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Equal

func Equal(left, right []string) bool

Equal reports whether two tag sets have the same canonical tag keys.

func Undocumented

func Undocumented(tags []string) []string

Undocumented returns tags that are not in Cloudflare's documented stored name:value form. Empty values are allowed, but missing separators and empty names are treated as undocumented.

Types

type Resolved

type Resolved struct {
	Inherited             []string
	Dropped               []string
	HasAmbiguousCanonical bool
	HasDuplicateCanonical bool
}

Resolved describes the canonical reconciliation of tags across multiple tag sets.

func Resolve

func Resolve(tags [][]string) Resolved

Resolve computes the canonical reconciliation result across tag sets. When the effective fallback tag set is empty, only tags present in every input set survive in Inherited and the remaining canonical tags are reported in Dropped. This is the DNS tag-specific instantiation of the managed-record reconciliation rule from docs/designs/features/managed-record-ownership.markdown.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL