Introduce convenience methods into generated analysis server classes.

pkg/analysis_server/lib/src/generated_protocol.dart

 // Copyright (c) 2014, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 //
 // This file has been automatically generated.  Please do not edit it manually.
 // To regenerate the file, use the script
 // "pkg/analysis_server/spec/generate_files".
 
 part of protocol2;
 
@@ skipping 3994 matching lines @@
       String correction;
       if (json.containsKey("correction")) {
         correction = jsonDecoder._decodeString(jsonPath + ".correction", json["correction"]);
       }
       return new AnalysisError(severity, type, location, message, correction: correction);
     } else {
       throw jsonDecoder.mismatch(jsonPath, "AnalysisError");
     }
   }
 
+  /**
+   * Construct based on error information from the analyzer engine.
+   */
+  factory AnalysisError.fromEngine(engine.LineInfo lineInfo, engine.AnalysisError error) =>
+      _analysisErrorFromEngine(lineInfo, error);
+
   Map<String, dynamic> toJson() {
     Map<String, dynamic> result = {};
     result["severity"] = severity.toJson();
     result["type"] = type.toJson();
     result["location"] = location.toJson();
     result["message"] = message;
     if (correction != null) {
       result["correction"] = correction;
     }
     return result;
@@ skipping 890 matching lines @@
  * {
  *   "kind": ElementKind
  *   "name": String
  *   "location": optional Location
  *   "flags": int
  *   "parameters": optional String
  *   "returnType": optional String
  * }
  */
 class Element implements HasToJson {
+  static const int FLAG_ABSTRACT = 0x01;
+  static const int FLAG_CONST = 0x02;
+  static const int FLAG_FINAL = 0x04;
+  static const int FLAG_STATIC = 0x08;
+  static const int FLAG_PRIVATE = 0x10;
+  static const int FLAG_DEPRECATED = 0x20;
+
+  static int makeFlags({isAbstract: false, isConst: false, isFinal: false, isStatic: false, isPrivate: false, isDeprecated: false}) {
+    int flags = 0;
+    if (isAbstract) flags |= FLAG_ABSTRACT;
+    if (isConst) flags |= FLAG_CONST;
+    if (isFinal) flags |= FLAG_FINAL;
+    if (isStatic) flags |= FLAG_STATIC;
+    if (isPrivate) flags |= FLAG_PRIVATE;
+    if (isDeprecated) flags |= FLAG_DEPRECATED;
+    return flags;
+  }
+
   /**
    * The kind of the element.
    */
   ElementKind kind;
 
   /**
    * The name of the element. This is typically used as the label in the
    * outline.
    */
   String name;
@@ skipping 66 matching lines @@
       String returnType;
       if (json.containsKey("returnType")) {
         returnType = jsonDecoder._decodeString(jsonPath + ".returnType", json["returnType"]);
       }
       return new Element(kind, name, flags, location: location, parameters: parameters, returnType: returnType);
     } else {
       throw jsonDecoder.mismatch(jsonPath, "Element");
     }
   }
 
+  bool get isAbstract => (flags & FLAG_ABSTRACT) != 0;
+  bool get isConst => (flags & FLAG_CONST) != 0;
+  bool get isFinal => (flags & FLAG_FINAL) != 0;
+  bool get isStatic => (flags & FLAG_STATIC) != 0;
+  bool get isPrivate => (flags & FLAG_PRIVATE) != 0;
+  bool get isDeprecated => (flags & FLAG_DEPRECATED) != 0;
+
   Map<String, dynamic> toJson() {
     Map<String, dynamic> result = {};
     result["kind"] = kind.toJson();
     result["name"] = name;
     if (location != null) {
       result["location"] = location.toJson();
     }
     result["flags"] = flags;
     if (parameters != null) {
       result["parameters"] = parameters;
@@ skipping 144 matching lines @@
     if (json is String) {
       try {
         return new ElementKind(json);
       } catch(_) {
         // Fall through
       }
     }
     throw jsonDecoder.mismatch(jsonPath, "ElementKind");
   }
 
+  /**
+   * Construct based on a value from the analyzer engine.
+   */
+  factory ElementKind.fromEngine(engine.ElementKind kind) =>
+      _elementKindFromEngine(kind);
+
   @override
   String toString() => "ElementKind.$name";
 
   String toJson() => name;
 }
 
 /**
  * Error
  *
  * {
@@ skipping 2675 matching lines @@
  *
  * {
  *   "offset": int
  *   "length": int
  *   "replacement": String
  *   "id": optional String
  * }
  */
 class SourceEdit implements HasToJson {
   /**
+   * Get the result of applying a set of [edits] to the given [code]. Edits are
+   * applied in the order they appear in [edits].
+   */
+  static String applySequence(String code, Iterable<SourceEdit> edits) =>
+      _applySequence(code, edits);
+
+  /**
    * The offset of the region to be modified.
    */
   int offset;
 
   /**
    * The length of the region to be modified.
    */
   int length;
 
   /**
@@ skipping 41 matching lines @@
       String id;
       if (json.containsKey("id")) {
         id = jsonDecoder._decodeString(jsonPath + ".id", json["id"]);
       }
       return new SourceEdit(offset, length, replacement, id: id);
     } else {
       throw jsonDecoder.mismatch(jsonPath, "SourceEdit");
     }
   }
 
+  /**
+   * Construct based on a SourceRange.
+   */
+  SourceEdit.range(engine.SourceRange range, String replacement, {String id})
+      : this(range.offset, range.length, replacement, id: id);
+
+  /**
+   * The end of the region to be modified.
+   */
+  int get end => offset + length;
+
   Map<String, dynamic> toJson() {
     Map<String, dynamic> result = {};
     result["offset"] = offset;
     result["length"] = length;
     result["replacement"] = replacement;
     if (id != null) {
       result["id"] = id;
     }
     return result;
   }
 
+  /**
+   * Get the result of applying the edit to the given [code].
+   */
+  String apply(String code) => _applyEdit(code, this);
+
   @override
   String toString() => JSON.encode(toJson());
 
   @override
   bool operator==(other) {
     if (other is SourceEdit) {
       return offset == other.offset &&
           length == other.length &&
           replacement == other.replacement &&
           id == other.id;
@@ skipping 950 matching lines @@
     return false;
   }
 
   @override
   int get hashCode {
     int hash = 0;
     hash = _JenkinsSmiHash.combine(hash, newName.hashCode);
     return _JenkinsSmiHash.finish(hash);
   }
 }