source_span is a library for tracking locations in source code. It's designed
to provide a standard representation for source code locations and spans so that
disparate packages can easily pass them among one another, and to make it easy
to generate human-friendly messages associated with a given piece of code.
The most commonly-used class is the package's namesake,
represents a span of characters in some source file, and is often attached to an
object that has been parsed to indicate where it was parsed from. It provides
access to the text of the span via
SourceSpan.text and can be used to produce
human-friendly messages using
When parsing code from a file,
SourceFile is useful. Not only does it provide
an efficient means of computing line and column numbers,
FileSpans that are able to provide more context for their
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
constructor (see below) should be used instead.
new SourceFile.fromString() constructor was added. This works like
SourceFile(), except it uses code units rather than runes.
The current behavior when characters larger than
0xFFFF are passed to
SourceFile.decoded() is now considered deprecated.
SourceSpan.highlight(), which returns just the highlighted text that would be included in
SourceSpanWithContext.contextto be overridden in strong mode.
FileSpan.end. In 1.2.0 these were mistakenly changed from
SourceLocation directly is deprecated. Instead,
extend the new
SourceLocationBase class or mix in the new
Dramatically improve the performance of
SourceFilewhen repeatedly called.
FileSpan.unioncould throw an exception for external implementations of
==, but not
no longer throw exceptions for external implementations of
FileSpan.hashCode now fully agrees with
SourceSpanWithContextto allow multiple occurrences of
FileSpan's context to include the full span text, not just the first line of it.
SourceSpanWithContext: a span that also includes the full line of text that contains the span.
Avoid unintentionally allocating extra objects for internal
SourceSpan.operator== works on arbitrary
This package was extracted from the
source_maps package, but the
API has many differences. Among them:
Span has been renamed to
Location has been renamed to
SourceLocation to clarify their purpose and maintain consistency with the
package name. Likewise,
SpanException is now
SpanFormatException is not
FixedLocation have been rolled into the
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
Uri objects rather than
Strings. The constructors allow either
SourceFile.getLocationMessage are now
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
Add this to your package's pubspec.yaml file:
dependencies: source_span: "^1.4.0"
You can install packages from the command line:
$ pub get
Alternatively, your editor might support 'pub get'. Check the docs for your editor to learn more.
Now in your Dart code, you can use:
|1.4.0||May 17, 2017||Go to the documentation of source_span 1.4.0||Download source_span 1.4.0 archive|
|1.3.1||Jan 7, 2017||Go to the documentation of source_span 1.3.1||Download source_span 1.3.1 archive|
|1.3.0||Nov 8, 2016||Go to the documentation of source_span 1.3.0||Download source_span 1.3.0 archive|
|1.2.4||Oct 21, 2016||Go to the documentation of source_span 1.2.4||Download source_span 1.2.4 archive|
|1.2.3||Jun 9, 2016||Go to the documentation of source_span 1.2.3||Download source_span 1.2.3 archive|
|1.2.2||Mar 2, 2016||Go to the documentation of source_span 1.2.2||Download source_span 1.2.2 archive|
|1.2.1||Sep 30, 2015||Go to the documentation of source_span 1.2.1||Download source_span 1.2.1 archive|
|1.2.0||Sep 2, 2015||Go to the documentation of source_span 1.2.0||Download source_span 1.2.0 archive|
|1.1.6||Sep 2, 2015||Go to the documentation of source_span 1.1.6||Download source_span 1.1.6 archive|
|1.1.5||Sep 1, 2015||Go to the documentation of source_span 1.1.5||Download source_span 1.1.5 archive|