Add debug file dump

[piohei]

Motivation

It could be very helpful to be able to dump to a JSON file whole debugger context: calls, source code, refs, etc. It would allow then to do a post processing like for example creating heatmap for most costly lines in terms of gas usage.

Closes #7364
Closes #7112

Solution

New --dump param is being added to forge debug and forge test --debug commands. It requires a path to file where to dump data and passing --debug flag same time. Debugger code is refactored to create abstraction over it. It is then used by two different presenters: TUI (interactive debugger) and file dumper. I also added to debugger data original path for the source file to allow figuring out where to make changes when debugging.

[onbjerg]

i am not too sure i am fond of this approach, ideally we'd move away from allocating a big chunk of memory for the debugger, i.e. ideally we'd move away from record/replay

[piohei]

Thanks for comment! Do you find the idea of changing record/replay approach as a new feature request or a blocker for that functionality? This record/replay could be also run only for the dumping or dump can be created on the fly and written to file. The main idea is to be able to use that output for post processing things. Other approach could be to create a plugin system and move things like that out of the core of foundry. What do you think?

[onbjerg]

hmm, thinking about this more, I think this is ok. if/when we move away from record/replay we can always change this as well

would like input from @DaniPopes iirc there are some coming changes to the debugger?

[onbjerg]

ping @DaniPopes

[DaniPopes]

Makes sense

would like input from @DaniPopes iirc there are some coming changes to the debugger?

No

[piohei]

Just fixed tests (clippy + fmt)

[piohei]

Fixed (again) - now using proper rust version locally. I don't know if this is intentional or not but in Cargo.toml there is rust-version = "1.76" while CI is using nightly version.

[piohei]

Any chances for merging this one? :) I don't want to mix same code and I could then work on fixing this #7292.

[mattsse]

very sorry about this @piohei

this now has a few conflicts that must be resolved first, still supportive of that feature

[piohei]

No problem. I will fix them. :)

[zerosnacks]

Hi @piohei thanks for your PR! Would you mind updating the PR to resolve the merge conflicts? Looks like there is consensus on the feature and the approach so it would be great to get this merged

[piohei]

Hi @zerosnacks! Sorry for late response. I will try to find some time to resolve conflicts here and prepare it to merge.

[zerosnacks]

Hi @zerosnacks! Sorry for late response. I will try to find some time to resolve conflicts here and prepare it to merge.

No problem! Thanks!

[zerosnacks]

Just so I understand correctly, would this supersede #7135?

I quite like the idea of having a keybinding that would trigger the dump to disk from inside of the debugger so you can decide on-the-fly too