changelist

package
Version: v0.7.0 Latest Latest
Warning

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

Go to latest
Published: Jan 14, 2021 License: Apache-2.0 Imports: 10 Imported by: 16

Documentation

Index

Constants

View Source
const (
	ScopeRoot    = "root"
	ScopeTargets = "targets"
)

Scopes for TUFChanges are simply the TUF roles. Unfortunately because of targets delegations, we can only cover the base roles.

View Source
const (
	TypeBaseRole          = "role"
	TypeTargetsTarget     = "target"
	TypeTargetsDelegation = "delegation"
	TypeWitness           = "witness"
)

Types for TUFChanges are namespaced by the Role they are relevant for. The Root and Targets roles are the only ones for which user action can cause a change, as all changes in Snapshot and Timestamp are programmatically generated base on Root and Targets changes.

View Source
const (
	// ActionCreate represents a Create action
	ActionCreate = "create"
	// ActionUpdate represents an Update action
	ActionUpdate = "update"
	// ActionDelete represents a Delete action
	ActionDelete = "delete"
)

Variables

This section is empty.

Functions

This section is empty.

Types

type Change

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
}

Change is the interface for a TUF Change

type ChangeIterator

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

ChangeIterator is the interface for iterating across collections of TUF Change items

type Changelist

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
}

Changelist is the interface for all TUF change lists

func NewMemChangelist

func NewMemChangelist() Changelist

NewMemChangelist instantiates a new in-memory changelist

type FileChangeListIterator

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

FileChangeListIterator is a concrete instance of ChangeIterator

func (*FileChangeListIterator) HasNext

func (m *FileChangeListIterator) HasNext() bool

HasNext indicates whether iterator is exhausted

func (*FileChangeListIterator) Next

func (m *FileChangeListIterator) Next() (item Change, err error)

Next returns the next Change in the FileChangeList

type FileChangelist

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

FileChangelist stores all the changes as files

func NewFileChangelist

func NewFileChangelist(dir string) (*FileChangelist, error)

NewFileChangelist is a convenience method for returning FileChangeLists

func (FileChangelist) Add

func (cl FileChangelist) Add(c Change) error

Add adds a change to the file change list

func (FileChangelist) Clear

func (cl FileChangelist) Clear(archive string) error

Clear clears the change list N.B. archiving not currently implemented

func (FileChangelist) Close

func (cl FileChangelist) Close() error

Close is a no-op

func (FileChangelist) List

func (cl FileChangelist) List() []Change

List returns a list of sorted changes

func (FileChangelist) Location added in v0.5.1

func (cl FileChangelist) Location() string

Location returns the file path to the changelist

func (FileChangelist) NewIterator

func (cl FileChangelist) NewIterator() (ChangeIterator, error)

NewIterator creates an iterator from FileChangelist

func (FileChangelist) Remove added in v0.4.0

func (cl FileChangelist) Remove(idxs []int) error

Remove deletes the changes found at the given indices

type IteratorBoundsError

type IteratorBoundsError int

IteratorBoundsError is an Error type used by Next()

func (IteratorBoundsError) Error

func (e IteratorBoundsError) Error() string

Error implements the Error interface

type MemChangeListIterator

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

MemChangeListIterator is a concrete instance of ChangeIterator

func (*MemChangeListIterator) HasNext

func (m *MemChangeListIterator) HasNext() bool

HasNext indicates whether the iterator is exhausted

func (*MemChangeListIterator) Next

func (m *MemChangeListIterator) Next() (item Change, err error)

Next returns the next Change

type TUFChange added in v0.4.0

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"`
}

TUFChange represents a change to a TUF repo

func NewTUFChange added in v0.4.0

func NewTUFChange(action string, role data.RoleName, changeType, changePath string, content []byte) *TUFChange

NewTUFChange initializes a TUFChange object

func (TUFChange) Action added in v0.4.0

func (c TUFChange) Action() string

Action return c.Actn

func (TUFChange) Content added in v0.4.0

func (c TUFChange) Content() []byte

Content returns c.Data

func (TUFChange) Path added in v0.4.0

func (c TUFChange) Path() string

Path return c.ChangePath

func (TUFChange) Scope added in v0.4.0

func (c TUFChange) Scope() data.RoleName

Scope returns c.Role

func (TUFChange) Type added in v0.4.0

func (c TUFChange) Type() string

Type returns c.ChangeType

type TUFDelegation added in v0.4.0

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"`
}

TUFDelegation represents a modification to a target delegation this includes creating a delegations. This format is used to avoid unexpected race conditions between humans modifying the same delegation

func (TUFDelegation) ToNewRole added in v0.4.0

func (td TUFDelegation) ToNewRole(scope data.RoleName) (*data.Role, error)

ToNewRole creates a fresh role object from the TUFDelegation data

type TUFRootData added in v0.4.0

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

TUFRootData represents a modification of the keys associated with a role that appears in the root.json

Jump to

Keyboard shortcuts

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