scope

package
v1.12.0 Latest Latest
Warning

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

 Go to latest Published: Apr 17, 2026 License: MIT Imports: 11 Imported by: 0

Documentation

Overview

Package scope provides scope manipulation for Jamf Classic API resources. It handles reading, modifying, and writing scope sections (targets, limitations, exclusions) on policies, configuration profiles, and other scopeable resources.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func AddScopeFlags 

func AddScopeFlags(cmd *cobra.Command, section *string)

AddScopeFlags registers the --section and item flags on a scope add/remove command.

func AddToScope 

func AddToScope(s *ScopeXML, singularKey, section, flagName, name string) bool

AddToScope adds a named item to the given scope section. Returns true if the item was added, false if already present (idempotent no-op).

func FlattenScope 

func FlattenScope(s *ScopeXML, singularKey string) []map[string]any

FlattenScope converts a ScopeXML into a flat list of rows for table output.

func NewScopeCmd 

func NewScopeCmd(ctx *registry.CLIContext, res Resource) *cobra.Command

NewScopeCmd creates the "scope" subcommand group with get, add, and remove subcommands for the given Classic API resource.

func OutputScope 

func OutputScope(out registry.OutputFormatter, s *ScopeXML, singularKey, format string) error

OutputScope writes the scope to the output formatter. For table/csv/plain formats it flattens the scope into rows; for json/yaml it outputs the full structure.

func PutScope 

func PutScope(ctx context.Context, client registry.HTTPClient, res Resource, id string, s *ScopeXML) error

PutScope writes an updated scope back to the Classic API via subset PUT.

func RemoveFromScope 

func RemoveFromScope(s *ScopeXML, singularKey, section, flagName, name string) bool

RemoveFromScope removes a named item from the given scope section. Returns true if removed, false if not found (idempotent no-op).

For the policy limitation user_group case, user groups can live in BOTH limit_to_users/user_groups (plain strings) AND limitations/user_groups (named items). Both locations are checked.

func ValidateScopeCombination 

func ValidateScopeCombination(singularKey, section, flagName string) error

ValidateScopeCombination checks that the given section/flag combination is valid for the resource type.

Types

type ExclusionsXML 

type ExclusionsXML struct {
	Computers          ScopeItemSlice `xml:"computers" json:"computers"`
	ComputerGroups     ScopeItemSlice `xml:"computer_groups" json:"computer_groups"`
	MobileDeviceGroups ScopeItemSlice `xml:"mobile_device_groups" json:"mobile_device_groups"`
	Users              ScopeItemSlice `xml:"users" json:"users"`
	UserGroups         ScopeItemSlice `xml:"user_groups" json:"user_groups"`
	NetworkSegments    ScopeItemSlice `xml:"network_segments" json:"network_segments"`
	Buildings          ScopeItemSlice `xml:"buildings" json:"buildings"`
	Departments        ScopeItemSlice `xml:"departments" json:"departments"`
	JSSUsers           ScopeItemSlice `xml:"jss_users" json:"jss_users"`
	JSSUserGroups      ScopeItemSlice `xml:"jss_user_groups" json:"jss_user_groups"`
	IBeacons           ScopeItemSlice `xml:"ibeacons" json:"ibeacons"`
}

ExclusionsXML models the <exclusions> section.

type LimitToUsersXML 

type LimitToUsersXML struct {
	UserGroups ScopeStringSlice `xml:"user_groups" json:"user_groups"`
}

LimitToUsersXML models the <limit_to_users> section (policies only).

type LimitationsXML 

type LimitationsXML struct {
	Users           ScopeItemSlice `xml:"users" json:"users"`
	UserGroups      ScopeItemSlice `xml:"user_groups" json:"user_groups"`
	NetworkSegments ScopeItemSlice `xml:"network_segments" json:"network_segments"`
	ComputerGroups  ScopeItemSlice `xml:"computer_groups" json:"computer_groups"`
	IBeacons        ScopeItemSlice `xml:"ibeacons" json:"ibeacons"`
}

LimitationsXML models the <limitations> section.

type NamedItem 

type NamedItem struct {
	ID   int    `xml:"id,omitempty" json:"id,omitempty"`
	Name string `xml:"name" json:"name"`
}

NamedItem is an item identified by name (and optionally ID) in scope XML.

type Resource 

type Resource struct {
	APIPath     string // URL segment under /JSSResource/, e.g. "policies"
	SingularKey string // XML root key for a single object, e.g. "policy"
}

Resource identifies a Classic API resource that supports scope operations.

type ScopeItemSlice 

type ScopeItemSlice struct {
	Items    []NamedItem
	ElemName string
}

ScopeItemSlice is a list of NamedItem elements under a single XML parent. The child element name (e.g. "computer_group") is learned during unmarshal and reused during marshal. For newly-created lists it falls back to the parent element name with trailing "s" stripped.

func (ScopeItemSlice) MarshalJSON 

func (s ScopeItemSlice) MarshalJSON() ([]byte, error)

func (ScopeItemSlice) MarshalXML 

func (s ScopeItemSlice) MarshalXML(e *xml.Encoder, start xml.StartElement) error

func (*ScopeItemSlice) UnmarshalXML 

func (s *ScopeItemSlice) UnmarshalXML(d *xml.Decoder, start xml.StartElement) error

type ScopeStringSlice 

type ScopeStringSlice struct {
	Items    []string
	ElemName string
}

ScopeStringSlice is a list of plain string elements under a single XML parent. Used for policy limitation user groups (limit_to_users/user_groups), where items are bare strings rather than objects with name sub-elements.

func (ScopeStringSlice) MarshalJSON 

func (s ScopeStringSlice) MarshalJSON() ([]byte, error)

func (ScopeStringSlice) MarshalXML 

func (s ScopeStringSlice) MarshalXML(e *xml.Encoder, start xml.StartElement) error

func (*ScopeStringSlice) UnmarshalXML 

func (s *ScopeStringSlice) UnmarshalXML(d *xml.Decoder, start xml.StartElement) error

type ScopeTarget 

type ScopeTarget struct {
	FlagName string
	Name     string
}

ScopeTarget holds a resolved flag name and value from a scope add/remove command.

func DetermineScopeTarget 

func DetermineScopeTarget(cmd *cobra.Command) (ScopeTarget, error)

DetermineScopeTarget inspects the command's flags to find exactly one scope target flag that was set. Returns an error if zero or multiple flags are set.

type ScopeXML 

type ScopeXML struct {
	XMLName            xml.Name         `xml:"scope" json:"-"`
	AllComputers       bool             `xml:"all_computers" json:"all_computers"`
	AllJSSUsers        bool             `xml:"all_jss_users" json:"all_jss_users"`
	Computers          ScopeItemSlice   `xml:"computers" json:"computers"`
	ComputerGroups     ScopeItemSlice   `xml:"computer_groups" json:"computer_groups"`
	JSSUsers           ScopeItemSlice   `xml:"jss_users" json:"jss_users"`
	JSSUserGroups      ScopeItemSlice   `xml:"jss_user_groups" json:"jss_user_groups"`
	MobileDeviceGroups ScopeItemSlice   `xml:"mobile_device_groups" json:"mobile_device_groups"`
	Buildings          ScopeItemSlice   `xml:"buildings" json:"buildings"`
	Departments        ScopeItemSlice   `xml:"departments" json:"departments"`
	LimitToUsers       *LimitToUsersXML `xml:"limit_to_users,omitempty" json:"limit_to_users,omitempty"`
	Limitations        *LimitationsXML  `xml:"limitations,omitempty" json:"limitations,omitempty"`
	Exclusions         *ExclusionsXML   `xml:"exclusions,omitempty" json:"exclusions,omitempty"`
}

ScopeXML models the complete <scope> section of a Classic API resource.

func FetchScope 

func FetchScope(ctx context.Context, client registry.HTTPClient, res Resource, name string) (string, *ScopeXML, error)

FetchScope performs a GET on a Classic API resource by name and returns the resource's ID and parsed scope.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.