id

Documentation

Overview

Package id List is responsible for id List managing

Package id List is responsible for id List managing

Package id List is responsible for id List managing

Index

• Variables
• func CompactSrcs()
• func SubCmdAddToList(w io.Writer, fSys *afero.Afero) (err error)
• func SubCmdIdAdd(w io.Writer, fSys *afero.Afero) error
• func SubCmdIdClean(w io.Writer, fSys *afero.Afero) error
• func SubCmdIdInsert(w io.Writer, fSys *afero.Afero) (e error)
• func SubCmdIdZero(w io.Writer, fSys *afero.Afero) error
• func SubCmdUpdate(w io.Writer, fSys *afero.Afero) error
• type ArrayFlag
  • func (i *ArrayFlag) Set(value string) error
  • func (i *ArrayFlag) String() string
• type TriceFmt
• type TriceID
  • func (id *TriceID) Set(value string) error
  • func (id *TriceID) String() string
• type TriceIDLookUp
  • func NewLut(w io.Writer, fSys *afero.Afero, fn string) TriceIDLookUp
  • func (ilu TriceIDLookUp) AddFmtCount(w io.Writer)
  • func (lu TriceIDLookUp) FileWatcher(w io.Writer, fSys *afero.Afero, m *sync.RWMutex)
  • func (ilu TriceIDLookUp) FromJSON(b []byte) (err error)
• type TriceIDLookUpLI
  • func NewLutLI(w io.Writer, fSys *afero.Afero, fn string) TriceIDLookUpLI
  • func (li TriceIDLookUpLI) FileWatcher(w io.Writer, fSys *afero.Afero)
  • func (li TriceIDLookUpLI) FromJSON(b []byte) (err error)
• type TriceIDs
• type TriceLI

Variables

var (
	Verbose          bool            // Verbose gives more information on output if set. The value is injected from main packages.
	DryRun           bool            // DryRun if set, inhibits real changes
	FnJSON           = "til.json"    // FnJSON is the filename for the JSON formatted ID list.
	LIFnJSON         string          // LIFnJSON is the filename for the JSON formatted location information list.
	Min              = TriceID(1000) // Min is the smallest allowed ID for normal trices.
	Max              = TriceID(7999) // Max is the biggest allowed ID for normal trices.
	SearchMethod     = "random"      // SearchMethod is the next ID search method.
	LiPathIsRelative bool            // LiPathIsRelative causes to store relative paths instead of base names only inside li.json.
	Srcs             ArrayFlag       // Srcs gets multiple files or directories.
	IDData           idData

	//matchNumber              = regexp.MustCompile(patNumber)
	//matchIncludeTriceHeader  = regexp.MustCompile(patIncludeTriceHeader)
	ExtendMacrosWithParamCount bool

	// DefaultTriceBitWidth tells the bit width of TRICE macros having no bit width in their names, like TRICE32 or TRICE8.
	//
	// One target can use only one bith width for bare TRICE macros and the setting inside the target code must match DefaultTriceBitWidth.
	DefaultTriceBitWidth = "32"

	DefaultStampSize = 32
	StampSizeId      string
)

var Logging bool // Logging is true, when sub command log is active.

var SkipAdditionalChecks bool

Functions

func CompactSrcs

func CompactSrcs()

CompactSrcs adds local dir to Srcs if Srcs is empty and reduces variable Scrs to the minimum to address all intended folders.

func SubCmdAddToList

func SubCmdAddToList(w io.Writer, fSys *afero.Afero) (err error)

SubCmdAddToList etends the trice id list by parsing the source tree without changing any source file. It only reads FnJSON and tries to add id:tf pairs from the source tree. If equal tf are found with different ids they are all added. If the same id is found with different tf only one is added. The others are reported as warning. If any TRICE* is found without Id(n) or with Id(0), it is ignored.

func SubCmdIdAdd

func SubCmdIdAdd(w io.Writer, fSys *afero.Afero) error

SubCmdIdZero performs sub-command zero, setting trice IDs in source tree to 0.

func SubCmdIdClean

func SubCmdIdClean(w io.Writer, fSys *afero.Afero) error

SubCmdIdClean performs sub-command clean, zeroing or removing trice IDs from source tree.

func SubCmdIdInsert

func SubCmdIdInsert(w io.Writer, fSys *afero.Afero) (e error)

SubCmdIdInsert performs sub-command insert, adding trice IDs to source tree.

func SubCmdIdZero

func SubCmdIdZero(w io.Writer, fSys *afero.Afero) error

SubCmdIdZero performs sub-command zero, setting trice IDs in source tree to 0.

func SubCmdUpdate

func SubCmdUpdate(w io.Writer, fSys *afero.Afero) error

SubCmdUpdate is sub-command update

Types

type ArrayFlag

type ArrayFlag []string

ArrayFlag is a slice type for multi flag

func (*ArrayFlag) Set

func (i *ArrayFlag) Set(value string) error

Set is a needed method for multi flags.

func (*ArrayFlag) String

func (i *ArrayFlag) String() string

String method is the needed for interface satisfaction.

type TriceFmt

type TriceFmt struct {
	Type string `json:"Type"` // format type (bit-size and number of fmt string parameters)
	Strg string `json:"Strg"` // format string
}

TriceFmt is the trice format information assigned to a trice ID.

type TriceID

type TriceID int

TriceID is the trice ID referencing to Fmt.

func (*TriceID) Set

func (id *TriceID) Set(value string) error

Set implements part of flag.Value interface. It initializes id from the partial command line string

func (*TriceID) String

func (id *TriceID) String() string

String implements part of flag.Value interface. It returns id as string.

type TriceIDLookUp

type TriceIDLookUp map[TriceID]TriceFmt

TriceIDLookUp is the ID-to-TriceFmt info translation map. Different IDs can refer to equal TriceFmt's. It is used during logging. Example: 1:A, 5:C, 7:C An ID can point to one and only format string.

func NewLut

func NewLut(w io.Writer, fSys *afero.Afero, fn string) TriceIDLookUp

NewLut returns a look-up map generated from JSON map file named fn.

func (TriceIDLookUp) AddFmtCount

func (ilu TriceIDLookUp) AddFmtCount(w io.Writer)

AddFmtCount adds inside ilu to all trice type names without format specifier count the appropriate count. example change: `map[10000:{Trice8_2 hi %03u, %5x} 10001:{TRICE16 hi %03u, %5x}] `map[10000:{Trice8_2 hi %03u, %5x} 10001:{TRICE16_2 hi %03u, %5x}]

func (TriceIDLookUp) FileWatcher

func (lu TriceIDLookUp) FileWatcher(w io.Writer, fSys *afero.Afero, m *sync.RWMutex)

FileWatcher checks the id list file for changes. taken from https://medium.com/@skdomino/watch-this-file-watching-in-go-5b5a247cf71f

func (TriceIDLookUp) FromJSON

func (ilu TriceIDLookUp) FromJSON(b []byte) (err error)

FromJSON converts JSON byte slice to ilu.

type TriceIDLookUpLI

type TriceIDLookUpLI map[TriceID]TriceLI

func NewLutLI

func NewLutLI(w io.Writer, fSys *afero.Afero, fn string) TriceIDLookUpLI

NewLutLI returns a look-up map generated from JSON map file named fn.

func (TriceIDLookUpLI) FileWatcher

func (li TriceIDLookUpLI) FileWatcher(w io.Writer, fSys *afero.Afero)

FileWatcher checks the id location information file for changes. taken from https://medium.com/@skdomino/watch-this-file-watching-in-go-5b5a247cf71f

func (TriceIDLookUpLI) FromJSON

func (li TriceIDLookUpLI) FromJSON(b []byte) (err error)

FromJSON converts JSON byte slice to li.

type TriceIDs

type TriceIDs []TriceID

TriceIDs is a slice of trice IDs.

type TriceLI

type TriceLI struct {
	File string `json:"File"` // source file name of trice id
	Line int    `json:"Line"` // source file line of trice id
}

TriceLI is the trice location information assigned to a trice ID.