profiler-md 0.6.0 → 0.8.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.
Files changed (239) hide show
  1. package/dist/cli/index.mjs +12953 -4258
  2. package/dist/index.d.mts +1182 -435
  3. package/dist/index.js +2 -2
  4. package/docs/api.md +138 -0
  5. package/docs/formats/callgrind.md +25 -0
  6. package/docs/formats/collapsed.md +5 -3
  7. package/docs/formats/ghc-eventlog.md +20 -0
  8. package/docs/formats/ghc-json-profile.md +23 -0
  9. package/docs/formats/hprof.md +21 -0
  10. package/docs/formats/jfr.md +2 -2
  11. package/docs/formats/jsc-heap-snapshot.md +10 -4
  12. package/docs/formats/memray.md +30 -0
  13. package/docs/formats/perf.md +74 -0
  14. package/docs/formats/pprof.md +4 -2
  15. package/docs/formats/speedscope.md +3 -2
  16. package/docs/formats/systing.md +17 -15
  17. package/docs/formats/v8-cpu-profile.md +4 -3
  18. package/docs/formats/v8-heap-profile.md +8 -5
  19. package/docs/formats/v8-heap-snapshot.md +8 -3
  20. package/docs/formats/webkit-timeline-recording.md +6 -0
  21. package/docs/languages/c.md +119 -32
  22. package/docs/languages/csharp.md +5 -3
  23. package/docs/languages/elixir.md +19 -11
  24. package/docs/languages/fortran.md +141 -0
  25. package/docs/languages/go.md +33 -10
  26. package/docs/languages/haskell.md +134 -0
  27. package/docs/languages/java.md +81 -26
  28. package/docs/languages/javascript.md +43 -25
  29. package/docs/languages/julia.md +21 -18
  30. package/docs/languages/php.md +19 -0
  31. package/docs/languages/python.md +105 -14
  32. package/docs/languages/ruby.md +15 -16
  33. package/docs/languages/rust.md +11 -10
  34. package/docs/languages/swift.md +135 -0
  35. package/docs/languages/zig.md +155 -0
  36. package/package.json +42 -42
  37. package/readme.md +302 -259
  38. package/skills/profile-optimize/SKILL.md +4 -2
  39. package/examples/output/c.gperftools.cpu.base.pprof.md +0 -324
  40. package/examples/output/c.gperftools.cpu.current.pprof.md +0 -271
  41. package/examples/output/c.gperftools.cpu.diff.pprof.md +0 -98
  42. package/examples/output/c.gperftools.heap.base.pprof.md +0 -362
  43. package/examples/output/c.gperftools.heap.current.pprof.md +0 -362
  44. package/examples/output/c.gperftools.heap.diff.pprof.md +0 -28
  45. package/examples/output/c.systing.cpu.base.systing.md +0 -824
  46. package/examples/output/c.systing.cpu.current.systing.md +0 -825
  47. package/examples/output/c.systing.cpu.diff.systing.md +0 -238
  48. package/examples/output/cpp.gperftools.cpu.base.pprof.md +0 -557
  49. package/examples/output/cpp.gperftools.cpu.current.pprof.md +0 -573
  50. package/examples/output/cpp.gperftools.cpu.diff.pprof.md +0 -122
  51. package/examples/output/cpp.gperftools.heap.base.pprof.md +0 -67
  52. package/examples/output/cpp.gperftools.heap.current.pprof.md +0 -67
  53. package/examples/output/cpp.gperftools.heap.diff.pprof.md +0 -19
  54. package/examples/output/csharp.dotnet-trace.base.speedscope.json.md +0 -411
  55. package/examples/output/csharp.dotnet-trace.current.speedscope.json.md +0 -412
  56. package/examples/output/csharp.dotnet-trace.diff.speedscope.json.md +0 -122
  57. package/examples/output/elixir.eflambe.cpu.base.collapsed.md +0 -399
  58. package/examples/output/elixir.eflambe.cpu.current.collapsed.md +0 -398
  59. package/examples/output/elixir.eflambe.cpu.diff.collapsed.md +0 -92
  60. package/examples/output/erlang.eflambe.cpu.base.collapsed.md +0 -147
  61. package/examples/output/erlang.eflambe.cpu.current.collapsed.md +0 -147
  62. package/examples/output/erlang.eflambe.cpu.diff.collapsed.md +0 -18
  63. package/examples/output/fsharp.dotnet-trace.base.speedscope.json.md +0 -324
  64. package/examples/output/fsharp.dotnet-trace.current.speedscope.json.md +0 -314
  65. package/examples/output/fsharp.dotnet-trace.diff.speedscope.json.md +0 -119
  66. package/examples/output/go.pprof.block.base.pprof.md +0 -86
  67. package/examples/output/go.pprof.block.current.pprof.md +0 -83
  68. package/examples/output/go.pprof.block.diff.pprof.md +0 -42
  69. package/examples/output/go.pprof.cpu.base.pprof.md +0 -81
  70. package/examples/output/go.pprof.cpu.current.pprof.md +0 -70
  71. package/examples/output/go.pprof.cpu.diff.pprof.md +0 -52
  72. package/examples/output/go.pprof.goroutine.base.pprof.md +0 -43
  73. package/examples/output/go.pprof.goroutine.current.pprof.md +0 -43
  74. package/examples/output/go.pprof.goroutine.diff.pprof.md +0 -13
  75. package/examples/output/go.pprof.heap-alloc.base.pprof.md +0 -154
  76. package/examples/output/go.pprof.heap-alloc.current.pprof.md +0 -146
  77. package/examples/output/go.pprof.heap-alloc.diff.pprof.md +0 -67
  78. package/examples/output/go.pprof.heap.base.pprof.md +0 -154
  79. package/examples/output/go.pprof.heap.current.pprof.md +0 -146
  80. package/examples/output/go.pprof.heap.diff.pprof.md +0 -67
  81. package/examples/output/go.pprof.mutex.base.pprof.md +0 -55
  82. package/examples/output/go.pprof.mutex.current.pprof.md +0 -41
  83. package/examples/output/go.pprof.mutex.diff.pprof.md +0 -31
  84. package/examples/output/go.pprof.threadcreate.base.pprof.md +0 -55
  85. package/examples/output/go.pprof.threadcreate.current.pprof.md +0 -55
  86. package/examples/output/go.pprof.threadcreate.diff.pprof.md +0 -19
  87. package/examples/output/java.async-profiler.all.base.jfr.md +0 -1071
  88. package/examples/output/java.async-profiler.all.current.jfr.md +0 -1007
  89. package/examples/output/java.async-profiler.all.diff.jfr.md +0 -268
  90. package/examples/output/java.async-profiler.alloc.base.jfr.md +0 -425
  91. package/examples/output/java.async-profiler.alloc.current.jfr.md +0 -413
  92. package/examples/output/java.async-profiler.alloc.diff.jfr.md +0 -99
  93. package/examples/output/java.async-profiler.cpu.base.collapsed.md +0 -367
  94. package/examples/output/java.async-profiler.cpu.base.jfr.md +0 -485
  95. package/examples/output/java.async-profiler.cpu.current.collapsed.md +0 -355
  96. package/examples/output/java.async-profiler.cpu.current.jfr.md +0 -488
  97. package/examples/output/java.async-profiler.cpu.diff.collapsed.md +0 -117
  98. package/examples/output/java.async-profiler.cpu.diff.jfr.md +0 -118
  99. package/examples/output/java.async-profiler.live.base.jfr.md +0 -697
  100. package/examples/output/java.async-profiler.live.current.jfr.md +0 -684
  101. package/examples/output/java.async-profiler.live.diff.jfr.md +0 -191
  102. package/examples/output/java.async-profiler.lock.base.jfr.md +0 -140
  103. package/examples/output/java.async-profiler.lock.current.jfr.md +0 -108
  104. package/examples/output/java.async-profiler.lock.diff.jfr.md +0 -44
  105. package/examples/output/java.async-profiler.nativemem.base.jfr.md +0 -222
  106. package/examples/output/java.async-profiler.nativemem.current.jfr.md +0 -222
  107. package/examples/output/java.async-profiler.nativemem.diff.jfr.md +0 -65
  108. package/examples/output/java.async-profiler.wall.base.jfr.md +0 -400
  109. package/examples/output/java.async-profiler.wall.current.jfr.md +0 -420
  110. package/examples/output/java.async-profiler.wall.diff.jfr.md +0 -94
  111. package/examples/output/java.jdk.all.base.jfr.md +0 -1024
  112. package/examples/output/java.jdk.all.current.jfr.md +0 -1010
  113. package/examples/output/java.jdk.all.diff.jfr.md +0 -311
  114. package/examples/output/java.jdk.alloc.base.jfr.md +0 -1024
  115. package/examples/output/java.jdk.alloc.current.jfr.md +0 -1046
  116. package/examples/output/java.jdk.alloc.diff.jfr.md +0 -312
  117. package/examples/output/java.jdk.cpu.base.jfr.md +0 -1023
  118. package/examples/output/java.jdk.cpu.current.jfr.md +0 -1039
  119. package/examples/output/java.jdk.cpu.diff.jfr.md +0 -285
  120. package/examples/output/java.jdk.live.base.jfr.md +0 -1029
  121. package/examples/output/java.jdk.live.current.jfr.md +0 -1035
  122. package/examples/output/java.jdk.live.diff.jfr.md +0 -289
  123. package/examples/output/java.jdk.lock.base.jfr.md +0 -1040
  124. package/examples/output/java.jdk.lock.current.jfr.md +0 -1051
  125. package/examples/output/java.jdk.lock.diff.jfr.md +0 -339
  126. package/examples/output/javascript.bun.base.cpuprofile.md +0 -73
  127. package/examples/output/javascript.bun.base.heapsnapshot.md +0 -608
  128. package/examples/output/javascript.bun.base.jsc-heap-snapshot.json.md +0 -480
  129. package/examples/output/javascript.bun.current.cpuprofile.md +0 -73
  130. package/examples/output/javascript.bun.current.heapsnapshot.md +0 -608
  131. package/examples/output/javascript.bun.current.jsc-heap-snapshot.json.md +0 -480
  132. package/examples/output/javascript.bun.diff.cpuprofile.md +0 -54
  133. package/examples/output/javascript.bun.diff.heapsnapshot.md +0 -48
  134. package/examples/output/javascript.bun.diff.jsc-heap-snapshot.json.md +0 -62
  135. package/examples/output/javascript.chrome.base.cpuprofile.md +0 -163
  136. package/examples/output/javascript.chrome.base.heapprofile.md +0 -32
  137. package/examples/output/javascript.chrome.base.heapsnapshot.md +0 -649
  138. package/examples/output/javascript.chrome.current.cpuprofile.md +0 -149
  139. package/examples/output/javascript.chrome.current.heapprofile.md +0 -32
  140. package/examples/output/javascript.chrome.current.heapsnapshot.md +0 -647
  141. package/examples/output/javascript.chrome.diff.cpuprofile.md +0 -65
  142. package/examples/output/javascript.chrome.diff.heapprofile.md +0 -50
  143. package/examples/output/javascript.chrome.diff.heapsnapshot.md +0 -73
  144. package/examples/output/javascript.deno.base.cpuprofile.md +0 -122
  145. package/examples/output/javascript.deno.current.cpuprofile.md +0 -114
  146. package/examples/output/javascript.deno.diff.cpuprofile.md +0 -66
  147. package/examples/output/javascript.node.base.cpuprofile.md +0 -136
  148. package/examples/output/javascript.node.base.heapprofile.md +0 -56
  149. package/examples/output/javascript.node.base.heapsnapshot.md +0 -660
  150. package/examples/output/javascript.node.current.cpuprofile.md +0 -119
  151. package/examples/output/javascript.node.current.heapprofile.md +0 -52
  152. package/examples/output/javascript.node.current.heapsnapshot.md +0 -660
  153. package/examples/output/javascript.node.diff.cpuprofile.md +0 -70
  154. package/examples/output/javascript.node.diff.heapprofile.md +0 -34
  155. package/examples/output/javascript.node.diff.heapsnapshot.md +0 -39
  156. package/examples/output/javascript.pprof.cpu.base.pprof.md +0 -104
  157. package/examples/output/javascript.pprof.cpu.current.pprof.md +0 -120
  158. package/examples/output/javascript.pprof.cpu.diff.pprof.md +0 -63
  159. package/examples/output/javascript.pprof.heap.base.pprof.md +0 -86
  160. package/examples/output/javascript.pprof.heap.current.pprof.md +0 -57
  161. package/examples/output/javascript.pprof.heap.diff.pprof.md +0 -42
  162. package/examples/output/javascript.safari.base.webkit-timeline-recording.json.md +0 -388
  163. package/examples/output/javascript.safari.current.webkit-timeline-recording.json.md +0 -378
  164. package/examples/output/javascript.safari.diff.webkit-timeline-recording.json.md +0 -122
  165. package/examples/output/julia.pprof-jl.alloc.base.pprof.md +0 -124
  166. package/examples/output/julia.pprof-jl.alloc.current.pprof.md +0 -126
  167. package/examples/output/julia.pprof-jl.alloc.diff.pprof.md +0 -30
  168. package/examples/output/julia.pprof-jl.cpu.base.pprof.md +0 -177
  169. package/examples/output/julia.pprof-jl.cpu.current.pprof.md +0 -179
  170. package/examples/output/julia.pprof-jl.cpu.diff.pprof.md +0 -64
  171. package/examples/output/julia.pprof-jl.wall.base.pprof.md +0 -181
  172. package/examples/output/julia.pprof-jl.wall.current.pprof.md +0 -193
  173. package/examples/output/julia.pprof-jl.wall.diff.pprof.md +0 -64
  174. package/examples/output/julia.profile.base.heapsnapshot.md +0 -590
  175. package/examples/output/julia.profile.current.heapsnapshot.md +0 -590
  176. package/examples/output/julia.profile.diff.heapsnapshot.md +0 -288
  177. package/examples/output/kotlin.async-profiler.all.base.jfr.md +0 -920
  178. package/examples/output/kotlin.async-profiler.all.current.jfr.md +0 -925
  179. package/examples/output/kotlin.async-profiler.all.diff.jfr.md +0 -247
  180. package/examples/output/kotlin.async-profiler.alloc.base.jfr.md +0 -467
  181. package/examples/output/kotlin.async-profiler.alloc.current.jfr.md +0 -473
  182. package/examples/output/kotlin.async-profiler.alloc.diff.jfr.md +0 -122
  183. package/examples/output/kotlin.async-profiler.cpu.base.collapsed.md +0 -371
  184. package/examples/output/kotlin.async-profiler.cpu.base.jfr.md +0 -472
  185. package/examples/output/kotlin.async-profiler.cpu.current.collapsed.md +0 -370
  186. package/examples/output/kotlin.async-profiler.cpu.current.jfr.md +0 -445
  187. package/examples/output/kotlin.async-profiler.cpu.diff.collapsed.md +0 -124
  188. package/examples/output/kotlin.async-profiler.cpu.diff.jfr.md +0 -125
  189. package/examples/output/kotlin.async-profiler.live.base.jfr.md +0 -934
  190. package/examples/output/kotlin.async-profiler.live.current.jfr.md +0 -917
  191. package/examples/output/kotlin.async-profiler.live.diff.jfr.md +0 -245
  192. package/examples/output/kotlin.async-profiler.lock.base.jfr.md +0 -1
  193. package/examples/output/kotlin.async-profiler.lock.current.jfr.md +0 -1
  194. package/examples/output/kotlin.async-profiler.lock.diff.jfr.md +0 -1
  195. package/examples/output/kotlin.async-profiler.nativemem.base.jfr.md +0 -234
  196. package/examples/output/kotlin.async-profiler.nativemem.current.jfr.md +0 -234
  197. package/examples/output/kotlin.async-profiler.nativemem.diff.jfr.md +0 -65
  198. package/examples/output/kotlin.async-profiler.wall.base.jfr.md +0 -452
  199. package/examples/output/kotlin.async-profiler.wall.current.jfr.md +0 -457
  200. package/examples/output/kotlin.async-profiler.wall.diff.jfr.md +0 -125
  201. package/examples/output/kotlin.jdk.all.base.jfr.md +0 -1442
  202. package/examples/output/kotlin.jdk.all.current.jfr.md +0 -1343
  203. package/examples/output/kotlin.jdk.all.diff.jfr.md +0 -392
  204. package/examples/output/kotlin.jdk.alloc.base.jfr.md +0 -1418
  205. package/examples/output/kotlin.jdk.alloc.current.jfr.md +0 -1389
  206. package/examples/output/kotlin.jdk.alloc.diff.jfr.md +0 -383
  207. package/examples/output/kotlin.jdk.cpu.base.jfr.md +0 -1406
  208. package/examples/output/kotlin.jdk.cpu.current.jfr.md +0 -1374
  209. package/examples/output/kotlin.jdk.cpu.diff.jfr.md +0 -380
  210. package/examples/output/kotlin.jdk.live.base.jfr.md +0 -1378
  211. package/examples/output/kotlin.jdk.live.current.jfr.md +0 -1311
  212. package/examples/output/kotlin.jdk.live.diff.jfr.md +0 -381
  213. package/examples/output/kotlin.jdk.lock.base.jfr.md +0 -1427
  214. package/examples/output/kotlin.jdk.lock.current.jfr.md +0 -1374
  215. package/examples/output/kotlin.jdk.lock.diff.jfr.md +0 -386
  216. package/examples/output/php.excimer.wall.base.speedscope.json.md +0 -25
  217. package/examples/output/php.excimer.wall.current.speedscope.json.md +0 -25
  218. package/examples/output/php.excimer.wall.diff.speedscope.json.md +0 -29
  219. package/examples/output/python.py-spy.cpu.base.collapsed.md +0 -526
  220. package/examples/output/python.py-spy.cpu.base.speedscope.json.md +0 -37
  221. package/examples/output/python.py-spy.cpu.current.collapsed.md +0 -514
  222. package/examples/output/python.py-spy.cpu.current.speedscope.json.md +0 -37
  223. package/examples/output/python.py-spy.cpu.diff.collapsed.md +0 -122
  224. package/examples/output/python.py-spy.cpu.diff.speedscope.json.md +0 -31
  225. package/examples/output/python.py-spy.wall.base.collapsed.md +0 -527
  226. package/examples/output/python.py-spy.wall.current.collapsed.md +0 -518
  227. package/examples/output/python.py-spy.wall.diff.collapsed.md +0 -122
  228. package/examples/output/ruby.rbspy.cpu.base.collapsed.md +0 -90
  229. package/examples/output/ruby.rbspy.cpu.base.pprof.md +0 -105
  230. package/examples/output/ruby.rbspy.cpu.base.speedscope.json.md +0 -105
  231. package/examples/output/ruby.rbspy.cpu.current.collapsed.md +0 -90
  232. package/examples/output/ruby.rbspy.cpu.current.pprof.md +0 -115
  233. package/examples/output/ruby.rbspy.cpu.current.speedscope.json.md +0 -115
  234. package/examples/output/ruby.rbspy.cpu.diff.collapsed.md +0 -32
  235. package/examples/output/ruby.rbspy.cpu.diff.pprof.md +0 -44
  236. package/examples/output/ruby.rbspy.cpu.diff.speedscope.json.md +0 -44
  237. package/examples/output/rust.pprof-rs.cpu.base.pprof.md +0 -60
  238. package/examples/output/rust.pprof-rs.cpu.current.pprof.md +0 -60
  239. package/examples/output/rust.pprof-rs.cpu.diff.pprof.md +0 -24
@@ -1,6 +1,8 @@
1
1
  # Python
2
2
 
3
- Python profiling uses [py-spy](https://github.com/benfred/py-spy) or
3
+ Python profiling uses [py-spy](https://github.com/benfred/py-spy),
4
+ [pyinstrument](https://github.com/joerick/pyinstrument),
5
+ [memray](https://github.com/bloomberg/memray), or
4
6
  [systing](https://github.com/josefbacik/systing).
5
7
 
6
8
  ## CPU profiling
@@ -43,23 +45,112 @@ py-spy dump --pid <pid>
43
45
  py-spy dump --pid <pid> --locals
44
46
  ```
45
47
 
46
- ## CLI flags
48
+ ## py-spy CLI flags
47
49
 
48
- | Flag | Default | Description |
49
- | ------------------- | ------------ | -------------------------------------------------------- |
50
- | `-f` / `--format` | `flamegraph` | Output format: `flamegraph`, `raw`, `speedscope` |
51
- | `-o` / `--output` | — | Output file path |
52
- | `-d` / `--duration` | — | Duration in seconds (default: until program exits) |
53
- | `-r` / `--rate` | `100` | Sampling rate in Hz |
54
- | `--idle` | off | Include stack traces for idle (sleeping/waiting) threads |
55
- | `--native` | off | Profile native Cython or C extensions |
56
- | `--nonblocking` | off | Sample without pausing the process (less accurate) |
57
- | `--subprocesses` | off | Also profile subprocesses of the target |
50
+ | Flag | Default | Description |
51
+ | ------------------- | ------------ | --------------------------------------------------------------- |
52
+ | `-f` / `--format` | `flamegraph` | Output format: `flamegraph`, `raw`, `speedscope`, `chrometrace` |
53
+ | `-o` / `--output` | — | Output file path |
54
+ | `-d` / `--duration` | — | Duration in seconds (default: until program exits) |
55
+ | `-r` / `--rate` | `100` | Sampling rate in Hz |
56
+ | `--idle` | off | Include stack traces for idle (sleeping/waiting) threads |
57
+ | `--native` | off | Profile native Cython or C extensions |
58
+ | `--nonblocking` | off | Sample without pausing the process (less accurate) |
59
+ | `--subprocesses` | off | Also profile subprocesses of the target |
60
+
61
+ ## In-process wall-clock profiling
62
+
63
+ Samples wall-clock time rather than CPU time, from inside the interpreter rather
64
+ than through ptrace. Useful for I/O-bound or latency-sensitive code.
65
+
66
+ [pyinstrument](https://github.com/joerick/pyinstrument) samples the call stack
67
+ from inside the interpreter, so it needs no ptrace access. Its speedscope
68
+ renderer writes a format this tool reads.
69
+
70
+ ### CLI
71
+
72
+ ```sh
73
+ # Profile a script
74
+ pyinstrument -r speedscope -o profile.speedscope.json script.py
75
+
76
+ # Profile a console script, such as the one an installed package provides
77
+ pyinstrument -r speedscope -o profile.speedscope.json "$(which black)" file.py
78
+
79
+ # Keep every frame instead of those above the 1% threshold
80
+ pyinstrument --show-all -r speedscope -o profile.speedscope.json script.py
81
+ ```
82
+
83
+ Run a console script by its path rather than as `python -m package`. Under `-m`,
84
+ pyinstrument trims the leading `runpy` frames by descending into the first child
85
+ of each. That child is the import subtree rather than the module body, so the
86
+ export covers only the imports. `--show-all` can trim the run the same way.
87
+
88
+ By default the export keeps the frames above 1% of the total and folds the rest
89
+ into the self time of the frame that called them.
90
+
91
+ #### Flags
92
+
93
+ | Flag | Default | Description |
94
+ | --------------------- | --------- | ------------------------------------------------------------- |
95
+ | `-r` / `--renderer` | see below | Output format. `speedscope` writes the format this tool reads |
96
+ | `-o` / `--outfile` | — | Output file path |
97
+ | `-m` | — | Run a library module as a script |
98
+ | `-i` / `--interval` | `0.001` | Minimum seconds between stack samples |
99
+ | `--show-all` | off | Keep every frame, including the standard library's |
100
+ | `--hide` | — | Glob matching the file paths whose frames to hide |
101
+ | `-t` / `--timeline` | off | Keep call ordering instead of condensing repeated calls |
102
+ | `--use-timing-thread` | off | Time the sampling interval on a separate thread |
103
+
104
+ Without `-r`, pyinstrument picks the renderer from the `-o` filename's
105
+ extension, and writes text when there is no `-o`.
106
+
107
+ ## Memory profiling
108
+
109
+ Traces every allocation with the Python call stack it came from. Useful for
110
+ finding where memory was held when the program's memory use was highest, and
111
+ what it never freed.
112
+
113
+ [memray](https://github.com/bloomberg/memray) traces the allocations the
114
+ interpreter makes, from inside the process.
115
+
116
+ ### CLI
117
+
118
+ ```sh
119
+ # Trace a script's allocations
120
+ memray run -o memory.bin script.py
121
+
122
+ # Trace a module, as `python -m` would run it
123
+ memray run -o memory.bin -m black file.py
124
+
125
+ # Keep per-stack totals only, for a smaller capture of a long run
126
+ memray run --aggregate -o memory.bin script.py
127
+
128
+ # Attach to a running process
129
+ memray attach --duration 60 -o memory.bin <pid>
130
+ ```
131
+
132
+ Tracing from inside the process makes the program run several times slower, so
133
+ profile a workload small enough to finish with tracing on.
134
+
135
+ #### Flags
136
+
137
+ | Flag | Default | Description |
138
+ | --------------------------- | -------------------------- | ------------------------------------------------------------------- |
139
+ | `-o` / `--output` | `<process_name>.<pid>.bin` | Output file path |
140
+ | `-f` / `--force` | off | Overwrite the output file if it exists |
141
+ | `--aggregate` | off | Record each stack's totals instead of every allocation |
142
+ | `--native` | off | Also record C/C++ frames, which this tool skips |
143
+ | `--trace-python-allocators` | off | Record pymalloc's own allocations as well as the ones underneath it |
144
+ | `--follow-fork` | off | Also trace child processes, each into its own capture |
145
+ | `--no-compress` | off | Write the capture uncompressed rather than LZ4 compressed |
58
146
 
59
147
  ## System profiling
60
148
 
61
- [systing](https://github.com/josefbacik/systing) is a Linux eBPF profiler that
62
- samples on-CPU stacks and records a stack each time a thread sleeps. With
149
+ Samples on-CPU stacks and records a stack each time a thread sleeps. Useful for
150
+ costs outside the process: off-CPU waits, syscall time, and contention across
151
+ the whole node.
152
+
153
+ [systing](https://github.com/josefbacik/systing) is a Linux eBPF profiler. With
63
154
  `--collect-pystacks` it walks CPython interpreter frames and blends them with
64
155
  the native stack, so profiles show Python functions alongside the C and kernel
65
156
  frames beneath them. It needs root (BPF) and a kernel with BTF
@@ -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 -o cpu.speedscope.json -- ruby script.rb
11
+ rbspy record --format speedscope --file cpu.speedscope.json -- ruby script.rb
14
12
 
15
13
  # Collapsed stacks
16
- rbspy record --format collapsed -o cpu.collapsed -- ruby script.rb
14
+ rbspy record --format collapsed --file cpu.collapsed -- ruby script.rb
17
15
 
18
16
  # pprof
19
- rbspy record --format pprof -o cpu.pprof -- ruby script.rb
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 -o cpu.speedscope.json --pid <pid>
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 -o profile.speedscope --duration 30 --pid <pid>
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 -o profile.speedscope --subprocesses --pid <pid>
29
+ rbspy record --format speedscope --file cpu.speedscope.json --subprocesses --pid <pid>
29
30
  ```
30
31
 
31
- ## Snapshot
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; records until Ctrl-C if omitted |
51
- | `-r` / `--rate` | `100` | Samples per second |
52
- | `-f` / `--format` | `flamegraph` | Output format: `flamegraph`, `collapsed`, `pprof`, `speedscope`, `callgrind`, `summary`, `summary_by_line` |
53
- | `-o` / `--file` | — | Output file path |
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) |
@@ -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 (the default stack unwinder
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)` | `100` | Samples per second |
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
- [systing](https://github.com/josefbacik/systing) is a Linux eBPF profiler that
44
- samples on-CPU stacks and records a stack each time a thread sleeps, across user
45
- and kernel code. Useful when the question spans more than the process (off-CPU
46
- waits, syscall time, whole-node contention). It needs root (BPF) and a kernel
47
- with BTF (`/sys/kernel/btf/vmlinux`).
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
- Frame-pointer unwinders walk the stack via frame pointers, which Cargo release
59
- builds omit by default. Force them on:
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.6.0",
3
+ "version": "0.8.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.1.1",
72
- "@optique/run": "^1.1.1",
73
- "@shikijs/core": "^4.2.0",
74
- "@shikijs/engine-oniguruma": "^4.2.0",
75
- "@shikijs/langs": "^4.2.0",
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.6.0",
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.2.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
- "@types/picomatch": "^4.0.3",
99
- "@vitest/coverage-v8": "^4.1.9",
117
+ "@vitest/coverage-v8": "^4.1.10",
100
118
  "dedent": "^1.7.2",
101
- "eslint": "^10.5.0",
102
- "jsdom": "^29.1.1",
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
- "prettier": "^3.8.4",
108
- "publint": "^0.3.21",
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.2",
127
+ "tsdown": "^0.22.14",
111
128
  "typescript": "^6.0.3",
112
- "vitest": "^4.1.9"
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
+ }