blob: c27048ede27833d0038a0964372bb42ba0630ed6 [file] [log] [blame]
// 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.
import 'package:test/test.dart';
import 'package:term_glyph/term_glyph.dart' as glyph;
import 'package:source_span/source_span.dart';
import 'package:source_span/src/colors.dart' as colors;
void main() {
late bool oldAscii;
setUpAll(() {
oldAscii = glyph.ascii;
glyph.ascii = true;
});
tearDownAll(() {
glyph.ascii = oldAscii;
});
late SourceSpan span;
setUp(() {
span = SourceSpan(SourceLocation(5, sourceUrl: 'foo.dart'),
SourceLocation(12, sourceUrl: 'foo.dart'), 'foo bar');
});
group('errors', () {
group('for new SourceSpan()', () {
test('source URLs must match', () {
final start = SourceLocation(0, sourceUrl: 'foo.dart');
final end = SourceLocation(1, sourceUrl: 'bar.dart');
expect(() => SourceSpan(start, end, '_'), throwsArgumentError);
});
test('end must come after start', () {
final start = SourceLocation(1);
final end = SourceLocation(0);
expect(() => SourceSpan(start, end, '_'), throwsArgumentError);
});
test('text must be the right length', () {
final start = SourceLocation(0);
final end = SourceLocation(1);
expect(() => SourceSpan(start, end, 'abc'), throwsArgumentError);
});
});
group('for new SourceSpanWithContext()', () {
test('context must contain text', () {
final start = SourceLocation(2);
final end = SourceLocation(5);
expect(() => SourceSpanWithContext(start, end, 'abc', '--axc--'),
throwsArgumentError);
});
test('text starts at start.column in context', () {
final start = SourceLocation(3);
final end = SourceLocation(5);
expect(() => SourceSpanWithContext(start, end, 'abc', '--abc--'),
throwsArgumentError);
});
test('text starts at start.column of line in multi-line context', () {
final start = SourceLocation(4, line: 55, column: 3);
final end = SourceLocation(7, line: 55, column: 6);
expect(() => SourceSpanWithContext(start, end, 'abc', '\n--abc--'),
throwsArgumentError);
expect(() => SourceSpanWithContext(start, end, 'abc', '\n----abc--'),
throwsArgumentError);
expect(() => SourceSpanWithContext(start, end, 'abc', '\n\n--abc--'),
throwsArgumentError);
// However, these are valid:
SourceSpanWithContext(start, end, 'abc', '\n---abc--');
SourceSpanWithContext(start, end, 'abc', '\n\n---abc--');
});
test('text can occur multiple times in context', () {
final start1 = SourceLocation(4, line: 55, column: 2);
final end1 = SourceLocation(7, line: 55, column: 5);
final start2 = SourceLocation(4, line: 55, column: 8);
final end2 = SourceLocation(7, line: 55, column: 11);
SourceSpanWithContext(start1, end1, 'abc', '--abc---abc--\n');
SourceSpanWithContext(start1, end1, 'abc', '--abc--abc--\n');
SourceSpanWithContext(start2, end2, 'abc', '--abc---abc--\n');
SourceSpanWithContext(start2, end2, 'abc', '---abc--abc--\n');
expect(
() => SourceSpanWithContext(start1, end1, 'abc', '---abc--abc--\n'),
throwsArgumentError);
expect(
() => SourceSpanWithContext(start2, end2, 'abc', '--abc--abc--\n'),
throwsArgumentError);
});
});
group('for union()', () {
test('source URLs must match', () {
final other = SourceSpan(SourceLocation(12, sourceUrl: 'bar.dart'),
SourceLocation(13, sourceUrl: 'bar.dart'), '_');
expect(() => span.union(other), throwsArgumentError);
});
test('spans may not be disjoint', () {
final other = SourceSpan(SourceLocation(13, sourceUrl: 'foo.dart'),
SourceLocation(14, sourceUrl: 'foo.dart'), '_');
expect(() => span.union(other), throwsArgumentError);
});
});
test('for compareTo() source URLs must match', () {
final other = SourceSpan(SourceLocation(12, sourceUrl: 'bar.dart'),
SourceLocation(13, sourceUrl: 'bar.dart'), '_');
expect(() => span.compareTo(other), throwsArgumentError);
});
});
test('fields work correctly', () {
expect(span.start, equals(SourceLocation(5, sourceUrl: 'foo.dart')));
expect(span.end, equals(SourceLocation(12, sourceUrl: 'foo.dart')));
expect(span.sourceUrl, equals(Uri.parse('foo.dart')));
expect(span.length, equals(7));
});
group('union()', () {
test('works with a preceding adjacent span', () {
final other = SourceSpan(SourceLocation(0, sourceUrl: 'foo.dart'),
SourceLocation(5, sourceUrl: 'foo.dart'), 'hey, ');
final result = span.union(other);
expect(result.start, equals(other.start));
expect(result.end, equals(span.end));
expect(result.text, equals('hey, foo bar'));
});
test('works with a preceding overlapping span', () {
final other = SourceSpan(SourceLocation(0, sourceUrl: 'foo.dart'),
SourceLocation(8, sourceUrl: 'foo.dart'), 'hey, foo');
final result = span.union(other);
expect(result.start, equals(other.start));
expect(result.end, equals(span.end));
expect(result.text, equals('hey, foo bar'));
});
test('works with a following adjacent span', () {
final other = SourceSpan(SourceLocation(12, sourceUrl: 'foo.dart'),
SourceLocation(16, sourceUrl: 'foo.dart'), ' baz');
final result = span.union(other);
expect(result.start, equals(span.start));
expect(result.end, equals(other.end));
expect(result.text, equals('foo bar baz'));
});
test('works with a following overlapping span', () {
final other = SourceSpan(SourceLocation(9, sourceUrl: 'foo.dart'),
SourceLocation(16, sourceUrl: 'foo.dart'), 'bar baz');
final result = span.union(other);
expect(result.start, equals(span.start));
expect(result.end, equals(other.end));
expect(result.text, equals('foo bar baz'));
});
test('works with an internal overlapping span', () {
final other = SourceSpan(SourceLocation(7, sourceUrl: 'foo.dart'),
SourceLocation(10, sourceUrl: 'foo.dart'), 'o b');
expect(span.union(other), equals(span));
});
test('works with an external overlapping span', () {
final other = SourceSpan(SourceLocation(0, sourceUrl: 'foo.dart'),
SourceLocation(16, sourceUrl: 'foo.dart'), 'hey, foo bar baz');
expect(span.union(other), equals(other));
});
});
group('subspan()', () {
group('errors', () {
test('start must be greater than zero', () {
expect(() => span.subspan(-1), throwsRangeError);
});
test('start must be less than or equal to length', () {
expect(() => span.subspan(span.length + 1), throwsRangeError);
});
test('end must be greater than start', () {
expect(() => span.subspan(2, 1), throwsRangeError);
});
test('end must be less than or equal to length', () {
expect(() => span.subspan(0, span.length + 1), throwsRangeError);
});
});
test('preserves the source URL', () {
final result = span.subspan(1, 2);
expect(result.start.sourceUrl, equals(span.sourceUrl));
expect(result.end.sourceUrl, equals(span.sourceUrl));
});
group('returns the original span', () {
test('with an implicit end', () => expect(span.subspan(0), equals(span)));
test('with an explicit end',
() => expect(span.subspan(0, span.length), equals(span)));
});
group('within a single line', () {
test('returns a strict substring of the original span', () {
final result = span.subspan(1, 5);
expect(result.text, equals('oo b'));
expect(result.start.offset, equals(6));
expect(result.start.line, equals(0));
expect(result.start.column, equals(6));
expect(result.end.offset, equals(10));
expect(result.end.line, equals(0));
expect(result.end.column, equals(10));
});
test('an implicit end goes to the end of the original span', () {
final result = span.subspan(1);
expect(result.text, equals('oo bar'));
expect(result.start.offset, equals(6));
expect(result.start.line, equals(0));
expect(result.start.column, equals(6));
expect(result.end.offset, equals(12));
expect(result.end.line, equals(0));
expect(result.end.column, equals(12));
});
test('can return an empty span', () {
final result = span.subspan(3, 3);
expect(result.text, isEmpty);
expect(result.start.offset, equals(8));
expect(result.start.line, equals(0));
expect(result.start.column, equals(8));
expect(result.end, equals(result.start));
});
});
group('across multiple lines', () {
setUp(() {
span = SourceSpan(
SourceLocation(5, line: 2, column: 0),
SourceLocation(16, line: 4, column: 3),
'foo\n'
'bar\n'
'baz');
});
test('with start and end in the middle of a line', () {
final result = span.subspan(2, 5);
expect(result.text, equals('o\nb'));
expect(result.start.offset, equals(7));
expect(result.start.line, equals(2));
expect(result.start.column, equals(2));
expect(result.end.offset, equals(10));
expect(result.end.line, equals(3));
expect(result.end.column, equals(1));
});
test('with start at the end of a line', () {
final result = span.subspan(3, 5);
expect(result.text, equals('\nb'));
expect(result.start.offset, equals(8));
expect(result.start.line, equals(2));
expect(result.start.column, equals(3));
});
test('with start at the beginning of a line', () {
final result = span.subspan(4, 5);
expect(result.text, equals('b'));
expect(result.start.offset, equals(9));
expect(result.start.line, equals(3));
expect(result.start.column, equals(0));
});
test('with end at the end of a line', () {
final result = span.subspan(2, 3);
expect(result.text, equals('o'));
expect(result.end.offset, equals(8));
expect(result.end.line, equals(2));
expect(result.end.column, equals(3));
});
test('with end at the beginning of a line', () {
final result = span.subspan(2, 4);
expect(result.text, equals('o\n'));
expect(result.end.offset, equals(9));
expect(result.end.line, equals(3));
expect(result.end.column, equals(0));
});
});
});
group('message()', () {
test('prints the text being described', () {
expect(span.message('oh no'), equals("""
line 1, column 6 of foo.dart: oh no
,
1 | foo bar
| ^^^^^^^
'"""));
});
test('gracefully handles a missing source URL', () {
final span = SourceSpan(SourceLocation(5), SourceLocation(12), 'foo bar');
expect(span.message('oh no'), equalsIgnoringWhitespace("""
line 1, column 6: oh no
,
1 | foo bar
| ^^^^^^^
'"""));
});
test('gracefully handles empty text', () {
final span = SourceSpan(SourceLocation(5), SourceLocation(5), '');
expect(span.message('oh no'), equals('line 1, column 6: oh no'));
});
test("doesn't colorize if color is false", () {
expect(span.message('oh no', color: false), equals("""
line 1, column 6 of foo.dart: oh no
,
1 | foo bar
| ^^^^^^^
'"""));
});
test('colorizes if color is true', () {
expect(span.message('oh no', color: true), equals("""
line 1, column 6 of foo.dart: oh no
${colors.blue} ,${colors.none}
${colors.blue}1 |${colors.none} ${colors.red}foo bar${colors.none}
${colors.blue} |${colors.none} ${colors.red}^^^^^^^${colors.none}
${colors.blue} '${colors.none}"""));
});
test("uses the given color if it's passed", () {
expect(span.message('oh no', color: colors.yellow), equals("""
line 1, column 6 of foo.dart: oh no
${colors.blue} ,${colors.none}
${colors.blue}1 |${colors.none} ${colors.yellow}foo bar${colors.none}
${colors.blue} |${colors.none} ${colors.yellow}^^^^^^^${colors.none}
${colors.blue} '${colors.none}"""));
});
test('with context, underlines the right column', () {
final spanWithContext = SourceSpanWithContext(
SourceLocation(5, sourceUrl: 'foo.dart'),
SourceLocation(12, sourceUrl: 'foo.dart'),
'foo bar',
'-----foo bar-----');
expect(spanWithContext.message('oh no', color: colors.yellow), equals("""
line 1, column 6 of foo.dart: oh no
${colors.blue} ,${colors.none}
${colors.blue}1 |${colors.none} -----${colors.yellow}foo bar${colors.none}-----
${colors.blue} |${colors.none} ${colors.yellow} ^^^^^^^${colors.none}
${colors.blue} '${colors.none}"""));
});
});
group('compareTo()', () {
test('sorts by start location first', () {
final other = SourceSpan(SourceLocation(6, sourceUrl: 'foo.dart'),
SourceLocation(14, sourceUrl: 'foo.dart'), 'oo bar b');
expect(span.compareTo(other), lessThan(0));
expect(other.compareTo(span), greaterThan(0));
});
test('sorts by length second', () {
final other = SourceSpan(SourceLocation(5, sourceUrl: 'foo.dart'),
SourceLocation(14, sourceUrl: 'foo.dart'), 'foo bar b');
expect(span.compareTo(other), lessThan(0));
expect(other.compareTo(span), greaterThan(0));
});
test('considers equal spans equal', () {
expect(span.compareTo(span), equals(0));
});
});
group('equality', () {
test('two spans with the same locations are equal', () {
final other = SourceSpan(SourceLocation(5, sourceUrl: 'foo.dart'),
SourceLocation(12, sourceUrl: 'foo.dart'), 'foo bar');
expect(span, equals(other));
});
test("a different start isn't equal", () {
final other = SourceSpan(SourceLocation(0, sourceUrl: 'foo.dart'),
SourceLocation(12, sourceUrl: 'foo.dart'), 'hey, foo bar');
expect(span, isNot(equals(other)));
});
test("a different end isn't equal", () {
final other = SourceSpan(SourceLocation(5, sourceUrl: 'foo.dart'),
SourceLocation(16, sourceUrl: 'foo.dart'), 'foo bar baz');
expect(span, isNot(equals(other)));
});
test("a different source URL isn't equal", () {
final other = SourceSpan(SourceLocation(5, sourceUrl: 'bar.dart'),
SourceLocation(12, sourceUrl: 'bar.dart'), 'foo bar');
expect(span, isNot(equals(other)));
});
});
}