1.4.0

• The new SourceFile() constructor is deprecated. This constructed a source file from a string's runes, rather than its code units, which runs counter to the way Dart handles strings otherwise. The new StringFile.fromString() constructor (see below) should be used instead.

• The new SourceFile.fromString() constructor was added. This works like new SourceFile(), except it uses code units rather than runes.

• The current behavior when characters larger than 0xFFFF are passed to new SourceFile.decoded() is now considered deprecated.

1.3.1

• Properly highlight spans for lines that include tabs with SourceSpan.highlight() and SourceSpan.message().

1.3.0

• Add SourceSpan.highlight(), which returns just the highlighted text that would be included in SourceSpan.message().

1.2.4

• Fix a new strong mode error.

1.2.3

• Fix a bug where a point span at the end of a file without a trailing newline would be printed incorrectly.

1.2.2

• Allow SourceSpanException.message, SourceSpanFormatException.source, and SourceSpanWithContext.context to be overridden in strong mode.

1.2.1

• Fix the declared type of FileSpan.start and FileSpan.end. In 1.2.0 these were mistakenly changed from FileLocation to SourceLocation.

1.2.0

• Deprecated: Extending SourceLocation directly is deprecated. Instead, extend the new SourceLocationBase class or mix in the new SourceLocationMixin mixin.

• Dramatically improve the performance of FileLocation.

1.1.6

• Optimize getLine() in SourceFile when repeatedly called.

1.1.5

• Fixed another case in which FileSpan.union could throw an exception for external implementations of FileSpan.

1.1.4

• Eliminated dart2js warning about overriding ==, but not hashCode.

1.1.3

• FileSpan.compareTo, FileSpan.==, FileSpan.union, and FileSpan.expand no longer throw exceptions for external implementations of FileSpan.

• FileSpan.hashCode now fully agrees with FileSpan.==.

1.1.2

• Fixed validation in SourceSpanWithContext to allow multiple occurrences of text within context.

1.1.1

• Fixed FileSpan's context to include the full span text, not just the first line of it.

1.1.0

• Added SourceSpanWithContext: a span that also includes the full line of text that contains the span.

1.0.3

• Cleanup equality operator to accept any Object rather than just a SourceLocation.

1.0.2

• Avoid unintentionally allocating extra objects for internal FileSpan operations.

• Ensure that SourceSpan.operator== works on arbitrary Objects.

1.0.1

• Use a more compact internal representation for FileSpan.

1.0.0

This package was extracted from the source_maps package, but the API has many differences. Among them:

• Span has been renamed to SourceSpan and Location has been renamed to SourceLocation to clarify their purpose and maintain consistency with the package name. Likewise, SpanException is now SourceSpanException and SpanFormatException is not SourceSpanFormatException.

• FixedSpan and FixedLocation have been rolled into the Span and Location classes, respectively.

• SourceFile is more aggressive about validating its arguments. Out-of-bounds lines, columns, and offsets will now throw errors rather than be silently clamped.

• SourceSpan.sourceUrl, SourceLocation.sourceUrl, and SourceFile.url now return Uri objects rather than Strings. The constructors allow either Strings or Uris.

• Span.getLocationMessage and SourceFile.getLocationMessage are now SourceSpan.message and SourceFile.message, respectively. Rather than taking both a useColor and a color parameter, they now take a single color parameter that controls both whether and which color is used.

• Span.isIdentifier has been removed. This property doesn't make sense outside of a source map context.

• SourceFileSegment has been removed. This class wasn't widely used and was inconsistent in its choice of which parameters were considered relative and which absolute.

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:

dependencies:
  source_span: "^1.4.0"

2. Install it

You can install packages from the command line:

with pub:

$ pub get

with Flutter:

$ flutter packages get

Alternatively, your editor might support pub get or flutter packages get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

      import 'package:source_span/source_span.dart';
  

Version	Uploaded	Documentation	Archive
1.4.0	May 17, 2017
1.3.1	Jan 7, 2017
1.3.0	Nov 8, 2016
1.2.4	Oct 21, 2016
1.2.3	Jun 9, 2016
1.2.2	Mar 2, 2016
1.2.1	Sep 30, 2015
1.2.0	Sep 2, 2015
1.1.6	Sep 2, 2015
1.1.5	Sep 1, 2015

All 18 versions...

Analysis

We analyzed this package on Jun 12, 2018, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

• Dart: 2.0.0-dev.60.0
• pana: 0.11.3

Scores

Platforms

Detected platforms: Flutter, web, other

No platform restriction found in primary library package:source_span/source_span.dart.

Suggestions

• Package is getting outdated.

  The package was released 55 weeks ago.

• The description is too short.

  Add more detail about the package, what it does and what is its target use case. Try to write at least 60 characters.

• Fix analysis and formatting issues.

  Analysis or formatting checks reported 6 hints.

  Run dartfmt to format lib/src/colors.dart.

  Run dartfmt to format lib/src/file.dart.

  Similar analysis of the following files failed:

  • lib/src/location.dart (hint)
  • lib/src/location_mixin.dart (hint)
  • lib/src/span_mixin.dart (hint)
  • lib/src/span_with_context.dart (hint)

• Maintain an example.

  Create a short demo in the example/ directory to show how to use this package. Common file name patterns include: main.dart, example.dart or you could also use source_span.dart.

• Use analysis_options.yaml.

  Rename old .analysis_options file to analysis_options.yaml.

Dependencies