1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
:orphan:
Overview
========
.. argparse::
:ref: memray.commands.get_argument_parser
:manpage:
:nosubcommands:
Memray can track memory allocations in Python code, in native extension modules, and in the Python
interpreter itself. It can generate several different types of reports to help you analyze the captured
memory usage data. While commonly used as a CLI tool, it can also be used as a library to perform more
fine-grained profiling tasks.
Most commonly you will use the ``memray run`` subcommand to create a capture file, and then use a reporter
like the ``memray flamegraph`` subcommand to analyze it.
.. note::
This manual page only documents usage of the Memray subcommands that can be invoked from the command line.
See `<https://bloomberg.github.io/memray/overview.html>`_ for the full Memray documentation, which
includes advice for interpreting Memray reports, example programs, API documentation, information about
integrating Memray into Jupyter notebooks and pytest test suites, explanations to help you understand how
Python uses memory and how Memray gathers information about memory usage, and more.
RUN SUB-COMMAND
---------------
.. argparse::
:ref: memray.commands.get_argument_parser
:path: run
:nodefaultconst:
:noepilog:
FLAMEGRAPH SUB-COMMAND
----------------------
.. argparse::
:ref: memray.commands.get_argument_parser
:path: flamegraph
:nodefaultconst:
:noepilog:
TABLE SUB-COMMAND
-----------------
.. argparse::
:ref: memray.commands.get_argument_parser
:path: table
:nodefaultconst:
:noepilog:
LIVE SUB-COMMAND
----------------
.. argparse::
:ref: memray.commands.get_argument_parser
:path: live
:nodefaultconst:
:noepilog:
TREE SUB-COMMAND
----------------
.. argparse::
:ref: memray.commands.get_argument_parser
:path: tree
:nodefaultconst:
:noepilog:
PARSE SUB-COMMAND
-----------------
.. argparse::
:ref: memray.commands.get_argument_parser
:path: parse
:nodefaultconst:
:noepilog:
SUMMARY SUB-COMMAND
-------------------
.. argparse::
:ref: memray.commands.get_argument_parser
:path: summary
:nodefaultconst:
:noepilog:
STATS SUB-COMMAND
-----------------
.. argparse::
:ref: memray.commands.get_argument_parser
:path: stats
:nodefaultconst:
:noepilog:
TRANSFORM SUB-COMMAND
---------------------
.. argparse::
:ref: memray.commands.get_argument_parser
:path: transform
:nodefaultconst:
:noepilog:
ATTACH SUB-COMMAND
------------------
.. argparse::
:ref: memray.commands.get_argument_parser
:path: attach
:nodefaultconst:
:noepilog:
DETACH SUB-COMMAND
------------------
.. argparse::
:ref: memray.commands.get_argument_parser
:path: detach
:nodefaultconst:
:noepilog:
|
