profiling-explorer 1.0.0__tar.gz → 1.1.0__tar.gz

profiling_explorer-1.1.0/CHANGELOG.rst

@@ -0,0 +1,29 @@
+=========
+Changelog
+=========
+
+1.1.0 (2026-04-13)
+------------------
+
+* Extend search to support multiple terms.
+
+  `PR #33 <https://github.com/adamchainz/profiling-explorer/pull/33>`__.
+
+* Add keyboard shortcuts to focus the search box.
+
+  `PR #35 <https://github.com/adamchainz/profiling-explorer/pull/35>`__.
+
+* Fix callers/callees views for built-in functions.
+
+  `PR #34 <https://github.com/adamchainz/profiling-explorer/pull/34>`__.
+  Thanks to David Szotten for the report in `Issue #32 <https://github.com/adamchainz/profiling-explorer/issues/32>`__.
+
+1.0.1 (2026-04-02)
+------------------
+
+* Fix crash when a record has an empty filename.
+
+1.0.0 (2026-04-02)
+------------------
+
+* Initial release.

{profiling_explorer-1.0.0/src/profiling_explorer.egg-info → profiling_explorer-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: profiling-explorer
-Version: 1.0.0
+Version: 1.1.0
 Summary: Table-based exploration tool for Python profiling data (pstats files).
 Author-email: Adam Johnson <me@adamj.eu>
 License-Expression: MIT
@@ -55,9 +55,11 @@ Table-based exploration tool for Python profiling data (pstats files).
 .. …then in another tab:
 .. uvx shot-scraper --width 1280 --height 720 --retina --wait 1000 http://127.0.0.1:8099/ -o screenshot.png
 
-.. figure:: https://raw.githubusercontent.com/adamchainz/profiling-explorer/screenshot/screenshot.png
+.. figure:: https://raw.githubusercontent.com/adamchainz/profiling-explorer/main/screenshot.png
    :alt: profiling-explorer screenshot
 
+Read more in `the introductory blog post <https://adamj.eu/tech/2026/04/03/python-introducing-profiling-explorer/>`__.
+
 ----
 
 **Get better at command line Git** with my book `Boost Your Git DX <https://adamchainz.gumroad.com/l/bygdx>`__.
@@ -110,6 +112,9 @@ Features:
 
 * Click the **calls**, **internal ms**, or **cumulative ms** column headers to sort by that column.
 * Use the search box to filter by filename or function name.
+  Separate multiple search terms by spaces to match records that contain all terms.
+* Press a keyboard shortcut to focus the search box: ``/``, ``Control+K``, or ``Command+K``.
+  Select some text first, like a filename, to pre-fill the search box with that text.
 * Hover by a filename + line number pair to reveal the copy button, which copies the location to your clipboard for faster opening.
 * Click the **callers** or **callees** links on the right of a row to see the callers or callees of that function.
 

{profiling_explorer-1.0.0 → profiling_explorer-1.1.0}/README.rst

@@ -28,9 +28,11 @@ Table-based exploration tool for Python profiling data (pstats files).
 .. …then in another tab:
 .. uvx shot-scraper --width 1280 --height 720 --retina --wait 1000 http://127.0.0.1:8099/ -o screenshot.png
 
-.. figure:: https://raw.githubusercontent.com/adamchainz/profiling-explorer/screenshot/screenshot.png
+.. figure:: https://raw.githubusercontent.com/adamchainz/profiling-explorer/main/screenshot.png
    :alt: profiling-explorer screenshot
 
+Read more in `the introductory blog post <https://adamj.eu/tech/2026/04/03/python-introducing-profiling-explorer/>`__.
+
 ----
 
 **Get better at command line Git** with my book `Boost Your Git DX <https://adamchainz.gumroad.com/l/bygdx>`__.
@@ -83,6 +85,9 @@ Features:
 
 * Click the **calls**, **internal ms**, or **cumulative ms** column headers to sort by that column.
 * Use the search box to filter by filename or function name.
+  Separate multiple search terms by spaces to match records that contain all terms.
+* Press a keyboard shortcut to focus the search box: ``/``, ``Control+K``, or ``Command+K``.
+  Select some text first, like a filename, to pre-fill the search box with that text.
 * Hover by a filename + line number pair to reveal the copy button, which copies the location to your clipboard for faster opening.
 * Click the **callers** or **callees** links on the right of a row to see the callers or callees of that function.
 

{profiling_explorer-1.0.0 → profiling_explorer-1.1.0}/pyproject.toml

@@ -6,7 +6,7 @@ requires = [
 
 [project]
 name = "profiling-explorer"
-version = "1.0.0"
+version = "1.1.0"
 description = "Table-based exploration tool for Python profiling data (pstats files)."
 readme = "README.rst"
 keywords = [
@@ -44,7 +44,7 @@ scripts.profiling-explorer = "profiling_explorer.main:main"
 [dependency-groups]
 test = [
   "cogapp>=3.6",
-  "coverage[toml]",
+  "coverage[toml]>=7.10",
   "pytest",
   "pytest-django",
   "pytest-randomly",
@@ -90,6 +90,18 @@ lint.isort.required-imports = [ "from __future__ import annotations" ]
 [tool.pyproject-fmt]
 max_supported_python = "3.14"
 
+[tool.mypy]
+enable_error_code = [
+  "ignore-without-code",
+  "redundant-expr",
+  "truthy-bool",
+]
+mypy_path = "src/"
+namespace_packages = false
+strict = true
+warn_unreachable = true
+overrides = [ { module = "tests.*", allow_untyped_defs = true } ]
+
 [tool.pytest]
 ini_options.addopts = """\
     --strict-config
@@ -111,24 +123,9 @@ paths.source = [
   "src",
   ".tox/**/site-packages",
 ]
-report.exclude_also = [
-  "if TYPE_CHECKING:",
-]
 report.show_missing = true
 report.skip_covered = true
 report.skip_empty = true
 
-[tool.mypy]
-enable_error_code = [
-  "ignore-without-code",
-  "redundant-expr",
-  "truthy-bool",
-]
-mypy_path = "src/"
-namespace_packages = false
-strict = true
-warn_unreachable = true
-overrides = [ { module = "tests.*", allow_untyped_defs = true } ]
-
 [tool.rstcheck]
 report_level = "ERROR"

{profiling_explorer-1.0.0 → profiling_explorer-1.1.0}/src/profiling_explorer/main.py

@@ -17,7 +17,7 @@ def main(argv: Sequence[str] | None = None) -> int:
         argv = sys.argv[1:]
 
     parser = argparse.ArgumentParser(prog="profiling-explorer", allow_abbrev=False)
-    parser.suggest_on_error = True  # type: ignore[attr-defined]
+    parser.suggest_on_error = True
     parser.add_argument(
         "filename",
         metavar="FILE",

{profiling_explorer-1.0.0 → profiling_explorer-1.1.0}/src/profiling_explorer/static/script.js

@@ -6,32 +6,63 @@ async function fetchDoc(url, options) {
 
 // Filter box
 const searchInput = document.getElementById('pe-search');
-let searchTimeout = null;
-let searchAbort = null;
 
+document.addEventListener('keydown', (e) => {
+  const target = event.composedPath()?.[0] || event.target;
+  const isTextField =
+    target instanceof HTMLElement &&
+    (["TEXTAREA", "INPUT"].includes(target.tagName) ||
+      target.isContentEditable);
+
+  if (isTextField) {
+    return;
+  }
+
+  const selection = globalThis.getSelection()?.toString();
+  const keyPressed = event.key;
+  const ctrlOrMetaPressed = event.ctrlKey || event.metaKey;
+  const isSlash = keyPressed === "/" && !ctrlOrMetaPressed;
+  const isCtrlK = keyPressed === "k" && ctrlOrMetaPressed && !event.shiftKey;
+
+  if (isSlash || isCtrlK) {
+    event.preventDefault();
+    searchInput.focus();
+    if (selection) {
+      searchInput.value = selection;
+      clearTimeout(searchTimeout);
+      searchTimeout = setTimeout(doSearch, 0);
+    }
+  }
+});
+
+let searchTimeout = null;
 searchInput.addEventListener('input', () => {
   clearTimeout(searchTimeout);
-  searchTimeout = setTimeout(async () => {
-    const q = searchInput.value.trim();
-    const url = new URL(window.location.href);
-    if (q) {
-      url.searchParams.set('q', q);
-    } else {
-      url.searchParams.delete('q');
-    }
-    history.replaceState(null, '', url);
-
-    searchAbort?.abort();
-    searchAbort = new AbortController();
-    try {
-      const doc = await fetchDoc(url, { signal: searchAbort.signal });
-      document.querySelector('main').replaceWith(doc.querySelector('main'));
-    } catch (e) {
-      if (e.name !== 'AbortError') throw e;
-    }
-  }, 300);
+  searchTimeout = setTimeout(doSearch, 300);
 });
 
+let searchAbort = null;
+
+async function doSearch() {
+  const q = searchInput.value.trim();
+  const url = new URL(window.location.href);
+  if (q) {
+    url.searchParams.set('q', q);
+  } else {
+    url.searchParams.delete('q');
+  }
+  history.replaceState(null, '', url);
+
+  searchAbort?.abort();
+  searchAbort = new AbortController();
+  try {
+    const doc = await fetchDoc(url, { signal: searchAbort.signal });
+    document.querySelector('main').replaceWith(doc.querySelector('main'));
+  } catch (e) {
+    if (e.name !== 'AbortError') throw e;
+  }
+}
+
 // Copy buttons
 document.addEventListener('click', (e) => {
   const btn = e.target.closest('button.copy-btn');

{profiling_explorer-1.0.0 → profiling_explorer-1.1.0}/src/profiling_explorer/views.py

@@ -4,6 +4,7 @@ import hashlib
 import os
 import pstats
 import re
+from collections import defaultdict
 from dataclasses import dataclass
 from importlib.resources import files as resource_files
 from typing import Any
@@ -23,11 +24,6 @@ class RowStats:
     cumulative_ms_pct: float
 
 
-@dataclass(slots=True)
-class EdgeStats(RowStats):
-    pass
-
-
 @dataclass(slots=True)
 class Row(RowStats):
     id: str
@@ -44,8 +40,8 @@ class Profile:
     total_time_ms: int
     rows: list[Row]
     rows_by_id: dict[str, Row]
-    callers_map: dict[str, dict[str, EdgeStats]]
-    callees_map: dict[str, dict[str, EdgeStats]]
+    callers_map: defaultdict[str, dict[str, RowStats]]
+    callees_map: defaultdict[str, dict[str, RowStats]]
 
 
 # Populated by main()
@@ -68,11 +64,21 @@ _STRIP_PREFIX_RE = re.compile(
 )
 
 
-def _shorten_filename(filename: str) -> str:
-    match = _STRIP_PREFIX_RE.match(filename)
-    if match:
-        return filename[match.end() :]
-    return os.path.relpath(filename)
+def _shorten_filename_function(filename: str, funcname: str) -> tuple[str, str, str]:
+    if filename == "~":
+        if funcname.startswith("<") and funcname.endswith(">"):
+            funcname = f"{{{funcname[1:-1]}}}"
+        short_filename = ""
+        full_filename = ""
+    else:
+        if filename == "":
+            short_filename = ""
+        match = _STRIP_PREFIX_RE.match(filename)
+        if match:
+            short_filename = filename[match.end() :]
+        short_filename = os.path.relpath(filename)
+        full_filename = filename
+    return full_filename, short_filename, funcname
 
 
 def _row_id(full_filename: str, lineno: int, funcname: str) -> str:
@@ -93,17 +99,14 @@ def build_profile(s: pstats.Stats, path: str) -> Profile:
     total_time_ms = round(s.total_tt * 1000)  # type: ignore[attr-defined]
     rows = []
     rows_by_id = {}
+    callers_map: defaultdict[str, dict[str, RowStats]] = defaultdict(dict)
+    callees_map: defaultdict[str, dict[str, RowStats]] = defaultdict(dict)
     for key in s.fcn_list:  # type: ignore[attr-defined]
         filename, lineno, funcname = key
-        _, calls, tottime, cumtime, _ = s.stats[key]  # type: ignore[attr-defined]
-        if filename == "~":
-            if funcname.startswith("<") and funcname.endswith(">"):
-                funcname = f"{{{funcname[1:-1]}}}"
-            short_filename = ""
-            full_filename = ""
-        else:
-            short_filename = _shorten_filename(filename)
-            full_filename = filename
+        _, calls, tottime, cumtime, callers = s.stats[key]  # type: ignore[attr-defined]
+        full_filename, short_filename, funcname = _shorten_filename_function(
+            filename, funcname
+        )
         row_id = _row_id(full_filename, lineno, funcname)
         cumulative_ms = round(cumtime * 1_000)
         row = Row(
@@ -122,31 +125,32 @@ def build_profile(s: pstats.Stats, path: str) -> Profile:
         )
         rows.append(row)
         rows_by_id[row_id] = row
-
-    def make_edge(enc: int, etc: float) -> EdgeStats:
-        cumulative_ms = round(etc * 1_000)
-        return EdgeStats(
-            calls=enc,
-            calls_pct=min(100.0, enc / total_calls * 100) if total_calls else 0.0,
-            internal_ms=None,
-            cumulative_ms=cumulative_ms,
-            cumulative_ms_pct=(
-                min(100.0, cumulative_ms / total_time_ms * 100)
-                if total_time_ms
-                else 0.0
-            ),
-        )
-
-    callers_map: dict[str, dict[str, EdgeStats]] = {}
-    callees_map: dict[str, dict[str, EdgeStats]] = {}
-    for (filename, lineno, funcname), (*_, callers) in s.stats.items():  # type: ignore[attr-defined]
-        full_filename = "" if filename == "~" else filename
-        callee_id = _row_id(full_filename, lineno, funcname)
-        for caller_key, (enc, _, __, etc) in callers.items():
-            caller_id = _row_id_from_pstats_key(caller_key)
-            edge = make_edge(enc, etc)
-            callers_map.setdefault(callee_id, {})[caller_id] = edge
-            callees_map.setdefault(caller_id, {})[callee_id] = edge
+        for (caller_filename, caller_lineno, caller_funcname), (
+            callee_calls,
+            _,
+            __,
+            callee_cumtime,
+        ) in callers.items():
+            caller_filename, _, caller_funcname = _shorten_filename_function(
+                caller_filename, caller_funcname
+            )
+            caller_id = _row_id(caller_filename, caller_lineno, caller_funcname)
+            callee_cumulative_ms = round(callee_cumtime * 1_000)
+            edge = RowStats(
+                calls=callee_calls,
+                calls_pct=min(100.0, callee_calls / total_calls * 100)
+                if total_calls
+                else 0.0,
+                internal_ms=None,
+                cumulative_ms=callee_cumulative_ms,
+                cumulative_ms_pct=(
+                    min(100.0, cumulative_ms / total_time_ms * 100)
+                    if total_time_ms
+                    else 0.0
+                ),
+            )
+            callers_map[row_id][caller_id] = edge
+            callees_map[caller_id][row_id] = edge
 
     return Profile(
         filename=path,
@@ -160,8 +164,8 @@ def build_profile(s: pstats.Stats, path: str) -> Profile:
 
 
 def _build_edge_rows(
-    edges: dict[str, EdgeStats],
-) -> list[tuple[Row, EdgeStats]]:
+    edges: dict[str, RowStats],
+) -> list[tuple[Row, RowStats]]:
     result = [
         (row, edge)
         for row_id, edge in edges.items()
@@ -181,7 +185,7 @@ def _render_table(
     rows: list[Row],
     template: str,
     extra_context: dict[str, Any],
-    edge_stats: dict[str, EdgeStats] | None = None,
+    edge_stats: dict[str, RowStats] | None = None,
 ) -> HttpResponse:
     sort_param = request.GET.get("sort", "-cumulative_ms")
     sort_desc = not sort_param.startswith("+")
@@ -192,9 +196,14 @@ def _render_table(
         sort_param = "-cumulative_ms"
 
     q = request.GET.get("q", "").strip()
+    queries = [query.strip() for query in q.split() if q.strip()]
     filtered_rows = rows
-    if q:
-        filtered_rows = [r for r in rows if q in r.filename or q in r.funcname]
+    if queries:
+        filtered_rows = [
+            r
+            for r in rows
+            if all(query in r.filename or query in r.funcname for query in queries)
+        ]
 
     if edge_stats is None:
         sorted_rows = sorted(
@@ -255,14 +264,14 @@ def index(request: HttpRequest) -> HttpResponse:
 def _callers_callees_view(
     request: HttpRequest,
     focal_row: Row,
-    edges: dict[str, EdgeStats],
+    edges: dict[str, RowStats],
     opposite_url: str,
     heading: str,
     opposite_label: str,
 ) -> HttpResponse:
     rows_with_edges = _build_edge_rows(edges)
     rows = [r for r, _ in rows_with_edges]
-    edge_stats: dict[str, EdgeStats] = {r.id: e for r, e in rows_with_edges}
+    edge_stats: dict[str, RowStats] = {r.id: e for r, e in rows_with_edges}
 
     return _render_table(
         request,

{profiling_explorer-1.0.0 → profiling_explorer-1.1.0/src/profiling_explorer.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: profiling-explorer
-Version: 1.0.0
+Version: 1.1.0
 Summary: Table-based exploration tool for Python profiling data (pstats files).
 Author-email: Adam Johnson <me@adamj.eu>
 License-Expression: MIT
@@ -55,9 +55,11 @@ Table-based exploration tool for Python profiling data (pstats files).
 .. …then in another tab:
 .. uvx shot-scraper --width 1280 --height 720 --retina --wait 1000 http://127.0.0.1:8099/ -o screenshot.png
 
-.. figure:: https://raw.githubusercontent.com/adamchainz/profiling-explorer/screenshot/screenshot.png
+.. figure:: https://raw.githubusercontent.com/adamchainz/profiling-explorer/main/screenshot.png
    :alt: profiling-explorer screenshot
 
+Read more in `the introductory blog post <https://adamj.eu/tech/2026/04/03/python-introducing-profiling-explorer/>`__.
+
 ----
 
 **Get better at command line Git** with my book `Boost Your Git DX <https://adamchainz.gumroad.com/l/bygdx>`__.
@@ -110,6 +112,9 @@ Features:
 
 * Click the **calls**, **internal ms**, or **cumulative ms** column headers to sort by that column.
 * Use the search box to filter by filename or function name.
+  Separate multiple search terms by spaces to match records that contain all terms.
+* Press a keyboard shortcut to focus the search box: ``/``, ``Control+K``, or ``Command+K``.
+  Select some text first, like a filename, to pre-fill the search box with that text.
 * Hover by a filename + line number pair to reveal the copy button, which copies the location to your clipboard for faster opening.
 * Click the **callers** or **callees** links on the right of a row to see the callers or callees of that function.
 

profiling_explorer-1.0.0/CHANGELOG.rst

@@ -1,8 +0,0 @@
-=========
-Changelog
-=========
-
-1.0.0 (2026-04-02)
-------------------
-
-* Initial release.