docs: use new art

Also fixed a minor regression and linting errors.

README.md

@@ -118,6 +118,15 @@ will be able to navigate through them with the arrow keys.
 > [linked](https://pip.pypa.io/en/latest/user_guide/#installing-from-wheels)
 > page.
 
+## Thread navigation
+
+Profiling data is processed on a per-thread basis. The total number of threads
+(across all processes, if sampling child processes) is displayed in the
+top-right corner of the TUI. To navigate to a different thread, use the
+<kbd>&larr;</kbd> and <kbd>&rarr;</kbd> arrows. The PID and TID of the currently
+selected thread will appear in the middle of the top bar in the TUI.
+
+
 ## Full mode
 
 By default, Austin TUI shows you statistics of the last seen stack for each
@@ -164,13 +173,31 @@ operation on the bottom-right corner.
  alt="Austin TUI - Save notification" />
 </p>
 
+If you run the Austin TUI inside VS Code, you can benefit from the editor's
+terminal features, like using <kbd>Ctrl</kbd>/<kbd>Cmd</kbd>+<kbd>Left-Click</kbd>
+to hop straight into a source file at a given line. You can also leverage the
+TUI's save feature to export the collected samples and import them into the
+[Austin VS Code] extension to also get a flame graph representation.
+
+<p align="center">
+ <img src="art/austin-tui-vscode.gif"
+ style="box-shadow: #111 0px 0px 16px;"
+ alt="Austin TUI" />
+</p>
 
 ## Threshold
 
 The statistics reported by the TUI might be overwhelming, especially in full
 mode. To reduce the amout of data that gets displayed, the keys <kbd>+</kbd> and
 <kbd>-</kbd> can be used to increase or lower the `%TOTAL` threshold
 
+<p align="center">
+ <img src="art/austin-tui-threshold.png"
+ style="box-shadow: #111 0px 0px 16px;"
+ alt="Austin TUI - Threshold demonstration" />
+</p>
+
+
 # Compatibility
 
 Austin TUI has been tested with Python 3.6-3.10 and is known to work on
@@ -218,4 +245,5 @@ on BMC or by chipping in a few pennies on
 [Austin]: https://github.com/P403n1x87/austin
 [austin-python]: https://github.com/P403n1x87/austin-python#installation
 [Austin installation]: https://github.com/P403n1x87/austin#installation
+[Austin VS Code]: https://marketplace.visualstudio.com/items?itemName=p403n1x87.austin-vscode
 [The Austin TUI Way to Resourceful Text-based User Interfaces]: https://p403n1x87.github.io/the-austin-tui-way-to-resourceful-text-based-user-interfaces.html

austin_tui/view/austin.py

@@ -105,11 +105,13 @@ async def on_table_pgdown(self, data: Any = None) -> bool:
  return False
 
  async def on_table_home(self, _: Any = None) -> bool:
+ """Handle Home key on the table widget."""
  self.stats_view.top()
  self.stats_view.refresh()
  return False
 
  async def on_table_end(self, _: Any = None) -> bool:
+ """Handle End key on the table widget."""
  self.stats_view.bottom()
  self.stats_view.refresh()
  return False
@@ -211,5 +213,5 @@ def set_pid(self, pid: int, children: bool) -> None:
  self.pid.set_text(self.markup(f"<pid><b>{pid}</b></pid>"))
 
  def set_python(self, version: str) -> None:
- """Set the Python version"""
+ """Set the Python version."""
  self.python.set_text(".".join([str(_) for _ in version]))

austin_tui/widgets/label.py

@@ -128,7 +128,10 @@ def draw(self) -> bool:
  return False
 
  if isinstance(self.text, AttrString):
- win.addstr(self.y, self.x, " " * width, self.attr)
+ try:
+ win.addstr(self.y, self.x, " " * width, self.attr)
+ except curses.error:
+ pass
  x = self.x
  if self.align == TextAlign.RIGHT and len(self.text) < width:
  x += width - len(self.text)

austin_tui/widgets/scroll.py

@@ -106,10 +106,12 @@ def scroll_up(self, lines: int = 1) -> None:
  self._draw_scroll_bar()
 
  def top(self) -> None:
+ """Scroll to the top."""
  self.curr_y = 0
  self._draw_scroll_bar()
 
  def bottom(self) -> None:
+ """Scroll to the bottom."""
  self.curr_y = self.h - self.height
  self._draw_scroll_bar()