//*************************************************************************** // Copyright © 2010 Microsoft Corporation. All Rights Reserved. // This code released under the terms of the // Microsoft Public License (MS-PL, http://opensource.org/licenses/ms-pl.html.) //*************************************************************************** using System; using System.Collections.Generic; using System.ComponentModel.Composition; using System.Diagnostics.Contracts; using Microsoft.Dafny; using Microsoft.VisualStudio.Text; using Microsoft.VisualStudio.Text.Tagging; using Microsoft.VisualStudio.Utilities; using Bpl = Microsoft.Boogie; namespace DafnyLanguage { #region Provider [Export(typeof(ITaggerProvider))] [ContentType("dafny")] [TagType(typeof(DafnyTokenTag))] internal sealed class IdentifierTaggerProvider : ITaggerProvider { [Import] internal IBufferTagAggregatorFactoryService AggregatorFactory = null; public ITagger CreateTagger(ITextBuffer buffer) where T : ITag { ITagAggregator tagAggregator = AggregatorFactory.CreateTagAggregator(buffer); // create a single tagger for each buffer. Func> sc = delegate() { return new IdentifierTagger(buffer, tagAggregator) as ITagger; }; return buffer.Properties.GetOrCreateSingletonProperty>(sc); } } #endregion #region Tagger /// /// Translate DafnyResolverTag's into IOutliningRegionTag's /// internal sealed class IdentifierTagger : ITagger { ITextBuffer _buffer; ITextSnapshot _snapshot; // the most recent snapshot of _buffer that we have been informed about Microsoft.Dafny.Program _program; // the program parsed from _snapshot List _regions = new List(); // the regions generated from _program ITagAggregator _aggregator; internal IdentifierTagger(ITextBuffer buffer, ITagAggregator tagAggregator) { _buffer = buffer; _snapshot = _buffer.CurrentSnapshot; _aggregator = tagAggregator; _aggregator.TagsChanged += new EventHandler(_aggregator_TagsChanged); } /// /// Find the Error tokens in the set of all tokens and create an ErrorTag for each /// public IEnumerable> GetTags(NormalizedSnapshotSpanCollection spans) { if (spans.Count == 0) yield break; // (A NormalizedSnapshotSpanCollection contains spans that all come from the same snapshot.) // The spans are ordered by the .Start component, and the collection contains no adjacent or abutting spans. // Hence, to find a span that includes all the ones in "spans", we only need to look at the .Start for the // first spand and the .End of the last span: var startPoint = spans[0].Start; var endPoint = spans[spans.Count - 1].End; // Note, (startPoint,endPoint) are points in the spans for which we're being asked to provide tags. We need to translate // these back into the most recent snapshot that we've computed regions for, namely _snapshot. var entire = new SnapshotSpan(startPoint, endPoint).TranslateTo(_snapshot, SpanTrackingMode.EdgeExclusive); int start = entire.Start; int end = entire.End; foreach (var r in _regions) { if (0 <= r.Length && r.Start <= end && start <= r.Start + r.Length) { DafnyTokenKind kind; switch (r.Kind) { case IdRegion.OccurrenceKind.Use: kind = DafnyTokenKind.VariableIdentifier; break; case IdRegion.OccurrenceKind.Definition: kind = DafnyTokenKind.VariableIdentifierDefinition; break; case IdRegion.OccurrenceKind.WildDefinition: kind = DafnyTokenKind.Keyword; break; case IdRegion.OccurrenceKind.AdditionalInformation: kind = DafnyTokenKind.AdditionalInformation; break; default: Contract.Assert(false); // unexpected OccurrenceKind goto case IdRegion.OccurrenceKind.Use; // to please compiler } yield return new TagSpan( new SnapshotSpan(_snapshot, r.Start, r.Length), new DafnyTokenTag(kind, r.HoverText, r.Variable)); } } } // the Classifier tagger is translating buffer change events into TagsChanged events, so we don't have to public event EventHandler TagsChanged; void _aggregator_TagsChanged(object sender, TagsChangedEventArgs e) { var r = sender as ResolverTagger; if (r != null) { ITextSnapshot snap; Microsoft.Dafny.Program prog; lock (this) { snap = r.Snapshot; prog = r.Program; } if (prog != null) { if (!ComputeIdentifierRegions(prog, snap)) return; // no new regions var chng = TagsChanged; if (chng != null) { NormalizedSnapshotSpanCollection spans = e.Span.GetSpans(_buffer.CurrentSnapshot); if (spans.Count > 0) { SnapshotSpan span = new SnapshotSpan(spans[0].Start, spans[spans.Count - 1].End); chng(this, new SnapshotSpanEventArgs(span)); } } } } } bool ComputeIdentifierRegions(Microsoft.Dafny.Program program, ITextSnapshot snapshot) { Contract.Requires(snapshot != null); if (program == _program) return false; // no new regions List newRegions = new List(); foreach (var addInfo in program.AdditionalInformation) { IdRegion.Add(newRegions, addInfo.Token, addInfo.Text, addInfo.Length); } foreach (var module in program.Modules) { if (module.IsFacade) { continue; } foreach (var d in module.TopLevelDecls) { if (d is DatatypeDecl) { var dt = (DatatypeDecl)d; foreach (var ctor in dt.Ctors) { foreach (var dtor in ctor.Destructors) { if (dtor.CorrespondingFormal.HasName) { IdRegion.Add(newRegions, dtor.tok, dtor, null, "destructor", true, module); } } } } else if (d is IteratorDecl) { var iter = (IteratorDecl)d; foreach (var p in iter.Ins) { IdRegion.Add(newRegions, p.tok, p, true, module); } foreach (var p in iter.Outs) { IdRegion.Add(newRegions, p.tok, p, true, "yield-parameter", module); } iter.Reads.Expressions.ForEach(fe => FrameExprRegions(fe, newRegions, true, module)); iter.Modifies.Expressions.ForEach(fe => FrameExprRegions(fe, newRegions, true, module)); iter.Requires.ForEach(e => ExprRegions(e.E, newRegions, module)); iter.YieldRequires.ForEach(e => ExprRegions(e.E, newRegions, module)); iter.YieldEnsures.ForEach(e => ExprRegions(e.E, newRegions, module)); iter.Ensures.ForEach(e => ExprRegions(e.E, newRegions, module)); if (!((ICallable)iter).InferredDecreases) { iter.Decreases.Expressions.ForEach(e => ExprRegions(e, newRegions, module)); } if (iter.Body != null) { StatementRegions(iter.Body, newRegions, module); } } else if (d is ClassDecl) { var cl = (ClassDecl)d; foreach (var member in cl.Members) { if (member is Function) { var f = (Function)member; foreach (var p in f.Formals) { IdRegion.Add(newRegions, p.tok, p, true, module); } f.Req.ForEach(e => ExprRegions(e, newRegions, module)); f.Reads.ForEach(fe => FrameExprRegions(fe, newRegions, true, module)); f.Ens.ForEach(e => ExprRegions(e, newRegions, module)); f.Decreases.Expressions.ForEach(e => ExprRegions(e, newRegions, module)); if (f.Body != null) { ExprRegions(f.Body, newRegions, module); } } else if (member is Method) { var m = (Method)member; foreach (var p in m.Ins) { IdRegion.Add(newRegions, p.tok, p, true, module); } foreach (var p in m.Outs) { IdRegion.Add(newRegions, p.tok, p, true, module); } m.Req.ForEach(e => ExprRegions(e.E, newRegions, module)); m.Mod.Expressions.ForEach(fe => FrameExprRegions(fe, newRegions, true, module)); m.Ens.ForEach(e => ExprRegions(e.E, newRegions, module)); m.Decreases.Expressions.ForEach(e => ExprRegions(e, newRegions, module)); if (m.Body != null) { StatementRegions(m.Body, newRegions, module); } } else if (member is SpecialField) { // do nothing } else if (member is Field) { var fld = (Field)member; IdRegion.Add(newRegions, fld.tok, fld, null, "field", true, module); } } } else if (d is NewtypeDecl) { var dd = (NewtypeDecl)d; if (dd.Var != null) { IdRegion.Add(newRegions, dd.Var.tok, dd.Var, true, module); ExprRegions(dd.Constraint, newRegions, module); } } } } _snapshot = snapshot; _regions = newRegions; _program = program; return true; } static void FrameExprRegions(FrameExpression fe, List regions, bool descendIntoExpressions, ModuleDefinition module) { Contract.Requires(fe != null); Contract.Requires(regions != null); if (descendIntoExpressions) { ExprRegions(fe.E, regions, module); } if (fe.Field != null) { Microsoft.Dafny.Type showType = null; // TODO: if we had the instantiated type of this field, that would have been nice to use here (but the Resolver currently does not compute or store the instantiated type for a FrameExpression) IdRegion.Add(regions, fe.tok, fe.Field, showType, "field", false, module); } } static void ExprRegions(Microsoft.Dafny.Expression expr, List regions, ModuleDefinition module) { Contract.Requires(expr != null); Contract.Requires(regions != null); if (expr is AutoGeneratedExpression) { // do nothing return; } else if (expr is IdentifierExpr) { var e = (IdentifierExpr)expr; IdRegion.Add(regions, e.tok, e.Var, false, module); } else if (expr is MemberSelectExpr) { var e = (MemberSelectExpr)expr; var field = e.Member as Field; if (field != null) { IdRegion.Add(regions, e.tok, field, e.Type, "field", false, module); } } else if (expr is LetExpr) { var e = (LetExpr)expr; foreach (var bv in e.BoundVars) { IdRegion.Add(regions, bv.tok, bv, true, module); } } else if (expr is ComprehensionExpr) { var e = (ComprehensionExpr)expr; foreach (var bv in e.BoundVars) { IdRegion.Add(regions, bv.tok, bv, true, module); } } else if (expr is MatchExpr) { var e = (MatchExpr)expr; foreach (var kase in e.Cases) { kase.Arguments.ForEach(bv => IdRegion.Add(regions, bv.tok, bv, true, module)); } } else if (expr is ChainingExpression) { var e = (ChainingExpression)expr; // Do the subexpressions only once (that is, avoid the duplication that occurs in the desugared form of the ChainingExpression) e.Operands.ForEach(ee => ExprRegions(ee, regions, module)); return; // return here, so as to avoid doing the subexpressions below } foreach (var ee in expr.SubExpressions) { ExprRegions(ee, regions, module); } } static void StatementRegions(Statement stmt, List regions, ModuleDefinition module) { Contract.Requires(stmt != null); Contract.Requires(regions != null); if (stmt is VarDeclStmt) { var s = (VarDeclStmt)stmt; // Add the variables here, once, and then go directly to the RHS's (without letting the sub-statements re-do the LHS's) foreach (var local in s.Locals) { IdRegion.Add(regions, local.Tok, local, true, module); } if (s.Update == null) { // the VarDeclStmt has no associated assignment } else if (s.Update is UpdateStmt) { var upd = (UpdateStmt)s.Update; foreach (var rhs in upd.Rhss) { foreach (var ee in rhs.SubExpressions) { ExprRegions(ee, regions, module); } } } else { var upd = (AssignSuchThatStmt)s.Update; ExprRegions(upd.Expr, regions, module); } // we're done, so don't do the sub-statements/expressions again return; } else if (stmt is ForallStmt) { var s = (ForallStmt)stmt; s.BoundVars.ForEach(bv => IdRegion.Add(regions, bv.tok, bv, true, module)); } else if (stmt is MatchStmt) { var s = (MatchStmt)stmt; foreach (var kase in s.Cases) { kase.Arguments.ForEach(bv => IdRegion.Add(regions, bv.tok, bv, true, module)); } } else if (stmt is LoopStmt) { var s = (LoopStmt)stmt; if (s.Mod.Expressions != null) { s.Mod.Expressions.ForEach(fe => FrameExprRegions(fe, regions, false, module)); } } else if (stmt is CalcStmt) { var s = (CalcStmt)stmt; // skip the last line, which is just a duplicate anyway for (int i = 0; i < s.Lines.Count - 1; i++) { ExprRegions(s.Lines[i], regions, module); } foreach (var ss in stmt.SubStatements) { StatementRegions(ss, regions, module); } return; } foreach (var ee in stmt.SubExpressions) { ExprRegions(ee, regions, module); } foreach (var ss in stmt.SubStatements) { StatementRegions(ss, regions, module); } } class IdRegion { public readonly int Start; public readonly int Length; public readonly string HoverText; public enum OccurrenceKind { Use, Definition, WildDefinition, AdditionalInformation } public readonly OccurrenceKind Kind; public readonly IVariable Variable; static bool SurfaceSyntaxToken(Bpl.IToken tok) { Contract.Requires(tok != null); return !(tok is TokenWrapper); } public static void Add(List regions, Bpl.IToken tok, IVariable v, bool isDefinition, ModuleDefinition context) { Contract.Requires(regions != null); Contract.Requires(tok != null); Contract.Requires(v != null); Add(regions, tok, v, isDefinition, null, context); } public static void Add(List regions, Bpl.IToken tok, IVariable v, bool isDefinition, string kind, ModuleDefinition context) { Contract.Requires(regions != null); Contract.Requires(tok != null); Contract.Requires(v != null); if (SurfaceSyntaxToken(tok)) { regions.Add(new IdRegion(tok, v, isDefinition, kind, context)); } } public static void Add(List regions, Bpl.IToken tok, Field decl, Microsoft.Dafny.Type showType, string kind, bool isDefinition, ModuleDefinition context) { Contract.Requires(regions != null); Contract.Requires(tok != null); Contract.Requires(decl != null); Contract.Requires(kind != null); if (SurfaceSyntaxToken(tok)) { regions.Add(new IdRegion(tok, decl, showType, kind, isDefinition, context)); } } public static void Add(List regions, Bpl.IToken tok, string text, int length) { Contract.Requires(regions != null); Contract.Requires(tok != null); Contract.Requires(text != null); if (SurfaceSyntaxToken(tok)) { regions.Add(new IdRegion(tok, OccurrenceKind.AdditionalInformation, text, length)); } } private IdRegion(Bpl.IToken tok, IVariable v, bool isDefinition, string kind, ModuleDefinition context) { Contract.Requires(tok != null); Contract.Requires(v != null); Start = tok.pos; Length = v.DisplayName.Length; if (kind == null) { // use default if (v is LocalVariable) { kind = "local variable"; } else if (v is BoundVar) { kind = "bound variable"; } else { var formal = (Formal)v; kind = formal.InParam ? "in-parameter" : "out-parameter"; if (formal is ImplicitFormal) { kind = "implicit " + kind; } } } Variable = v; HoverText = string.Format("({2}{3}) {0}: {1}", v.DisplayName, v.Type.TypeName(context), v.IsGhost ? "ghost " : "", kind); Kind = !isDefinition ? OccurrenceKind.Use : LocalVariable.HasWildcardName(v) ? OccurrenceKind.WildDefinition : OccurrenceKind.Definition; } private IdRegion(Bpl.IToken tok, Field decl, Microsoft.Dafny.Type showType, string kind, bool isDefinition, ModuleDefinition context) { Contract.Requires(tok != null); Contract.Requires(decl != null); Contract.Requires(kind != null); if (showType == null) { showType = decl.Type; } Start = tok.pos; Length = decl.Name.Length; HoverText = string.Format("({4}{2}{3}) {0}: {1}", decl.FullNameInContext(context), showType.TypeName(context), decl.IsGhost ? "ghost " : "", kind, decl.IsUserMutable || decl is DatatypeDestructor ? "" : decl.IsMutable ? " non-assignable " : "immutable "); Kind = !isDefinition ? OccurrenceKind.Use : OccurrenceKind.Definition; } private IdRegion(Bpl.IToken tok, OccurrenceKind occurrenceKind, string info, int length) { this.Start = tok.pos; this.Length = length; this.Kind = occurrenceKind; this.HoverText = info; } } } #endregion }