profiler-md 0.6.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/index.mjs +12685 -4219
- package/dist/index.d.mts +1140 -432
- package/dist/index.js +2 -2
- package/docs/api.md +138 -0
- package/docs/formats/callgrind.md +25 -0
- package/docs/formats/collapsed.md +5 -3
- package/docs/formats/ghc-eventlog.md +20 -0
- package/docs/formats/ghc-json-profile.md +23 -0
- package/docs/formats/hprof.md +21 -0
- package/docs/formats/jfr.md +2 -2
- package/docs/formats/jsc-heap-snapshot.md +10 -4
- package/docs/formats/memray.md +30 -0
- package/docs/formats/perf.md +74 -0
- package/docs/formats/pprof.md +4 -2
- package/docs/formats/speedscope.md +3 -2
- package/docs/formats/systing.md +17 -15
- package/docs/formats/v8-cpu-profile.md +4 -3
- package/docs/formats/v8-heap-profile.md +8 -5
- package/docs/formats/v8-heap-snapshot.md +8 -3
- package/docs/formats/webkit-timeline-recording.md +6 -0
- package/docs/languages/c.md +119 -32
- package/docs/languages/csharp.md +5 -3
- package/docs/languages/elixir.md +19 -11
- package/docs/languages/fortran.md +141 -0
- package/docs/languages/go.md +33 -10
- package/docs/languages/haskell.md +134 -0
- package/docs/languages/java.md +81 -26
- package/docs/languages/javascript.md +33 -27
- package/docs/languages/julia.md +21 -18
- package/docs/languages/php.md +7 -0
- package/docs/languages/python.md +105 -14
- package/docs/languages/ruby.md +15 -16
- package/docs/languages/rust.md +11 -10
- package/docs/languages/swift.md +135 -0
- package/docs/languages/zig.md +155 -0
- package/package.json +42 -42
- package/readme.md +301 -259
- package/skills/profile-optimize/SKILL.md +4 -2
- package/examples/output/c.gperftools.cpu.base.pprof.md +0 -324
- package/examples/output/c.gperftools.cpu.current.pprof.md +0 -271
- package/examples/output/c.gperftools.cpu.diff.pprof.md +0 -98
- package/examples/output/c.gperftools.heap.base.pprof.md +0 -362
- package/examples/output/c.gperftools.heap.current.pprof.md +0 -362
- package/examples/output/c.gperftools.heap.diff.pprof.md +0 -28
- package/examples/output/c.systing.cpu.base.systing.md +0 -824
- package/examples/output/c.systing.cpu.current.systing.md +0 -825
- package/examples/output/c.systing.cpu.diff.systing.md +0 -238
- package/examples/output/cpp.gperftools.cpu.base.pprof.md +0 -557
- package/examples/output/cpp.gperftools.cpu.current.pprof.md +0 -573
- package/examples/output/cpp.gperftools.cpu.diff.pprof.md +0 -122
- package/examples/output/cpp.gperftools.heap.base.pprof.md +0 -67
- package/examples/output/cpp.gperftools.heap.current.pprof.md +0 -67
- package/examples/output/cpp.gperftools.heap.diff.pprof.md +0 -19
- package/examples/output/csharp.dotnet-trace.base.speedscope.json.md +0 -411
- package/examples/output/csharp.dotnet-trace.current.speedscope.json.md +0 -412
- package/examples/output/csharp.dotnet-trace.diff.speedscope.json.md +0 -122
- package/examples/output/elixir.eflambe.cpu.base.collapsed.md +0 -399
- package/examples/output/elixir.eflambe.cpu.current.collapsed.md +0 -398
- package/examples/output/elixir.eflambe.cpu.diff.collapsed.md +0 -92
- package/examples/output/erlang.eflambe.cpu.base.collapsed.md +0 -147
- package/examples/output/erlang.eflambe.cpu.current.collapsed.md +0 -147
- package/examples/output/erlang.eflambe.cpu.diff.collapsed.md +0 -18
- package/examples/output/fsharp.dotnet-trace.base.speedscope.json.md +0 -324
- package/examples/output/fsharp.dotnet-trace.current.speedscope.json.md +0 -314
- package/examples/output/fsharp.dotnet-trace.diff.speedscope.json.md +0 -119
- package/examples/output/go.pprof.block.base.pprof.md +0 -86
- package/examples/output/go.pprof.block.current.pprof.md +0 -83
- package/examples/output/go.pprof.block.diff.pprof.md +0 -42
- package/examples/output/go.pprof.cpu.base.pprof.md +0 -81
- package/examples/output/go.pprof.cpu.current.pprof.md +0 -70
- package/examples/output/go.pprof.cpu.diff.pprof.md +0 -52
- package/examples/output/go.pprof.goroutine.base.pprof.md +0 -43
- package/examples/output/go.pprof.goroutine.current.pprof.md +0 -43
- package/examples/output/go.pprof.goroutine.diff.pprof.md +0 -13
- package/examples/output/go.pprof.heap-alloc.base.pprof.md +0 -154
- package/examples/output/go.pprof.heap-alloc.current.pprof.md +0 -146
- package/examples/output/go.pprof.heap-alloc.diff.pprof.md +0 -67
- package/examples/output/go.pprof.heap.base.pprof.md +0 -154
- package/examples/output/go.pprof.heap.current.pprof.md +0 -146
- package/examples/output/go.pprof.heap.diff.pprof.md +0 -67
- package/examples/output/go.pprof.mutex.base.pprof.md +0 -55
- package/examples/output/go.pprof.mutex.current.pprof.md +0 -41
- package/examples/output/go.pprof.mutex.diff.pprof.md +0 -31
- package/examples/output/go.pprof.threadcreate.base.pprof.md +0 -55
- package/examples/output/go.pprof.threadcreate.current.pprof.md +0 -55
- package/examples/output/go.pprof.threadcreate.diff.pprof.md +0 -19
- package/examples/output/java.async-profiler.all.base.jfr.md +0 -1071
- package/examples/output/java.async-profiler.all.current.jfr.md +0 -1007
- package/examples/output/java.async-profiler.all.diff.jfr.md +0 -268
- package/examples/output/java.async-profiler.alloc.base.jfr.md +0 -425
- package/examples/output/java.async-profiler.alloc.current.jfr.md +0 -413
- package/examples/output/java.async-profiler.alloc.diff.jfr.md +0 -99
- package/examples/output/java.async-profiler.cpu.base.collapsed.md +0 -367
- package/examples/output/java.async-profiler.cpu.base.jfr.md +0 -485
- package/examples/output/java.async-profiler.cpu.current.collapsed.md +0 -355
- package/examples/output/java.async-profiler.cpu.current.jfr.md +0 -488
- package/examples/output/java.async-profiler.cpu.diff.collapsed.md +0 -117
- package/examples/output/java.async-profiler.cpu.diff.jfr.md +0 -118
- package/examples/output/java.async-profiler.live.base.jfr.md +0 -697
- package/examples/output/java.async-profiler.live.current.jfr.md +0 -684
- package/examples/output/java.async-profiler.live.diff.jfr.md +0 -191
- package/examples/output/java.async-profiler.lock.base.jfr.md +0 -140
- package/examples/output/java.async-profiler.lock.current.jfr.md +0 -108
- package/examples/output/java.async-profiler.lock.diff.jfr.md +0 -44
- package/examples/output/java.async-profiler.nativemem.base.jfr.md +0 -222
- package/examples/output/java.async-profiler.nativemem.current.jfr.md +0 -222
- package/examples/output/java.async-profiler.nativemem.diff.jfr.md +0 -65
- package/examples/output/java.async-profiler.wall.base.jfr.md +0 -400
- package/examples/output/java.async-profiler.wall.current.jfr.md +0 -420
- package/examples/output/java.async-profiler.wall.diff.jfr.md +0 -94
- package/examples/output/java.jdk.all.base.jfr.md +0 -1024
- package/examples/output/java.jdk.all.current.jfr.md +0 -1010
- package/examples/output/java.jdk.all.diff.jfr.md +0 -311
- package/examples/output/java.jdk.alloc.base.jfr.md +0 -1024
- package/examples/output/java.jdk.alloc.current.jfr.md +0 -1046
- package/examples/output/java.jdk.alloc.diff.jfr.md +0 -312
- package/examples/output/java.jdk.cpu.base.jfr.md +0 -1023
- package/examples/output/java.jdk.cpu.current.jfr.md +0 -1039
- package/examples/output/java.jdk.cpu.diff.jfr.md +0 -285
- package/examples/output/java.jdk.live.base.jfr.md +0 -1029
- package/examples/output/java.jdk.live.current.jfr.md +0 -1035
- package/examples/output/java.jdk.live.diff.jfr.md +0 -289
- package/examples/output/java.jdk.lock.base.jfr.md +0 -1040
- package/examples/output/java.jdk.lock.current.jfr.md +0 -1051
- package/examples/output/java.jdk.lock.diff.jfr.md +0 -339
- package/examples/output/javascript.bun.base.cpuprofile.md +0 -73
- package/examples/output/javascript.bun.base.heapsnapshot.md +0 -608
- package/examples/output/javascript.bun.base.jsc-heap-snapshot.json.md +0 -480
- package/examples/output/javascript.bun.current.cpuprofile.md +0 -73
- package/examples/output/javascript.bun.current.heapsnapshot.md +0 -608
- package/examples/output/javascript.bun.current.jsc-heap-snapshot.json.md +0 -480
- package/examples/output/javascript.bun.diff.cpuprofile.md +0 -54
- package/examples/output/javascript.bun.diff.heapsnapshot.md +0 -48
- package/examples/output/javascript.bun.diff.jsc-heap-snapshot.json.md +0 -62
- package/examples/output/javascript.chrome.base.cpuprofile.md +0 -163
- package/examples/output/javascript.chrome.base.heapprofile.md +0 -32
- package/examples/output/javascript.chrome.base.heapsnapshot.md +0 -649
- package/examples/output/javascript.chrome.current.cpuprofile.md +0 -149
- package/examples/output/javascript.chrome.current.heapprofile.md +0 -32
- package/examples/output/javascript.chrome.current.heapsnapshot.md +0 -647
- package/examples/output/javascript.chrome.diff.cpuprofile.md +0 -65
- package/examples/output/javascript.chrome.diff.heapprofile.md +0 -50
- package/examples/output/javascript.chrome.diff.heapsnapshot.md +0 -73
- package/examples/output/javascript.deno.base.cpuprofile.md +0 -122
- package/examples/output/javascript.deno.current.cpuprofile.md +0 -114
- package/examples/output/javascript.deno.diff.cpuprofile.md +0 -66
- package/examples/output/javascript.node.base.cpuprofile.md +0 -136
- package/examples/output/javascript.node.base.heapprofile.md +0 -56
- package/examples/output/javascript.node.base.heapsnapshot.md +0 -660
- package/examples/output/javascript.node.current.cpuprofile.md +0 -119
- package/examples/output/javascript.node.current.heapprofile.md +0 -52
- package/examples/output/javascript.node.current.heapsnapshot.md +0 -660
- package/examples/output/javascript.node.diff.cpuprofile.md +0 -70
- package/examples/output/javascript.node.diff.heapprofile.md +0 -34
- package/examples/output/javascript.node.diff.heapsnapshot.md +0 -39
- package/examples/output/javascript.pprof.cpu.base.pprof.md +0 -104
- package/examples/output/javascript.pprof.cpu.current.pprof.md +0 -120
- package/examples/output/javascript.pprof.cpu.diff.pprof.md +0 -63
- package/examples/output/javascript.pprof.heap.base.pprof.md +0 -86
- package/examples/output/javascript.pprof.heap.current.pprof.md +0 -57
- package/examples/output/javascript.pprof.heap.diff.pprof.md +0 -42
- package/examples/output/javascript.safari.base.webkit-timeline-recording.json.md +0 -388
- package/examples/output/javascript.safari.current.webkit-timeline-recording.json.md +0 -378
- package/examples/output/javascript.safari.diff.webkit-timeline-recording.json.md +0 -122
- package/examples/output/julia.pprof-jl.alloc.base.pprof.md +0 -124
- package/examples/output/julia.pprof-jl.alloc.current.pprof.md +0 -126
- package/examples/output/julia.pprof-jl.alloc.diff.pprof.md +0 -30
- package/examples/output/julia.pprof-jl.cpu.base.pprof.md +0 -177
- package/examples/output/julia.pprof-jl.cpu.current.pprof.md +0 -179
- package/examples/output/julia.pprof-jl.cpu.diff.pprof.md +0 -64
- package/examples/output/julia.pprof-jl.wall.base.pprof.md +0 -181
- package/examples/output/julia.pprof-jl.wall.current.pprof.md +0 -193
- package/examples/output/julia.pprof-jl.wall.diff.pprof.md +0 -64
- package/examples/output/julia.profile.base.heapsnapshot.md +0 -590
- package/examples/output/julia.profile.current.heapsnapshot.md +0 -590
- package/examples/output/julia.profile.diff.heapsnapshot.md +0 -288
- package/examples/output/kotlin.async-profiler.all.base.jfr.md +0 -920
- package/examples/output/kotlin.async-profiler.all.current.jfr.md +0 -925
- package/examples/output/kotlin.async-profiler.all.diff.jfr.md +0 -247
- package/examples/output/kotlin.async-profiler.alloc.base.jfr.md +0 -467
- package/examples/output/kotlin.async-profiler.alloc.current.jfr.md +0 -473
- package/examples/output/kotlin.async-profiler.alloc.diff.jfr.md +0 -122
- package/examples/output/kotlin.async-profiler.cpu.base.collapsed.md +0 -371
- package/examples/output/kotlin.async-profiler.cpu.base.jfr.md +0 -472
- package/examples/output/kotlin.async-profiler.cpu.current.collapsed.md +0 -370
- package/examples/output/kotlin.async-profiler.cpu.current.jfr.md +0 -445
- package/examples/output/kotlin.async-profiler.cpu.diff.collapsed.md +0 -124
- package/examples/output/kotlin.async-profiler.cpu.diff.jfr.md +0 -125
- package/examples/output/kotlin.async-profiler.live.base.jfr.md +0 -934
- package/examples/output/kotlin.async-profiler.live.current.jfr.md +0 -917
- package/examples/output/kotlin.async-profiler.live.diff.jfr.md +0 -245
- package/examples/output/kotlin.async-profiler.lock.base.jfr.md +0 -1
- package/examples/output/kotlin.async-profiler.lock.current.jfr.md +0 -1
- package/examples/output/kotlin.async-profiler.lock.diff.jfr.md +0 -1
- package/examples/output/kotlin.async-profiler.nativemem.base.jfr.md +0 -234
- package/examples/output/kotlin.async-profiler.nativemem.current.jfr.md +0 -234
- package/examples/output/kotlin.async-profiler.nativemem.diff.jfr.md +0 -65
- package/examples/output/kotlin.async-profiler.wall.base.jfr.md +0 -452
- package/examples/output/kotlin.async-profiler.wall.current.jfr.md +0 -457
- package/examples/output/kotlin.async-profiler.wall.diff.jfr.md +0 -125
- package/examples/output/kotlin.jdk.all.base.jfr.md +0 -1442
- package/examples/output/kotlin.jdk.all.current.jfr.md +0 -1343
- package/examples/output/kotlin.jdk.all.diff.jfr.md +0 -392
- package/examples/output/kotlin.jdk.alloc.base.jfr.md +0 -1418
- package/examples/output/kotlin.jdk.alloc.current.jfr.md +0 -1389
- package/examples/output/kotlin.jdk.alloc.diff.jfr.md +0 -383
- package/examples/output/kotlin.jdk.cpu.base.jfr.md +0 -1406
- package/examples/output/kotlin.jdk.cpu.current.jfr.md +0 -1374
- package/examples/output/kotlin.jdk.cpu.diff.jfr.md +0 -380
- package/examples/output/kotlin.jdk.live.base.jfr.md +0 -1378
- package/examples/output/kotlin.jdk.live.current.jfr.md +0 -1311
- package/examples/output/kotlin.jdk.live.diff.jfr.md +0 -381
- package/examples/output/kotlin.jdk.lock.base.jfr.md +0 -1427
- package/examples/output/kotlin.jdk.lock.current.jfr.md +0 -1374
- package/examples/output/kotlin.jdk.lock.diff.jfr.md +0 -386
- package/examples/output/php.excimer.wall.base.speedscope.json.md +0 -25
- package/examples/output/php.excimer.wall.current.speedscope.json.md +0 -25
- package/examples/output/php.excimer.wall.diff.speedscope.json.md +0 -29
- package/examples/output/python.py-spy.cpu.base.collapsed.md +0 -526
- package/examples/output/python.py-spy.cpu.base.speedscope.json.md +0 -37
- package/examples/output/python.py-spy.cpu.current.collapsed.md +0 -514
- package/examples/output/python.py-spy.cpu.current.speedscope.json.md +0 -37
- package/examples/output/python.py-spy.cpu.diff.collapsed.md +0 -122
- package/examples/output/python.py-spy.cpu.diff.speedscope.json.md +0 -31
- package/examples/output/python.py-spy.wall.base.collapsed.md +0 -527
- package/examples/output/python.py-spy.wall.current.collapsed.md +0 -518
- package/examples/output/python.py-spy.wall.diff.collapsed.md +0 -122
- package/examples/output/ruby.rbspy.cpu.base.collapsed.md +0 -90
- package/examples/output/ruby.rbspy.cpu.base.pprof.md +0 -105
- package/examples/output/ruby.rbspy.cpu.base.speedscope.json.md +0 -105
- package/examples/output/ruby.rbspy.cpu.current.collapsed.md +0 -90
- package/examples/output/ruby.rbspy.cpu.current.pprof.md +0 -115
- package/examples/output/ruby.rbspy.cpu.current.speedscope.json.md +0 -115
- package/examples/output/ruby.rbspy.cpu.diff.collapsed.md +0 -32
- package/examples/output/ruby.rbspy.cpu.diff.pprof.md +0 -44
- package/examples/output/ruby.rbspy.cpu.diff.speedscope.json.md +0 -44
- package/examples/output/rust.pprof-rs.cpu.base.pprof.md +0 -60
- package/examples/output/rust.pprof-rs.cpu.current.pprof.md +0 -60
- package/examples/output/rust.pprof-rs.cpu.diff.pprof.md +0 -24
package/docs/languages/ruby.md
CHANGED
|
@@ -6,35 +6,34 @@ Ruby profiling uses [rbspy](https://rbspy.github.io).
|
|
|
6
6
|
|
|
7
7
|
Periodically samples the call stack. Useful for finding CPU hot spots.
|
|
8
8
|
|
|
9
|
-
### CLI
|
|
10
|
-
|
|
11
9
|
```sh
|
|
12
10
|
# Profile a command (speedscope format)
|
|
13
|
-
rbspy record --format speedscope
|
|
11
|
+
rbspy record --format speedscope --file cpu.speedscope.json -- ruby script.rb
|
|
14
12
|
|
|
15
13
|
# Collapsed stacks
|
|
16
|
-
rbspy record --format collapsed
|
|
14
|
+
rbspy record --format collapsed --file cpu.collapsed -- ruby script.rb
|
|
17
15
|
|
|
18
16
|
# pprof
|
|
19
|
-
rbspy record --format pprof
|
|
17
|
+
rbspy record --format pprof --file cpu.pprof -- ruby script.rb
|
|
18
|
+
|
|
19
|
+
# Callgrind
|
|
20
|
+
rbspy record --format callgrind --file cpu.callgrind -- ruby script.rb
|
|
20
21
|
|
|
21
22
|
# Attach to a running process
|
|
22
|
-
rbspy record --format speedscope
|
|
23
|
+
rbspy record --format speedscope --file cpu.speedscope.json --pid <pid>
|
|
23
24
|
|
|
24
25
|
# Profile for a fixed duration
|
|
25
|
-
rbspy record --format speedscope
|
|
26
|
+
rbspy record --format speedscope --file cpu.speedscope.json --duration 30 --pid <pid>
|
|
26
27
|
|
|
27
28
|
# Profile including child processes
|
|
28
|
-
rbspy record --format speedscope
|
|
29
|
+
rbspy record --format speedscope --file cpu.speedscope.json --subprocesses --pid <pid>
|
|
29
30
|
```
|
|
30
31
|
|
|
31
|
-
##
|
|
32
|
+
## Call stack dump
|
|
32
33
|
|
|
33
34
|
Captures a single stack trace from a running process. Useful for quickly
|
|
34
35
|
checking what a process is executing without a full recording.
|
|
35
36
|
|
|
36
|
-
### CLI
|
|
37
|
-
|
|
38
37
|
```sh
|
|
39
38
|
rbspy snapshot --pid <pid>
|
|
40
39
|
|
|
@@ -42,14 +41,14 @@ rbspy snapshot --pid <pid>
|
|
|
42
41
|
rbspy snapshot --nonblocking --pid <pid>
|
|
43
42
|
```
|
|
44
43
|
|
|
45
|
-
## CLI flags
|
|
44
|
+
## rbspy CLI flags
|
|
46
45
|
|
|
47
46
|
| Flag | Default | Description |
|
|
48
47
|
| ------------------- | ------------ | ---------------------------------------------------------------------------------------------------------- |
|
|
49
48
|
| `-p` / `--pid` | — | PID of a running process to attach to |
|
|
50
|
-
| `-d` / `--duration` | — | Duration in seconds
|
|
51
|
-
| `-r` / `--rate` | `
|
|
52
|
-
| `-
|
|
53
|
-
| `-
|
|
49
|
+
| `-d` / `--duration` | — | Duration in seconds, recording until Ctrl-C if omitted |
|
|
50
|
+
| `-r` / `--rate` | `99` | Samples per second |
|
|
51
|
+
| `-o` / `--format` | `flamegraph` | Output format: `flamegraph`, `collapsed`, `pprof`, `speedscope`, `callgrind`, `summary`, `summary-by-line` |
|
|
52
|
+
| `-f` / `--file` | — | Output file path |
|
|
54
53
|
| `--subprocesses` | — | Also profile child processes |
|
|
55
54
|
| `--nonblocking` | — | Read the stack without pausing the process (lower overhead, may miss frames) |
|
package/docs/languages/rust.md
CHANGED
|
@@ -14,8 +14,8 @@ Add to `Cargo.toml`:
|
|
|
14
14
|
pprof = { version = "...", features = ["prost-codec", "frame-pointer"] }
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
The `frame-pointer` feature is required on macOS
|
|
18
|
-
crashes with SIGBUS
|
|
17
|
+
The `frame-pointer` feature is required on macOS, because the default stack
|
|
18
|
+
unwinder crashes with SIGBUS.
|
|
19
19
|
|
|
20
20
|
```rust
|
|
21
21
|
use pprof::protos::Message;
|
|
@@ -35,16 +35,17 @@ std::fs::write("cpu.pprof", &buf)?;
|
|
|
35
35
|
|
|
36
36
|
| Method | Default | Description |
|
|
37
37
|
| -------------------- | ------- | ---------------------------------------- |
|
|
38
|
-
| `.frequency(hz)` | `
|
|
38
|
+
| `.frequency(hz)` | `99` | Samples per second |
|
|
39
39
|
| `.blocklist(frames)` | `[]` | Stack frames to exclude from the profile |
|
|
40
40
|
|
|
41
41
|
## System profiling
|
|
42
42
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
and
|
|
46
|
-
|
|
47
|
-
|
|
43
|
+
Samples on-CPU stacks and records a stack each time a thread sleeps, across user
|
|
44
|
+
and kernel code. Useful for costs outside the process: off-CPU waits, syscall
|
|
45
|
+
time, and contention across the whole node.
|
|
46
|
+
|
|
47
|
+
[systing](https://github.com/josefbacik/systing) is a Linux eBPF profiler. It
|
|
48
|
+
needs root (BPF) and a kernel with BTF (`/sys/kernel/btf/vmlinux`).
|
|
48
49
|
|
|
49
50
|
```sh
|
|
50
51
|
# Record a command (and its children) for 30 seconds
|
|
@@ -55,8 +56,8 @@ sudo systing --duration 30 --output profile.systing -- ./target/release/program
|
|
|
55
56
|
|
|
56
57
|
### Frame pointers
|
|
57
58
|
|
|
58
|
-
|
|
59
|
-
|
|
59
|
+
A frame-pointer unwinder needs frame pointers, which Cargo release builds omit
|
|
60
|
+
by default. Force them on:
|
|
60
61
|
|
|
61
62
|
```sh
|
|
62
63
|
RUSTFLAGS="-C force-frame-pointers=yes" cargo build ...
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
# Swift
|
|
2
|
+
|
|
3
|
+
Swift profiling on Linux uses
|
|
4
|
+
[gperftools](https://github.com/gperftools/gperftools), whose CPU profiler and
|
|
5
|
+
tcmalloc heap profiler attach to any dynamically linked native program. Swift
|
|
6
|
+
allocates class instances and buffers through `malloc`, so tcmalloc records
|
|
7
|
+
them.
|
|
8
|
+
|
|
9
|
+
## CPU profiling
|
|
10
|
+
|
|
11
|
+
Periodically samples the call stack. Useful for finding CPU hot spots.
|
|
12
|
+
|
|
13
|
+
Build with debug info so frames resolve to source files and lines, and link
|
|
14
|
+
`-lprofiler` with `--as-needed` disabled, because the linker would otherwise
|
|
15
|
+
drop a library the program references no symbol from:
|
|
16
|
+
|
|
17
|
+
```sh
|
|
18
|
+
# A single file
|
|
19
|
+
swiftc -O -g program.swift -o program -Xlinker --no-as-needed -Xlinker -lprofiler
|
|
20
|
+
|
|
21
|
+
# A SwiftPM package
|
|
22
|
+
swift build -c release -Xswiftc -g -Xlinker --no-as-needed -Xlinker -lprofiler
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### CLI
|
|
26
|
+
|
|
27
|
+
```sh
|
|
28
|
+
# Generate a CPU profile
|
|
29
|
+
CPUPROFILE=cpu.prof ./program
|
|
30
|
+
|
|
31
|
+
# Convert to pprof protobuf format
|
|
32
|
+
pprof --proto ./program cpu.prof > cpu.pprof
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
#### Environment variables
|
|
36
|
+
|
|
37
|
+
| Variable | Default | Description |
|
|
38
|
+
| ---------------------- | ------- | -------------------------------------------------------------------------------- |
|
|
39
|
+
| `CPUPROFILE` | — | Output filename that enables profiling when set |
|
|
40
|
+
| `CPUPROFILE_FREQUENCY` | `100` | Samples per second |
|
|
41
|
+
| `CPUPROFILE_REALTIME` | — | Use wall-clock time (`ITIMER_REAL`) instead of CPU time (`ITIMER_PROF`) when set |
|
|
42
|
+
| `CPUPROFILESIGNAL` | — | Signal number to toggle profiling on/off at runtime |
|
|
43
|
+
|
|
44
|
+
### Programmatic API
|
|
45
|
+
|
|
46
|
+
Declare gperftools' C entry points with `@_silgen_name` and link `-lprofiler`:
|
|
47
|
+
|
|
48
|
+
```swift
|
|
49
|
+
@_silgen_name("ProfilerStart")
|
|
50
|
+
func ProfilerStart(_ path: UnsafePointer<CChar>) -> Int32
|
|
51
|
+
@_silgen_name("ProfilerStop")
|
|
52
|
+
func ProfilerStop()
|
|
53
|
+
|
|
54
|
+
_ = "cpu.prof".withCString { ProfilerStart($0) }
|
|
55
|
+
|
|
56
|
+
// Code to profile...
|
|
57
|
+
|
|
58
|
+
ProfilerStop()
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
## Memory profiling
|
|
62
|
+
|
|
63
|
+
Periodically dumps the live heap, capturing allocation stack traces. Useful for
|
|
64
|
+
finding memory leaks and allocation hot spots.
|
|
65
|
+
|
|
66
|
+
Link `-ltcmalloc` the same way:
|
|
67
|
+
|
|
68
|
+
```sh
|
|
69
|
+
swiftc -O -g program.swift -o program -Xlinker --no-as-needed -Xlinker -ltcmalloc
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### CLI
|
|
73
|
+
|
|
74
|
+
```sh
|
|
75
|
+
# Generate heap profiles (written as <prefix>.0001.heap, .0002.heap, …)
|
|
76
|
+
HEAPPROFILE=heap.prof ./program
|
|
77
|
+
|
|
78
|
+
# Convert a heap profile to pprof protobuf format
|
|
79
|
+
pprof --proto ./program heap.prof.0001.heap > heap.pprof
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
#### Environment variables
|
|
83
|
+
|
|
84
|
+
| Variable | Default | Description |
|
|
85
|
+
| ---------------------------------- | ------------ | --------------------------------------------------------------------------------------------- |
|
|
86
|
+
| `HEAPPROFILE` | — | Output filename prefix that enables heap profiling when set |
|
|
87
|
+
| `HEAP_PROFILE_ALLOCATION_INTERVAL` | `1073741824` | Dump a profile after every this many bytes allocated (default 1 GB) |
|
|
88
|
+
| `HEAP_PROFILE_INUSE_INTERVAL` | `104857600` | Dump a profile each time the in-use high-water mark grows by this many bytes (default 100 MB) |
|
|
89
|
+
| `HEAP_PROFILE_TIME_INTERVAL` | `0` | Dump a profile every this many seconds (disabled by default) |
|
|
90
|
+
| `HEAPPROFILESIGNAL` | — | Signal number to dump a profile on demand |
|
|
91
|
+
| `HEAP_PROFILE_MMAP` | `false` | Also profile `mmap`/`mremap`/`sbrk` calls |
|
|
92
|
+
|
|
93
|
+
## Tips
|
|
94
|
+
|
|
95
|
+
### Demangling
|
|
96
|
+
|
|
97
|
+
gperftools reads names from the binary's symbol table, where Swift names are
|
|
98
|
+
mangled (`$s11SwiftParser5LexerO6CursorV7advance2ifS2bs7UnicodeO6ScalarVXE_tF`).
|
|
99
|
+
`swift demangle` rewrites the mangled names in any text it reads, so pipe the
|
|
100
|
+
Markdown through it:
|
|
101
|
+
|
|
102
|
+
```sh
|
|
103
|
+
profiler-md cpu.pprof | swift demangle
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
`--simplified` drops module names and implicit `self` types, turning the name
|
|
107
|
+
above into `Lexer.Cursor.advance(if:)`.
|
|
108
|
+
|
|
109
|
+
### Preloading
|
|
110
|
+
|
|
111
|
+
`LD_PRELOAD` activates the profiler in a program that was linked without it:
|
|
112
|
+
|
|
113
|
+
```sh
|
|
114
|
+
CPUPROFILE=cpu.prof LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libprofiler.so ./program
|
|
115
|
+
HEAPPROFILE=heap.prof LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libtcmalloc.so ./program
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
### Symbols
|
|
119
|
+
|
|
120
|
+
SwiftPM statically links a package and its dependencies into the executable, so
|
|
121
|
+
one binary contains their symbols. The Swift runtime (`libswiftCore.so` and the
|
|
122
|
+
rest of `/usr/lib/swift/linux`) stays dynamic. `pprof` needs those libraries
|
|
123
|
+
present to symbolize frames inside them.
|
|
124
|
+
|
|
125
|
+
### Optimization
|
|
126
|
+
|
|
127
|
+
`-Onone` frames are easy to read, but the timings differ from a release build's.
|
|
128
|
+
Profile `-O`, and expect inlining and generic specialization to attribute some
|
|
129
|
+
samples to the caller or to a specialized copy of the callee.
|
|
130
|
+
|
|
131
|
+
### Converting
|
|
132
|
+
|
|
133
|
+
`pprof --proto` requires the Go `pprof`. gperftools stopped shipping a `pprof`
|
|
134
|
+
of its own in 2.17, and the Perl `pprof`/`google-pprof` that earlier releases
|
|
135
|
+
and the distro packages built from them install has no protobuf output.
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
# Zig
|
|
2
|
+
|
|
3
|
+
Zig profiling uses [gperftools](https://github.com/gperftools/gperftools), whose
|
|
4
|
+
CPU profiler and tcmalloc heap profiler attach to any dynamically linked native
|
|
5
|
+
program, or [Linux `perf`](https://perfwiki.github.io/main/), which samples the
|
|
6
|
+
program from the kernel.
|
|
7
|
+
|
|
8
|
+
## CPU profiling
|
|
9
|
+
|
|
10
|
+
Periodically samples the call stack. Useful for finding CPU hot spots.
|
|
11
|
+
|
|
12
|
+
Link libc dynamically so the profiler can be preloaded, and keep frame pointers
|
|
13
|
+
so its unwinder can walk the stack:
|
|
14
|
+
|
|
15
|
+
```sh
|
|
16
|
+
zig build-exe -O ReleaseSafe -fno-omit-frame-pointer -lc program.zig
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### CLI
|
|
20
|
+
|
|
21
|
+
```sh
|
|
22
|
+
# Generate a CPU profile
|
|
23
|
+
CPUPROFILE=cpu.prof LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libprofiler.so ./program
|
|
24
|
+
|
|
25
|
+
# Convert to pprof protobuf format
|
|
26
|
+
pprof --proto ./program cpu.prof > cpu.pprof
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
#### Environment variables
|
|
30
|
+
|
|
31
|
+
| Variable | Default | Description |
|
|
32
|
+
| ---------------------- | ------- | -------------------------------------------------------------------------------- |
|
|
33
|
+
| `CPUPROFILE` | — | Output filename that enables profiling when set |
|
|
34
|
+
| `CPUPROFILE_FREQUENCY` | `100` | Samples per second |
|
|
35
|
+
| `CPUPROFILE_REALTIME` | — | Use wall-clock time (`ITIMER_REAL`) instead of CPU time (`ITIMER_PROF`) when set |
|
|
36
|
+
| `CPUPROFILESIGNAL` | — | Signal number to toggle profiling on/off at runtime |
|
|
37
|
+
|
|
38
|
+
### Programmatic API
|
|
39
|
+
|
|
40
|
+
Declare the C entry points and link `-lprofiler`:
|
|
41
|
+
|
|
42
|
+
```zig
|
|
43
|
+
extern fn ProfilerStart(fname: [*:0]const u8) c_int;
|
|
44
|
+
extern fn ProfilerStop() void;
|
|
45
|
+
|
|
46
|
+
_ = ProfilerStart("cpu.prof");
|
|
47
|
+
|
|
48
|
+
// Code to profile...
|
|
49
|
+
|
|
50
|
+
ProfilerStop();
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
```sh
|
|
54
|
+
zig build-exe -O ReleaseSafe -fno-omit-frame-pointer -lc -lprofiler program.zig
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## Memory profiling
|
|
58
|
+
|
|
59
|
+
Periodically dumps the live heap, capturing allocation stack traces. Useful for
|
|
60
|
+
finding memory leaks and allocation hot spots.
|
|
61
|
+
|
|
62
|
+
Allocate through `std.heap.c_allocator`, which routes every allocation to
|
|
63
|
+
`malloc` and so to tcmalloc:
|
|
64
|
+
|
|
65
|
+
```zig
|
|
66
|
+
const gpa = std.heap.c_allocator;
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### CLI
|
|
70
|
+
|
|
71
|
+
```sh
|
|
72
|
+
# Generate heap profiles (written as <prefix>.0001.heap, .0002.heap, …)
|
|
73
|
+
HEAPPROFILE=heap.prof LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libtcmalloc.so ./program
|
|
74
|
+
|
|
75
|
+
# Convert a heap profile to pprof protobuf format
|
|
76
|
+
pprof --proto ./program heap.prof.0001.heap > heap.pprof
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
#### Environment variables
|
|
80
|
+
|
|
81
|
+
| Variable | Default | Description |
|
|
82
|
+
| ---------------------------------- | ------------ | --------------------------------------------------------------------------------------------- |
|
|
83
|
+
| `HEAPPROFILE` | — | Output filename prefix that enables heap profiling when set |
|
|
84
|
+
| `HEAP_PROFILE_ALLOCATION_INTERVAL` | `1073741824` | Dump a profile after every this many bytes allocated (default 1 GB) |
|
|
85
|
+
| `HEAP_PROFILE_INUSE_INTERVAL` | `104857600` | Dump a profile each time the in-use high-water mark grows by this many bytes (default 100 MB) |
|
|
86
|
+
| `HEAP_PROFILE_TIME_INTERVAL` | `0` | Dump a profile every this many seconds (disabled by default) |
|
|
87
|
+
| `HEAPPROFILESIGNAL` | — | Signal number to dump a profile on demand |
|
|
88
|
+
| `HEAP_PROFILE_MMAP` | `false` | Also profile `mmap`/`mremap`/`sbrk` calls |
|
|
89
|
+
|
|
90
|
+
## Linux perf profiling
|
|
91
|
+
|
|
92
|
+
Samples the call stack through the kernel's own `perf_event` counters, across
|
|
93
|
+
user and kernel code. Useful for finding CPU hot spots, including the ones in
|
|
94
|
+
the kernel.
|
|
95
|
+
|
|
96
|
+
[Linux `perf`](https://perfwiki.github.io/main/) samples any native program and
|
|
97
|
+
writes `perf.data` itself. It needs a Linux kernel and a
|
|
98
|
+
`/proc/sys/kernel/perf_event_paranoid` low enough to permit sampling (`1` or
|
|
99
|
+
below for kernel stacks).
|
|
100
|
+
|
|
101
|
+
Build with frame pointers so perf's unwinder can walk the stack:
|
|
102
|
+
|
|
103
|
+
```sh
|
|
104
|
+
zig build-exe -O ReleaseSafe -fno-omit-frame-pointer program.zig
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
### CLI
|
|
108
|
+
|
|
109
|
+
```sh
|
|
110
|
+
# Sample a command at 999 Hz, recording call chains
|
|
111
|
+
perf record -F 999 -g -o perf.data -- ./program args
|
|
112
|
+
|
|
113
|
+
# Or sample a running process for 30 seconds
|
|
114
|
+
perf record -F 999 -g -o perf.data --pid <pid> -- sleep 30
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
#### Flags
|
|
118
|
+
|
|
119
|
+
| Flag | Default | Description |
|
|
120
|
+
| -------------- | ----------- | -------------------------------------------------------------------- |
|
|
121
|
+
| `-F` | `4000` | Samples per second |
|
|
122
|
+
| `-e` | `cycles` | Event to sample (`cpu-clock` where no hardware counter is available) |
|
|
123
|
+
| `-g` | off | Record call chains |
|
|
124
|
+
| `--call-graph` | `fp` | How to unwind: `fp`, `dwarf` (larger files), or `lbr` |
|
|
125
|
+
| `-o` | `perf.data` | Output path |
|
|
126
|
+
| `-a` | off | Sample every CPU on the system rather than one command |
|
|
127
|
+
|
|
128
|
+
A `perf.data` file holds addresses rather than function names. See
|
|
129
|
+
`profiler-md --help perf` for how frames are named and how to symbolize them.
|
|
130
|
+
|
|
131
|
+
## Tips
|
|
132
|
+
|
|
133
|
+
### Linking
|
|
134
|
+
|
|
135
|
+
`LD_PRELOAD` requires a dynamic loader, and a Zig program without libc is
|
|
136
|
+
statically linked. Pass `-lc` to link glibc dynamically, or link
|
|
137
|
+
`-lprofiler`/`-ltcmalloc` and call the profiler's C API instead.
|
|
138
|
+
|
|
139
|
+
### Symbols
|
|
140
|
+
|
|
141
|
+
gperftools symbolizes addresses from the binary's symbol table, so profile a
|
|
142
|
+
build that keeps its symbols. `-O ReleaseSafe` and `-O ReleaseFast` keep them,
|
|
143
|
+
and `-fstrip` removes them.
|
|
144
|
+
|
|
145
|
+
### Optimization
|
|
146
|
+
|
|
147
|
+
`-O Debug` frames are easy to read, but the timings differ from a release
|
|
148
|
+
build's. Profile `-O ReleaseSafe` or `-O ReleaseFast`, and expect inlining to
|
|
149
|
+
attribute some samples to the caller.
|
|
150
|
+
|
|
151
|
+
### Converting
|
|
152
|
+
|
|
153
|
+
`pprof --proto` requires the Go `pprof`. gperftools stopped shipping a `pprof`
|
|
154
|
+
of its own in 2.17, and the Perl `pprof`/`google-pprof` that earlier releases
|
|
155
|
+
and the distro packages built from them install has no protobuf output.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "profiler-md",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.7.0",
|
|
4
4
|
"author": {
|
|
5
5
|
"name": "Tomer Aberbach",
|
|
6
6
|
"email": "tomer@aberba.ch",
|
|
@@ -34,10 +34,7 @@
|
|
|
34
34
|
"v8"
|
|
35
35
|
],
|
|
36
36
|
"homepage": "https://github.com/TomerAberbach/profiler-md",
|
|
37
|
-
"repository":
|
|
38
|
-
"type": "git",
|
|
39
|
-
"url": "TomerAberbach/profiler-md"
|
|
40
|
-
},
|
|
37
|
+
"repository": "TomerAberbach/profiler-md",
|
|
41
38
|
"bugs": {
|
|
42
39
|
"url": "https://github.com/TomerAberbach/profiler-md/issues"
|
|
43
40
|
},
|
|
@@ -46,7 +43,6 @@
|
|
|
46
43
|
},
|
|
47
44
|
"license": "MIT",
|
|
48
45
|
"files": [
|
|
49
|
-
"examples/output",
|
|
50
46
|
"dist",
|
|
51
47
|
"docs",
|
|
52
48
|
"skills"
|
|
@@ -66,24 +62,47 @@
|
|
|
66
62
|
},
|
|
67
63
|
"./package.json": "./package.json"
|
|
68
64
|
},
|
|
65
|
+
"scripts": {
|
|
66
|
+
"format:base": "prettier --cache --write",
|
|
67
|
+
"format": "pnpm format:base .",
|
|
68
|
+
"lint:base": "eslint --cache --cache-location node_modules/.cache/eslint/ --fix",
|
|
69
|
+
"lint": "pnpm lint:base .",
|
|
70
|
+
"typecheck": "tsc --noEmit",
|
|
71
|
+
"knip": "knip",
|
|
72
|
+
"test": "vitest",
|
|
73
|
+
"coverage": "vitest --coverage",
|
|
74
|
+
"bench": "./scripts/bench",
|
|
75
|
+
"categories": "node scripts/categories.ts",
|
|
76
|
+
"build": "tsdown",
|
|
77
|
+
"generate-inputs": "./scripts/generate-inputs",
|
|
78
|
+
"update-readme": "node scripts/update-readme.ts",
|
|
79
|
+
"check-readme": "node scripts/update-readme.ts --check",
|
|
80
|
+
"update-demo": "node scripts/update-demo.ts",
|
|
81
|
+
"check-demo": "node scripts/update-demo.ts --check",
|
|
82
|
+
"update-examples": "node scripts/update-examples.ts",
|
|
83
|
+
"check-examples": "node scripts/update-examples.ts --check",
|
|
84
|
+
"check": "run-p -lc check:heavy check:light",
|
|
85
|
+
"check:heavy": "run-s \"test --run\" check-examples",
|
|
86
|
+
"check:light": "run-s -c build typecheck \"lint --no-fix\" \"format --no-write --check\" knip check-readme check-demo",
|
|
87
|
+
"prepublishOnly": "pnpm build"
|
|
88
|
+
},
|
|
69
89
|
"prettier": "@tomer/prettier-config",
|
|
70
90
|
"dependencies": {
|
|
71
|
-
"@optique/core": "^1.
|
|
72
|
-
"@optique/run": "^1.
|
|
73
|
-
"@shikijs/core": "^4.
|
|
74
|
-
"@shikijs/engine-oniguruma": "^4.
|
|
75
|
-
"@shikijs/langs": "^4.
|
|
91
|
+
"@optique/core": "^1.2.0",
|
|
92
|
+
"@optique/run": "^1.2.0",
|
|
93
|
+
"@shikijs/core": "^4.3.1",
|
|
94
|
+
"@shikijs/engine-oniguruma": "^4.3.1",
|
|
95
|
+
"@shikijs/langs": "^4.3.1",
|
|
76
96
|
"ansis": "^4.3.1",
|
|
77
97
|
"convert-source-map": "^2.0.0",
|
|
78
|
-
"globals": "^17.
|
|
98
|
+
"globals": "^17.7.0",
|
|
79
99
|
"jumbo-json": "^0.2.0",
|
|
80
100
|
"mdast-util-from-markdown": "^2.0.3",
|
|
81
101
|
"mdast-util-gfm-table": "^2.0.0",
|
|
82
102
|
"mdast-util-to-markdown": "^2.1.2",
|
|
83
103
|
"micromark-extension-gfm-table": "^2.1.1",
|
|
84
|
-
"picomatch": "^4.0.4",
|
|
85
104
|
"plur": "^6.0.0",
|
|
86
|
-
"pprof-format": "^2.
|
|
105
|
+
"pprof-format": "^2.3.0",
|
|
87
106
|
"pretty-bytes": "^7.1.1",
|
|
88
107
|
"pretty-ms": "^9.3.0",
|
|
89
108
|
"source-map-js": "^1.2.1"
|
|
@@ -95,37 +114,18 @@
|
|
|
95
114
|
"@tomer/prettier-config": "^4.0.1",
|
|
96
115
|
"@types/convert-source-map": "^2.0.3",
|
|
97
116
|
"@types/mdast": "^4.0.4",
|
|
98
|
-
"@
|
|
99
|
-
"@vitest/coverage-v8": "^4.1.9",
|
|
117
|
+
"@vitest/coverage-v8": "^4.1.10",
|
|
100
118
|
"dedent": "^1.7.2",
|
|
101
|
-
"eslint": "^10.
|
|
102
|
-
"
|
|
103
|
-
"knip": "^6.24.0",
|
|
104
|
-
"limit-concur": "^4.0.0",
|
|
119
|
+
"eslint": "^10.8.0",
|
|
120
|
+
"knip": "^6.29.0",
|
|
105
121
|
"mdast-util-gfm": "^3.1.0",
|
|
106
122
|
"micromark-extension-gfm": "^3.0.0",
|
|
107
|
-
"
|
|
108
|
-
"
|
|
123
|
+
"npm-run-all2": "^9.0.3",
|
|
124
|
+
"prettier": "^3.9.6",
|
|
125
|
+
"publint": "^0.3.22",
|
|
109
126
|
"rollup-plugin-tree-shakeable": "^2.0.0",
|
|
110
|
-
"tsdown": "^0.22.
|
|
127
|
+
"tsdown": "^0.22.14",
|
|
111
128
|
"typescript": "^6.0.3",
|
|
112
|
-
"vitest": "^4.1.
|
|
113
|
-
},
|
|
114
|
-
"scripts": {
|
|
115
|
-
"format:base": "prettier --cache --write",
|
|
116
|
-
"format": "pnpm format:base .",
|
|
117
|
-
"lint:base": "eslint --cache --cache-location node_modules/.cache/eslint/ --fix",
|
|
118
|
-
"lint": "pnpm lint:base .",
|
|
119
|
-
"typecheck": "tsc --noEmit",
|
|
120
|
-
"knip": "knip",
|
|
121
|
-
"test": "vitest",
|
|
122
|
-
"coverage": "vitest --coverage",
|
|
123
|
-
"bench": "./scripts/bench",
|
|
124
|
-
"build": "tsdown",
|
|
125
|
-
"generate-inputs": "./scripts/generate-inputs",
|
|
126
|
-
"update-readme": "node scripts/update-readme.ts",
|
|
127
|
-
"check-readme": "node scripts/update-readme.ts --check",
|
|
128
|
-
"update-examples": "node scripts/update-examples.ts",
|
|
129
|
-
"check-examples": "node scripts/update-examples.ts --check"
|
|
129
|
+
"vitest": "^4.1.10"
|
|
130
130
|
}
|
|
131
|
-
}
|
|
131
|
+
}
|