changelist

type Change interface {
	// "create","update", or "delete"
	Action() string

	// Where the change should be made.
	// For TUF this will be the role
	Scope() data.RoleName

	// The content type being affected.
	// For TUF this will be "target", or "delegation".
	// If the type is "delegation", the Scope will be
	// used to determine if a root role is being updated
	// or a target delegation.
	Type() string

	// Path indicates the entry within a role to be affected by the
	// change. For targets, this is simply the target's path,
	// for delegations it's the delegated role name.
	Path() string

	// Serialized content that the interpreter of a changelist
	// can use to apply the change.
	// For TUF this will be the serialized JSON that needs
	// to be inserted or merged. In the case of a "delete"
	// action, it will be nil.
	Content() []byte
}

type ChangeIterator interface {
	Next() (Change, error)
	HasNext() bool
}

type Changelist interface {
	// List returns the ordered list of changes
	// currently stored
	List() []Change

	// Add change appends the provided change to
	// the list of changes
	Add(Change) error

	// Clear empties the current change list.
	// Archive may be provided as a directory path
	// to save a copy of the changelist in that location
	Clear(archive string) error

	// Remove deletes the changes corresponding with the indices given
	Remove(idxs []int) error

	// Close synchronizes any pending writes to the underlying
	// storage and closes the file/connection
	Close() error

	// NewIterator returns an iterator for walking through the list
	// of changes currently stored
	NewIterator() (ChangeIterator, error)

	// Location returns the place the changelist is stores
	Location() string
}

type FileChangeListIterator struct {
	// contains filtered or unexported fields
}

type FileChangelist struct {
	// contains filtered or unexported fields
}

type IteratorBoundsError int

type MemChangeListIterator struct {
	// contains filtered or unexported fields
}

type TUFChange struct {
	// Abbreviated because Go doesn't permit a field and method of the same name
	Actn       string        `json:"action"`
	Role       data.RoleName `json:"role"`
	ChangeType string        `json:"type"`
	ChangePath string        `json:"path"`
	Data       []byte        `json:"data"`
}

type TUFDelegation struct {
	NewName       data.RoleName `json:"new_name,omitempty"`
	NewThreshold  int           `json:"threshold,omitempty"`
	AddKeys       data.KeyList  `json:"add_keys,omitempty"`
	RemoveKeys    []string      `json:"remove_keys,omitempty"`
	AddPaths      []string      `json:"add_paths,omitempty"`
	RemovePaths   []string      `json:"remove_paths,omitempty"`
	ClearAllPaths bool          `json:"clear_paths,omitempty"`
}

type TUFRootData struct {
	Keys     data.KeyList  `json:"keys"`
	RoleName data.RoleName `json:"role"`
}