Documentation
¶
Index ¶
- Constants
- Variables
- func DefaultValueExists(schema *sdcpb.SchemaElem) bool
- func DefaultValueRetrieve(schema *sdcpb.SchemaElem, path []string, prio int32, intent string) (*types.Update, error)
- func FilterDeleted(l *LeafEntry) bool
- func FilterNew(l *LeafEntry) bool
- func FilterNonDeleted(l *LeafEntry) bool
- func FilterNonDeletedButNewOrUpdated(l *LeafEntry) bool
- func FilterUpdated(l *LeafEntry) bool
- func HighestPrecedenceFilterAll(le *LeafEntry) bool
- func HighestPrecedenceFilterWithoutDeleted(le *LeafEntry) bool
- func HighestPrecedenceFilterWithoutNew(le *LeafEntry) bool
- func LeafEntriesToUpdates(l []*LeafEntry) []*types.Update
- func Unfiltered(l *LeafEntry) bool
- type Entry
- type EntryImpl
- func (s EntryImpl) AddUpdateRecursive(ctx context.Context, u *types.Update, flags *types.UpdateInsertFlags) (Entry, error)
- func (s EntryImpl) BreadthSearch(ctx context.Context, path string) ([]Entry, error)
- func (s EntryImpl) DeepCopy(tc *TreeContext, parent Entry) (Entry, error)
- func (s EntryImpl) DeleteSubtree(relativePath types.PathSlice, owner string) (bool, error)
- func (s EntryImpl) FilterChilds(keys map[string]string) ([]Entry, error)
- func (s EntryImpl) FinishInsertionPhase(ctx context.Context) error
- func (s EntryImpl) GetByOwner(owner string, result []*LeafEntry) LeafVariantSlice
- func (s EntryImpl) GetDeletes(deletes []types.DeleteEntry, aggregatePaths bool) ([]types.DeleteEntry, error)
- func (s EntryImpl) GetDeviations(ch chan<- *types.DeviationEntry, activeCase bool)
- func (s EntryImpl) GetFirstAncestorWithSchema() (Entry, int)
- func (s EntryImpl) GetHighestPrecedence(result LeafVariantSlice, onlyNewOrUpdated bool, includeDefaults bool) LeafVariantSlice
- func (s EntryImpl) GetLevel() int
- func (s EntryImpl) GetListChilds() ([]Entry, error)
- func (s EntryImpl) GetParent() Entry
- func (s EntryImpl) GetRoot() Entry
- func (s EntryImpl) GetRootBasedEntryChain() []Entry
- func (s EntryImpl) GetSchema() *sdcpb.SchemaElem
- func (s EntryImpl) GetSchemaKeys() []string
- func (s EntryImpl) ImportConfig(ctx context.Context, t importer.ImportConfigAdapter, intentName string, ...) error
- func (s EntryImpl) IsRoot() bool
- func (s EntryImpl) MarkOwnerDelete(o string, onlyIntended bool)
- func (s EntryImpl) Navigate(ctx context.Context, path []string, isRootPath bool, dotdotSkipKeys bool) (Entry, error)
- func (s EntryImpl) NavigateLeafRef(ctx context.Context) ([]Entry, error)
- func (s EntryImpl) NavigateSdcpbPath(ctx context.Context, pathElems []*sdcpb.PathElem, isRootPath bool) (Entry, error)
- func (s EntryImpl) Path() types.PathSlice
- func (s EntryImpl) PathName() string
- func (s EntryImpl) SdcpbPath() (*sdcpb.Path, error)
- func (s EntryImpl) SdcpbPathInternal(spath []string) (*sdcpb.Path, error)
- func (s EntryImpl) String() string
- func (s EntryImpl) StringIndent(result []string) []string
- func (s EntryImpl) ToJson(onlyNewOrUpdated bool) (any, error)
- func (s EntryImpl) ToJsonIETF(onlyNewOrUpdated bool) (any, error)
- func (s EntryImpl) ToXML(...) (*etree.Document, error)
- func (s EntryImpl) TreeExport(owner string) ([]*tree_persist.TreeElement, error)
- func (s EntryImpl) Validate(ctx context.Context, resultChan chan<- *types.ValidationResultEntry, ...)
- func (s EntryImpl) Walk(f EntryVisitor) error
- type EntrySlice
- type EntryVisitor
- type HighestPrecedenceFilter
- type LeafEntry
- func (l *LeafEntry) DeepCopy(parentEntry Entry) *LeafEntry
- func (l *LeafEntry) DropDeleteFlag()
- func (l *LeafEntry) GetDeleteFlag() bool
- func (l *LeafEntry) GetDeleteOnlyIntendedFlag() bool
- func (l *LeafEntry) GetEntry() Entry
- func (l *LeafEntry) GetNewFlag() bool
- func (l *LeafEntry) GetRootBasedEntryChain() []Entry
- func (l *LeafEntry) GetUpdateFlag() bool
- func (l *LeafEntry) MarkDelete(onlyIntended bool)
- func (l *LeafEntry) MarkNew()
- func (l *LeafEntry) MarkUpdate(u *types.Update)
- func (l *LeafEntry) String() string
- type LeafEntryFilter
- type LeafVariantSlice
- type LeafVariants
- func (lv *LeafVariants) Add(le *LeafEntry)
- func (lv *LeafVariants) DeepCopy(tc *TreeContext, parent Entry) *LeafVariants
- func (lv *LeafVariants) DeleteByOwner(owner string) (remainsToExist bool)
- func (lv *LeafVariants) GetByOwner(owner string) *LeafEntry
- func (lv *LeafVariants) GetDeviations(ch chan<- *types.DeviationEntry, isActiveCase bool)
- func (lv *LeafVariants) GetHighestPrecedence(onlyNewOrUpdated bool, includeDefaults bool) *LeafEntry
- func (lv *LeafVariants) GetHighestPrecedenceValue(filter HighestPrecedenceFilter) int32
- func (lv *LeafVariants) Items() iter.Seq[*LeafEntry]
- func (lv *LeafVariants) Length() int
- func (lv *LeafVariants) MarkOwnerForDeletion(owner string, onlyIntended bool)
- type RootEntry
- func (s RootEntry) AddUpdateRecursive(ctx context.Context, u *types.Update, flags *types.UpdateInsertFlags) (Entry, error)
- func (r *RootEntry) AddUpdatesRecursive(ctx context.Context, us types.UpdateSlice, flags *types.UpdateInsertFlags) error
- func (s RootEntry) BreadthSearch(ctx context.Context, path string) ([]Entry, error)
- func (r *RootEntry) DeepCopy(ctx context.Context) (*RootEntry, error)
- func (s RootEntry) DeleteSubtree(relativePath types.PathSlice, owner string) (bool, error)
- func (r *RootEntry) DeleteSubtreePaths(deletes types.DeleteEntriesList, intentName string) (bool, error)
- func (s RootEntry) FilterChilds(keys map[string]string) ([]Entry, error)
- func (s RootEntry) FinishInsertionPhase(ctx context.Context) error
- func (r *RootEntry) GetAncestorSchema() (*sdcpb.SchemaElem, int)
- func (s RootEntry) GetByOwner(owner string, result []*LeafEntry) LeafVariantSlice
- func (r *RootEntry) GetDeletes(aggregatePaths bool) (types.DeleteEntriesList, error)
- func (r *RootEntry) GetDeletesForOwner(owner string) types.PathSlices
- func (r *RootEntry) GetDeviations(ch chan<- *types.DeviationEntry)
- func (s RootEntry) GetFirstAncestorWithSchema() (Entry, int)
- func (r *RootEntry) GetHighestPrecedence(onlyNewOrUpdated bool) LeafVariantSlice
- func (s RootEntry) GetLevel() int
- func (s RootEntry) GetListChilds() ([]Entry, error)
- func (s RootEntry) GetParent() Entry
- func (s RootEntry) GetRoot() Entry
- func (s RootEntry) GetRootBasedEntryChain() []Entry
- func (s RootEntry) GetSchema() *sdcpb.SchemaElem
- func (s RootEntry) GetSchemaKeys() []string
- func (r *RootEntry) GetUpdatesForOwner(owner string) types.UpdateSlice
- func (r *RootEntry) ImportConfig(ctx context.Context, basePath types.PathSlice, ...) error
- func (s RootEntry) IsRoot() bool
- func (s RootEntry) MarkOwnerDelete(o string, onlyIntended bool)
- func (s RootEntry) Navigate(ctx context.Context, path []string, isRootPath bool, dotdotSkipKeys bool) (Entry, error)
- func (s RootEntry) NavigateLeafRef(ctx context.Context) ([]Entry, error)
- func (s RootEntry) NavigateSdcpbPath(ctx context.Context, pathElems []*sdcpb.PathElem, isRootPath bool) (Entry, error)
- func (s RootEntry) Path() types.PathSlice
- func (s RootEntry) PathName() string
- func (s RootEntry) SdcpbPath() (*sdcpb.Path, error)
- func (s RootEntry) SdcpbPathInternal(spath []string) (*sdcpb.Path, error)
- func (r *RootEntry) String() string
- func (s RootEntry) StringIndent(result []string) []string
- func (s RootEntry) ToJson(onlyNewOrUpdated bool) (any, error)
- func (s RootEntry) ToJsonIETF(onlyNewOrUpdated bool) (any, error)
- func (r *RootEntry) ToProtoDeletes(ctx context.Context) ([]*sdcpb.Path, error)
- func (r *RootEntry) ToProtoUpdates(ctx context.Context, onlyNewOrUpdated bool) ([]*sdcpb.Update, error)
- func (s RootEntry) ToXML(...) (*etree.Document, error)
- func (r *RootEntry) TreeExport(owner string, priority int32) (*tree_persist.Intent, error)
- func (r *RootEntry) Validate(ctx context.Context, vCfg *config.Validation) types.ValidationResults
- func (s RootEntry) Walk(f EntryVisitor) error
- type TreeContext
Constants ¶
Variables ¶
var (
ErrorIntentNotPresent = fmt.Errorf("intent not present")
)
Functions ¶
func DefaultValueExists ¶ added in v0.0.56
func DefaultValueExists(schema *sdcpb.SchemaElem) bool
func DefaultValueRetrieve ¶ added in v0.0.56
func FilterDeleted ¶
FilterDeleted Accepts all Entries that are marked as deleted
func FilterNonDeleted ¶
FilterNonDeleted Accepts all Entries that are not marked as deleted
func FilterNonDeletedButNewOrUpdated ¶
FilterNonDeletedButNewOrUpdated Accepts all Entries that are New or Updated and not Deleted.
func FilterUpdated ¶
FilterUpdated Accepts all entries that are updates
func HighestPrecedenceFilterAll ¶ added in v0.0.56
func HighestPrecedenceFilterWithoutDeleted ¶ added in v0.0.56
func HighestPrecedenceFilterWithoutNew ¶ added in v0.0.56
func LeafEntriesToUpdates ¶ added in v0.0.56
LeafEntriesToCacheUpdates
func Unfiltered ¶
Unfiltered accepts all entries without any filtering
Types ¶
type Entry ¶
type Entry interface {
// Path returns the Path as PathSlice
Path() types.PathSlice
// PathName returns the last Path element, the name of the Entry
PathName() string
// GetLevel returns the depth of the Entry in the tree
GetLevel() int
// AddUpdateRecursive Add the given cache.Update to the tree
AddUpdateRecursive(ctx context.Context, u *types.Update, flags *types.UpdateInsertFlags) (Entry, error)
// StringIndent debug tree struct as indented string slice
StringIndent(result []string) []string
// GetHighesPrio return the new cache.Update entried from the tree that are the highes priority.
// If the onlyNewOrUpdated option is set to true, only the New or Updated entries will be returned
// It will append to the given list and provide a new pointer to the slice
GetHighestPrecedence(result LeafVariantSlice, onlyNewOrUpdated bool, includeDefaults bool) LeafVariantSlice
// GetByOwner returns the branches Updates by owner
GetByOwner(owner string, result []*LeafEntry) LeafVariantSlice
// markOwnerDelete Sets the delete flag on all the LeafEntries belonging to the given owner.
MarkOwnerDelete(o string, onlyIntended bool)
// GetDeletes returns the cache-updates that are not updated, have no lower priority value left and hence should be deleted completely
GetDeletes(entries []types.DeleteEntry, aggregatePaths bool) ([]types.DeleteEntry, error)
// Walk takes the EntryVisitor and applies it to every Entry in the tree
Walk(f EntryVisitor) error
// Validate kicks off validation
Validate(ctx context.Context, resultChan chan<- *types.ValidationResultEntry, vCfg *config.Validation)
// GetSchema returns the *sdcpb.SchemaElem of the Entry
GetSchema() *sdcpb.SchemaElem
// IsRoot returns true if the Entry is the root of the tree
IsRoot() bool
// FinishInsertionPhase indicates, that the insertion of Entries into the tree is over
// Hence calculations for e.g. choice/case can be performed.
FinishInsertionPhase(ctx context.Context) error
// GetParent returns the parent entry
GetParent() Entry
// Navigate navigates the tree according to the given path and returns the referenced entry or nil if it does not exist.
NavigateLeafRef(ctx context.Context) ([]Entry, error)
// GetFirstAncestorWithSchema returns the first parent node which has a schema set.
// if the parent has no schema (is a key element in the tree) it will recurs the call to the parents parent.
// the level of recursion is indicated via the levelUp attribute
GetFirstAncestorWithSchema() (ancestor Entry, levelUp int)
// SdcpbPath returns the sdcpb.Path struct for the Entry
SdcpbPath() (*sdcpb.Path, error)
// SdcpbPathInternal is the internal function to calculate the SdcpbPath
SdcpbPathInternal(spath []string) (*sdcpb.Path, error)
// GetSchemaKeys checks for the schema of the entry, and returns the defined keys
GetSchemaKeys() []string
// GetRootBasedEntryChain returns all the entries starting from the root down to the actual Entry.
GetRootBasedEntryChain() []Entry
// GetRoot returns the Trees Root Entry
GetRoot() Entry
FilterChilds(keys map[string]string) ([]Entry, error)
// ToJson returns the Tree contained structure as JSON
// use e.g. json.MarshalIndent() on the returned struct
ToJson(onlyNewOrUpdated bool) (any, error)
// ToJsonIETF returns the Tree contained structure as JSON_IETF
// use e.g. json.MarshalIndent() on the returned struct
ToJsonIETF(onlyNewOrUpdated bool) (any, error)
// ToXML returns the tree and its current state in the XML representation used by netconf
ToXML(onlyNewOrUpdated bool, honorNamespace bool, operationWithNamespace bool, useOperationRemove bool) (*etree.Document, error)
// ImportConfig allows importing config data received from e.g. the device in different formats (json, xml) to be imported into the tree.
ImportConfig(ctx context.Context, importer importer.ImportConfigAdapter, intentName string, intentPrio int32, flags *types.UpdateInsertFlags) error
TreeExport(owner string) ([]*tree_persist.TreeElement, error)
// DeleteSubtree Deletes from the tree, all elements of the PathSlice defined branch of the given owner
DeleteSubtree(relativePath types.PathSlice, owner string) (remainsToExist bool, err error)
GetDeviations(ch chan<- *types.DeviationEntry, activeCase bool)
// GetListChilds collects all the childs of the list. In the tree we store them seperated into their key branches.
// this is collecting all the last level key entries.
GetListChilds() ([]Entry, error)
BreadthSearch(ctx context.Context, path string) ([]Entry, error)
DeepCopy(tc *TreeContext, parent Entry) (Entry, error)
// contains filtered or unexported methods
}
Entry is the primary Element of the Tree.
type EntryImpl ¶
type EntryImpl struct {
// contains filtered or unexported fields
}
func (EntryImpl) AddUpdateRecursive ¶ added in v0.0.56
func (s EntryImpl) AddUpdateRecursive(ctx context.Context, u *types.Update, flags *types.UpdateInsertFlags) (Entry, error)
AddUpdateRecursive recursively adds the given cache.Update to the tree. Thereby creating all the entries along the path. if the entries along th path already exist, the existing entries are called to add the Update.
func (EntryImpl) BreadthSearch ¶ added in v0.0.56
func (EntryImpl) DeepCopy ¶ added in v0.0.56
func (s EntryImpl) DeepCopy(tc *TreeContext, parent Entry) (Entry, error)
func (EntryImpl) DeleteSubtree ¶ added in v0.0.56
func (EntryImpl) FilterChilds ¶ added in v0.0.43
FilterChilds returns the child entries (skipping the key entries in the tree) that match the given keys. The keys do not need to match all levels of keys, in which case the key level is considered a wildcard match (*)
func (EntryImpl) FinishInsertionPhase ¶
FinishInsertionPhase certain values that are costly to calculate but used multiple times will be calculated and stored for later use. However therefore the insertion phase into the tree needs to be over. Calling this function indicated the end of the phase and thereby triggers the calculation
func (EntryImpl) GetByOwner ¶
func (s EntryImpl) GetByOwner(owner string, result []*LeafEntry) LeafVariantSlice
GetByOwner returns all the LeafEntries that belong to a certain owner.
func (EntryImpl) GetDeletes ¶
func (s EntryImpl) GetDeletes(deletes []types.DeleteEntry, aggregatePaths bool) ([]types.DeleteEntry, error)
GetDeletes calculate the deletes that need to be send to the device.
func (EntryImpl) GetDeviations ¶ added in v0.0.56
func (s EntryImpl) GetDeviations(ch chan<- *types.DeviationEntry, activeCase bool)
func (EntryImpl) GetFirstAncestorWithSchema ¶
GetAncestorSchema returns the schema of the parent node if the schema is set. if the parent has no schema (is a key element in the tree) it will recurs the call to the parents parent. the level of recursion is indicated via the levelUp attribute
func (EntryImpl) GetHighestPrecedence ¶
func (s EntryImpl) GetHighestPrecedence(result LeafVariantSlice, onlyNewOrUpdated bool, includeDefaults bool) LeafVariantSlice
GetHighestPrecedence goes through the whole branch and returns the new and updated cache.Updates. These are the updated that will be send to the device.
func (EntryImpl) GetLevel ¶
func (s EntryImpl) GetLevel() int
GetLevel returns the level / depth position of this element in the tree
func (EntryImpl) GetListChilds ¶ added in v0.0.56
getListChilds collects all the childs of the list. In the tree we store them seperated into their key branches. this is collecting all the last level key entries.
func (EntryImpl) GetParent ¶
func (s EntryImpl) GetParent() Entry
GetParent returns the parent entry
func (EntryImpl) GetRootBasedEntryChain ¶ added in v0.0.42
func (s EntryImpl) GetRootBasedEntryChain() []Entry
func (EntryImpl) GetSchema ¶
func (s EntryImpl) GetSchema() *sdcpb.SchemaElem
GetSchema return the schema fiels of the Entry
func (EntryImpl) GetSchemaKeys ¶
func (s EntryImpl) GetSchemaKeys() []string
GetSchemaKeys checks for the schema of the entry, and returns the defined keys
func (EntryImpl) ImportConfig ¶ added in v0.0.44
func (s EntryImpl) ImportConfig(ctx context.Context, t importer.ImportConfigAdapter, intentName string, intentPrio int32, insertFlags *types.UpdateInsertFlags) error
func (EntryImpl) IsRoot ¶
func (s EntryImpl) IsRoot() bool
IsRoot returns true if the element has no parent elements, hence is the root of the tree
func (EntryImpl) MarkOwnerDelete ¶ added in v0.0.56
markOwnerDelete Sets the delete flag on all the LeafEntries belonging to the given owner.
func (EntryImpl) Navigate ¶
func (s EntryImpl) Navigate(ctx context.Context, path []string, isRootPath bool, dotdotSkipKeys bool) (Entry, error)
Navigate move through the tree, returns the Entry that is present under the given path
func (EntryImpl) NavigateLeafRef ¶ added in v0.0.43
NavigateLeafRef
func (EntryImpl) NavigateSdcpbPath ¶ added in v0.0.42
func (EntryImpl) PathName ¶
func (s EntryImpl) PathName() string
PathName returns the name of the Entry
func (EntryImpl) SdcpbPath ¶
SdcpbPath returns the sdcpb.Path, with its elements and keys based on the local schema
func (EntryImpl) SdcpbPathInternal ¶
sdcpbPathInternal is the internale recursive function to calculate and the sdcpb.Path, with its elements and keys based on the local schema
func (EntryImpl) String ¶
func (s EntryImpl) String() string
String returns a string representation of the Entry
func (EntryImpl) StringIndent ¶
StringIndent returns the sharedEntryAttributes in its string representation The string is intented according to the nesting level in the yang model
func (EntryImpl) ToJsonIETF ¶ added in v0.0.44
func (EntryImpl) ToXML ¶ added in v0.0.44
func (s EntryImpl) ToXML(onlyNewOrUpdated, honorNamespace, operationWithNamespace, useOperationRemove bool) (*etree.Document, error)
ToXML yields the xml representation of the tree. Either updates only (onlyNewOrUpdated flag) or the actual view on the whole tree. If honorNamespace is set, the xml elements will carry their respective namespace attributes. If operationWithNamespace is set, the operation attributes added to the to be deleted alements will also carry the Netconf Base namespace. If useOperationRemove is set, the remove operation will be used for deletes, instead of the delete operation.
func (EntryImpl) TreeExport ¶ added in v0.0.56
func (s EntryImpl) TreeExport(owner string) ([]*tree_persist.TreeElement, error)
func (EntryImpl) Validate ¶
func (s EntryImpl) Validate(ctx context.Context, resultChan chan<- *types.ValidationResultEntry, vCfg *config.Validation)
Validate is the highlevel function to perform validation. it will multiplex all the different Validations that need to happen
func (EntryImpl) Walk ¶
func (s EntryImpl) Walk(f EntryVisitor) error
Walk takes the EntryVisitor and applies it to every Entry in the tree
type EntrySlice ¶ added in v0.0.44
type EntrySlice []Entry
type EntryVisitor ¶
type EntryVisitor func(s *sharedEntryAttributes) error
type HighestPrecedenceFilter ¶ added in v0.0.56
type LeafEntry ¶
type LeafEntry struct {
*types.Update
IsNew bool
Delete bool
DeleteOnlyIntended bool
IsUpdated bool
// contains filtered or unexported fields
}
LeafEntry stores the *cache.Update along with additional attributes. These Attributes indicate if the entry is to be deleted / added (new) or updated.
func NewLeafEntry ¶
NewLeafEntry constructor for a new LeafEntry
func (*LeafEntry) DropDeleteFlag ¶ added in v0.0.50
func (l *LeafEntry) DropDeleteFlag()
func (*LeafEntry) GetDeleteFlag ¶ added in v0.0.50
func (*LeafEntry) GetDeleteOnlyIntendedFlag ¶ added in v0.0.54
func (*LeafEntry) GetNewFlag ¶ added in v0.0.50
func (*LeafEntry) GetRootBasedEntryChain ¶ added in v0.0.42
func (*LeafEntry) GetUpdateFlag ¶ added in v0.0.50
func (*LeafEntry) MarkDelete ¶
MarkDelete indicate that the entry is to be deleted
func (*LeafEntry) MarkUpdate ¶
MarkUpdate indicate that the entry is an Updated value
type LeafEntryFilter ¶
type LeafVariantSlice ¶ added in v0.0.42
type LeafVariantSlice []*LeafEntry
func (LeafVariantSlice) ToUpdateSlice ¶ added in v0.0.56
func (lvs LeafVariantSlice) ToUpdateSlice() types.UpdateSlice
type LeafVariants ¶
type LeafVariants struct {
// contains filtered or unexported fields
}
func (*LeafVariants) Add ¶ added in v0.0.50
func (lv *LeafVariants) Add(le *LeafEntry)
func (*LeafVariants) DeepCopy ¶ added in v0.0.56
func (lv *LeafVariants) DeepCopy(tc *TreeContext, parent Entry) *LeafVariants
func (*LeafVariants) DeleteByOwner ¶ added in v0.0.56
func (lv *LeafVariants) DeleteByOwner(owner string) (remainsToExist bool)
func (*LeafVariants) GetByOwner ¶
func (lv *LeafVariants) GetByOwner(owner string) *LeafEntry
GetByOwner returns the entry that is owned by the given owner, returns nil if no entry exists.
func (*LeafVariants) GetDeviations ¶ added in v0.0.56
func (lv *LeafVariants) GetDeviations(ch chan<- *types.DeviationEntry, isActiveCase bool)
func (*LeafVariants) GetHighestPrecedence ¶
func (lv *LeafVariants) GetHighestPrecedence(onlyNewOrUpdated bool, includeDefaults bool) *LeafEntry
GetHighesNewUpdated returns the LeafEntry with the highes priority nil if no leaf entry exists.
func (*LeafVariants) GetHighestPrecedenceValue ¶
func (lv *LeafVariants) GetHighestPrecedenceValue(filter HighestPrecedenceFilter) int32
func (*LeafVariants) Items ¶ added in v0.0.49
func (lv *LeafVariants) Items() iter.Seq[*LeafEntry]
Items iterator for the LeafVariants
func (*LeafVariants) Length ¶ added in v0.0.49
func (lv *LeafVariants) Length() int
func (*LeafVariants) MarkOwnerForDeletion ¶ added in v0.0.56
func (lv *LeafVariants) MarkOwnerForDeletion(owner string, onlyIntended bool)
MarkOwnerForDeletion searches for a LefVariant of given owner, if it exists the entry is marked for deletion
type RootEntry ¶
type RootEntry struct {
// contains filtered or unexported fields
}
RootEntry the root of the cache.Update tree
func NewTreeRoot ¶
func NewTreeRoot(ctx context.Context, tc *TreeContext) (*RootEntry, error)
NewTreeRoot Instantiate a new Tree Root element.
func (RootEntry) AddUpdateRecursive ¶ added in v0.0.56
func (s RootEntry) AddUpdateRecursive(ctx context.Context, u *types.Update, flags *types.UpdateInsertFlags) (Entry, error)
AddUpdateRecursive recursively adds the given cache.Update to the tree. Thereby creating all the entries along the path. if the entries along th path already exist, the existing entries are called to add the Update.
func (*RootEntry) AddUpdatesRecursive ¶ added in v0.0.56
func (r *RootEntry) AddUpdatesRecursive(ctx context.Context, us types.UpdateSlice, flags *types.UpdateInsertFlags) error
func (RootEntry) BreadthSearch ¶ added in v0.0.56
func (RootEntry) DeleteSubtree ¶ added in v0.0.56
func (*RootEntry) DeleteSubtreePaths ¶ added in v0.0.56
func (r *RootEntry) DeleteSubtreePaths(deletes types.DeleteEntriesList, intentName string) (bool, error)
DeleteSubtree Deletes from the tree, all elements of the PathSlice defined branch of the given owner. Return values are remainsToExist and error if an error occured.
func (RootEntry) FilterChilds ¶ added in v0.0.43
FilterChilds returns the child entries (skipping the key entries in the tree) that match the given keys. The keys do not need to match all levels of keys, in which case the key level is considered a wildcard match (*)
func (RootEntry) FinishInsertionPhase ¶
FinishInsertionPhase certain values that are costly to calculate but used multiple times will be calculated and stored for later use. However therefore the insertion phase into the tree needs to be over. Calling this function indicated the end of the phase and thereby triggers the calculation
func (*RootEntry) GetAncestorSchema ¶
func (r *RootEntry) GetAncestorSchema() (*sdcpb.SchemaElem, int)
func (RootEntry) GetByOwner ¶
func (s RootEntry) GetByOwner(owner string, result []*LeafEntry) LeafVariantSlice
GetByOwner returns all the LeafEntries that belong to a certain owner.
func (*RootEntry) GetDeletes ¶
func (r *RootEntry) GetDeletes(aggregatePaths bool) (types.DeleteEntriesList, error)
GetDeletes returns the paths that due to the Tree content are to be deleted from the southbound device.
func (*RootEntry) GetDeletesForOwner ¶
func (r *RootEntry) GetDeletesForOwner(owner string) types.PathSlices
GetDeletesForOwner returns the deletes that have been calculated for the given intent / owner
func (*RootEntry) GetDeviations ¶ added in v0.0.56
func (r *RootEntry) GetDeviations(ch chan<- *types.DeviationEntry)
func (RootEntry) GetFirstAncestorWithSchema ¶
GetAncestorSchema returns the schema of the parent node if the schema is set. if the parent has no schema (is a key element in the tree) it will recurs the call to the parents parent. the level of recursion is indicated via the levelUp attribute
func (*RootEntry) GetHighestPrecedence ¶
func (r *RootEntry) GetHighestPrecedence(onlyNewOrUpdated bool) LeafVariantSlice
GetHighesPrecedence return the new cache.Update entried from the tree that are the highes priority. If the onlyNewOrUpdated option is set to true, only the New or Updated entries will be returned It will append to the given list and provide a new pointer to the slice
func (RootEntry) GetLevel ¶
func (s RootEntry) GetLevel() int
GetLevel returns the level / depth position of this element in the tree
func (RootEntry) GetListChilds ¶ added in v0.0.56
getListChilds collects all the childs of the list. In the tree we store them seperated into their key branches. this is collecting all the last level key entries.
func (RootEntry) GetParent ¶
func (s RootEntry) GetParent() Entry
GetParent returns the parent entry
func (RootEntry) GetRootBasedEntryChain ¶ added in v0.0.42
func (s RootEntry) GetRootBasedEntryChain() []Entry
func (RootEntry) GetSchema ¶
func (s RootEntry) GetSchema() *sdcpb.SchemaElem
GetSchema return the schema fiels of the Entry
func (RootEntry) GetSchemaKeys ¶
func (s RootEntry) GetSchemaKeys() []string
GetSchemaKeys checks for the schema of the entry, and returns the defined keys
func (*RootEntry) GetUpdatesForOwner ¶
func (r *RootEntry) GetUpdatesForOwner(owner string) types.UpdateSlice
GetUpdatesForOwner returns the updates that have been calculated for the given intent / owner
func (*RootEntry) ImportConfig ¶ added in v0.0.44
func (RootEntry) IsRoot ¶
func (s RootEntry) IsRoot() bool
IsRoot returns true if the element has no parent elements, hence is the root of the tree
func (RootEntry) MarkOwnerDelete ¶ added in v0.0.56
markOwnerDelete Sets the delete flag on all the LeafEntries belonging to the given owner.
func (RootEntry) Navigate ¶
func (s RootEntry) Navigate(ctx context.Context, path []string, isRootPath bool, dotdotSkipKeys bool) (Entry, error)
Navigate move through the tree, returns the Entry that is present under the given path
func (RootEntry) NavigateLeafRef ¶ added in v0.0.43
NavigateLeafRef
func (RootEntry) NavigateSdcpbPath ¶ added in v0.0.42
func (RootEntry) PathName ¶
func (s RootEntry) PathName() string
PathName returns the name of the Entry
func (RootEntry) SdcpbPath ¶
SdcpbPath returns the sdcpb.Path, with its elements and keys based on the local schema
func (RootEntry) SdcpbPathInternal ¶
sdcpbPathInternal is the internale recursive function to calculate and the sdcpb.Path, with its elements and keys based on the local schema
func (RootEntry) StringIndent ¶
StringIndent returns the sharedEntryAttributes in its string representation The string is intented according to the nesting level in the yang model
func (RootEntry) ToJsonIETF ¶ added in v0.0.44
func (*RootEntry) ToProtoDeletes ¶ added in v0.0.44
func (*RootEntry) ToProtoUpdates ¶ added in v0.0.44
func (RootEntry) ToXML ¶ added in v0.0.44
func (s RootEntry) ToXML(onlyNewOrUpdated, honorNamespace, operationWithNamespace, useOperationRemove bool) (*etree.Document, error)
ToXML yields the xml representation of the tree. Either updates only (onlyNewOrUpdated flag) or the actual view on the whole tree. If honorNamespace is set, the xml elements will carry their respective namespace attributes. If operationWithNamespace is set, the operation attributes added to the to be deleted alements will also carry the Netconf Base namespace. If useOperationRemove is set, the remove operation will be used for deletes, instead of the delete operation.
func (*RootEntry) TreeExport ¶ added in v0.0.56
func (*RootEntry) Validate ¶
func (r *RootEntry) Validate(ctx context.Context, vCfg *config.Validation) types.ValidationResults
func (RootEntry) Walk ¶
func (s RootEntry) Walk(f EntryVisitor) error
Walk takes the EntryVisitor and applies it to every Entry in the tree
type TreeContext ¶
type TreeContext struct {
// contains filtered or unexported fields
}
func NewTreeContext ¶
func NewTreeContext(sc schemaClient.SchemaClientBound, actualOwner string) *TreeContext
func (*TreeContext) GetActualOwner ¶
func (t *TreeContext) GetActualOwner() string
func (*TreeContext) SetActualOwner ¶ added in v0.0.54
func (t *TreeContext) SetActualOwner(owner string)
func (*TreeContext) SetRoot ¶
func (t *TreeContext) SetRoot(e Entry) error