Tagging

Tagging allows us to use the clip name to convey multiple fields or key-value pairs of information. These can be parsed and then used by clients to give reports structure and detail.

The tagging process involves taking a single monolithic text string and producing a dictionary of string keys and string values:

func generateTags(from : String) -> [String:String]

By convention, we accept any text before the first tag as un-keyed text.

func generateTags(from : String) -> (text : String, fields : [String : String])

We use a restricted set of characters to convey tags, usually square and angle brackets.