mirror of
https://github.com/tailscale/tailscale.git
synced 2024-12-01 22:15:51 +00:00
67df9abdc6
Package setting contains types for defining and representing policy settings. It facilitates the registration of setting definitions using Register and RegisterDefinition, and the retrieval of registered setting definitions via Definitions and DefinitionOf. This package is intended for use primarily within the syspolicy package hierarchy, and added in a preparation for the next PRs. Updates #12687 Signed-off-by: Nick Khyl <nickk@tailscale.com>
72 lines
1.9 KiB
Go
72 lines
1.9 KiB
Go
// Copyright (c) Tailscale Inc & AUTHORS
|
|
// SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
package setting
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
jsonv2 "github.com/go-json-experiment/json"
|
|
"github.com/go-json-experiment/json/jsontext"
|
|
)
|
|
|
|
// Origin describes where a policy or a policy setting is configured.
|
|
type Origin struct {
|
|
data settingOrigin
|
|
}
|
|
|
|
// settingOrigin is the marshallable data of an [Origin].
|
|
type settingOrigin struct {
|
|
Name string `json:",omitzero"`
|
|
Scope PolicyScope
|
|
}
|
|
|
|
// NewOrigin returns a new [Origin] with the specified scope.
|
|
func NewOrigin(scope PolicyScope) *Origin {
|
|
return NewNamedOrigin("", scope)
|
|
}
|
|
|
|
// NewNamedOrigin returns a new [Origin] with the specified scope and name.
|
|
func NewNamedOrigin(name string, scope PolicyScope) *Origin {
|
|
return &Origin{settingOrigin{name, scope}}
|
|
}
|
|
|
|
// Scope reports the policy [PolicyScope] where the setting is configured.
|
|
func (s Origin) Scope() PolicyScope {
|
|
return s.data.Scope
|
|
}
|
|
|
|
// Name returns the name of the policy source where the setting is configured,
|
|
// or "" if not available.
|
|
func (s Origin) Name() string {
|
|
return s.data.Name
|
|
}
|
|
|
|
// String implements [fmt.Stringer].
|
|
func (s Origin) String() string {
|
|
if s.Name() != "" {
|
|
return fmt.Sprintf("%s (%v)", s.Name(), s.Scope())
|
|
}
|
|
return s.Scope().String()
|
|
}
|
|
|
|
// MarshalJSONV2 implements [jsonv2.MarshalerV2].
|
|
func (s Origin) MarshalJSONV2(out *jsontext.Encoder, opts jsonv2.Options) error {
|
|
return jsonv2.MarshalEncode(out, &s.data, opts)
|
|
}
|
|
|
|
// UnmarshalJSONV2 implements [jsonv2.UnmarshalerV2].
|
|
func (s *Origin) UnmarshalJSONV2(in *jsontext.Decoder, opts jsonv2.Options) error {
|
|
return jsonv2.UnmarshalDecode(in, &s.data, opts)
|
|
}
|
|
|
|
// MarshalJSON implements [json.Marshaler].
|
|
func (s Origin) MarshalJSON() ([]byte, error) {
|
|
return jsonv2.Marshal(s) // uses MarshalJSONV2
|
|
}
|
|
|
|
// UnmarshalJSON implements [json.Unmarshaler].
|
|
func (s *Origin) UnmarshalJSON(b []byte) error {
|
|
return jsonv2.Unmarshal(b, s) // uses UnmarshalJSONV2
|
|
}
|