Implement mix profile.tprof

[sabiwara]

Close #13581

Sharing my draft for feedback as I think the implementation is now done - I still need to do the moduledocs.

I used profile.eprof as a base, since these are actually quite close.
Reviewing this commit Actually implement tprof might help the review since it highlights the differences.

Sample outputs

mix profile.tprof -e "Enum.each(1..5, &String.Chars.Integer.to_string/1)"
Warmup...


Profile results of #PID<0.107.0>
#                                               CALLS      % TIME µS/CALL
Total                                              20 100.00    2    0.10
String.Chars.Integer.to_string/1                    5   0.00    0    0.00
anonymous fn/0 in :elixir_compiler_1.__FILE__/1     1   0.00    0    0.00
Enum.each/2                                         1   0.00    0    0.00
Enum.reduce_range/5                                 3   0.00    0    0.00
:erlang.integer_to_binary/1                         5  50.00    1    0.20
anonymous fn/3 in Enum.each/2                       5  50.00    1    0.20

Profile done over 6 matching functions

mix profile.tprof -e "Enum.each(1..5, &String.Chars.Integer.to_string/1)" --type memory
Warmup...


Profile results of #PID<0.107.0>
#                           CALLS      % WORDS PER CALL
Total                           6 100.00    19     3.17
Enum.each/2                     1  21.05     4     4.00
:erlang.integer_to_binary/1     5  78.95    15     3.00

Profile done over 2 matching functions

mix profile.tprof -e "Enum.each(1..5, &String.Chars.Integer.to_string/1)" --type calls
Warmup...


Profile results over all processes
#                                               CALLS      %
Total                                              20 100.00
anonymous fn/0 in :elixir_compiler_1.__FILE__/1     1   5.00
Enum.each/2                                         1   5.00
Enum.reduce_range/5                                 3  15.00
:erlang.integer_to_binary/1                         5  25.00
String.Chars.Integer.to_string/1                    5  25.00
anonymous fn/3 in Enum.each/2                       5  25.00

Profile done over 6 matching functions

mix profile.tprof -e "Enum.each(1..5, &String.Chars.Integer.to_string/1)" --type calls --sort time
Warmup...

** (Mix) Incompatible sort option `time` with type `calls`

[josevalim]

Suggested change

	scenario or focus on the main modules or processes. Another alternative is to use
	`Mix.Tasks.Profile.Cprof` that uses [`:cprof`](`:cprof`) and has a low performance degradation effect.
	scenario or focus on the main modules or processes.

This is pretty much the same as cprof (which will be deprecated in the future anyway).

[sabiwara]

Yes sorry as I mentioned in the description I should still rewrite the bulk of the moduledoc, it's still mostly eprof's 😅

[josevalim]

I don't think we need to start and stop it, do we?

[sabiwara]

You're right we don't 27e56dc

[josevalim]

We don't use backticks in Elixir error messages. Perhaps #{inspect(type)} is enough?

[sabiwara]

Sounds much better indeed. I needed some kind of visual distinction to keep readability but atom notation feels much more natural.

[sabiwara]

27e56dc

[josevalim]

Beautifully done!

[sabiwara]

OK I think we should now be good. Updated the moduledoc adf24b6.
Reused some of the wording from the original doc:

[josevalim]

The whole doc looked good to me before and it still looks good to me now :D