Deprecate the source_maps span classes.

pkg/source_maps/lib/span.dart

 // Copyright (c) 2013, 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.
 
 /// Dart classes representing the souce spans and source files.
 library source_maps.span;
 
 import 'dart:math' show min, max;
 
 import 'package:path/path.dart' as p;
 
 import 'src/utils.dart';
 
 /// A simple class that describe a segment of source text.
+@Deprecated("Use the source_span package instead.")
 abstract class Span implements Comparable {
   /// The start location of this span.
   final Location start;
 
   /// The end location of this span, exclusive.
   final Location end;
 
   /// Url of the source (typically a file) containing this span.
   String get sourceUrl => start.sourceUrl;
 
@@ skipping 47 matching lines @@
 
   bool operator ==(Span other) =>
     sourceUrl == other.sourceUrl && start == other.start && end == other.end;
 
   int get hashCode => sourceUrl.hashCode + start.offset + (31 * length);
 
   String toString() => '<$runtimeType: $start $end $formatLocation $text>';
 }
 
 /// A location in the source text
+@Deprecated("Use the source_span package instead.")
 abstract class Location implements Comparable {
   /// Url of the source containing this span.
   String get sourceUrl;
 
   /// The offset of this location, 0-based.
   final int offset;
 
   /// The 0-based line in the source of this location.
   int get line;
 
@@ skipping 14 matching lines @@
   bool operator ==(Location other) =>
       sourceUrl == other.sourceUrl && offset == other.offset;
 
   int get hashCode => sourceUrl.hashCode + offset;
 
   String toString() => '(Location $offset)';
   String get formatString => '$sourceUrl:${line + 1}:${column + 1}';
 }
 
 /// Implementation of [Location] with fixed values given at allocation time.
+@Deprecated("Use the source_span package instead.")
 class FixedLocation extends Location {
   final String sourceUrl;
   final int line;
   final int column;
 
   FixedLocation(int offset, this.sourceUrl, this.line, this.column)
       : super(offset);
 }
 
 /// Implementation of [Span] where all the values are given at allocation time.
+@Deprecated("Use the source_span package instead.")
 class FixedSpan extends Span {
   /// The source text for this span, if available.
   final String text;
 
   /// Creates a span which starts and end in the same line.
   FixedSpan(String sourceUrl, int start, int line, int column,
             {String text: '', bool isIdentifier: false})
       : text = text, super(new FixedLocation(start, sourceUrl, line, column),
             new FixedLocation(start + text.length, sourceUrl, line,
                 column + text.length),
             isIdentifier);
 }
 
 /// [Location] with values computed from an underling [SourceFile].
+@Deprecated("Use the source_span package instead.")
 class FileLocation extends Location {
   /// The source file containing this location.
   final SourceFile file;
 
   String get sourceUrl => file.url;
   int get line => file.getLine(offset);
   int get column => file.getColumn(line, offset);
 
   FileLocation(this.file, int offset): super(offset);
 }
 
 /// [Span] where values are computed from an underling [SourceFile].
+@Deprecated("Use the source_span package instead.")
 class FileSpan extends Span {
   /// The source file containing this span.
   final SourceFile file;
 
   /// The source text for this span, if available.
   String get text => file.getText(start.offset, end.offset);
 
   factory FileSpan(SourceFile file, int start,
       [int end, bool isIdentifier = false]) {
     var startLoc = new FileLocation(file, start);
@@ skipping 26 matching lines @@
 const int _LF = 10;
 const int _CR = 13;
 
 // Color constants used for generating messages.
 const String _RED_COLOR = '\u001b[31m';
 const String _NO_COLOR = '\u001b[0m';
 
 /// Stores information about a source file, to permit computation of the line
 /// and column. Also contains a nice default error message highlighting the code
 /// location.
+@Deprecated("Use the source_span package instead.")
 class SourceFile {
   /// Url where the source file is located.
   final String url;
   final List<int> _lineStarts;
   final List<int> _decodedChars;
 
   SourceFile(this.url, this._lineStarts, this._decodedChars);
 
   SourceFile.text(this.url, String text)
       : _lineStarts = <int>[0],
@@ skipping 91 matching lines @@
     if (useColors) buf.write(_NO_COLOR);
     return buf.toString();
   }
 }
 
 /// A convenience type to treat a code segment as if it were a separate
 /// [SourceFile]. A [SourceFileSegment] shifts all locations by an offset, which
 /// allows you to set source-map locations based on the locations relative to
 /// the start of the segment, but that get translated to absolute locations in
 /// the original source file.
+@Deprecated("Use the source_span package instead.")
 class SourceFileSegment extends SourceFile {
   final int _baseOffset;
   final int _baseLine;
   final int _baseColumn;
   final int _maxOffset;
 
   SourceFileSegment(String url, String textSegment, Location startOffset)
       : _baseOffset = startOffset.offset,
         _baseLine = startOffset.line,
         _baseColumn = startOffset.column,
@@ skipping 39 matching lines @@
         line == _baseLine ? column - _baseColumn : column) + _baseOffset;
 
   /// Retrieve the text associated with the specified range. This method
   /// operates on the real offsets from the original file, so that error
   /// messages can be reported accurately.
   String getText(int start, [int end]) =>
     super.getText(start - _baseOffset, end == null ? null : end - _baseOffset);
 }
 
 /// A class for exceptions that have source span information attached.
+@Deprecated("Use the source_span package instead.")
 class SpanException implements Exception {
   /// A message describing the exception.
   final String message;
 
   /// The span associated with this exception.
   ///
   /// This may be `null` if the source location can't be determined.
   final Span span;
 
   SpanException(this.message, this.span);
 
   String toString({bool useColors: false, String color}) {
     if (span == null) return message;
     return "Error on " + span.getLocationMessage(message,
         useColors: useColors, color: color);
   }
 }
 
 /// A [SpanException] that's also a [FormatException].
+@Deprecated("Use the source_span package instead.")
 class SpanFormatException extends SpanException implements FormatException {
   final source;
 
   SpanFormatException(String message, Span span, [this.source])
       : super(message, span);
 
   int get offset => span == null ? null : span.start.offset;
 }