benaadams/Ben.Demystifier
Ben.Demystifier
Ben.Demystifier is a .NET library that transforms raw stack traces into modern C# 7+ syntax. It reads compiler-generated frames produced by async methods, iterators, lambdas, local functions, and generic types, then rewrites them to match the original source code, making exception call stacks and debug output immediately readable.
The library resolves common compiler artifacts such as MoveNext frames back into their original async method or iterator names, shows declaring method names and ordinals for lambdas and local functions instead of generated identifiers, and displays resolved generic type parameters and value tuple syntax inside stack frames. It also includes parameter qualifiers like ref, in, and out along with return types in method signatures, and preserves original line numbers and file paths during transformation.
Under the hood, Ben.Demystifier processes stack traces through a pipeline of regex-based token matching, symbol-table resolution, and syntax rewriting, producing immutable output with preserved line numbers. It handles multiple stack trace entries in a single pass to minimise memory allocations. The library is available as a NuGet package and integrates directly into existing .NET debugging workflows.
Features
- Stack Trace Demystifiers - Reads raw .NET stack traces by translating compiler-generated frames into modern C# syntax.
- Async Frame Resolvers - Replaces compiler-generated MoveNext frames with original async method names.
- Stack Trace Debugging Workflows - Translates legacy stack trace formats into current language constructs for debugging.
- Async Stack Frame Resolvers - Replaces compiler-generated async frames with original method names for readable stack traces.
- Async Iterator Frame Resolvers - Replaces compiler-generated MoveNext frames with original async method or iterator names.
- Lambda Frame Resolvers - Shows declaring method and ordinal for lambdas instead of compiler-generated identifiers.
- Lambda Name Resolvers - Shows declaring method names and ordinals for lambdas instead of compiler-generated identifiers.
- C# - Rewrites compiler-generated method names into readable C# syntax for faster debugging.
- Error Message Interpretation Tools - Transforms cryptic exception call stacks into human-readable representations.
- Stack Frame Type Resolvers - Shows resolved generic parameters and value tuple syntax inside stack frames.
- Stack Trace Formatters - Transforms raw stack traces into modern C# 7+ syntax for clearer debugging.
- .NET Stack Trace Demystifiers - Transforms raw .NET stack traces into modern C# 7+ syntax by resolving compiler-generated frames.
- Stack Trace Generation - Produces a human-readable string from a demystified exception or current call stack.
- Stack Trace Readability Enhancers - Converts raw .NET stack traces into modern C# syntax for easier debugging.
- Stack Trace Syntax Rewriters - Applies rule-based substitution to convert old C# stack frame tokens into modern equivalents.
- Parameter Qualifier Displays - Includes parameter qualifiers like ref, in, and out along with return types in stack traces.
- Exception Handling - High-performance stack trace analysis and formatting.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
