Source code for nexuslims_logger.db_logger_gui

import os
import queue
import sys
import threading
import time
from datetime import datetime
from tkinter import *
from tkinter import messagebox, ttk
from uuid import uuid4


[docs]def check_singleton(): if sys.platform == 'win32': if hasattr(sys, '_MEIPASS'): # we're in a pyinstaller environment, so use psutil to check for exe import psutil db_logger_exe_count = 0 for proc in psutil.process_iter(): try: pinfo = proc.as_dict(attrs=['pid', 'name', 'username']) if pinfo['name'] == 'NexusLIMS Session Logger.exe': db_logger_exe_count += 1 except psutil.NoSuchProcess: pass else: pass # When running the pyinstaller .exe, two processes are spawned, so # if we see more than that, we know there's already an instance # running if db_logger_exe_count > 2: raise OSError('Only one instance of NexusLIMS Session Logger ' 'allowed') else: # we're not running as an .exe, so use tendo return tendo_singleton() else: return tendo_singleton()
[docs]def tendo_singleton(): from tendo import singleton try: me = singleton.SingleInstance() except singleton.SingleInstanceException as e: raise OSError('Only one instance of db_logger_gui allowed') return me
[docs]def resource_path(relative_path): try: # try to set the base_path to the pyinstaller temp dir (for when we're) # running from a compiled .exe built with pyinstaller base_path = os.path.join(sys._MEIPASS, 'resources') except Exception: thisdir = os.path.dirname(os.path.abspath(__file__)) base_path = os.path.join(thisdir, 'resources') pth = os.path.join(base_path, relative_path) return pth
[docs]def format_date(dt, with_newline=True): """ Format a datetime object in our preferred format Parameters ---------- dt : datetime.datetime Returns ------- datestring : str A datetime formatted in our preferred format """ datestring = dt.strftime("%a %b %d, %Y" + ("\n" if with_newline else " at ") + "%I:%M:%S %p") return datestring
[docs]class ScreenRes: def __init__(self, db_logger): """ When an instance of this class is created, the screen is queried for its dimensions. This is done once, so as to limit the number of calls to external programs. Can provide a db_logger instance (from MainApp) if output should be logged to the LogWindow """ default_screen_dims = ('800', '600') try: if sys.platform == 'win32': cmd = 'wmic path Win32_VideoController get ' + \ 'CurrentHorizontalResolution, CurrentVerticalResolution' output = db_logger.run_cmd(cmd).split()[-2::] # Tested working in Windows XP and Windows 7/10 screen_dims = tuple(map(int, output)) db_logger.log('(SCREENRES) Found "raw" Windows resolution ' 'of {}'.format(screen_dims), 2) # Get the DPI of the screen so we can adjust the resolution cmd = r'reg query "HKCU\Control Panel\Desktop\WindowMetrics" ' \ r'/v AppliedDPI' # pick off last value, which is DPI in hex, and convert to # decimal: dpi = 96 dpi = int(db_logger.run_cmd(cmd).split()[-1], 16) scale_factor = dpi / 96 screen_dims = tuple(int(dim/scale_factor) for dim in screen_dims) db_logger.log("(SCREENRES) Found DPI of {}; ".format(dpi) + "Scale factor {}; Scaled ".format(scale_factor) + "resolution is {}".format(screen_dims), 2) temp_file = 'TempWmicBatchFile.bat' if os.path.isfile(temp_file): os.remove(temp_file) db_logger.log("(SCREENRES) Removed {}".format(temp_file), 2) elif sys.platform == 'linux': cmd = 'xrandr' screen_dims = os.popen(cmd).read() result = re.search(r'primary (\d+)x(\d+)', screen_dims) screen_dims = result.groups() if result else default_screen_dims screen_dims = tuple(map(int, screen_dims)) db_logger.log('(SCREENRES) Found Linux resolution of ' '{}'.format(screen_dims), 2) else: screen_dims = default_screen_dims except Exception as e: db_logger.log("(SCREENRES) Caught exception when determining " "screen resolution: {}".format(e) + '\n' + " " * 34 + "Using default of " "{}".format(default_screen_dims), 0) screen_dims = default_screen_dims self.screen_dims = screen_dims
[docs] def get_center_geometry_string(self, width, height): """ This method will return a Tkinter geometry string that will place a Toplevel window into the middle of the screen given the widget's width and height (using a Windows command or `xrandr` as needed). If it fails for some reason, a basic resolution of 800x600 is assumed. Parameters ---------- width : int The width of the widget desired height : int The height of the widget desired Returns ------- geometry_string : str The Tkinter geometry string that will put a window of `width` and `height` at the center of the screen given the current resolution (of the format "WIDTHxHEIGHT+XPOSITION+YPOSITION") """ screen_width, screen_height = (int(x) for x in self.screen_dims) geometry_string = "%dx%d%+d%+d" % (width, height, int(screen_width / 2 - width / 2), int(screen_height / 2 - height / 2)) return geometry_string
[docs]class MainApp(Tk): def __init__(self, db_logger, screen_res=None): """ This class configures and populates the main toplevel window. ``top`` is the toplevel containing window. Parameters ---------- db_logger : make_db_entry.DBSessionLogger Instance of the database logger that actually does the communication with the database screen_res : ScreenRes An instance of the screen resolution class to help determine where to place the window in the center of the screen """ super(MainApp, self).__init__() self.db_logger = db_logger self.db_logger.log('(GUI) Creating the session logger instance', 1) self.startup_thread_queue = queue.Queue() # a separate queue that will contain either nothing, or an instruction # to exit (from the GUI to the make_db_entry code) self.startup_thread_exit_queue = queue.Queue() self.startup_thread = None self.end_thread_queue = queue.Queue() self.end_thread_exit_queue = queue.Queue() self.end_thread = None self.screen_res = ScreenRes() if screen_res is None else screen_res self.style = ttk.Style() if sys.platform == "win32": self.style.theme_use('winnative') self.style.configure('.', font=("TkDefaultFont", 20, "bold")) self.tooltip_font = "TkDefaultFont" self.info_font = 'TkDefaultFont 16 bold' self.geometry(self.screen_res.get_center_geometry_string(350, 530)) self.minsize(1, 1) self.maxsize(3840, 1170) self.resizable(1, 1) self.title("NexusLIMS Session Logger") self.configure(highlightcolor="black") # Set window icon self.icon = PhotoImage(master=self, file=resource_path("logo_bare.png")) self.wm_iconphoto(True, self.icon) # Top NexusLIMS logo with tooltip if os.path.isfile(resource_path("logo_text_250x100_version.png")): fname = resource_path("logo_text_250x100_version.png") else: fname = resource_path("logo_text_250x100.png") self.logo_img = PhotoImage(file=fname) self.logo_label = ttk.Label(self, background=self['background'], foreground="#000000", relief="flat", image=self.logo_img) ToolTip(self.logo_label, self.tooltip_font, 'Brought to you by the NIST Office of Data and Informatics ' 'and the Electron Microscopy Nexus', header_msg='NexusLIMS', delay=0.25) # Loading information that is hidden after session is established self.setup_frame = Frame(self) self.loading_Label = Label(self.setup_frame, anchor='center', justify='center', wraplength="250", text="Please wait while the session is " "established...") self.loading_pbar = ttk.Progressbar(self.setup_frame, orient=HORIZONTAL, length=200, mode='determinate') self.loading_pbar_length = 7.0 self.loading_status_text = StringVar() self.loading_status_text.set('Initiating session logger...') self.loading_status_Label = Label(self.setup_frame, foreground="#777", font='TkDefaultFont 10 italic', anchor='center', justify='center', wraplength="250", textvariable=self.loading_status_text) # Actual information that is shown once session is started self.running_frame = Frame(self) self.running_Label_1 = Label(self.running_frame, anchor='center', justify='center', wraplength="250", text="A new session has been started " "for the", font=self.info_font) self.instr_string = StringVar() self.instr_string.set("$INSTRUMENT") self.instrument_label = Label(self.running_frame, foreground="#12649b", anchor='center', justify='center', wraplength="250", textvariable=self.instr_string, font=self.info_font) self.running_Label_2 = Label(self.running_frame, anchor='center', justify='center', wraplength="250", text="at", font='TkDefaultFont 16 bold') self.datetime_string = StringVar() self.datetime_string.set('$DATETIME') self.datetime_label = Label(self.running_frame, foreground="#12649b", anchor='center', justify='center', wraplength="250", textvariable=self.datetime_string, font=self.info_font) self.running_Label_3 = Label(self.running_frame, anchor='center', justify='left', wraplength="250", fg='#a30019', text="Leave this window open while you " "work! Copy data before you end this session.", font=self.info_font) # Buttons at bottom self.button_frame = Frame(self, padx=15, pady=10) self.end_icon = PhotoImage(file=resource_path('window-close.png')) self.end_button = Button(self.button_frame, # takefocus="", text="End session", padx=2.7, pady=10, state=DISABLED, compound=LEFT, command=self.session_end, image=self.end_icon) self.end_button.config(fg='black', font=('kDefaultFont',16,'bold'), relief=RAISED) ToolTip(self.end_button, self.tooltip_font, "Ending the session will close this window and start the record" " building process (don't click unless you're sure you've " "saved all your data to the network share!)", header_msg='Warning!', delay=0.00) self.log_icon = PhotoImage(file=resource_path('file.png')) self.log_button = Button(self.button_frame, text=" Show Debug Log ", command=lambda: LogWindow(parent=self), padx=2.7, pady=10, compound=LEFT, image=self.log_icon) self.log_button.config(fg='black', font=('kDefaultFont',12,'bold'), relief=RAISED) # Add button for logging session note by user self.note_icon = PhotoImage(file=resource_path('note.png')) self.note_button = Button(self.button_frame, text="Add Session Note", command=lambda: NoteWindow(parent=self), padx=2.7, pady=10, compound=LEFT, image=self.note_icon) self.note_button.config(fg='black', font=('kDefaultFont',12,'bold'), relief=RAISED) # self.copy_icon =PhotoImage(file=resource_path('copy.png')) # self.copydata_button = Button( # self.button_frame, # text=" Copy Data ", # padx=10, pady=10, # state=DISABLED, # compound=LEFT, # command=self.db_logger.copydata, # image=self.copy_icon # ) # self.copydata_button.config(fg='black', font=('kDefaultFont',16,'bold'),relief=RAISED) # grid the Toplevel window contents self.logo_label.grid(row=0, column=0, sticky=N, pady=(15, 0)) # grid the setup_frame contents self.setup_frame.grid(row=1, column=0) self.loading_Label.grid(row=0, column=0) self.loading_pbar.grid(row=1, column=0, pady=10) self.loading_status_Label.grid(row=2, column=0) # grid the button_frame contents self.button_frame.grid(row=3, column=0, sticky=S, pady=(15, 5)) self.end_button.grid(row=0, column=0, columnspan=2, sticky=EW) self.log_button.grid(row=1, column=0, ) self.note_button.grid(row=1, column=1, ) # self.copydata_button.grid(row=0, column=0, sticky=S, pady=5) self.columnconfigure(0, weight=1) self.rowconfigure(1, weight=1) self.setup_frame.rowconfigure(0, weight=1) self.db_logger.log('(GUI) Created the top level window', 1) self.session_startup()
[docs] def session_startup(self): self.startup_thread = threading.Thread( target=self.session_startup_worker) self.startup_thread.start() self.loading_pbar_length = 7.0 self.after(100, self.watch_for_startup_result)
[docs] def session_startup_worker(self): # each of these methods will return True if they succeed, and we only # want to continue with each one if the last ones succeeded if self.db_logger.db_logger_setup( self.startup_thread_queue, self.startup_thread_exit_queue): # Check to make sure that the last session was ended if self.db_logger.last_session_ended( self.startup_thread_queue, self.startup_thread_exit_queue): if self.db_logger.process_start( self.startup_thread_queue, self.startup_thread_exit_queue): self.db_logger.db_logger_teardown( self.startup_thread_queue, self.startup_thread_exit_queue) else: # we got an inconsistent state from the DB, so ask user # what to do about it response = HangingSessionDialog( self, self.db_logger, screen_res=self.screen_res).show() if response == 'new': # we need to end the existing session that was found # and then create a new one by changing the session_id to # a new UUID4 and running process_start self.loading_pbar_length = 13.0 self.db_logger.session_id = self.db_logger.last_session_id self.db_logger.log('Chose to start a new session; ' 'ending the existing session with id ' '{}'.format(self.db_logger.session_id), 1) if self.db_logger.process_end( self.startup_thread_queue, self.startup_thread_exit_queue): self.db_logger.session_id = str(uuid4()) self.db_logger.log( 'Starting a new session with new id ' '{}'.format(self.db_logger.session_id), 1) if self.db_logger.process_start( self.startup_thread_queue, self.startup_thread_exit_queue): self.db_logger.db_logger_teardown( self.startup_thread_queue, self.startup_thread_exit_queue) elif response == 'continue': # we set the session_id to the one that was previously # found (and set the time accordingly, and only run the # teardown instead of process_start self.loading_pbar_length = 5.0 self.running_Label_1.configure(text='Continuing the last ' 'session for the') self.running_Label_2.configure(text=' started at ') self.db_logger.session_id = self.db_logger.last_session_id self.db_logger.log('Chose to continue the existing ' 'session; setting the logger\'s ' 'session_id to the existing value ' '{}'.format(self.db_logger.session_id), 1) self.db_logger.session_started = True self.db_logger.session_start_time = datetime.strptime( self.db_logger.last_session_ts, "%Y-%m-%dT%H:%M:%S.%f") self.db_logger.db_logger_teardown( self.startup_thread_queue, self.startup_thread_exit_queue)
[docs] def watch_for_startup_result(self): """ Check if there is something in the queue """ try: res = self.startup_thread_queue.get(0) self.show_error_if_needed(res) if not isinstance(res, Exception): self.loading_status_text.set(res[0] + '...' if '!' not in res[0] else res[0]) self.loading_pbar['value'] = int(res[1]/ self.loading_pbar_length * 100) self.update() if res[0] == 'Unmounted network share': time.sleep(0.5) self.instr_string.set(self.db_logger.instr_schema_name) self.datetime_string.set( format_date(self.db_logger.session_start_time)) self.done_loading() else: self.after(100, self.watch_for_startup_result) except queue.Empty: self.after(100, self.watch_for_startup_result)
[docs] def show_error_if_needed(self, res): if isinstance(res, Exception): self.loading_pbar['value'] = 50 st = ttk.Style() st.configure("red.Horizontal.TProgressbar", background='#990000') self.loading_pbar.configure(style="red.Horizontal.TProgressbar") messagebox.showerror(parent=self, title="Error", message="Error encountered during " "session setup: \n\n" + str(res)) lw = LogWindow(parent=self, is_error=True) lw.mainloop()
[docs] def done_loading(self): # Remove the setup_frame contents self.setup_frame.grid_forget() # grid the running_frame contents to be shown after session is started self.running_frame.grid(row=1, column=0) self.running_Label_1.grid(row=0, pady=(20, 0)) self.instrument_label.grid(row=1, pady=(15, 5)) self.running_Label_2.grid(row=2, pady=(0, 0)) self.datetime_label.grid(row=3, pady=(5, 15)) self.running_Label_3.grid(row=4, pady=(0, 20)) # activate the "end session" button self.end_button.configure(state=ACTIVE)
# self.copydata_button.configure(state=ACTIVE)
[docs] def switch_gui_to_end(self): # Remove the setup_frame contents self.running_frame.grid_forget() # grid the setup_frame contents again self.setup_frame.grid(row=1, column=0) # deactivate the "end session" button self.end_button.configure(state=DISABLED)
# deactivate the "copy data" button # self.copydata_button.configure(state=DISABLED)
[docs] def session_end(self): # signal the startup thread to exit (if it's still running) self.startup_thread_exit_queue.put(True) # pass # do this in a separate end_thread (since it could take some time) if not self.db_logger.session_started: messagebox.showinfo("No session started", "A session was never started, so the logger " "will exit without sending a log to the " "database.", icon='warning') self.destroy() else: self.db_logger.log('(GUI) Starting session_end thread', 2) self.end_thread = threading.Thread(target=self.session_end_worker) self.end_thread.start() self.loading_Label.configure(text="Please wait while the session " "end is logged to the " "database...\n(this window will " "close when completed)") self.switch_gui_to_end() self.loading_pbar_length = 10.0 self.loading_pbar['value'] = 0 self.loading_status_text.set('Ending the session...') self.after(100, self.watch_for_end_result)
[docs] def session_end_worker(self): if self.db_logger.db_logger_setup(self.end_thread_queue, self.end_thread_exit_queue): if self.db_logger.process_end(self.end_thread_queue, self.end_thread_exit_queue): self.db_logger.db_logger_teardown(self.end_thread_queue, self.end_thread_exit_queue)
[docs] def watch_for_end_result(self): """ Check if there is something in the queue """ try: res = self.end_thread_queue.get(0) self.show_error_if_needed(res) self.loading_status_text.set(res[0] + '...') self.loading_pbar['value'] = int(res[1]/self.loading_pbar_length * 100) self.update() if res[0] == 'Unmounted network share': self.after(3000, self.destroy) self.close_warning(3) self.after(1000, lambda: self.close_warning(2)) self.after(2000, lambda: self.close_warning(1)) self.after(3000, lambda: self.close_warning(0)) # self.after(4000, lambda: self.close_warning(1)) # self.after(5000, lambda: self.close_warning(0)) else: self.after(100, self.watch_for_end_result) except queue.Empty: self.after(100, self.watch_for_end_result)
[docs] def close_warning(self, num_to_show): self.loading_status_text.set('Closing window in {} ' 'seconds...'.format(num_to_show))
[docs] def on_closing(self): resp = PauseOrEndDialogue(self, db_logger=self.db_logger, screen_res=self.screen_res).show() self.db_logger.log('(GUI) User clicked on window manager close button; ' 'asking for clarification', 2) if resp == 'end': self.db_logger.log('(GUI) Received end session signal from ' 'PauseOrEndDialogue', 1) self.session_end() elif resp == 'pause': self.db_logger.log('(GUI) Received pause session signal from ' 'PauseOrEndDialogue', 1) self.destroy() elif resp == 'cancel': self.db_logger.log('(GUI) User clicked Cancel in ' 'PauseOrEndDialogue', 1) pass
[docs]class PauseOrEndDialogue(Toplevel): def __init__(self, parent, db_logger, screen_res=None): self.tooltip_font = "TkDefaultFont" self.response = StringVar() self.screen_res = ScreenRes() if screen_res is None else screen_res Toplevel.__init__(self, parent) self.geometry(self.screen_res.get_center_geometry_string(480, 175)) self.grab_set() self.title("Confirm exit") self.protocol("WM_DELETE_WINDOW", self.destroy) self.bell() self.end_icon = PhotoImage(file=resource_path('window-close.png')) self.pause_icon = PhotoImage(file=resource_path('pause.png')) self.cancel_icon = PhotoImage(file=resource_path('arrow-alt-' 'circle-left.png')) self.error_icon = PhotoImage(file=resource_path('error-icon.png')) self.top_frame = Frame(self) self.button_frame = Frame(self, padx=15, pady=10) self.label_frame = Frame(self.top_frame) self.top_label = Label(self.label_frame, text="Are you sure?", font=("TkDefaultFont", 14, "bold"), wraplength=250, anchor='n', justify='left') if db_logger.session_started: msg = "Are you sure you want to exit? If so, please choose " \ "whether to end the current session, or pause it so it may " \ "be continued by running the Session Logger application " \ "again. Click \"Cancel\" to return to the main screen." else: msg = "Are you sure you want to exit?\nPlease choose an option " \ "below." self.warn_label = Label(self.label_frame, wraplength=350, anchor='w', justify='left', text=msg) self.error_icon_label = ttk.Label(self.top_frame, background=self['background'], foreground="#000000", relief="flat", image=self.error_icon) if not db_logger.session_started: end_text = "Exit logger" else: end_text = "End session" self.end_button = Button(self.button_frame, text=end_text, command=self.click_end, padx=10, pady=5, width=80, compound=LEFT, image=self.end_icon) self.pause_button = Button(self.button_frame, text='Pause session', command=self.click_pause, padx=10, pady=5, width=80, compound=LEFT, image=self.pause_icon) self.cancel_button = Button(self.button_frame, text='Cancel', command=self.click_cancel, padx=10, pady=5, width=80, compound=LEFT, image=self.cancel_icon) self.top_frame.place(relwidth = 1, relheight = 1) self.error_icon_label.grid(column=0, row=0, padx=(20,0), pady=5) self.label_frame.grid(column=1, row=0, padx=10, pady=10) self.top_label.grid(row=0, column=0, padx=(0,10), pady=0, sticky=(W,S)) self.warn_label.grid(row=1, column=0, padx=(0,10) , pady=(5,0)) self.button_frame.grid(row=1, column=1, ipadx=10, ipady=5) self.end_button.grid(row=0, column=0, padx=10) if db_logger.session_started: self.pause_button.grid(row=0, column=1, padx=10) self.cancel_button.grid(row=0, column=2, padx=10) self.columnconfigure(0, weight=1) self.rowconfigure(0, weight=1) self.focus_force() self.resizable(False, False) self.transient(parent) if db_logger.session_started: ToolTip(self.end_button, self.tooltip_font, "Ending the session will close this window and start the " "record building process (don't click unless you're sure " "you've saved all your data to the network share!)", header_msg='Warning!', delay=0.00) ToolTip(self.pause_button, self.tooltip_font, "Pausing the session will leave the NexusLIMS database in " "an inconsistent state. Please only do this if you plan to " "immediately resume the session before another user uses " "the tool (such as if you need to reboot the computer). To " "resume the session, simply run this application again and " "you will be prompted whether to continue or start a new " "session.", header_msg='Warning!', delay=0.00) self.protocol("WM_DELETE_WINDOW", self.click_close)
[docs] def show(self): self.wm_deiconify() self.focus_force() self.wait_window() return self.response.get()
[docs] def click_end(self): self.response.set('end') self.destroy()
[docs] def click_pause(self): self.response.set('pause') self.destroy()
[docs] def click_cancel(self): self.response.set('cancel') self.destroy()
[docs] def click_close(self): self.click_cancel()
[docs]class HangingSessionDialog(Toplevel): def __init__(self, parent, db_logger, screen_res=None): self.response = StringVar() self.screen_res = ScreenRes() if screen_res is None else screen_res Toplevel.__init__(self, parent) self.geometry(self.screen_res.get_center_geometry_string(480, 175)) self.grab_set() self.title("Incomplete session warning") self.protocol("WM_DELETE_WINDOW", self.destroy) self.bell() if db_logger.last_session_ts is not None: last_session_dt = datetime.strptime(db_logger.last_session_ts, "%Y-%m-%dT%H:%M:%S.%f") last_session_timestring = format_date(last_session_dt, with_newline=False) else: last_session_timestring = 'UNKNOWN' self.new_icon = PhotoImage(file=resource_path('file-plus.png')) self.continue_icon = PhotoImage(file=resource_path( 'arrow-alt-circle-right.png')) self.error_icon = PhotoImage(file=resource_path('error-icon.png')) self.top_frame = Frame(self) self.button_frame = Frame(self, padx=15, pady=10) self.label_frame = Frame(self.top_frame) self.top_label = Label(self.label_frame, text="Warning!", font=("TkDefaultFont", 14, "bold"), wraplength=200, anchor='w', justify='left', ) msg = "An interrupted session was found in the database for this " \ "instrument (started on {}). ".format(last_session_timestring) db_logger.log(msg, 0) msg += "Would you like to continue that existing session, or end it " \ "and start a new one?" self.warn_label = Label(self.label_frame, wraplength=350, anchor='w', justify='left', text=msg) self.error_icon_label = ttk.Label(self.top_frame, background=self['background'], foreground="#000000", relief="flat", image=self.error_icon) self.continue_button = Button(self.button_frame, text='Continue', command=self.click_continue, padx=10, pady=5, width=80, compound=LEFT, image=self.continue_icon) self.new_button = Button(self.button_frame, text='New session', command=self.click_new, padx=10, pady=5, width=80, compound=LEFT, image=self.new_icon) self.top_frame.place(relwidth=1, relheight=1) self.error_icon_label.grid(column=0, row=0, padx=(20,5), pady=5) self.label_frame.grid(column=1, row=0, padx=0, pady=0) self.top_label.grid(row=0, column=0, padx=(5,10), pady=(15,5), sticky=(W,S)) self.warn_label.grid(row=1, column=0, padx=(5,10), pady=(5,0)) self.button_frame.grid(row=1, column=0, sticky=S, ipadx=10, ipady=5) self.continue_button.grid(row=0, column=0, sticky=E, padx=15) self.new_button.grid(row=0, column=1, sticky=W, padx=15) self.columnconfigure(0, weight=1) self.rowconfigure(0, weight=1) self.focus_force() self.resizable(False, False) self.transient(parent) self.protocol("WM_DELETE_WINDOW", self.click_close)
[docs] def show(self): self.wm_deiconify() self.focus_force() self.wait_window() return self.response.get()
[docs] def click_new(self): self.response.set('new') self.destroy()
[docs] def click_continue(self): self.response.set('continue') self.destroy()
[docs] def click_close(self): messagebox.showerror(parent=self, title="Error", message="Please choose to either continue the " "existing session or start a new one")
[docs]class LogWindow(Toplevel): def __init__(self, parent, is_error=False): """ Create and raise a window showing a text field that holds the session logger `log_text` Parameters ---------- parent : MainApp The MainApp (or other widget) this LogWindow is associated with is_error : bool If True, closing the log window will close the whole application """ self.screen_res = parent.screen_res Toplevel.__init__(self, padx=3, pady=3) self.transient(parent) self.grab_set() self.tooltip_font = "TkDefaultFont" self.geometry(self.screen_res.get_center_geometry_string(450, 350)) self.title('NexusLIMS Session Logger Log') self.text_label = Label(self, text="Session Debugging Log:", padx=5, pady=5) self.text = Text(self, width=40, height=10, wrap='none') self.text.insert('1.0', "----------------------------------------------------" "\n" "If you encounter an error, please send the " "following\n" "log information to miclims@nist.gov for assistance \n" "----------------------------------------------------" "\n\n" + parent.db_logger.log_text) self.s_v = ttk.Scrollbar(self, orient=VERTICAL, command=self.text.yview) self.s_h = ttk.Scrollbar(self, orient=HORIZONTAL, command=self.text.xview) self.text['yscrollcommand'] = self.s_v.set self.text['xscrollcommand'] = self.s_h.set self.text.configure(state='disabled') self.button_frame = Frame(self, padx=15, pady=10) self.copy_icon = PhotoImage(file=resource_path('copy.png')) self.close_icon = PhotoImage(file=resource_path('window-close.png')) self.copy_button = Button(self.button_frame, text='Copy', # log to clipboard', command=self.copy_text_to_clipboard, padx=10, pady=5, width=60, compound="left", image=self.copy_icon) ToolTip(self.copy_button, self.tooltip_font, "Copy log information to clipboard", delay=0.25) def _close_cmd(): """Fix for LogWindow preventing app from closing if there was an error""" parent.db_logger.umount_network_share() self.destroy() parent.destroy() sys.exit(1) self.close_button = Button(self.button_frame, text='Close', # window', command=self.destroy if not is_error else _close_cmd, padx=10, pady=5, width=60, compound=LEFT, image=self.close_icon) # Make close window button do same thing as regular close button self.protocol("WM_DELETE_WINDOW", self.destroy if not is_error else lambda: sys.exit(1)) ToolTip(self.close_button, self.tooltip_font, "Close this window" if not is_error else "Close the application; make sure to copy the log if you " "need!", delay=0.25) self.text_label.grid(column=0, row=0, sticky=(S, W)) self.text.grid(column=0, row=1, sticky=(N, S, E, W)) self.s_v.grid(column=1, row=1, sticky=(N, S)) self.s_h.grid(column=0, row=2, sticky=(E, W)) self.button_frame.grid(row=3, column=0, sticky=(S), ipadx=10) self.copy_button.grid(row=0, column=0, sticky=E, padx=10) self.close_button.grid(row=0, column=1, sticky=W, padx=10) self.columnconfigure(0, weight=1) self.rowconfigure(1, weight=1) self.focus_force() if is_error: time_left = 3 self.change_close_button(3, DISABLED) # self.after(1000, lambda: self.change_close_button(4)) # self.after(2000, lambda: self.change_close_button(3)) self.after(1000, lambda: self.change_close_button(2)) self.after(2000, lambda: self.change_close_button(1)) self.after(3000, lambda: self.change_close_button(0, ACTIVE))
[docs] def change_close_button(self, num_to_show, state=DISABLED): if num_to_show == 0: self.close_button.configure(text='Close', state=state) else: self.close_button.configure(text='Close ({})'.format( num_to_show), state=state) self.close_button.grid(row=0, column=1, sticky=W, ipadx=10, padx=10)
[docs] def copy_text_to_clipboard(self): text_content = self.text.get('1.0', 'end') self.clipboard_clear() if sys.platform == 'win32': text_content = text_content.replace('\n', '\r\n') # put some text on clipboard # https://stackoverflow.com/a/4203897 r = Tk() r.withdraw() r.clipboard_clear() r.clipboard_append(text_content) r.update() r.destroy() self.update()
[docs]class NoteWindow(Toplevel): def __init__(self, parent, is_error=False): """ Create and raise a window showing a text input field so users can add session note to the current session; the last saved session note will gets written to the session log database when user ends the current session Parameters ---------- parent : MainApp The MainApp (or other widget) this NoteWindow is associated with is_error : bool If True, closing the Note window will close the whole application """ self.screen_res = parent.screen_res Toplevel.__init__(self, padx=3, pady=3) self.transient(parent) self.grab_set() self.tooltip_font = "TkDefaultFont" self.geometry(self.screen_res.get_center_geometry_string(450, 450)) self.title('Add Note to the Current Session') self.parent = parent # prepare some variables self.old_note = self.parent.db_logger.session_note self.old_note = self.old_note.replace("''", "'") self.note = StringVar() self.note.set(self.old_note) self.session_note = Text(self, width=40, height=10, wrap='word', font=("TkDefaultFont", 16)) self.s_v = ttk.Scrollbar(self, orient=VERTICAL, command=self.session_note.yview) self.s_h = ttk.Scrollbar(self, orient=HORIZONTAL, command=self.session_note.xview) self.session_note['yscrollcommand'] = self.s_v.set self.session_note['xscrollcommand'] = self.s_h.set self.session_note.insert("1.0", self.old_note) # add functional buttons self.button_frame = Frame(self, padx=15, pady=10) self.save_icon = PhotoImage(file=resource_path('save.png')) self.clear_icon = PhotoImage(file=resource_path('clear.png')) self.close_icon = PhotoImage(file=resource_path('window-close.png')) self.clear_button = Button(self.button_frame, text='Clear', # clear saved note', command= self.delete_note, padx=10, pady=5, width=60, compound="left", image=self.clear_icon) self.save_button = Button(self.button_frame, text='Save', # log to clipboard', command=self.save_note, padx=10, pady=5, width=60, compound="left", image=self.save_icon) ToolTip(self.save_button, self.tooltip_font, "Save session note before closing this window", delay=0.25) def _close_cmd(): """Fix for LogWindow preventing app from closing if there was an error""" parent.notes = self.old_note parent.db_logger.umount_network_share() self.destroy() parent.destroy() sys.exit(1) self.close_button = Button(self.button_frame, text='Close', # window', command=self.destroy if not is_error else _close_cmd, padx=10, pady=5, width=60, compound=LEFT, image=self.close_icon) # Make close window button do same thing as regular close button self.protocol("WM_DELETE_WINDOW", self.destroy if not is_error else lambda: sys.exit(1)) ToolTip(self.close_button, self.tooltip_font, "Close this window" if not is_error else "Close the application; make sure to copy the log if you " "need!", delay=0.25) # self.text_label.grid(column=0, row=0, sticky=(S, W)) self.session_note.grid(column=0, row=1, sticky=(N, S, E, W)) self.s_v.grid(column=1, row=1, sticky=(N, S)) self.s_h.grid(column=0, row=2, sticky=(E, W)) self.button_frame.grid(row=3, column=0, sticky=(S), ipadx=10) self.clear_button.grid(row=0, column=1, sticky=E, padx=10) self.save_button.grid(row=0, column=0, sticky=E, padx=10) self.close_button.grid(row=0, column=2, sticky=W, padx=10) self.columnconfigure(0, weight=1) self.rowconfigure(1, weight=1) self.focus_force() if is_error: time_left = 3 self.change_close_button(3, DISABLED) # self.after(1000, lambda: self.change_close_button(4)) # self.after(2000, lambda: self.change_close_button(3)) self.after(1000, lambda: self.change_close_button(2)) self.after(2000, lambda: self.change_close_button(1)) self.after(3000, lambda: self.change_close_button(0, ACTIVE))
[docs] def save_note(self): #Save the current session note in the text box, overwrite previous saved note self.note = self.session_note.get("1.0", END) #escape single quote by doubling it so it won't cause issues with sql insert_statement self.note = self.note.replace("'", "''") if not (self.note == self.old_note): self.old_note = self.note #self.parent.notes = self.note self.parent.db_logger.session_note = self.note
[docs] def delete_note(self): #delete the current session note in the text box self.session_note.delete("1.0", END)
[docs] def change_close_button(self, num_to_show, state=DISABLED): if num_to_show == 0: self.close_button.configure(text='Close', state=state) else: self.close_button.configure(text='Close ({})'.format( num_to_show), state=state) self.close_button.grid(row=0, column=1, sticky=W, ipadx=10, padx=10)
[docs] def copy_text_to_clipboard(self): text_content = self.text.get('1.0', 'end') self.clipboard_clear() if sys.platform == 'win32': text_content = text_content.replace('\n', '\r\n') # put some text on clipboard # https://stackoverflow.com/a/4203897 r = Tk() r.withdraw() r.clipboard_clear() r.clipboard_append(text_content) r.update() r.destroy() self.update()
[docs]class ToolTip(Toplevel): """ Provides a ToolTip widget for Tkinter. To apply a ToolTip to any Tkinter widget, simply pass the widget to the ToolTip constructor """ def __init__(self, wdgt, tooltip_font, msg=None, msgFunc=None, header_msg=None, delay=1, follow=True): """ Initialize the ToolTip Parameters ---------- wdgt : The widget this ToolTip is assigned to tooltip_font : str Font to be used msg : str A static string message assigned to the ToolTip msgFunc : object A function that retrieves a string to use as the ToolTip text delay : float The delay in seconds before the ToolTip appears follow : bool If True, the ToolTip follows motion, otherwise hides """ self.wdgt = wdgt # The parent of the ToolTip is the parent of the ToolTips widget self.parent = self.wdgt.master # Initialise the Toplevel Toplevel.__init__(self, self.parent, bg='black', padx=1, pady=1) # Hide initially self.withdraw() # The ToolTip Toplevel should have no frame or title bar self.overrideredirect(True) # The msgVar will contain the text displayed by the ToolTip self.msgVar = StringVar() self.header_msgVar = StringVar() if msg is None: self.msgVar.set('No message provided') else: self.msgVar.set(msg) if header_msg is None: self.header_msgVar.set('') else: self.header_msgVar.set(header_msg) self.msgFunc = msgFunc self.delay = delay self.follow = follow self.visible = 0 self.lastMotion = 0 if header_msg is not None: hdr_wdgt = Message(self, textvariable=self.header_msgVar, bg='#FFFFDD', font=(tooltip_font, 8, 'bold'), aspect=1000, justify='left', anchor=W, pady=0) msg_wdgt = Message(self, textvariable=self.msgVar, bg='#FFFFDD', font=tooltip_font, aspect=1000, pady=0) hdr_wdgt.grid(row=0, sticky=(W, E, S), pady=(0,0)) msg_wdgt.grid(row=1) else: # The text of the ToolTip is displayed in a Message widget Message(self, textvariable=self.msgVar, bg='#FFFFDD', font=tooltip_font, aspect=1000).grid() # Add bindings to the widget. This will NOT override # bindings that the widget already has self.wdgt.bind('<Enter>', self.spawn, '+') self.wdgt.bind('<Leave>', self.hide, '+') self.wdgt.bind('<Motion>', self.move, '+')
[docs] def spawn(self, event=None): """ Spawn the ToolTip. This simply makes the ToolTip eligible for display. Usually this is caused by entering the widget Arguments: event: The event that called this function """ self.visible = 1 # The after function takes a time argument in milliseconds self.after(int(self.delay * 1000), self.show)
[docs] def show(self): """ Displays the ToolTip if the time delay has been long enough """ if self.visible == 1 and time.time() - self.lastMotion > self.delay: self.visible = 2 if self.visible == 2: self.deiconify()
[docs] def move(self, event): """ Processes motion within the widget. Arguments: event: The event that called this function """ self.lastMotion = time.time() # If the follow flag is not set, motion within the # widget will make the ToolTip disappear # if self.follow is False: self.withdraw() self.visible = 1 # Offset the ToolTip 20x10 pixes southwest of the pointer self.geometry('+%i+%i' % (event.x_root + 20, event.y_root - 10)) try: # Try to call the message function. Will not change # the message if the message function is None or # the message function fails self.msgVar.set(self.msgFunc()) except: pass self.after(int(self.delay * 1000), self.show)
[docs] def hide(self, event=None): """ Hides the ToolTip. Usually this is caused by leaving the widget Arguments: event: The event that called this function """ self.visible = 0 self.withdraw()
if __name__ == "__main__": try: sing = check_singleton() except OSError as e: root = Tk() root.title('Error') message = "Only one instance of the NexusLIMS " + \ "Session Logger can be run at one time. " + \ "Please close the existing window if " + \ "you would like to start a new session " \ "and run the application again." if sys.platform == 'win32': message = message.replace('be run ', 'be run\n') message = message.replace('like to ', 'like to\n') root.withdraw() messagebox.showerror(parent=root, title="Error", message=message) sys.exit(0)