Swiftpack.co - Package - llvm-swift/PrettyStackTrace


PrettyStackTrace allows Swift command-line programs to print a trace of execution behaviors when a terminating signal is raised, such as a fatal error.

To use it, wrap your actions in a call to trace(_:). This will register an entry in the stack trace and (if your process fatal errors) will print breadcrumbs to stderr describing what was going on when you crashed.


PrettyStackTrace is available from the Swift package manager. Add

.package(url: "https://github.com/llvm-swift/PrettyStackTrace.git", from: "0.0.1")

to your Package.swift file to use it.


trace("doing first task") {
  print("I'm doing the first task!")
  trace("doing second task") {
    print("I'm doing the second task!")
    fatalError("error on second task!")

This will output:

I'm doing the first task!
I'm doing the second task!
Fatal error: error on second task
Stack dump:
-> While doing second task (func main(), in file file.swift, on line 3)
-> While doing first task (func main(), in file file.swift, on line 1)


Harlan Haskins (@harlanhaskins)

Robert Widmann (@CodaFi)


PrettyStackTrace is released under the MIT license, a copy of which is available in this repository.


Stars: 42
Help us keep the lights on


0.0.7 - Jun 17, 2019

  • Update SwiftPM dependency

0.0.6 - Mar 18, 2019

Update to Swift 4.2

0.0.5 - Apr 12, 2018

Update to Swift 4.1

0.0.4 - Feb 22, 2018

0.0.1 - Jan 12, 2018