mcs/tools/corcompare/mono-api-html/Comparer.cs

   1 //
   2 // Authors
   3 //    Sebastien Pouliot  <sebastien@xamarin.com>
   4 //
   5 // Copyright 2013 Xamarin Inc. http://www.xamarin.com
   6 //
   7 // Permission is hereby granted, free of charge, to any person obtaining
   8 // a copy of this software and associated documentation files (the
   9 // "Software"), to deal in the Software without restriction, including
  10 // without limitation the rights to use, copy, modify, merge, publish,
  11 // distribute, sublicense, and/or sell copies of the Software, and to
  12 // permit persons to whom the Software is furnished to do so, subject to
  13 // the following conditions:
  14 //
  15 // The above copyright notice and this permission notice shall be
  16 // included in all copies or substantial portions of the Software.
  17 //
  18 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  19 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  20 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  21 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  22 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  23 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  24 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  25 //
  26
  27 using System;
  28 using System.Collections.Generic;
  29 using System.IO;
  30 using System.Linq;
  31 using System.Xml.Linq;
  32
  33 namespace Xamarin.ApiDiff {
  34
  35         public abstract class Comparer {
  36
  37                 protected List<XElement> removed = new List<XElement> ();
  38                 protected List<XElement> obsoleted = new List<XElement> ();
  39
  40                 public TextWriter Output {
  41                         get { return State.Output; }
  42                 }
  43
  44                 protected TextWriter Indent ()
  45                 {
  46                         for (int i = 0; i < State.Indent; i++)
  47                                 State.Output.Write ("\t");
  48                         return State.Output;
  49                 }
  50
  51                 public abstract void Added (XElement target);
  52                 public abstract void Modified (XElement source, XElement target);
  53                 public abstract void Removed (XElement source);
  54
  55                 public virtual bool Equals (XElement source, XElement target)
  56                 {
  57                         return XNode.DeepEquals (source, target);
  58                 }
  59
  60                 public abstract void SetContext (XElement current);
  61
  62                 public virtual void Compare (IEnumerable<XElement> source, IEnumerable<XElement> target)
  63                 {
  64                         removed.Clear ();
  65
  66                         foreach (var s in source) {
  67                                 SetContext (s);
  68                                 string sn = s.GetAttribute ("name");
  69                                 var t = target == null ? null : target.SingleOrDefault (x => x.GetAttribute ("name") == sn);
  70                                 if (t == null) {
  71                                         // not in target, it was removed
  72                                         removed.Add (s);
  73                                 } else {
  74                                         t.Remove ();
  75                                         // possibly modified
  76                                         if (Equals (s, t))
  77                                                 continue;
  78
  79                                         // still in target so will be part of Added
  80                                         Modified (s, t);
  81                                 }
  82                         }
  83                         // delayed, that way we show "Modified", "Added" and then "Removed"
  84                         foreach (var item in removed) {
  85                                 SetContext (item);
  86                                 Removed (item);
  87                         }
  88                         // remaining == newly added in target
  89                         if (target != null) {
  90                                 foreach (var item in target) {
  91                                         SetContext (item);
  92                                         Added (item);
  93                                 }
  94                         }
  95                 }
  96         }
  97 }