mitigate jarring scroll up on completion

thomasballinger · thomasballinger · commit e945ea5ab894 · 2015-02-13T19:38:27.000-05:00
-max completion box size calculated from space on screen
-prefer displaying box below, but if scroll require display above
-scroll down 10 lines on startup
diff --git a/bpython/curtsies.py b/bpython/curtsies.py
@@ -111,6 +111,9 @@ def after_suspend():
                 window.__enter__()
                 interrupting_refresh()
 
+            def get_top_usable_line():
+                return window.top_usable_row
+
             # global for easy introspection `from bpython.curtsies import repl`
             global repl
             with Repl(config=config,
@@ -126,9 +129,12 @@ def after_suspend():
                       interactive=interactive,
                       orig_tcattrs=input_generator.original_stty,
                       on_suspend=on_suspend,
-                      after_suspend=after_suspend) as repl:
+                      after_suspend=after_suspend,
+                      get_top_usable_line=get_top_usable_line) as repl:
                 repl.height, repl.width = window.t.height, window.t.width
 
+                repl.request_paint_to_pad_bottom = 10
+
                 def process_event(e):
                     """If None is passed in, just paint the screen"""
                     try:
diff --git a/bpython/curtsiesfrontend/repl.py b/bpython/curtsiesfrontend/repl.py
@@ -246,7 +246,8 @@ def __init__(self,
                  interactive=True,
                  orig_tcattrs=None,
                  on_suspend=lambda *args: None,
-                 after_suspend=lambda *args: None):
+                 after_suspend=lambda *args: None,
+                 get_top_usable_line=lambda: 0):
         """
         locals_ is a mapping of locals to pass into the interpreter
         config is a bpython config.Struct with config attributes
@@ -266,6 +267,7 @@ def __init__(self,
         original terminal state, useful for shelling out with normal terminal
         on_suspend will be called on sigtstp
         after_suspend will be called when process foregrounded after suspend
+        get_top_usable_line returns the top line of the terminal owned
         """
 
         logger.debug("starting init")
@@ -361,6 +363,7 @@ def smarter_request_reload(files_modified=()):
         self.orig_tcattrs = orig_tcattrs
         self.on_suspend = on_suspend
         self.after_suspend = after_suspend
+        self.get_top_usable_line = get_top_usable_line
 
         self.coderunner = CodeRunner(self.interp, self.request_refresh)
         self.stdout = FakeOutput(self.coderunner, self.send_to_stdout)
@@ -370,6 +373,8 @@ def smarter_request_reload(files_modified=()):
         # next paint should clear screen
         self.request_paint_to_clear_screen = False
 
+        self.request_paint_to_pad_bottom = 0
+
         # offscreen command yields results different from scrollback bufffer
         self.inconsistent_history = False
 
@@ -1125,6 +1130,10 @@ def paint(self, about_to_exit=False, user_quit=False):
         if self.request_paint_to_clear_screen: # or show_status_bar and about_to_exit ?
             self.request_paint_to_clear_screen = False
             arr = FSArray(min_height + current_line_start_row, width)
+        elif self.request_paint_to_pad_bottom:
+            # min_height - 1 for startup banner with python version
+            arr = FSArray(min(self.request_paint_to_pad_bottom, min_height - 1), width)
+            self.request_paint_to_pad_bottom = 0
         else:
             arr = FSArray(0, width)
         #TODO test case of current line filling up the whole screen (there aren't enough rows to show it)
@@ -1209,7 +1218,8 @@ def move_screen_up(current_line_start_row):
         if self.list_win_visible and not self.coderunner.running:
             logger.debug('infobox display code running')
             visible_space_above = history.height
-            visible_space_below = min_height - current_line_end_row - 1
+            potential_space_below = min_height - current_line_end_row - 1
+            visible_space_below = potential_space_below - self.get_top_usable_line()
 
             info_max_rows = max(visible_space_above, visible_space_below)
             infobox = paint.paint_infobox(info_max_rows,
@@ -1219,12 +1229,16 @@ def move_screen_up(current_line_start_row):
                                           self.current_match,
                                           self.docstring,
                                           self.config,
-                                          self.matches_iter.completer.format if self.matches_iter.completer else None)
+                                          self.matches_iter.completer.format
+                                          if self.matches_iter.completer
+                                          else None)
 
-            if visible_space_above >= infobox.height and self.config.curtsies_list_above:
-                arr[current_line_start_row - infobox.height:current_line_start_row, 0:infobox.width] = infobox
-            else:
+            if visible_space_below >= infobox.height or not self.config.curtsies_list_above:
+                if visible_space_below < infobox.height:
+                    raise ValueError('whoops %r %r' % (visible_space_below, infobox.height))
                 arr[current_line_end_row + 1:current_line_end_row + 1 + infobox.height, 0:infobox.width] = infobox
+            else:
+                arr[current_line_start_row - infobox.height:current_line_start_row, 0:infobox.width] = infobox
                 logger.debug('slamming infobox of shape %r into arr of shape %r', infobox.shape, arr.shape)
 
         logger.debug('about to exit: %r', about_to_exit)
