# Armaan Bhojwani 2021
import curses
+import curses.panel
from random import shuffle
import sys
import textwrap
+from . import runner, progress
-def disp_bar(stdscr, stack, headers, obj):
- """
- Display the statusbar at the bottom of the screen with progress, star
- status, and card side.
- """
- (mlines, mcols) = stdscr.getmaxyx()
-
- # Calculate percent done
- if len(stack) <= 1:
- percent = "100"
- else:
- percent = str(round(obj.getIdx() / (len(stack) - 1) * 100)).zfill(3)
-
- # Print yellow if starred
- stdscr.addstr(mlines - 1, 0, "[", curses.color_pair(1))
- if stack[obj.getIdx()].getStar():
- stdscr.addstr(stack[obj.getIdx()].printStar(), curses.color_pair(3))
- else:
- stdscr.addstr(stack[obj.getIdx()].printStar(), curses.color_pair(1))
-
- # Put all the info together
- stdscr.addstr("] [" +
- percent +
- "% (" +
- str(obj.getIdx() + 1).zfill(len(str(len(stack)))) +
- "/" +
- str(len(stack)) +
- ")]" +
- " [" +
- headers[obj.getSide()] +
- " (" +
- str(obj.getSide() + 1) +
- ")]", curses.color_pair(1))
-
-
-def disp_menu(stdscr, stack, headers, idx):
- """
- Display a menu once the end of the deck has been reached, offering
- multiple options on how to continue.
- """
- stdscr.addstr("Good job, you've completed a round!\n\n",
- curses.color_pair(1))
- stdscr.addstr("Choose one of the following options:\n" +
- "[r]: restart\n" +
- "[s]: restart with starred only\n" +
- "[u]: restart and unstar all\n" +
- "[z]: restart and shuffle cards\n" +
- "[f]: restart and show the other side first\n" +
- "[t]: restart in reverse order\n" +
- "[q]: quit")
- while True:
- key = stdscr.getkey()
- if key == "q":
- sys.exit(0)
- elif key == "r":
- idx.setIdx(0)
- get_key(stdscr, stack, headers, idx)
- elif key == "s":
- # Check if there are any starred cards before proceeding, and if
- # not, don't allow to proceed and show an error message
- cont = False
- for x in stack:
- if x.getStar():
- cont = True
-
- if cont:
- idx.setIdx(0)
- stack = [x for x in stack if x.getStar()]
- get_key(stdscr, stack, headers, idx)
- else:
- stdscr.clear()
- stdscr.addstr("ERR: Stack empty. Choose another option\n\n",
- curses.color_pair(2))
- disp_menu(stdscr, stack, headers, idx)
- elif key == "u":
- idx.setIdx(0)
- for x in stack:
- x.unStar()
- get_key(stdscr, stack, headers, idx)
- elif key == "z":
- idx.setIdx(0)
- shuffle(stack)
- get_key(stdscr, stack, headers, idx)
- elif key == "f":
- idx.setIdx(0)
- for x in stack:
- x[0], x[1] = x[1], x[0]
- headers[0], headers[1] = headers[1], headers[0]
- get_key(stdscr, stack, headers, idx)
- elif key == "t":
- idx.setIdx(0)
- stack.reverse()
- get_key(stdscr, stack, headers, idx)
-
-
-def disp_card(stdscr, stack, headers, obj):
- """
- Display the contents of the card
- Shows a header, a horizontal line, and the contents of the current side.
- """
- stdscr.clear()
- (mlines, mcols) = stdscr.getmaxyx()
- if obj.getIdx() == len(stack):
- disp_menu(stdscr, stack, headers, obj)
- else:
- # If on the back of the card, show the content of the front side in the
- # header
- num_done = str(obj.getIdx() + 1).zfill(len(str(len(stack))))
- if obj.getSide() == 0:
- top = num_done + " | " + headers[obj.getSide()]
+
+def panel_create(x, y):
+ """Create popup panels to a certain scale"""
+ win = curses.newwin(x, y)
+ panel = curses.panel.new_panel(win)
+ win.erase()
+ return (win, panel)
+
+
+class Help:
+ def __init__(self, outer, mlines=20, mcols=52):
+ """Initialize help screen"""
+ self.outer = outer
+ (self.win, self.panel) = panel_create(mlines, mcols)
+ self.panel.top()
+ self.panel.hide()
+ self.win.clear()
+
+ text = [
+ "Welcome to runner. Here are some keybindings",
+ "to get you started:",
+ "",
+ "h, left previous card",
+ "l, right next card",
+ "j, k, up, down flip card",
+ "i, / star card",
+ "0, ^, home go to the start of the deck",
+ "$, end go to the end of the deck",
+ "H, ? open this screen",
+ "e open the input file in $EDITOR",
+ "m open the control menu",
+ "",
+ "More information can be found in the man page, or",
+ "by running `lightcards --help`.",
+ "",
+ "Press [H], or [?] to go back.",
+ ]
+
+ self.win.addstr(
+ 1,
+ int(mcols / 2) - 8,
+ "LIGHTCARDS HELP",
+ curses.color_pair(1) + curses.A_BOLD,
+ )
+ self.win.hline(2, 1, curses.ACS_HLINE, mcols)
+
+ for t in enumerate(text):
+ self.win.addstr(t[0] + 3, 1, t[1])
+
+ self.win.box()
+
+ def disp(self):
+ """Display help screen"""
+ (mlines, mcols) = self.outer.win.getmaxyx()
+ self.win.mvwin(int(mlines / 2) - 10, int(mcols / 2) - 26)
+ self.outer.update_panels()
+ self.panel.show()
+
+ while True:
+ key = self.win.getkey()
+ if key == "q":
+ self.outer.leave()
+ elif key in ["H", "?"]:
+ self.panel.hide()
+ self.outer.get_key()
+
+
+class Menu:
+ def __init__(self, outer, mlines=17, mcols=44):
+ """Initialize the menu with content"""
+ self.outer = outer
+ (self.win, self.panel) = panel_create(mlines, mcols)
+ self.panel.top()
+ self.panel.hide()
+
+ self.win.addstr(
+ 1,
+ int(mcols / 2) - 8,
+ "LIGHTCARDS MENU",
+ curses.color_pair(1) + curses.A_BOLD,
+ )
+ self.win.hline(2, 1, curses.ACS_HLINE, mcols)
+ text = [
+ "[y]: reset stack to original state",
+ "[a]: alphabetize stack",
+ "[z]: shuffle stack",
+ "[f]: flip all cards in stack",
+ "[t]: reverse stack order",
+ "[u]: unstar all",
+ "[d]: star all",
+ "[s]: update stack to include starred only",
+ "",
+ "[r]: restart",
+ "[m]: close menu",
+ ]
+
+ for t in enumerate(text):
+ self.win.addstr(t[0] + 3, 1, t[1])
+
+ self.win.box()
+ self.outer.update_panels()
+
+ def menu_print(self, string, err=False):
+ """Print messages on the menu screen"""
+ if err:
+ color = curses.color_pair(2)
+ else:
+ color = curses.color_pair(1)
+
+ for i in range(42):
+ self.win.addch(15, i + 1, " ")
+
+ self.win.addstr(15, 1, string, color)
+ self.outer.update_panels()
+ self.menu_grab()
+
+ def menu_grab(self):
+ """Grab keypresses on the menu screen"""
+ while True:
+ key = self.win.getkey()
+ if key in ["r", "m"]:
+ self.panel.hide()
+ self.outer.update_panels()
+ self.outer.get_key()
+ elif key == "q":
+ self.outer.leave()
+ elif key == "y":
+ self.outer.stack = runner.get_orig()[1]
+ self.menu_print("Stack reset!")
+ elif key == "a":
+ self.outer.stack.sort(key=lambda x: x.front)
+ self.menu_print("Stack alphabetized!")
+ elif key == "u":
+ [x.unStar() for x in self.outer.stack]
+ self.menu_print("All unstarred!")
+ elif key == "d":
+ [x.star() for x in self.outer.stack]
+ self.menu_print("All starred!")
+ elif key == "t":
+ self.outer.stack.reverse()
+ self.menu_print("Stack reversed!")
+ elif key == "z":
+ shuffle(self.outer.stack)
+ self.menu_print("Stack shuffled!")
+ elif key == "f":
+ for x in self.outer.stack:
+ x.front, x.back = x.back, x.front
+ (self.outer.headers[0], self.outer.headers[1]) = (
+ self.outer.headers[1],
+ self.outer.headers[0],
+ )
+ self.menu_print("Cards flipped!")
+ elif key == "s":
+ # Check if there are any starred cards before proceeding, and
+ # if not, don't allow to proceed and show an error message
+ cont = False
+ for x in self.outer.stack:
+ if x.starred:
+ cont = True
+ break
+
+ if cont:
+ self.outer.stack = [
+ x for x in self.outer.stack if x.starred
+ ]
+ self.menu_print("Stars only!")
+ else:
+ self.menu_print("ERR: None are starred!", err=True)
+ elif key in ["h", "KEY_LEFT"]:
+ self.outer.obj.index = len(self.outer.stack) - 1
+ self.outer.get_key()
+ elif key == "r":
+ self.outer.obj.index = 0
+ self.outer.get_key()
+
+ def disp(self):
+ """
+ Display a menu offering multiple options on how to manipulate the deck
+ and to continue
+ """
+ (mlines, mcols) = self.outer.win.getmaxyx()
+ self.win.mvwin(int(mlines / 2) - 9, int(mcols / 2) - 22)
+ self.panel.show()
+ self.outer.update_panels()
+
+ self.menu_grab()
+
+
+class Display:
+ def __init__(self, stack, headers, obj):
+ self.stack = stack
+ self.headers = headers
+ self.obj = obj
+
+ def run(self, stdscr):
+ """Set important options that require stdscr before starting"""
+ self.win = stdscr
+ (mlines, mcols) = self.win.getmaxyx()
+ curses.curs_set(0) # Hide cursor
+ curses.use_default_colors() # Allow transparency
+ curses.init_pair(1, curses.COLOR_CYAN, -1)
+ curses.init_pair(2, curses.COLOR_RED, -1)
+ curses.init_pair(3, curses.COLOR_YELLOW, -1)
+
+ (self.main_win, self.main_panel) = panel_create(mlines, mcols)
+ self.menu_obj = Menu(self)
+ self.help_obj = Help(self)
+
+ self.get_key()
+
+ def update_panels(self):
+ """Update panel and window contents"""
+ curses.panel.update_panels()
+ self.win.refresh()
+
+ def leave(self):
+ """Pickle stack before quitting"""
+ if self.obj.index + 1 == len(self.stack):
+ self.obj.index = 0
+
+ progress.dump(self.stack, runner.get_orig()[1])
+ sys.exit(0)
+
+ def nstarred(self):
+ """Get total number of starred cards"""
+ return [card for card in self.stack if card.starred]
+
+ def disp_bar(self):
+ """
+ Display the statusbar at the bottom of the screen with progress, star
+ status, and card side.
+ """
+ (mlines, mcols) = self.win.getmaxyx()
+ self.win.hline(mlines - 2, 0, 0, mcols)
+
+ # Calculate percent done
+ if len(self.stack) <= 1:
+ percent = "100"
+ else:
+ percent = str(
+ round(self.obj.index / (len(self.stack) - 1) * 100)
+ ).zfill(2)
+
+ # Print yellow if starred
+ if self.current_card().starred:
+ star_color = curses.color_pair(3)
else:
- top = num_done + " | " + headers[obj.getSide()] + " | \"" + \
- str(stack[obj.getIdx()][0]) + "\""
+ star_color = curses.color_pair(1)
+
+ # Create bar component
+ bar_start = "["
+ bar_middle = self.current_card().printStar()
+ bar_end = (
+ f"] [{len(self.nstarred())}/{str(len(self.stack))} starred] "
+ f"[{percent}% ("
+ f"{str(self.obj.index).zfill(len(str(len(self.stack))))}"
+ f"/{str(len(self.stack))})] ["
+ f"{self.headers[self.current_card().side]} ("
+ f"{str(int(self.current_card().side) + 1)})]"
+ )
+
+ # Put it all togethor
+ self.win.addstr(mlines - 1, 0, bar_start, curses.color_pair(1))
+ self.win.addstr(mlines - 1, len(bar_start), bar_middle, star_color)
+ self.win.addstr(
+ mlines - 1,
+ len(bar_start + bar_middle),
+ bar_end,
+ curses.color_pair(1),
+ )
+
+ def wrap_width(self):
+ """Calculate the width at which the body text should wrap"""
+ (_, mcols) = self.win.getmaxyx()
+ wrap_width = mcols - 20
+ if wrap_width > 80:
+ wrap_width = 80
+ return wrap_width
+
+ def disp_card(self):
+ """
+ Display the contents of the card.
+ Shows a header, a horizontal line, and the contents of the current
+ side.
+ """
+ (mlines, mcols) = self.win.getmaxyx()
+ self.main_panel.bottom()
+ self.main_win.clear()
+ # If on the back of the card, show the content of the front side in
+ # the header
+ num_done = str(self.obj.index + 1).zfill(len(str(len(self.stack))))
+ if self.current_card().side == 0:
+ top = num_done + " | " + self.headers[self.current_card().side]
+ else:
+ top = (
+ num_done
+ + " | "
+ + self.headers[self.current_card().side]
+ + ' | "'
+ + str(self.current_card().front)
+ + '"'
+ )
header_width = mcols
if mcols > 80:
header_width = 80
- stdscr.addstr(textwrap.shorten(top, width=header_width,
- placeholder="…"), curses.A_BOLD)
+ self.main_win.addstr(
+ 0,
+ 0,
+ textwrap.shorten(top, width=header_width, placeholder="…"),
+ curses.A_BOLD,
+ )
# Add horizontal line
- lin_width = header_width
- if len(top) < header_width:
- lin_width = len(top)
- stdscr.hline(1, 0, curses.ACS_HLINE, lin_width)
+ self.main_win.hline(1, 0, curses.ACS_HLINE, mcols)
# Show current side
- wrap_width = mcols
- if mcols > 80:
- wrap_width = 80
- stdscr.addstr(2, 0, textwrap.fill(stack[obj.getIdx()][obj.getSide()],
- width=wrap_width))
- disp_bar(stdscr, stack, headers, obj)
-
-
-def disp_help(stdscr, stack, headers, idx):
- """Display help screen"""
- stdscr.clear()
- stdscr.addstr("LIGHTCARDS HELP", curses.color_pair(1) + curses.A_BOLD)
- stdscr.hline(1, 0, curses.ACS_HLINE, 15)
- stdscr.addstr(2, 0,
- "Welcome to lightcards. Here are some keybindings to get\n" +
- "you started.\n\n" +
- "h, left previous card\n" +
- "l, right next card\n" +
- "j, k, up, down flip card\n" +
- "i, / star card\n" +
- "0, ^, home go to the start of the deck\n" +
- "$, end go to the end of the deck\n" +
- "H, ? open this screen\n\n" +
- "More information can be found in the man page, or by\n" +
- "running `lightcards --help`.\n\n" +
- "Press [q], [H], or [?] to go back.")
- while True:
- key = stdscr.getkey()
- if key in ["q", "H", "?"]:
- get_key(stdscr, stack, headers, idx)
-
-
-def init_disp(stdscr, stack, headers, idx):
- """Initialize curses options. Entrypoint into the display functions."""
- curses.curs_set(0) # Hide cursor
- curses.init_pair(1, curses.COLOR_CYAN, 0)
- curses.init_pair(2, curses.COLOR_RED, 0)
- curses.init_pair(3, curses.COLOR_YELLOW, 0)
- get_key(stdscr, stack, headers, idx)
-
-
-def get_key(stdscr, stack, headers, idx):
- """
- Display a card and wait for the input.
- Used as a general way of getting back into the card flow from a menu
- """
-
- disp_card(stdscr, stack, headers, idx)
- while True:
- key = stdscr.getkey()
- if key == "q":
- sys.exit(0)
- elif key in ["l", "KEY_LEFT"]:
- idx.forward(stack)
- idx.setSide(0)
- disp_card(stdscr, stack, headers, idx)
- elif key in ["h", "KEY_RIGHT"]:
- idx.back()
- idx.setSide(0)
- disp_card(stdscr, stack, headers, idx)
- elif key in ["j", "k", "KEY_UP", "KEY_DOWN"]:
- idx.flip()
- disp_card(stdscr, stack, headers, idx)
- elif key in ["i", "/"]:
- stack[idx.getIdx()].toggleStar()
- disp_card(stdscr, stack, headers, idx)
- elif key in ["0", "^", "KEY_HOME"]:
- idx.setIdx(0)
- idx.setSide(0)
- disp_card(stdscr, stack, headers, idx)
- elif key in ["$", "KEY_END"]:
- idx.setIdx(len(stack) - 1)
- idx.setSide(0)
- disp_card(stdscr, stack, headers, idx)
- elif key in ["H", "?"]:
- disp_help(stdscr, stack, headers, idx)
+ self.main_win.addstr(
+ 2,
+ 0,
+ textwrap.fill(
+ self.current_card().get(),
+ width=self.wrap_width(),
+ ),
+ )
+ self.update_panels()
+ self.disp_bar()
+ self.disp_sidebar()
+
+ def current_card(self):
+ """Get current card object"""
+ return self.stack[self.obj.index]
+
+ def get_key(self):
+ """
+ Display a card and wait for the input.
+ Used as a general way of getting back into the card flow from a menu
+ """
+ self.disp_card()
+ while True:
+ key = self.win.getkey()
+ if key == "q":
+ self.leave()
+ elif key in ["h", "KEY_LEFT"]:
+ self.obj.back()
+ self.current_card().side = 0
+ self.disp_card()
+ elif key in ["l", "KEY_RIGHT"]:
+ if self.obj.index + 1 == len(self.stack):
+ self.menu_obj.disp()
+ else:
+ self.obj.forward(self.stack)
+ self.current_card().side = 0
+ self.disp_card()
+ elif key in ["j", "k", "KEY_UP", "KEY_DOWN"]:
+ self.current_card().flip()
+ self.disp_card()
+ elif key in ["i", "/"]:
+ self.current_card().toggleStar()
+ self.disp_card()
+ elif key in ["0", "^", "KEY_HOME"]:
+ self.obj.index = 0
+ self.current_card().side = 0
+ self.disp_card()
+ elif key in ["$", "KEY_END"]:
+ self.obj.index = len(self.stack) - 1
+ self.current_card().side = 0
+ self.disp_card()
+ elif key in ["H", "?"]:
+ self.help_obj.disp()
+ elif key == "m":
+ self.menu_obj.disp()
+ elif key == "e":
+ (self.headers, self.stack) = runner.reparse()
+ self.get_key()
+
+ def disp_sidebar(self):
+ """Display a sidebar with the starred terms"""
+ (mlines, mcols) = self.win.getmaxyx()
+ left = mcols - 19
+
+ self.win.addstr(
+ 0,
+ mcols - 16,
+ "STARRED CARDS",
+ curses.color_pair(3) + curses.A_BOLD,
+ )
+ self.win.vline(0, mcols - 20, 0, mlines - 2)
+
+ nstarred = self.nstarred()
+ if mlines - 5 < len(self.nstarred()):
+ nstarred = self.nstarred()[: mlines - 4]
+ elif mlines - 5 == len(self.nstarred()):
+ nstarred = self.nstarred()[: mlines - 3]
+
+ for _ in nstarred:
+ for i, card in enumerate(nstarred):
+ term = card.front
+ if len(term) > 18:
+ term = term + "…"
+ self.win.addstr(2 + i, left, term)
+ if not nstarred == self.nstarred():
+ self.win.addstr(
+ mlines - 3,
+ left,
+ f"({len(self.nstarred()) - len(nstarred)} more)",
+ )
+ break
+
+ if len(self.nstarred()) == 0:
+ self.win.addstr(2, left, "None starred")