Better Mouse Support

examples/full-screen/calculator.py

@@ -70,7 +70,7 @@ def accept(buff):
     @kb.add("c-c")
     @kb.add("c-q")
     def _(event):
-        " Pressing Ctrl-Q or Ctrl-C will exit the user interface. "
+        "Pressing Ctrl-Q or Ctrl-C will exit the user interface."
         event.app.exit()
 
     # Style.

examples/full-screen/hello-world.py

@@ -27,7 +27,7 @@
 
 @kb.add("c-c")
 def _(event):
-    " Quit when control-c is pressed. "
+    "Quit when control-c is pressed."
     event.app.exit()
 
 

examples/full-screen/pager.py

@@ -78,7 +78,7 @@ def get_statusbar_text():
 @bindings.add("c-c")
 @bindings.add("q")
 def _(event):
-    " Quit. "
+    "Quit."
     event.app.exit()
 
 

examples/full-screen/simple-demos/alignment.py

@@ -44,7 +44,7 @@
 
 @kb.add("q")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 

examples/full-screen/simple-demos/autocompletion.py

@@ -84,7 +84,7 @@
 @kb.add("q")
 @kb.add("c-c")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 

examples/full-screen/simple-demos/colorcolumn.py

@@ -47,7 +47,7 @@
 
 @kb.add("q")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 

examples/full-screen/simple-demos/cursorcolumn-cursorline.py

@@ -43,7 +43,7 @@
 
 @kb.add("q")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 

examples/full-screen/simple-demos/float-transparency.py

@@ -71,7 +71,7 @@
 
 @kb.add("q")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 

examples/full-screen/simple-demos/floats.py

@@ -100,7 +100,7 @@
 
 @kb.add("q")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 

examples/full-screen/simple-demos/focus.py

@@ -52,7 +52,7 @@
 
 @kb.add("q")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 

examples/full-screen/simple-demos/horizontal-align.py

@@ -193,7 +193,7 @@
 
 @kb.add("q")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 

examples/full-screen/simple-demos/horizontal-split.py

@@ -28,7 +28,7 @@
 
 @kb.add("q")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 

examples/full-screen/simple-demos/line-prefixes.py

@@ -86,13 +86,13 @@ def get_line_prefix(lineno, wrap_count):
 @kb.add("q")
 @kb.add("c-c")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 
 @kb.add("w")
 def _(event):
-    " Disable/enable wrapping. "
+    "Disable/enable wrapping."
     global wrap_lines
     wrap_lines = not wrap_lines
 

examples/full-screen/simple-demos/margins.py

@@ -55,7 +55,7 @@
 @kb.add("q")
 @kb.add("c-c")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 

examples/full-screen/simple-demos/vertical-align.py

@@ -152,7 +152,7 @@
 
 @kb.add("q")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 

examples/full-screen/simple-demos/vertical-split.py

@@ -28,7 +28,7 @@
 
 @kb.add("q")
 def _(event):
-    " Quit application. "
+    "Quit application."
     event.app.exit()
 
 

examples/full-screen/text-editor.py

@@ -161,7 +161,7 @@ def __pt_container__(self):
 
 @bindings.add("c-c")
 def _(event):
-    " Focus menu. "
+    "Focus menu."
     event.app.layout.focus(root_container.window)
 
 
@@ -204,7 +204,7 @@ async def coroutine():
 
 
 async def show_dialog_as_float(dialog):
-    " Coroutine. "
+    "Coroutine."
     float_ = Float(content=dialog)
     root_container.floats.insert(0, float_)
 

examples/progress-bar/custom-key-bindings.py

@@ -28,12 +28,12 @@ def _(event):
 
     @kb.add("q")
     def _(event):
-        " Quit by setting cancel flag. "
+        "Quit by setting cancel flag."
         cancel[0] = True
 
     @kb.add("x")
     def _(event):
-        " Quit by sending SIGINT to the main thread. "
+        "Quit by sending SIGINT to the main thread."
         os.kill(os.getpid(), signal.SIGINT)
 
     # Use `patch_stdout`, to make sure that prints go above the

examples/prompts/clock-input.py

@@ -8,7 +8,7 @@
 
 
 def get_prompt():
-    " Tokens to be shown before the prompt. "
+    "Tokens to be shown before the prompt."
     now = datetime.datetime.now()
     return [
         ("bg:#008800 #ffffff", "%s:%s:%s" % (now.hour, now.minute, now.second)),

examples/prompts/custom-key-binding.py

@@ -36,7 +36,7 @@ def _(event):
 
     @bindings.add("a", "b", "c")
     def _(event):
-        " Typing 'abc' should insert 'd'. "
+        "Typing 'abc' should insert 'd'."
         event.app.current_buffer.insert_text("d")
 
     @bindings.add("c-t")

examples/prompts/custom-vi-operator-and-text-object.py

@@ -26,7 +26,7 @@ def main():
 
     @operator("R")
     def _(event, text_object):
-        " Custom operator that reverses text. "
+        "Custom operator that reverses text."
         buff = event.current_buffer
 
         # Get relative start/end coordinates.
@@ -43,7 +43,7 @@ def _(event, text_object):
 
     @text_object("A")
     def _(event):
-        " A custom text object that involves everything. "
+        "A custom text object that involves everything."
         # Note that a `TextObject` has coordinates, relative to the cursor position.
         buff = event.current_buffer
         return TextObject(

examples/prompts/get-password-with-toggle-display-shortcut.py

@@ -14,7 +14,7 @@ def main():
 
     @bindings.add("c-t")
     def _(event):
-        " When ControlT has been pressed, toggle visibility. "
+        "When ControlT has been pressed, toggle visibility."
         hidden[0] = not hidden[0]
 
     print("Type Control-T to toggle password visible.")

examples/prompts/swap-light-and-dark-colors.py

@@ -44,7 +44,7 @@ def main():
 
     @bindings.add("c-t")
     def _(event):
-        " When ControlT has been pressed, toggle light/dark colors. "
+        "When ControlT has been pressed, toggle light/dark colors."
         swapped[0] = not swapped[0]
 
     def bottom_toolbar():

examples/prompts/switch-between-vi-emacs.py

@@ -16,14 +16,14 @@ def run():
     # Add an additional key binding for toggling this flag.
     @bindings.add("f4")
     def _(event):
-        " Toggle between Emacs and Vi mode. "
+        "Toggle between Emacs and Vi mode."
         if event.app.editing_mode == EditingMode.VI:
             event.app.editing_mode = EditingMode.EMACS
         else:
             event.app.editing_mode = EditingMode.VI
 
     def bottom_toolbar():
-        " Display the current input mode. "
+        "Display the current input mode."
         if get_app().editing_mode == EditingMode.VI:
             return " [F4] Vi "
         else:

prompt_toolkit/application/application.py

@@ -503,7 +503,7 @@ async def redraw_in_future() -> None:
 
     @property
     def invalidated(self) -> bool:
-        " True when a redraw operation has been scheduled. "
+        "True when a redraw operation has been scheduled."
         return self._invalidated
 
     def _redraw(self, render_as_done: bool = False) -> None:
@@ -650,7 +650,7 @@ async def run_async(
         assert not self._is_running, "Application is already running."
 
         async def _run_async() -> _AppResult:
-            " Coroutine. "
+            "Coroutine."
             loop = get_event_loop()
             f = loop.create_future()
             self.future = f  # XXX: make sure to set this before calling '_redraw'.
@@ -946,17 +946,17 @@ def in_terminal() -> None:
 
     @overload
     def exit(self) -> None:
-        " Exit without arguments. "
+        "Exit without arguments."
 
     @overload
     def exit(self, *, result: _AppResult, style: str = "") -> None:
-        " Exit with `_AppResult`. "
+        "Exit with `_AppResult`."
 
     @overload
     def exit(
         self, *, exception: Union[BaseException, Type[BaseException]], style: str = ""
     ) -> None:
-        " Exit with exception. "
+        "Exit with exception."
 
     def exit(
         self,
@@ -1095,7 +1095,7 @@ def print_text(
 
     @property
     def is_running(self) -> bool:
-        " `True` when the application is currently active/running. "
+        "`True` when the application is currently active/running."
         return self._is_running
 
     @property
@@ -1234,7 +1234,7 @@ def _ok(event: E) -> None:
 
     @key_bindings.add(Keys.Any)
     def _ignore(event: E) -> None:
-        " Disallow typing. "
+        "Disallow typing."
         pass
 
     session: PromptSession[None] = PromptSession(

prompt_toolkit/buffer.py

@@ -61,11 +61,11 @@
 
 
 class EditReadOnlyBuffer(Exception):
-    " Attempt editing of read-only :class:`.Buffer`. "
+    "Attempt editing of read-only :class:`.Buffer`."
 
 
 class ValidationState(Enum):
-    " The validation state of a buffer. This is set after the validation. "
+    "The validation state of a buffer. This is set after the validation."
     VALID = "VALID"
     INVALID = "INVALID"
     UNKNOWN = "UNKNOWN"
@@ -440,7 +440,7 @@ def load_history_done(f: "asyncio.Future[None]") -> None:
     # <getters/setters>
 
     def _set_text(self, value: str) -> bool:
-        """ set text at current working_index. Return whether it changed. """
+        """set text at current working_index. Return whether it changed."""
         working_index = self.working_index
         working_lines = self._working_lines
 
@@ -460,7 +460,7 @@ def _set_text(self, value: str) -> bool:
         return False
 
     def _set_cursor_position(self, value: int) -> bool:
-        """ Set cursor position. Return whether it changed. """
+        """Set cursor position. Return whether it changed."""
         original_position = self.__cursor_position
         self.__cursor_position = max(0, value)
 
@@ -725,7 +725,7 @@ def cursor_right(self, count: int = 1) -> None:
         self.cursor_position += self.document.get_cursor_right_position(count=count)
 
     def cursor_up(self, count: int = 1) -> None:
-        """ (for multiline edit). Move cursor to the previous line.  """
+        """(for multiline edit). Move cursor to the previous line."""
         original_column = self.preferred_column or self.document.cursor_position_col
         self.cursor_position += self.document.get_cursor_up_position(
             count=count, preferred_column=original_column
@@ -735,7 +735,7 @@ def cursor_up(self, count: int = 1) -> None:
         self.preferred_column = original_column
 
     def cursor_down(self, count: int = 1) -> None:
-        """ (for multiline edit). Move cursor to the next line.  """
+        """(for multiline edit). Move cursor to the next line."""
         original_column = self.preferred_column or self.document.cursor_position_col
         self.cursor_position += self.document.get_cursor_down_position(
             count=count, preferred_column=original_column
@@ -1918,7 +1918,7 @@ async def new_coroutine(*a: Any, **kw: Any) -> Any:
 
 
 class _Retry(Exception):
-    " Retry in `_only_one_at_a_time`. "
+    "Retry in `_only_one_at_a_time`."
 
 
 def indent(buffer: Buffer, from_row: int, to_row: int, count: int = 1) -> None:

prompt_toolkit/cache.py

@@ -51,7 +51,7 @@ def get(self, key: _T, getter_func: Callable[[], _U]) -> _U:
             return value
 
     def clear(self) -> None:
-        " Clear cache. "
+        "Clear cache."
         self._data = {}
         self._keys = deque()