From cd572ba37acc1f2147d36b65fc40f052043c5f8d Mon Sep 17 00:00:00 2001 From: abhro <5664668+abhro@users.noreply.github.com> Date: Sat, 19 Jul 2025 16:27:22 -0400 Subject: [PATCH] Update README.rst - Add header - Markup CLI text as monospace --- README.rst | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/README.rst b/README.rst index 3fda4d2..2e1f086 100644 --- a/README.rst +++ b/README.rst @@ -1,6 +1,10 @@ +======== +pprofile +======== + Line-granularity, thread-aware deterministic and statistic pure-python profiler -Inspired from Robert Kern's line_profiler_ . +Inspired from Robert Kern's line_profiler_. Usage ===== @@ -9,17 +13,17 @@ As a command:: $ pprofile some_python_executable arg1 ... -Once `some_python_executable` returns, prints annotated code of each file +Once ``some_python_executable`` returns, prints annotated code of each file involved in the execution. -As a command, ignoring any files from default `sys.path` (ie, python modules +As a command, ignoring any files from default ``sys.path`` (ie, python modules themselves), for shorter output:: $ pprofile --exclude-syspath some_python_executable arg1 ... -Executing a module, like :code:`python -m`. `--exclude-syspath` is not +Executing a module, like :code:`python -m`. ``--exclude-syspath`` is not recommended in this mode, as it will likely hide what you intend to profile. -Also, explicitly ending pprofile arguments with `--` will prevent accidentally +Also, explicitly ending pprofile arguments with ``--`` will prevent accidentally stealing command's arguments:: $ pprofile -m some_python_module -- arg1 ...