Make LexemeSequence CustomDebugStringConvertible

Author: ahoppen

Sources/SwiftParser/Lexer.swift

@@ -87,7 +87,7 @@ public struct Lexer {
 extension Lexer {
   /// A sequence of ``Lexer/Lexeme`` tokens starting from a ``Lexer/Cursor``
   /// that points into an input buffer.
-  public struct LexemeSequence: IteratorProtocol, Sequence {
+  public struct LexemeSequence: IteratorProtocol, Sequence, CustomDebugStringConvertible {
     fileprivate let start: Lexer.Cursor
     fileprivate var cursor: Lexer.Cursor
     fileprivate var nextToken: Lexer.Lexeme
@@ -134,6 +134,10 @@ extension Lexer {
     func peek() -> Lexer.Lexeme {
       return self.nextToken
     }
+
+    public var debugDescription: String {
+      return self.nextToken.debugDescription + String(syntaxText: SyntaxText(baseAddress: self.cursor.input.baseAddress, count: self.cursor.input.count))
+    }
   }
 
   @_spi(RawSyntax)

Sources/SwiftParser/SwiftParser.docc/FixingBugs.md

@@ -4,7 +4,7 @@ Guide to write test cases in the parser’s test suite and how to debug failures
 
 The general approach to fixing bugs in the parser is to first write an automated test case that reproduces the test case in isolation. This allows you to invoke the parser with minimal dependencies and allows you to set breakpoints inside of it. 
 
-Once you’ve written a test case (see below), set a breakpoint in `Parser.parseSourceFile` and navigate the debugger to the place where the parser behaves unexpectedly. While the debugger is stopped at an instance function in <doc:SwiftParser/Parser>, `po self.currentToken` can show you the next token that will be parsed.
+Once you’ve written a test case (see below), set a breakpoint in `Parser.parseSourceFile` and navigate the debugger to the place where the parser behaves unexpectedly. While the debugger is stopped at an instance function in <doc:SwiftParser/Parser>, `po self.currentToken` can show you the next token that will be parsed. `po self.lexemes` can show the next tokens that will be parsed.
 
 ## Round-Trip Failure or Parser Crash