using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Text.RegularExpressions; using Mustache.Properties; namespace Mustache { /// /// Parses a format string and returns a text generator. /// public sealed class FormatCompiler { private readonly Dictionary _tagLookup; private readonly Dictionary _regexLookup; private readonly MasterTagDefinition _masterDefinition; /// /// Initializes a new instance of a FormatCompiler. /// public FormatCompiler() { _tagLookup = new Dictionary(); _regexLookup = new Dictionary(); _masterDefinition = new MasterTagDefinition(); IfTagDefinition ifDefinition = new IfTagDefinition(); _tagLookup.Add(ifDefinition.Name, ifDefinition); ElifTagDefinition elifDefinition = new ElifTagDefinition(); _tagLookup.Add(elifDefinition.Name, elifDefinition); ElseTagDefinition elseDefinition = new ElseTagDefinition(); _tagLookup.Add(elseDefinition.Name, elseDefinition); EachTagDefinition eachDefinition = new EachTagDefinition(); _tagLookup.Add(eachDefinition.Name, eachDefinition); IndexTagDefinition indexDefinition = new IndexTagDefinition(); _tagLookup.Add(indexDefinition.Name, indexDefinition); WithTagDefinition withDefinition = new WithTagDefinition(); _tagLookup.Add(withDefinition.Name, withDefinition); } /// /// Occurs when a placeholder is found in the template. /// public event EventHandler PlaceholderFound; /// /// Registers the given tag definition with the parser. /// /// The tag definition to register. /// Specifies whether the tag is immediately in scope. public void RegisterTag(TagDefinition definition, bool isTopLevel) { if (definition == null) { throw new ArgumentNullException("definition"); } if (_tagLookup.ContainsKey(definition.Name)) { string message = String.Format(Resources.DuplicateTagDefinition, definition.Name); throw new ArgumentException(message, "definition"); } _tagLookup.Add(definition.Name, definition); } /// /// Builds a text generator based on the given format. /// /// The format to parse. /// The text generator. public Generator Compile(string format) { if (format == null) { throw new ArgumentNullException("format"); } CompoundGenerator generator = new CompoundGenerator(_masterDefinition, new ArgumentCollection()); Trimmer trimmer = new Trimmer(); List context = new List() { new Context(_masterDefinition.Name, new ContextParameter[0]) }; int formatIndex = buildCompoundGenerator(_masterDefinition, context, generator, trimmer, format, 0); string trailing = format.Substring(formatIndex); generator.AddStaticGenerators(trimmer.RecordText(trailing, false, false)); trimmer.Trim(); return new Generator(generator); } private Match findNextTag(TagDefinition definition, string format, int formatIndex) { Regex regex = prepareRegex(definition); return regex.Match(format, formatIndex); } private Regex prepareRegex(TagDefinition definition) { Regex regex; if (!_regexLookup.TryGetValue(definition.Name, out regex)) { List matches = new List(); matches.Add(getKeyRegex()); matches.Add(getCommentTagRegex()); foreach (string closingTag in definition.ClosingTags) { matches.Add(getClosingTagRegex(closingTag)); } foreach (TagDefinition globalDefinition in _tagLookup.Values) { if (!globalDefinition.IsContextSensitive) { matches.Add(getTagRegex(globalDefinition)); } } foreach (string childTag in definition.ChildTags) { TagDefinition childDefinition = _tagLookup[childTag]; matches.Add(getTagRegex(childDefinition)); } matches.Add(getUnknownTagRegex()); string match = "{{(" + String.Join("|", matches) + ")}}"; regex = new Regex(match); _regexLookup.Add(definition.Name, regex); } return regex; } private static string getClosingTagRegex(string tagName) { StringBuilder regexBuilder = new StringBuilder(); regexBuilder.Append(@"(?(/(?"); regexBuilder.Append(tagName); regexBuilder.Append(@")\s*?))"); return regexBuilder.ToString(); } private static string getCommentTagRegex() { return @"(?#!.*?)"; } private static string getKeyRegex() { return @"((?" + RegexHelper.CompoundKey + @")(,(?(\+|-)?[\d]+))?(:(?.*?))?)"; } private static string getTagRegex(TagDefinition definition) { StringBuilder regexBuilder = new StringBuilder(); regexBuilder.Append(@"(?(#(?"); regexBuilder.Append(definition.Name); regexBuilder.Append(@")"); foreach (TagParameter parameter in definition.Parameters) { regexBuilder.Append(@"(\s+?"); regexBuilder.Append(@"(?"); regexBuilder.Append(RegexHelper.CompoundKey); regexBuilder.Append(@"))"); if (!parameter.IsRequired) { regexBuilder.Append("?"); } } regexBuilder.Append(@"\s*?))"); return regexBuilder.ToString(); } private string getUnknownTagRegex() { return @"(?(#.*?))"; } private int buildCompoundGenerator( TagDefinition tagDefinition, List context, CompoundGenerator generator, Trimmer trimmer, string format, int formatIndex) { while (true) { Match match = findNextTag(tagDefinition, format, formatIndex); if (!match.Success) { if (tagDefinition.ClosingTags.Any()) { string message = String.Format(Resources.MissingClosingTag, tagDefinition.Name); throw new FormatException(message); } break; } string leading = format.Substring(formatIndex, match.Index - formatIndex); if (match.Groups["key"].Success) { generator.AddStaticGenerators(trimmer.RecordText(leading, true, true)); formatIndex = match.Index + match.Length; string key = match.Groups["key"].Value; string alignment = match.Groups["alignment"].Value; string formatting = match.Groups["format"].Value; PlaceholderFoundEventArgs args = new PlaceholderFoundEventArgs(key, alignment, formatting, context.ToArray()); if (PlaceholderFound != null) { PlaceholderFound(this, args); } KeyGenerator keyGenerator = new KeyGenerator(args.Key, args.Alignment, args.Formatting); generator.AddGenerator(keyGenerator); } else if (match.Groups["open"].Success) { formatIndex = match.Index + match.Length; string tagName = match.Groups["name"].Value; TagDefinition nextDefinition = _tagLookup[tagName]; if (nextDefinition == null) { string message = String.Format(Resources.UnknownTag, tagName); throw new FormatException(message); } if (nextDefinition.HasContent) { generator.AddStaticGenerators(trimmer.RecordText(leading, true, false)); ArgumentCollection arguments = getArguments(nextDefinition, match); CompoundGenerator compoundGenerator = new CompoundGenerator(nextDefinition, arguments); IEnumerable contextParameters = nextDefinition.GetChildContextParameters(); bool hasContext = contextParameters.Any(); if (hasContext) { ContextParameter[] parameters = contextParameters.Select(p => new ContextParameter(p.Name, arguments.GetKey(p))).ToArray(); context.Add(new Context(nextDefinition.Name, parameters)); } formatIndex = buildCompoundGenerator(nextDefinition, context, compoundGenerator, trimmer, format, formatIndex); generator.AddGenerator(nextDefinition, compoundGenerator); if (hasContext) { context.RemoveAt(context.Count - 1); } } else { generator.AddStaticGenerators(trimmer.RecordText(leading, true, true)); Match nextMatch = findNextTag(nextDefinition, format, formatIndex); ArgumentCollection arguments = getArguments(nextDefinition, nextMatch); InlineGenerator inlineGenerator = new InlineGenerator(nextDefinition, arguments); generator.AddGenerator(inlineGenerator); } } else if (match.Groups["close"].Success) { generator.AddStaticGenerators(trimmer.RecordText(leading, true, false)); string tagName = match.Groups["name"].Value; TagDefinition nextDefinition = _tagLookup[tagName]; formatIndex = match.Index; if (tagName == tagDefinition.Name) { formatIndex += match.Length; } break; } else if (match.Groups["comment"].Success) { generator.AddStaticGenerators(trimmer.RecordText(leading, true, false)); formatIndex = match.Index + match.Length; } else if (match.Groups["unknown"].Success) { string tagName = match.Value; string message = String.Format(Resources.UnknownTag, tagName); throw new FormatException(message); } } return formatIndex; } private static ArgumentCollection getArguments(TagDefinition definition, Match match) { ArgumentCollection collection = new ArgumentCollection(); List captures = match.Groups["argument"].Captures.Cast().ToList(); List parameters = definition.Parameters.ToList(); if (captures.Count > parameters.Count) { string message = String.Format(Resources.WrongNumberOfArguments, definition.Name); throw new FormatException(message); } if (captures.Count < parameters.Count) { captures.AddRange(Enumerable.Repeat((Capture)null, parameters.Count - captures.Count)); } foreach (var pair in parameters.Zip(captures, (p, c) => new { Capture = c, Parameter = p })) { if (pair.Capture == null) { if (pair.Parameter.IsRequired) { string message = String.Format(Resources.WrongNumberOfArguments, definition.Name); throw new FormatException(message); } collection.AddArgument(pair.Parameter, null); } else { collection.AddArgument(pair.Parameter, pair.Capture.Value); } } return collection; } } }