memory 0.1.0 → 0.3.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- checksums.yaml.gz.sig +0 -0
- data/bake/memory/profiler.rb +9 -7
- data/lib/memory/aggregate.rb +31 -19
- data/lib/memory/cache.rb +9 -19
- data/lib/memory/deque.rb +2 -19
- data/lib/memory/report.rb +14 -19
- data/lib/memory/rspec/profiler.rb +54 -0
- data/lib/memory/sampler.rb +12 -19
- data/lib/memory/version.rb +6 -20
- data/lib/memory.rb +6 -19
- data/license.md +45 -0
- data/readme.md +123 -0
- data.tar.gz.sig +0 -0
- metadata +107 -10
- metadata.gz.sig +0 -0
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 37c553347c5941efab19b0f3df37824d10193cbf138582cfc5d24a598ba5a850
|
4
|
+
data.tar.gz: edac25b5c09088fabde46d7af1cc5603897d26d5543b3c8b49adea9a92ef6c68
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 69d25c208346c039acf4c7b190c9b9eece09e7f6fc970db1d4191ed384d2cd74b0650f1c5e69d744e8a1344021c39945d0e21604706887d8495a3f719682bbf9
|
7
|
+
data.tar.gz: 0d5d16c7def274988e920930c181e6abf0d5d32b60489d24d95d35b6fc9faa71e4cf285524246a53c3eb9ec589a6892af7685b52a3d320f933a130c0ca1f1553
|
checksums.yaml.gz.sig
ADDED
Binary file
|
data/bake/memory/profiler.rb
CHANGED
@@ -1,13 +1,17 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
-
|
3
|
+
# Released under the MIT License.
|
4
|
+
# Copyright, 2013-2018, by Sam Saffron.
|
5
|
+
# Copyright, 2014, by Richard Schneeman.
|
6
|
+
# Copyright, 2018, by Jonas Peschla.
|
7
|
+
# Copyright, 2020-2022, by Samuel Williams.
|
8
|
+
|
9
|
+
def check(paths:)
|
4
10
|
require 'console'
|
5
11
|
|
6
|
-
paths = Dir["../../*.mprof"]
|
7
|
-
|
8
12
|
total_size = paths.sum{|path| File.size(path)}
|
9
13
|
|
10
|
-
require_relative 'lib/
|
14
|
+
require_relative '../../lib/memory'
|
11
15
|
|
12
16
|
report = Memory::Report.general
|
13
17
|
|
@@ -32,6 +36,4 @@ def check
|
|
32
36
|
end
|
33
37
|
|
34
38
|
report.print($stdout)
|
35
|
-
|
36
|
-
binding.irb
|
37
|
-
end
|
39
|
+
end
|
data/lib/memory/aggregate.rb
CHANGED
@@ -1,24 +1,7 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
-
#
|
4
|
-
#
|
5
|
-
# Permission is hereby granted, free of charge, to any person obtaining a copy
|
6
|
-
# of this software and associated documentation files (the "Software"), to deal
|
7
|
-
# in the Software without restriction, including without limitation the rights
|
8
|
-
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
9
|
-
# copies of the Software, and to permit persons to whom the Software is
|
10
|
-
# furnished to do so, subject to the following conditions:
|
11
|
-
#
|
12
|
-
# The above copyright notice and this permission notice shall be included in
|
13
|
-
# all copies or substantial portions of the Software.
|
14
|
-
#
|
15
|
-
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
16
|
-
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
17
|
-
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
18
|
-
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
19
|
-
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
20
|
-
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
21
|
-
# THE SOFTWARE.
|
3
|
+
# Released under the MIT License.
|
4
|
+
# Copyright, 2020-2022, by Samuel Williams.
|
22
5
|
|
23
6
|
module Memory
|
24
7
|
UNITS = {
|
@@ -59,6 +42,13 @@ module Memory
|
|
59
42
|
def to_s
|
60
43
|
"(#{Memory.formatted_bytes memory} in #{count} allocations)"
|
61
44
|
end
|
45
|
+
|
46
|
+
def as_json
|
47
|
+
{
|
48
|
+
memory: memory,
|
49
|
+
count: count
|
50
|
+
}
|
51
|
+
end
|
62
52
|
end
|
63
53
|
|
64
54
|
def initialize(title, &block)
|
@@ -69,7 +59,10 @@ module Memory
|
|
69
59
|
@totals = Hash.new{|h,k| h[k] = Total.new}
|
70
60
|
end
|
71
61
|
|
62
|
+
attr :title
|
63
|
+
attr :metric
|
72
64
|
attr :total
|
65
|
+
attr :totals
|
73
66
|
|
74
67
|
def << allocation
|
75
68
|
metric = @metric.call(allocation)
|
@@ -95,6 +88,14 @@ module Memory
|
|
95
88
|
|
96
89
|
io.puts nil
|
97
90
|
end
|
91
|
+
|
92
|
+
def as_json
|
93
|
+
{
|
94
|
+
title: @title,
|
95
|
+
total: @total.as_json,
|
96
|
+
totals: @totals.map{|k, v| [k, v.as_json]}
|
97
|
+
}
|
98
|
+
end
|
98
99
|
end
|
99
100
|
|
100
101
|
class ValueAggregate
|
@@ -105,6 +106,10 @@ module Memory
|
|
105
106
|
@aggregates = Hash.new{|h,k| h[k] = Aggregate.new(k.inspect, &@metric)}
|
106
107
|
end
|
107
108
|
|
109
|
+
attr :title
|
110
|
+
attr :metric
|
111
|
+
attr :aggregates
|
112
|
+
|
108
113
|
def << allocation
|
109
114
|
if value = allocation.value
|
110
115
|
aggregate = @aggregates[value]
|
@@ -124,5 +129,12 @@ module Memory
|
|
124
129
|
aggregate.print(io, level: level+1)
|
125
130
|
end
|
126
131
|
end
|
132
|
+
|
133
|
+
def as_json
|
134
|
+
{
|
135
|
+
title: @title,
|
136
|
+
aggregates: @aggregates.map{|k, v| [k, v.as_json]}
|
137
|
+
}
|
138
|
+
end
|
127
139
|
end
|
128
140
|
end
|
data/lib/memory/cache.rb
CHANGED
@@ -1,24 +1,14 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
-
#
|
4
|
-
#
|
5
|
-
#
|
6
|
-
#
|
7
|
-
#
|
8
|
-
#
|
9
|
-
#
|
10
|
-
#
|
11
|
-
#
|
12
|
-
# The above copyright notice and this permission notice shall be included in
|
13
|
-
# all copies or substantial portions of the Software.
|
14
|
-
#
|
15
|
-
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
16
|
-
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
17
|
-
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
18
|
-
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
19
|
-
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
20
|
-
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
21
|
-
# THE SOFTWARE.
|
3
|
+
# Released under the MIT License.
|
4
|
+
# Copyright, 2013-2020, by Sam Saffron.
|
5
|
+
# Copyright, 2015-2018, by Dave Gynn.
|
6
|
+
# Copyright, 2015, by Vincent Woo.
|
7
|
+
# Copyright, 2015, by Boris Staal.
|
8
|
+
# Copyright, 2016, by Hamdi Akoğuz.
|
9
|
+
# Copyright, 2018, by Jonas Peschla.
|
10
|
+
# Copyright, 2020, by Jean Boussier.
|
11
|
+
# Copyright, 2020-2022, by Samuel Williams.
|
22
12
|
|
23
13
|
module Memory
|
24
14
|
class Cache
|
data/lib/memory/deque.rb
CHANGED
@@ -1,24 +1,7 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
-
#
|
4
|
-
#
|
5
|
-
# Permission is hereby granted, free of charge, to any person obtaining a copy
|
6
|
-
# of this software and associated documentation files (the "Software"), to deal
|
7
|
-
# in the Software without restriction, including without limitation the rights
|
8
|
-
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
9
|
-
# copies of the Software, and to permit persons to whom the Software is
|
10
|
-
# furnished to do so, subject to the following conditions:
|
11
|
-
#
|
12
|
-
# The above copyright notice and this permission notice shall be included in
|
13
|
-
# all copies or substantial portions of the Software.
|
14
|
-
#
|
15
|
-
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
16
|
-
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
17
|
-
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
18
|
-
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
19
|
-
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
20
|
-
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
21
|
-
# THE SOFTWARE.
|
3
|
+
# Released under the MIT License.
|
4
|
+
# Copyright, 2020-2022, by Samuel Williams.
|
22
5
|
|
23
6
|
require 'objspace'
|
24
7
|
require 'msgpack'
|
data/lib/memory/report.rb
CHANGED
@@ -1,24 +1,7 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
-
#
|
4
|
-
#
|
5
|
-
# Permission is hereby granted, free of charge, to any person obtaining a copy
|
6
|
-
# of this software and associated documentation files (the "Software"), to deal
|
7
|
-
# in the Software without restriction, including without limitation the rights
|
8
|
-
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
9
|
-
# copies of the Software, and to permit persons to whom the Software is
|
10
|
-
# furnished to do so, subject to the following conditions:
|
11
|
-
#
|
12
|
-
# The above copyright notice and this permission notice shall be included in
|
13
|
-
# all copies or substantial portions of the Software.
|
14
|
-
#
|
15
|
-
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
16
|
-
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
17
|
-
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
18
|
-
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
19
|
-
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
20
|
-
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
21
|
-
# THE SOFTWARE.
|
3
|
+
# Released under the MIT License.
|
4
|
+
# Copyright, 2020-2022, by Samuel Williams.
|
22
5
|
|
23
6
|
require_relative 'aggregate'
|
24
7
|
|
@@ -66,5 +49,17 @@ module Memory
|
|
66
49
|
aggregate.print(io)
|
67
50
|
end
|
68
51
|
end
|
52
|
+
|
53
|
+
def as_json
|
54
|
+
{
|
55
|
+
total_allocated: @total_allocated.as_json,
|
56
|
+
total_retained: @total_retained.as_json,
|
57
|
+
aggregates: @aggregates.map(&:as_json)
|
58
|
+
}
|
59
|
+
end
|
60
|
+
|
61
|
+
def to_json(...)
|
62
|
+
as_json.to_json(...)
|
63
|
+
end
|
69
64
|
end
|
70
65
|
end
|
@@ -0,0 +1,54 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Released under the MIT License.
|
4
|
+
# Copyright, 2020-2022, by Samuel Williams.
|
5
|
+
|
6
|
+
require_relative '../sampler'
|
7
|
+
|
8
|
+
module Memory
|
9
|
+
module RSpec
|
10
|
+
module Profiler
|
11
|
+
def self.profile(scope)
|
12
|
+
memory_sampler = nil
|
13
|
+
|
14
|
+
scope.before(:all) do |example_group|
|
15
|
+
name = example_group.class.description.gsub(/[^\w]+/, "-")
|
16
|
+
path = "#{name}.mprof"
|
17
|
+
|
18
|
+
skip if File.exist?(path)
|
19
|
+
|
20
|
+
memory_sampler = Memory::Sampler.new
|
21
|
+
memory_sampler.start
|
22
|
+
end
|
23
|
+
|
24
|
+
scope.after(:all) do |example_group|
|
25
|
+
name = example_group.class.description.gsub(/[^\w]+/, "-")
|
26
|
+
path = "#{name}.mprof"
|
27
|
+
|
28
|
+
if memory_sampler
|
29
|
+
memory_sampler.stop
|
30
|
+
|
31
|
+
File.open(path, "w", encoding: Encoding::BINARY) do |io|
|
32
|
+
memory_sampler.dump(io)
|
33
|
+
end
|
34
|
+
|
35
|
+
memory_sampler = nil
|
36
|
+
end
|
37
|
+
end
|
38
|
+
|
39
|
+
scope.after(:suite) do
|
40
|
+
memory_sampler = Memory::Sampler.new
|
41
|
+
|
42
|
+
Dir.glob("*.mprof") do |path|
|
43
|
+
memory_sampler.load(File.read(
|
44
|
+
path,
|
45
|
+
encoding: Encoding::BINARY,
|
46
|
+
))
|
47
|
+
end
|
48
|
+
|
49
|
+
memory_sampler.report.print
|
50
|
+
end
|
51
|
+
end
|
52
|
+
end
|
53
|
+
end
|
54
|
+
end
|
data/lib/memory/sampler.rb
CHANGED
@@ -1,24 +1,17 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
-
#
|
4
|
-
#
|
5
|
-
#
|
6
|
-
#
|
7
|
-
#
|
8
|
-
#
|
9
|
-
#
|
10
|
-
#
|
11
|
-
#
|
12
|
-
#
|
13
|
-
#
|
14
|
-
#
|
15
|
-
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
16
|
-
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
17
|
-
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
18
|
-
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
19
|
-
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
20
|
-
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
21
|
-
# THE SOFTWARE.
|
3
|
+
# Released under the MIT License.
|
4
|
+
# Copyright, 2013-2020, by Sam Saffron.
|
5
|
+
# Copyright, 2014, by Richard Schneeman.
|
6
|
+
# Copyright, 2014, by Søren Skovsbøll.
|
7
|
+
# Copyright, 2015, by Anton Davydov.
|
8
|
+
# Copyright, 2015-2018, by Dave Gynn.
|
9
|
+
# Copyright, 2017, by Nick LaMuro.
|
10
|
+
# Copyright, 2018, by William Tabi.
|
11
|
+
# Copyright, 2018, by Jonas Peschla.
|
12
|
+
# Copyright, 2018, by Espartaco Palma.
|
13
|
+
# Copyright, 2020, by Jean Boussier.
|
14
|
+
# Copyright, 2020-2022, by Samuel Williams.
|
22
15
|
|
23
16
|
require 'objspace'
|
24
17
|
require 'msgpack'
|
data/lib/memory/version.rb
CHANGED
@@ -1,25 +1,11 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
-
#
|
4
|
-
#
|
5
|
-
#
|
6
|
-
#
|
7
|
-
#
|
8
|
-
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
9
|
-
# copies of the Software, and to permit persons to whom the Software is
|
10
|
-
# furnished to do so, subject to the following conditions:
|
11
|
-
#
|
12
|
-
# The above copyright notice and this permission notice shall be included in
|
13
|
-
# all copies or substantial portions of the Software.
|
14
|
-
#
|
15
|
-
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
16
|
-
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
17
|
-
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
18
|
-
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
19
|
-
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
20
|
-
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
21
|
-
# THE SOFTWARE.
|
3
|
+
# Released under the MIT License.
|
4
|
+
# Copyright, 2013-2019, by Sam Saffron.
|
5
|
+
# Copyright, 2015-2016, by Dave Gynn.
|
6
|
+
# Copyright, 2018, by Jonas Peschla.
|
7
|
+
# Copyright, 2020-2022, by Samuel Williams.
|
22
8
|
|
23
9
|
module Memory
|
24
|
-
VERSION = "0.
|
10
|
+
VERSION = "0.3.0"
|
25
11
|
end
|
data/lib/memory.rb
CHANGED
@@ -1,24 +1,11 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
-
#
|
4
|
-
#
|
5
|
-
#
|
6
|
-
#
|
7
|
-
#
|
8
|
-
#
|
9
|
-
# copies of the Software, and to permit persons to whom the Software is
|
10
|
-
# furnished to do so, subject to the following conditions:
|
11
|
-
#
|
12
|
-
# The above copyright notice and this permission notice shall be included in
|
13
|
-
# all copies or substantial portions of the Software.
|
14
|
-
#
|
15
|
-
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
16
|
-
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
17
|
-
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
18
|
-
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
19
|
-
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
20
|
-
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
21
|
-
# THE SOFTWARE.
|
3
|
+
# Released under the MIT License.
|
4
|
+
# Copyright, 2013-2019, by Sam Saffron.
|
5
|
+
# Copyright, 2014, by Søren Skovsbøll.
|
6
|
+
# Copyright, 2017, by Nick LaMuro.
|
7
|
+
# Copyright, 2018, by Jonas Peschla.
|
8
|
+
# Copyright, 2020-2022, by Samuel Williams.
|
22
9
|
|
23
10
|
require_relative "memory/version"
|
24
11
|
require_relative "memory/cache"
|
data/license.md
ADDED
@@ -0,0 +1,45 @@
|
|
1
|
+
# MIT License
|
2
|
+
|
3
|
+
Copyright, 2013-2020, by Sam Saffron.
|
4
|
+
Copyright, 2013, by Luís Ferreira.
|
5
|
+
Copyright, 2014, by John Bachir.
|
6
|
+
Copyright, 2014, by Andrew Grimm.
|
7
|
+
Copyright, 2014, by Richard Schneeman.
|
8
|
+
Copyright, 2014, by Jaiden Mispy.
|
9
|
+
Copyright, 2014, by Søren Skovsbøll.
|
10
|
+
Copyright, 2015, by Anton Davydov.
|
11
|
+
Copyright, 2015, by Mike Subelsky.
|
12
|
+
Copyright, 2015, by Florian Schwab.
|
13
|
+
Copyright, 2015-2018, by Dave Gynn.
|
14
|
+
Copyright, 2015, by Vincent Woo.
|
15
|
+
Copyright, 2015, by Boris Staal.
|
16
|
+
Copyright, 2016, by Hamdi Akoğuz.
|
17
|
+
Copyright, 2017, by Nick LaMuro.
|
18
|
+
Copyright, 2017, by Vasily Kolesnikov.
|
19
|
+
Copyright, 2018, by William Tabi.
|
20
|
+
Copyright, 2018, by Jonas Peschla.
|
21
|
+
Copyright, 2018, by Benoit Tigeot.
|
22
|
+
Copyright, 2018, by Espartaco Palma.
|
23
|
+
Copyright, 2019-2020, by Jean Boussier.
|
24
|
+
Copyright, 2019, by Ashwin Maroli.
|
25
|
+
Copyright, 2019, by Olle Jonsson.
|
26
|
+
Copyright, 2019, by Danny Ben Shitrit.
|
27
|
+
Copyright, 2020-2022, by Samuel Williams.
|
28
|
+
|
29
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
30
|
+
of this software and associated documentation files (the "Software"), to deal
|
31
|
+
in the Software without restriction, including without limitation the rights
|
32
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
33
|
+
copies of the Software, and to permit persons to whom the Software is
|
34
|
+
furnished to do so, subject to the following conditions:
|
35
|
+
|
36
|
+
The above copyright notice and this permission notice shall be included in all
|
37
|
+
copies or substantial portions of the Software.
|
38
|
+
|
39
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
40
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
41
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
42
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
43
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
44
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
45
|
+
SOFTWARE.
|
data/readme.md
ADDED
@@ -0,0 +1,123 @@
|
|
1
|
+
# Memory
|
2
|
+
|
3
|
+
A set of tools for profiling memory in Ruby.
|
4
|
+
|
5
|
+
[![Development Status](https://github.com/socketry/memory/workflows/Test/badge.svg)](https://github.com/socketry/memory/actions?workflow=Test)
|
6
|
+
|
7
|
+
## Features
|
8
|
+
|
9
|
+
- Fast memory capture for million+ allocations.
|
10
|
+
- Persist results to disk for vast aggregations and comparisons over time.
|
11
|
+
|
12
|
+
## Installation
|
13
|
+
|
14
|
+
Add this line to your application's Gemfile:
|
15
|
+
|
16
|
+
``` shell
|
17
|
+
$ bundle add 'memory'
|
18
|
+
```
|
19
|
+
|
20
|
+
## Usage
|
21
|
+
|
22
|
+
``` ruby
|
23
|
+
require 'memory'
|
24
|
+
|
25
|
+
report = Memory.report do
|
26
|
+
# run your code here
|
27
|
+
end
|
28
|
+
|
29
|
+
report.print
|
30
|
+
```
|
31
|
+
|
32
|
+
Or, you can use the `.start`/`.stop` methods as well:
|
33
|
+
|
34
|
+
``` ruby
|
35
|
+
require 'memory'
|
36
|
+
|
37
|
+
sampler = Memory::Sampler.new
|
38
|
+
|
39
|
+
sampler.start
|
40
|
+
# run your code here
|
41
|
+
sampler.stop
|
42
|
+
|
43
|
+
report = sampler.report
|
44
|
+
report.print
|
45
|
+
```
|
46
|
+
|
47
|
+
### RSpec Integration
|
48
|
+
|
49
|
+
``` ruby
|
50
|
+
memory_sampler = nil
|
51
|
+
config.before(:all) do |example_group|
|
52
|
+
name = example_group.class.description.gsub(/[^\w]+/, "-")
|
53
|
+
path = "#{name}.mprof"
|
54
|
+
|
55
|
+
skip if File.exist?(path)
|
56
|
+
|
57
|
+
memory_sampler = Memory::Sampler.new
|
58
|
+
memory_sampler.start
|
59
|
+
end
|
60
|
+
|
61
|
+
config.after(:all) do |example_group|
|
62
|
+
name = example_group.class.description.gsub(/[^\w]+/, "-")
|
63
|
+
path = "#{name}.mprof"
|
64
|
+
|
65
|
+
if memory_sampler
|
66
|
+
memory_sampler.stop
|
67
|
+
|
68
|
+
File.open(path, "w", encoding: Encoding::BINARY) do |io|
|
69
|
+
memory_sampler.dump(io)
|
70
|
+
end
|
71
|
+
|
72
|
+
memory_sampler = nil
|
73
|
+
end
|
74
|
+
end
|
75
|
+
|
76
|
+
config.after(:suite) do
|
77
|
+
memory_sampler = Memory::Sampler.new
|
78
|
+
|
79
|
+
Dir.glob("*.mprof") do |path|
|
80
|
+
memory_sampler.load(File.read(
|
81
|
+
path,
|
82
|
+
encoding: Encoding::BINARY,
|
83
|
+
))
|
84
|
+
end
|
85
|
+
|
86
|
+
memory_sampler.results.print
|
87
|
+
end
|
88
|
+
```
|
89
|
+
|
90
|
+
#### Raw Object Allocations
|
91
|
+
|
92
|
+
``` ruby
|
93
|
+
before = nil
|
94
|
+
|
95
|
+
config.before(:suite) do |example|
|
96
|
+
3.times{GC.start}
|
97
|
+
GC.disable
|
98
|
+
before = ObjectSpace.count_objects
|
99
|
+
end
|
100
|
+
|
101
|
+
config.after(:suite) do |example|
|
102
|
+
after = ObjectSpace.count_objects
|
103
|
+
GC.enable
|
104
|
+
|
105
|
+
$stderr.puts
|
106
|
+
$stderr.puts "Object Allocations:"
|
107
|
+
|
108
|
+
after.each do |key, b|
|
109
|
+
a = before.fetch(key, 0)
|
110
|
+
$stderr.puts "#{key}: #{a} -> #{b} = #{b-a} allocations"
|
111
|
+
end
|
112
|
+
end
|
113
|
+
```
|
114
|
+
|
115
|
+
## Contributing
|
116
|
+
|
117
|
+
We welcome contributions to this project.
|
118
|
+
|
119
|
+
1. Fork it.
|
120
|
+
2. Create your feature branch (`git checkout -b my-new-feature`).
|
121
|
+
3. Commit your changes (`git commit -am 'Add some feature'`).
|
122
|
+
4. Push to the branch (`git push origin my-new-feature`).
|
123
|
+
5. Create new Pull Request.
|
data.tar.gz.sig
ADDED
Binary file
|
metadata
CHANGED
@@ -1,16 +1,96 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: memory
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.3.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
|
-
- Samuel Williams
|
8
7
|
- Sam Saffron
|
8
|
+
- Dave Gynn
|
9
|
+
- Nick LaMuro
|
10
|
+
- Jonas Peschla
|
11
|
+
- Samuel Williams
|
12
|
+
- Ashwin Maroli
|
13
|
+
- Søren Skovsbøll
|
14
|
+
- Richard Schneeman
|
15
|
+
- Anton Davydov
|
16
|
+
- Benoit Tigeot
|
17
|
+
- Jean Boussier
|
18
|
+
- Vincent Woo
|
19
|
+
- Andrew Grimm
|
20
|
+
- Boris Staal
|
21
|
+
- Danny Ben Shitrit
|
22
|
+
- Espartaco Palma
|
23
|
+
- Florian Schwab
|
24
|
+
- Hamdi Akoğuz
|
25
|
+
- Jaiden Mispy
|
26
|
+
- John Bachir
|
27
|
+
- Luís Ferreira
|
28
|
+
- Mike Subelsky
|
29
|
+
- Olle Jonsson
|
30
|
+
- Vasily Kolesnikov
|
31
|
+
- William Tabi
|
9
32
|
autorequire:
|
10
33
|
bindir: bin
|
11
|
-
cert_chain:
|
12
|
-
|
34
|
+
cert_chain:
|
35
|
+
- |
|
36
|
+
-----BEGIN CERTIFICATE-----
|
37
|
+
MIIE2DCCA0CgAwIBAgIBATANBgkqhkiG9w0BAQsFADBhMRgwFgYDVQQDDA9zYW11
|
38
|
+
ZWwud2lsbGlhbXMxHTAbBgoJkiaJk/IsZAEZFg1vcmlvbnRyYW5zZmVyMRIwEAYK
|
39
|
+
CZImiZPyLGQBGRYCY28xEjAQBgoJkiaJk/IsZAEZFgJuejAeFw0yMjA4MDYwNDUz
|
40
|
+
MjRaFw0zMjA4MDMwNDUzMjRaMGExGDAWBgNVBAMMD3NhbXVlbC53aWxsaWFtczEd
|
41
|
+
MBsGCgmSJomT8ixkARkWDW9yaW9udHJhbnNmZXIxEjAQBgoJkiaJk/IsZAEZFgJj
|
42
|
+
bzESMBAGCgmSJomT8ixkARkWAm56MIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIB
|
43
|
+
igKCAYEAomvSopQXQ24+9DBB6I6jxRI2auu3VVb4nOjmmHq7XWM4u3HL+pni63X2
|
44
|
+
9qZdoq9xt7H+RPbwL28LDpDNflYQXoOhoVhQ37Pjn9YDjl8/4/9xa9+NUpl9XDIW
|
45
|
+
sGkaOY0eqsQm1pEWkHJr3zn/fxoKPZPfaJOglovdxf7dgsHz67Xgd/ka+Wo1YqoE
|
46
|
+
e5AUKRwUuvaUaumAKgPH+4E4oiLXI4T1Ff5Q7xxv6yXvHuYtlMHhYfgNn8iiW8WN
|
47
|
+
XibYXPNP7NtieSQqwR/xM6IRSoyXKuS+ZNGDPUUGk8RoiV/xvVN4LrVm9upSc0ss
|
48
|
+
RZ6qwOQmXCo/lLcDUxJAgG95cPw//sI00tZan75VgsGzSWAOdjQpFM0l4dxvKwHn
|
49
|
+
tUeT3ZsAgt0JnGqNm2Bkz81kG4A2hSyFZTFA8vZGhp+hz+8Q573tAR89y9YJBdYM
|
50
|
+
zp0FM4zwMNEUwgfRzv1tEVVUEXmoFCyhzonUUw4nE4CFu/sE3ffhjKcXcY//qiSW
|
51
|
+
xm4erY3XAgMBAAGjgZowgZcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0O
|
52
|
+
BBYEFO9t7XWuFf2SKLmuijgqR4sGDlRsMC4GA1UdEQQnMCWBI3NhbXVlbC53aWxs
|
53
|
+
aWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MC4GA1UdEgQnMCWBI3NhbXVlbC53aWxs
|
54
|
+
aWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MA0GCSqGSIb3DQEBCwUAA4IBgQB5sxkE
|
55
|
+
cBsSYwK6fYpM+hA5B5yZY2+L0Z+27jF1pWGgbhPH8/FjjBLVn+VFok3CDpRqwXCl
|
56
|
+
xCO40JEkKdznNy2avOMra6PFiQyOE74kCtv7P+Fdc+FhgqI5lMon6tt9rNeXmnW/
|
57
|
+
c1NaMRdxy999hmRGzUSFjozcCwxpy/LwabxtdXwXgSay4mQ32EDjqR1TixS1+smp
|
58
|
+
8C/NCWgpIfzpHGJsjvmH2wAfKtTTqB9CVKLCWEnCHyCaRVuKkrKjqhYCdmMBqCws
|
59
|
+
JkxfQWC+jBVeG9ZtPhQgZpfhvh+6hMhraUYRQ6XGyvBqEUe+yo6DKIT3MtGE2+CP
|
60
|
+
eX9i9ZWBydWb8/rvmwmX2kkcBbX0hZS1rcR593hGc61JR6lvkGYQ2MYskBveyaxt
|
61
|
+
Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
|
62
|
+
voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
|
63
|
+
-----END CERTIFICATE-----
|
64
|
+
date: 2022-11-15 00:00:00.000000000 Z
|
13
65
|
dependencies:
|
66
|
+
- !ruby/object:Gem::Dependency
|
67
|
+
name: bake
|
68
|
+
requirement: !ruby/object:Gem::Requirement
|
69
|
+
requirements:
|
70
|
+
- - "~>"
|
71
|
+
- !ruby/object:Gem::Version
|
72
|
+
version: '0.15'
|
73
|
+
type: :runtime
|
74
|
+
prerelease: false
|
75
|
+
version_requirements: !ruby/object:Gem::Requirement
|
76
|
+
requirements:
|
77
|
+
- - "~>"
|
78
|
+
- !ruby/object:Gem::Version
|
79
|
+
version: '0.15'
|
80
|
+
- !ruby/object:Gem::Dependency
|
81
|
+
name: console
|
82
|
+
requirement: !ruby/object:Gem::Requirement
|
83
|
+
requirements:
|
84
|
+
- - ">="
|
85
|
+
- !ruby/object:Gem::Version
|
86
|
+
version: '0'
|
87
|
+
type: :runtime
|
88
|
+
prerelease: false
|
89
|
+
version_requirements: !ruby/object:Gem::Requirement
|
90
|
+
requirements:
|
91
|
+
- - ">="
|
92
|
+
- !ruby/object:Gem::Version
|
93
|
+
version: '0'
|
14
94
|
- !ruby/object:Gem::Dependency
|
15
95
|
name: msgpack
|
16
96
|
requirement: !ruby/object:Gem::Requirement
|
@@ -25,6 +105,20 @@ dependencies:
|
|
25
105
|
- - ">="
|
26
106
|
- !ruby/object:Gem::Version
|
27
107
|
version: '0'
|
108
|
+
- !ruby/object:Gem::Dependency
|
109
|
+
name: bake-test
|
110
|
+
requirement: !ruby/object:Gem::Requirement
|
111
|
+
requirements:
|
112
|
+
- - ">="
|
113
|
+
- !ruby/object:Gem::Version
|
114
|
+
version: '0'
|
115
|
+
type: :development
|
116
|
+
prerelease: false
|
117
|
+
version_requirements: !ruby/object:Gem::Requirement
|
118
|
+
requirements:
|
119
|
+
- - ">="
|
120
|
+
- !ruby/object:Gem::Version
|
121
|
+
version: '0'
|
28
122
|
- !ruby/object:Gem::Dependency
|
29
123
|
name: bundler
|
30
124
|
requirement: !ruby/object:Gem::Requirement
|
@@ -54,19 +148,19 @@ dependencies:
|
|
54
148
|
- !ruby/object:Gem::Version
|
55
149
|
version: '0'
|
56
150
|
- !ruby/object:Gem::Dependency
|
57
|
-
name:
|
151
|
+
name: sus
|
58
152
|
requirement: !ruby/object:Gem::Requirement
|
59
153
|
requirements:
|
60
|
-
- - "
|
154
|
+
- - ">="
|
61
155
|
- !ruby/object:Gem::Version
|
62
|
-
version: '
|
156
|
+
version: '0'
|
63
157
|
type: :development
|
64
158
|
prerelease: false
|
65
159
|
version_requirements: !ruby/object:Gem::Requirement
|
66
160
|
requirements:
|
67
|
-
- - "
|
161
|
+
- - ">="
|
68
162
|
- !ruby/object:Gem::Version
|
69
|
-
version: '
|
163
|
+
version: '0'
|
70
164
|
description:
|
71
165
|
email:
|
72
166
|
executables: []
|
@@ -79,8 +173,11 @@ files:
|
|
79
173
|
- lib/memory/cache.rb
|
80
174
|
- lib/memory/deque.rb
|
81
175
|
- lib/memory/report.rb
|
176
|
+
- lib/memory/rspec/profiler.rb
|
82
177
|
- lib/memory/sampler.rb
|
83
178
|
- lib/memory/version.rb
|
179
|
+
- license.md
|
180
|
+
- readme.md
|
84
181
|
homepage: https://github.com/socketry/memory
|
85
182
|
licenses:
|
86
183
|
- MIT
|
@@ -100,7 +197,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
100
197
|
- !ruby/object:Gem::Version
|
101
198
|
version: '0'
|
102
199
|
requirements: []
|
103
|
-
rubygems_version: 3.
|
200
|
+
rubygems_version: 3.3.7
|
104
201
|
signing_key:
|
105
202
|
specification_version: 4
|
106
203
|
summary: Memory profiling routines for Ruby 2.3+
|
metadata.gz.sig
ADDED
Binary file
|