Skip to content

Commit 8becdd3

Browse files
committed
docs: Drop the memray3.N entry point
With `scikit-build-core`, we don't have any way to produce an entry point script called `memray3.N` (where `3.N` is the Python version Memray was installed for). Drop references to it from the docs. Signed-off-by: Matt Wozniski <[email protected]>
1 parent 7363ed4 commit 8becdd3

File tree

4 files changed

+11
-16
lines changed

4 files changed

+11
-16
lines changed

docs/examples/README.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,11 +11,11 @@ Make sure you install the required dependencies by running
1111
directory. The examples below use the project in the ``mandelbrot`` folder, but
1212
you can use the same instructions to launch the other examples as well.
1313

14-
To track memory allocations, invoke ``memray3.9 run``:
14+
To track memory allocations, invoke ``memray run``:
1515

1616
.. code:: shell
1717
18-
memray3.9 run mandelbrot/mandelbrot.py
18+
memray run mandelbrot/mandelbrot.py
1919
2020
Memray will print a message displaying the output file it creates.
2121

@@ -28,7 +28,7 @@ graph, use the following command:
2828

2929
.. code:: shell
3030
31-
memray3.9 flamegraph mandelbrot/memray-mandelbrot.py.187967.bin
31+
memray flamegraph mandelbrot/memray-mandelbrot.py.187967.bin
3232
3333
The HTML file for the flame graph will be generated under
3434
``mandelbrot/memray-flamegraph-mandelbrot.py.187967.html``. The flame graph

docs/getting_started.rst

Lines changed: 4 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -26,19 +26,13 @@ You can invoke Memray the following way:
2626
2727
python3.9 -m memray
2828
29-
Or alternatively through the version-qualified ``memrayX.Y`` script:
30-
31-
.. code:: shell
32-
33-
memray3.9
34-
35-
You can also invoke Memray without version-qualifying it:
29+
Or alternatively through the ``memray`` script:
3630

3731
.. code:: shell
3832
3933
memray
4034
41-
The downside to the unqualified ``memray`` script is that it's not immediately
35+
The downside to using the ``memray`` script is that it's not immediately
4236
clear what Python interpreter will be used to execute Memray. If you're using
4337
a virtual environment that's not a problem because you know exactly what interpreter is
4438
in use, but otherwise you need to be careful to ensure that ``memray`` is
@@ -56,7 +50,7 @@ To run memray on the ``example.py`` script, use :doc:`the run subcommand <run>`.
5650

5751
.. code:: shell
5852
59-
memray3.9 run example.py
53+
memray run example.py
6054
6155
This will execute the script and track its memory allocations, displaying the name of the file where results are being recorded with a message like:
6256

@@ -72,7 +66,7 @@ the results file:
7266

7367
.. code:: shell
7468
75-
memray3.9 flamegraph memray-example.py.4131.bin
69+
memray flamegraph memray-example.py.4131.bin
7670
7771
This will generate the ``memray-flamegraph-example.py.4131.html`` file in the current directory. See the :doc:`flamegraph`
7872
documentation which explains how to interpret flame graphs.

docs/run.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -140,15 +140,15 @@ You can run a program in live mode using ``run --live``:
140140

141141
.. code:: shell
142142
143-
memray3.9 run --live application.py
143+
memray run --live application.py
144144
145145
Immediately Memray will start your application in the background and will run a TUI in the foreground that you can use
146146
to analyze your application's memory usage. If you don't want to run your program in the background, you can instead
147147
use ``run --live-remote``:
148148

149149
.. code:: shell
150150
151-
memray3.9 run --live-remote application.py
151+
memray run --live-remote application.py
152152
153153
In this mode, Memray will choose an unused port, bind to it, and display a message saying:
154154

@@ -160,7 +160,7 @@ It will wait for you to run:
160160

161161
.. code:: shell
162162
163-
memray3.9 live <port>
163+
memray live <port>
164164
165165
in another terminal window to attach to it. Regardless of whether you choose to use one terminal or two, the resulting
166166
TUI is exactly the same. See :doc:`live` for details on how to interpret and control the TUI.

news/673.removal.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Memray no longer provides an entry point named ``memray3.N`` (where "3.N" is the Python version that Memray was installed for). You can use ``python3.N -m memray`` instead.

0 commit comments

Comments
 (0)