// 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:source_span/source_span.dart'; import 'package:source_span/src/colors.dart' as colors; import 'package:term_glyph/term_glyph.dart' as glyph; import 'package:test/test.dart'; 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)); }); test('preserves the context', () { final start = SourceLocation(2); final end = SourceLocation(5); final span = SourceSpanWithContext(start, end, 'abc', '--abc--'); expect(span.subspan(1, 2).context, equals('--abc--')); }); 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))); }); }); }