heapscope 0.6.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 (110) hide show
  1. checksums.yaml +7 -0
  2. data/.rubocop.yml +119 -0
  3. data/CHANGELOG.md +86 -0
  4. data/CODE_OF_CONDUCT.md +38 -0
  5. data/CONTRIBUTING.md +72 -0
  6. data/Gemfile +11 -0
  7. data/LICENSE +21 -0
  8. data/README.md +342 -0
  9. data/Rakefile +49 -0
  10. data/SECURITY.md +39 -0
  11. data/assets/heapscope-logo.png +0 -0
  12. data/assets/logo.svg +24 -0
  13. data/assets/wordmark.svg +18 -0
  14. data/docs/README.md +20 -0
  15. data/docs/ROADMAP.md +29 -0
  16. data/docs/adr/0001-evidence-over-certainty.md +24 -0
  17. data/docs/adr/0002-local-only-privacy.md +19 -0
  18. data/docs/adr/0003-runtime-adapters.md +25 -0
  19. data/docs/adr/README.md +7 -0
  20. data/docs/allocators.md +13 -0
  21. data/docs/api/overview.md +70 -0
  22. data/docs/changelogs/0.1.0.md +22 -0
  23. data/docs/changelogs/0.2.0.md +49 -0
  24. data/docs/changelogs/0.3.0.md +38 -0
  25. data/docs/changelogs/0.4.0.md +32 -0
  26. data/docs/changelogs/0.5.0.md +18 -0
  27. data/docs/changelogs/0.6.0.md +23 -0
  28. data/docs/cli.md +98 -0
  29. data/docs/diagnostics/HS001_persistent_class_growth.md +39 -0
  30. data/docs/diagnostics/HS002_high_retention_ratio.md +24 -0
  31. data/docs/diagnostics/HS003_thread_local_retention.md +24 -0
  32. data/docs/diagnostics/HS004_unbounded_collection.md +19 -0
  33. data/docs/diagnostics/HS005_callback_accumulation.md +14 -0
  34. data/docs/diagnostics/HS006_closure_retention.md +15 -0
  35. data/docs/diagnostics/HS007_poor_gc_recovery.md +18 -0
  36. data/docs/diagnostics/HS008_baseline_regression.md +15 -0
  37. data/docs/diagnostics/HS009_high_allocation_pressure.md +13 -0
  38. data/docs/diagnostics/HS010_native_memory_mismatch.md +19 -0
  39. data/docs/guides/ci-budgets.md +43 -0
  40. data/docs/guides/first-retention-experiment.md +25 -0
  41. data/docs/guides/production-safe.md +17 -0
  42. data/docs/index.md +38 -0
  43. data/examples/cache_vs_leak.rb +30 -0
  44. data/examples/closure_capture.rb +20 -0
  45. data/examples/healthy_churn.rb +16 -0
  46. data/examples/heapscope.yml +12 -0
  47. data/examples/import_leak.rb +19 -0
  48. data/examples/probe_and_session.rb +22 -0
  49. data/examples/thread_local_leak.rb +31 -0
  50. data/exe/heapscope +7 -0
  51. data/heapscope.gemspec +73 -0
  52. data/lib/heapscope/aging.rb +114 -0
  53. data/lib/heapscope/analyzer.rb +333 -0
  54. data/lib/heapscope/baseline.rb +77 -0
  55. data/lib/heapscope/branding.rb +98 -0
  56. data/lib/heapscope/budget.rb +108 -0
  57. data/lib/heapscope/capabilities.rb +42 -0
  58. data/lib/heapscope/catalog.rb +71 -0
  59. data/lib/heapscope/cli/color.rb +67 -0
  60. data/lib/heapscope/cli/commands/capture.rb +289 -0
  61. data/lib/heapscope/cli/commands/diffing.rb +157 -0
  62. data/lib/heapscope/cli/commands/meta.rb +244 -0
  63. data/lib/heapscope/cli/commands/reporting.rb +228 -0
  64. data/lib/heapscope/cli/completion.rb +72 -0
  65. data/lib/heapscope/cli/help.rb +226 -0
  66. data/lib/heapscope/cli/support.rb +126 -0
  67. data/lib/heapscope/cli.rb +165 -0
  68. data/lib/heapscope/closures.rb +102 -0
  69. data/lib/heapscope/collector.rb +167 -0
  70. data/lib/heapscope/config.rb +196 -0
  71. data/lib/heapscope/detectors.rb +131 -0
  72. data/lib/heapscope/diff.rb +130 -0
  73. data/lib/heapscope/dominators.rb +87 -0
  74. data/lib/heapscope/errors.rb +13 -0
  75. data/lib/heapscope/extrapolation.rb +51 -0
  76. data/lib/heapscope/findings.rb +149 -0
  77. data/lib/heapscope/globals.rb +108 -0
  78. data/lib/heapscope/graph.rb +218 -0
  79. data/lib/heapscope/growth.rb +108 -0
  80. data/lib/heapscope/middleware.rb +35 -0
  81. data/lib/heapscope/minitest.rb +47 -0
  82. data/lib/heapscope/monitor.rb +160 -0
  83. data/lib/heapscope/noise.rb +48 -0
  84. data/lib/heapscope/notifications.rb +79 -0
  85. data/lib/heapscope/pack.rb +55 -0
  86. data/lib/heapscope/paths.rb +64 -0
  87. data/lib/heapscope/rails.rb +71 -0
  88. data/lib/heapscope/report/html.rb +283 -0
  89. data/lib/heapscope/report/markdown.rb +78 -0
  90. data/lib/heapscope/report/text.rb +204 -0
  91. data/lib/heapscope/report.rb +308 -0
  92. data/lib/heapscope/retention.rb +91 -0
  93. data/lib/heapscope/rspec.rb +118 -0
  94. data/lib/heapscope/runtime/base.rb +130 -0
  95. data/lib/heapscope/runtime/jruby.rb +28 -0
  96. data/lib/heapscope/runtime/mri.rb +86 -0
  97. data/lib/heapscope/runtime/truffleruby.rb +40 -0
  98. data/lib/heapscope/runtime/windows_rss.rb +75 -0
  99. data/lib/heapscope/runtime.rb +33 -0
  100. data/lib/heapscope/schema.rb +28 -0
  101. data/lib/heapscope/scorecard.rb +85 -0
  102. data/lib/heapscope/session.rb +90 -0
  103. data/lib/heapscope/sidekiq_middleware.rb +36 -0
  104. data/lib/heapscope/snapshot.rb +165 -0
  105. data/lib/heapscope/suggest.rb +99 -0
  106. data/lib/heapscope/tables.rb +58 -0
  107. data/lib/heapscope/trend_store.rb +41 -0
  108. data/lib/heapscope/version.rb +6 -0
  109. data/lib/heapscope.rb +307 -0
  110. metadata +211 -0
metadata ADDED
@@ -0,0 +1,211 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: heapscope
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.6.0
5
+ platform: ruby
6
+ authors:
7
+ - theworker02
8
+ bindir: exe
9
+ cert_chain: []
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
+ dependencies:
12
+ - !ruby/object:Gem::Dependency
13
+ name: minitest
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ - - "~>"
17
+ - !ruby/object:Gem::Version
18
+ version: '5.20'
19
+ type: :development
20
+ prerelease: false
21
+ version_requirements: !ruby/object:Gem::Requirement
22
+ requirements:
23
+ - - "~>"
24
+ - !ruby/object:Gem::Version
25
+ version: '5.20'
26
+ - !ruby/object:Gem::Dependency
27
+ name: rake
28
+ requirement: !ruby/object:Gem::Requirement
29
+ requirements:
30
+ - - "~>"
31
+ - !ruby/object:Gem::Version
32
+ version: '13.0'
33
+ type: :development
34
+ prerelease: false
35
+ version_requirements: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - "~>"
38
+ - !ruby/object:Gem::Version
39
+ version: '13.0'
40
+ - !ruby/object:Gem::Dependency
41
+ name: rubocop
42
+ requirement: !ruby/object:Gem::Requirement
43
+ requirements:
44
+ - - "~>"
45
+ - !ruby/object:Gem::Version
46
+ version: '1.60'
47
+ type: :development
48
+ prerelease: false
49
+ version_requirements: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - "~>"
52
+ - !ruby/object:Gem::Version
53
+ version: '1.60'
54
+ description: |
55
+ HeapScope is a local, evidence-driven memory diagnostics toolkit for Ruby.
56
+ It helps identify object retention, abnormal heap growth, allocation hot spots,
57
+ long-lived objects, GC-surviving populations, and likely memory leaks in
58
+ long-running Ruby processes — without claiming a leak unless evidence is strong.
59
+ email:
60
+ - matthewlooney5@gmail.com
61
+ executables:
62
+ - heapscope
63
+ extensions: []
64
+ extra_rdoc_files: []
65
+ files:
66
+ - ".rubocop.yml"
67
+ - CHANGELOG.md
68
+ - CODE_OF_CONDUCT.md
69
+ - CONTRIBUTING.md
70
+ - Gemfile
71
+ - LICENSE
72
+ - README.md
73
+ - Rakefile
74
+ - SECURITY.md
75
+ - assets/heapscope-logo.png
76
+ - assets/logo.svg
77
+ - assets/wordmark.svg
78
+ - docs/README.md
79
+ - docs/ROADMAP.md
80
+ - docs/adr/0001-evidence-over-certainty.md
81
+ - docs/adr/0002-local-only-privacy.md
82
+ - docs/adr/0003-runtime-adapters.md
83
+ - docs/adr/README.md
84
+ - docs/allocators.md
85
+ - docs/api/overview.md
86
+ - docs/changelogs/0.1.0.md
87
+ - docs/changelogs/0.2.0.md
88
+ - docs/changelogs/0.3.0.md
89
+ - docs/changelogs/0.4.0.md
90
+ - docs/changelogs/0.5.0.md
91
+ - docs/changelogs/0.6.0.md
92
+ - docs/cli.md
93
+ - docs/diagnostics/HS001_persistent_class_growth.md
94
+ - docs/diagnostics/HS002_high_retention_ratio.md
95
+ - docs/diagnostics/HS003_thread_local_retention.md
96
+ - docs/diagnostics/HS004_unbounded_collection.md
97
+ - docs/diagnostics/HS005_callback_accumulation.md
98
+ - docs/diagnostics/HS006_closure_retention.md
99
+ - docs/diagnostics/HS007_poor_gc_recovery.md
100
+ - docs/diagnostics/HS008_baseline_regression.md
101
+ - docs/diagnostics/HS009_high_allocation_pressure.md
102
+ - docs/diagnostics/HS010_native_memory_mismatch.md
103
+ - docs/guides/ci-budgets.md
104
+ - docs/guides/first-retention-experiment.md
105
+ - docs/guides/production-safe.md
106
+ - docs/index.md
107
+ - examples/cache_vs_leak.rb
108
+ - examples/closure_capture.rb
109
+ - examples/healthy_churn.rb
110
+ - examples/heapscope.yml
111
+ - examples/import_leak.rb
112
+ - examples/probe_and_session.rb
113
+ - examples/thread_local_leak.rb
114
+ - exe/heapscope
115
+ - heapscope.gemspec
116
+ - lib/heapscope.rb
117
+ - lib/heapscope/aging.rb
118
+ - lib/heapscope/analyzer.rb
119
+ - lib/heapscope/baseline.rb
120
+ - lib/heapscope/branding.rb
121
+ - lib/heapscope/budget.rb
122
+ - lib/heapscope/capabilities.rb
123
+ - lib/heapscope/catalog.rb
124
+ - lib/heapscope/cli.rb
125
+ - lib/heapscope/cli/color.rb
126
+ - lib/heapscope/cli/commands/capture.rb
127
+ - lib/heapscope/cli/commands/diffing.rb
128
+ - lib/heapscope/cli/commands/meta.rb
129
+ - lib/heapscope/cli/commands/reporting.rb
130
+ - lib/heapscope/cli/completion.rb
131
+ - lib/heapscope/cli/help.rb
132
+ - lib/heapscope/cli/support.rb
133
+ - lib/heapscope/closures.rb
134
+ - lib/heapscope/collector.rb
135
+ - lib/heapscope/config.rb
136
+ - lib/heapscope/detectors.rb
137
+ - lib/heapscope/diff.rb
138
+ - lib/heapscope/dominators.rb
139
+ - lib/heapscope/errors.rb
140
+ - lib/heapscope/extrapolation.rb
141
+ - lib/heapscope/findings.rb
142
+ - lib/heapscope/globals.rb
143
+ - lib/heapscope/graph.rb
144
+ - lib/heapscope/growth.rb
145
+ - lib/heapscope/middleware.rb
146
+ - lib/heapscope/minitest.rb
147
+ - lib/heapscope/monitor.rb
148
+ - lib/heapscope/noise.rb
149
+ - lib/heapscope/notifications.rb
150
+ - lib/heapscope/pack.rb
151
+ - lib/heapscope/paths.rb
152
+ - lib/heapscope/rails.rb
153
+ - lib/heapscope/report.rb
154
+ - lib/heapscope/report/html.rb
155
+ - lib/heapscope/report/markdown.rb
156
+ - lib/heapscope/report/text.rb
157
+ - lib/heapscope/retention.rb
158
+ - lib/heapscope/rspec.rb
159
+ - lib/heapscope/runtime.rb
160
+ - lib/heapscope/runtime/base.rb
161
+ - lib/heapscope/runtime/jruby.rb
162
+ - lib/heapscope/runtime/mri.rb
163
+ - lib/heapscope/runtime/truffleruby.rb
164
+ - lib/heapscope/runtime/windows_rss.rb
165
+ - lib/heapscope/schema.rb
166
+ - lib/heapscope/scorecard.rb
167
+ - lib/heapscope/session.rb
168
+ - lib/heapscope/sidekiq_middleware.rb
169
+ - lib/heapscope/snapshot.rb
170
+ - lib/heapscope/suggest.rb
171
+ - lib/heapscope/tables.rb
172
+ - lib/heapscope/trend_store.rb
173
+ - lib/heapscope/version.rb
174
+ homepage: https://github.com/theworker02/heapscope
175
+ licenses:
176
+ - MIT
177
+ metadata:
178
+ homepage_uri: https://github.com/theworker02/heapscope
179
+ source_code_uri: https://github.com/theworker02/heapscope.git
180
+ changelog_uri: https://github.com/theworker02/heapscope/blob/main/CHANGELOG.md
181
+ bug_tracker_uri: https://github.com/theworker02/heapscope/issues
182
+ documentation_uri: https://theworker02.github.io/heapscope/
183
+ funding_uri: https://thanks.dev/u/gh/theworker02
184
+ rubygems_mfa_required: 'true'
185
+ post_install_message: |2
186
+
187
+ HeapScope 0.6.0 installed.
188
+ heapscope doctor
189
+ heapscope about
190
+ https://theworker02.github.io/heapscope/
191
+ https://thanks.dev/u/gh/theworker02
192
+
193
+ Local-only diagnostics. No telemetry. No object-value dumps by default.
194
+ rdoc_options: []
195
+ require_paths:
196
+ - lib
197
+ required_ruby_version: !ruby/object:Gem::Requirement
198
+ requirements:
199
+ - - ">="
200
+ - !ruby/object:Gem::Version
201
+ version: 3.1.0
202
+ required_rubygems_version: !ruby/object:Gem::Requirement
203
+ requirements:
204
+ - - ">="
205
+ - !ruby/object:Gem::Version
206
+ version: '0'
207
+ requirements: []
208
+ rubygems_version: 4.0.16
209
+ specification_version: 4
210
+ summary: Ruby object retention, heap growth, and memory leak diagnostics
211
+ test_files: []