Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/parroty/exprof
A simple code profiler for Elixir using eprof.
https://github.com/parroty/exprof
Last synced: 2 months ago
JSON representation
A simple code profiler for Elixir using eprof.
- Host: GitHub
- URL: https://github.com/parroty/exprof
- Owner: parroty
- License: mit
- Created: 2013-10-12T15:56:49.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2020-12-17T14:55:12.000Z (about 4 years ago)
- Last Synced: 2024-10-02T06:50:44.638Z (3 months ago)
- Language: Elixir
- Homepage:
- Size: 41 KB
- Stars: 179
- Watchers: 1
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- freaking_awesome_elixir - Elixir - A simple code profiler for Elixir, using eprof. (Code Analysis)
- fucking-awesome-elixir - exprof - A simple code profiler for Elixir, using eprof. (Code Analysis)
- awesome-elixir - exprof - A simple code profiler for Elixir, using eprof. (Code Analysis)
README
ExProf
============
[](https://github.com/parroty/exprof/actions)
[](https://hex.pm/packages/exprof)
[](https://hex.pm/packages/exprof)
A simple code profiler for Elixir using eprof.
It provides a simple macro as a wrapper for Erlang's :eprof profiler.
### Install
Add `:exprof` to `deps` section of `mix.exs`.
```elixir
def deps do
[ {:exprof, "~> 0.2.0"} ]
end
```
### Usage
import "ExProf.Macro", then use "profile" macro to start profiling. It
prints out results, and returns them as list of records, along with the
result of the profiled block.
```elixir
defmodule SampleRunner do
import ExProf.Macro
@doc "analyze with profile macro"
def do_analyze do
profile do
:timer.sleep 2000
IO.puts "message\n"
end
end
@doc "get analysis records and sum them up"
def run do
{records, _block_result} = do_analyze
total_percent = Enum.reduce(records, 0.0, &(&1.percent + &2))
IO.inspect "total = #{total_percent}"
end
end
```
### Run
An example to use in iex console.
```elixir
$ iex -S mix
..
iex(1)> SampleRunner.run
message
FUNCTION CALLS % TIME [uS / CALLS]
-------- ----- --- ---- [----------]
'Elixir.IO':puts/2 1 0.86 1 [ 1.00]
io:o_request/3 1 1.72 2 [ 2.00]
io:put_chars/2 1 1.72 2 [ 2.00]
erlang:group_leader/0 1 1.72 2 [ 2.00]
io:request/2 1 2.59 3 [ 3.00]
io:execute_request/2 1 2.59 3 [ 3.00]
'Elixir.SampleRunner':'-run/0-fun-0-'/0 1 2.59 3 [ 3.00]
'Elixir.IO':map_dev/1 1 3.45 4 [ 4.00]
erlang:demonitor/2 1 4.31 5 [ 5.00]
io:io_request/2 1 6.03 7 [ 7.00]
io:wait_io_mon_reply/2 1 6.90 8 [ 8.00]
'Elixir.IO':puts/1 1 8.62 10 [ 10.00]
unicode:characters_to_binary/2 1 11.21 13 [ 13.00]
timer:sleep/1 1 14.66 17 [ 17.00]
erlang:monitor/2 1 31.03 36 [ 36.00]
"total = 100.0"
```
### Add a Mix Task
An example to use as mix tasks.
```elixir
defmodule Mix.Tasks.Exprof do
@shortdoc "Profile using ExProf"
use Mix.Task
import ExProf.Macro
def run(_mix_args) do
profile do: do_work(2)
end
defp do_work(n) do
:timer.sleep(n * 1000)
end
end
```