Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 47d37a3abf
Fetching contributors…

Cannot retrieve contributors at this time

545 lines (472 sloc) 28.011 kb
#!/usr/bin/env python
import sys, Tkinter as tk, re, csv, optparse, signal, commands, subprocess, getpass
from optparse import OptionParser
from functools import partial
from ConfigParser import SafeConfigParser
# Should also try to import atm.functions here ...
Idea is that there are three components.
We have this file - the core logic,
the menu.cfg file - the configuration,
the file
def parse_args(options):
''' Parse the given options and arguments using optparse'''
parser = OptionParser()
parser.add_option("-c", "--config", metavar="FILE", dest="config",
help="Default: menu.cfg", default='menu.cfg')
parser.add_option("-f", "--functions", metavar="FILE", dest="functions",
help="Default:", default='menu.functions')
parser.add_option("-t", "--text", dest="text", default=False,
action="store_true",help="text mode. Default: False")
(options, args) = parser.parse_args()
return (options,args)
def parse_config(config):
'''Build a dictionary of the menu from the given config file after having removed empty lines and comments'''
f = open(config, 'rt')
# Want to ignore comments and then remove all commas on the ends of lines, to ensure consistency
lines = f.readlines()
# remove comments, subsequent trailing spaces and the final comma (should be at most 1 of these)
processed_lines = [ line.split('#')[0].rstrip('\n').rstrip(' ').rstrip(',') for line in lines ]
# Now we let the csv module parse what's left, although I'm not sure it's doing anything very clever.
reader = csv.reader(processed_lines,skipinitialspace = True)
sys.exit('Couldn\t open %s' % config)
# Would like to convert this into a dictionary, where a key is the dictionary
# position defined as a tuple, and the value is a list of the options at that point.
# eg. menu_opts[('level1','level2')] = ['list','of','options','under','level','2']
menu_opts = {}
for line in reader:
line = tuple(line) # Lists can't be keys in dictionaries
for i in range(len(line)):
if line[:i] not in menu_opts: menu_opts[line[:i]] = [line[i]]
if line[i] not in menu_opts[line[:i]]: menu_opts[line[:i]].append(line[i])
return menu_opts
def handle_sigint():
'''Gracefully quit on receiving Ctrl + c'''
# This doesn't seem to always work, so I've wrapped the main() call in a try / except clause
# instead until I figure it out.
print 'Recieved Ctrl + c - exiting ...'
# So I can quickly test changes in Idle - use line below:
#import menu; menu_dict = menu.parse_config('D:\Edmund\Python\Scripts\menu.cfg'); menu = menu.Menu(menu_dict)
class Menu:
'''The menu class needs to be instantiated with a dictionary built from a menu config file.\
The dictionary has the property that each key is a tuple defining a particular menu level (eg. ('level1','level2') )\
, with the value being the list of all the options available at that level (eg. ['level3', 'command1','command2']).'''
def __init__(self,menu_dict):
self.position = [] # At the base of the menu
self.menu_dict = menu_dict # This is the config file we're using
def get_options(self,position):
'''Display the options returned from the previous search, if applicable, or those available at this point in the menu'''
if hasattr(self,'search_dict'):
return_dict = self.search_dict
return return_dict
if tuple(position) not in self.menu_dict: return -1
# The line below is just returning a single entry of the menu_dict, but
# in a dictionary form for consistency
return dict([(tuple(position),sorted(self.menu_dict[tuple(position)]))])
def choose_option(self,position,option):
'''Move to selected level of menu / execute chosen command'''
if self.categorise(position,option) == -1: return -1
if self.categorise(position,option) == 'search':
elif self.categorise(position,option) == 'sub-menu':
self.position = position
# Not a search or a sub-menu implies this is a command which should be run,
# so this will call the associated 'actual-command' lying under the command entry
# Obviously, this has yet to be implemented - it just prints the line below currently.
self.execute_command(self.menu_dict[tuple(position + [option])][0])
def go_up(self):
'''Move back up one level of the menu (unless already at base, in which case do nothing)'''
if len(self.position) > 0:
self.position.pop(len(self.position) - 1)
def search(self,regex):
'''Returns and stores, as an object attribute, a mini-menu_dict, where regex matches \
either the key or the value or, if value is a 'command', the 'actual-command' lying underneath'''
matches = {}
for (key, value) in self.menu_dict.items():
for level in key:
matches[key] = value
if key not in matches:
for entry in value:
# I'm being careful here to only add the menu entries that match
if key not in matches: matches[key] = [entry]
else: matches[key].append(entry)
# Note that we may have matched the 'actual-command', as opposed to a 'sub-menu' or a 'command'
# (which are what you see when you browse the menu). In these cases, I only want to store the
# command entry, not the actual command entry
for (key,value) in matches.items():
if self.categorise(list(key),value[0]) == 'actual-command':
del matches[key] # we know in this case the actual-command is the only entry in value
if tuple(list(key)[:-1]) not in matches:
# If key,value matches the menu position of the actual command
# and the actual command itself, key[:-1],[key[-1]] is the dictionary
# entry for the associated command you can browse to in the menu,
# which is what we want
matches[tuple(list(key)[:-1])] = [key[-1]]
self.search_dict = matches
# I return the dictionary here, but I think I'm more likely
# to use the fact that I've set
return self.search_dict
def categorise(self,position,option):
'''Returns 'sub-menu','command','actual-command' (as typed on the command line) depending on the option'''
if tuple(position) not in self.menu_dict: return -1
if option not in self.menu_dict[tuple(position)]: return 'search' # If someone hasn't picked a valid option, it's a search
if tuple(position + [option]) not in self.menu_dict: return 'actual-command'
elif tuple(position + [option]) in self.menu_dict \
and len(self.menu_dict[tuple(position + [option])]) == 1 \
and tuple(position + [option] + [self.menu_dict[tuple(position + [option])][0]]) not in self.menu_dict:
return 'command'
else: return 'sub-menu'
def execute_command(self,text):
'''Executes the given command in the shell. Not currently working in Git Bash, but yet to test on an actual Unix box'''
# two possibilities. Simple function, in which case execute as the current user.
# (user;command) - in which case execute the command as the user.
match ='^\(([^;]+);(.*)\)',text)
if match:
# User has been specified
(user,command) = (,
# No user has been specified
(user,command) = (text,getpass.getuser())
process = subprocess.Popen(
"sudo su - %s" % user,
(stdout_value,stderr_value) = process.communicate(command)
returncode =
print "stdout: \n%s" % stdout_value
print "stderr: \n%s" % stderr_value
print "returncode: %s" % returncode
print "\n\n------------------------------------------\n\n"
def run_text_menu(menu):
while True:
print "\n****** Menu ******"
# Zero option is always 'go up one level' ...
print "%d:(%s): %s\n" % (0,'Parent-menu','Go back up one level')
# These are the current options ...
options = menu.get_options(menu.position)
# A dictionary that will keep track of what the
# numbered menu options actually refer to under the cover
index_dict = {}
label = 0
# Loop through options and print them to the screen
for index1 in range(len(options.items())):
key,value = sorted(options.items())[index1]
# Create a multi-line variable showing where you are in the menu, and print it.
location_text = 'Root'
for index in range(len(key)):
if index == len(key) -1: location_text = location_text + '\n' + '--' * (index + 1) + '>' + key[index]
else: location_text = location_text + '\n' + '--' * (index + 1) + key[index]
print "%s:" % location_text
for index2 in range(len(value)):
label = label + 1
# Make a note of the menu number label -> indexes mapping
index_dict[label] = (index1,index2)
# Is the option a command or submenu? Work this out so we can label it.
category = menu.categorise(list(key),value[index2])
if category == -1: sys.exit("Some error has occurred")
print "%d:(%s):\t%s" % (label,category,value[index2])
print "\n-------------------\n"
# Take user input
choice = raw_input('\nMake your choice: ')
# Process user input
if choice == '0': menu.go_up()
elif'(quit|exit)',choice): sys.exit()
elif'^$',choice): pass # Do nothing if nothing has been entered
# They've picked a menu entry as opposed to a search
# Using the index_dict, work out what position and option they've chosen
index1,index2 = index_dict[int(choice)]
position, entries = sorted(options.items())[index1]
option = entries[index2]
else: position, option = menu.position, choice
#if menu.choose_option(menu.position,menu.specify_option(menu.position,choice)) == -1:
if menu.choose_option(list(position),option) == -1:
sys.exit('Some error has occurred')
class Button:
def __init__(self,frame,position,GUI):
self.frame = frame
self.colour = tk.StringVar()
self.variable = tk.StringVar()
# 'executed' is used for command buttons, and is set to 'yes' when they are pressed
# This is because it's useful to reset the appearance of all buttons and then redo the
# appearance of the pressed ones as necessary. command buttons are a bit more tricky,
# because if you press them twice you want the command to be executed and the button to then
# appear unpressed, which is what this variable helps with.
self.executed = tk.StringVar()
self.position = position
GUI.buttons[tuple(position)] = self
self.type =[:-1],self.position[-1])
if self.type == 'command':
self.actual_command =[tuple(self.position)][0]
self.default_colour = GUI.colour_scheme['command-initial']
self.colour_when_pressed = GUI.colour_scheme['command-final']
self.default_colour = GUI.colour_scheme['not-selected']
self.colour_when_pressed = GUI.colour_scheme['selected']
self.button = tk.Button(frame,bg=self.colour.get(),activebackground=self.colour.get(),text=self.position[-1],relief=self.relief,command = partial(GUI.button_press,self))
# Also want to make the command_display_frame show underlying command
# or menu position (useful when doing a search) when mouse hovers over button
self.button.bind("<Enter>", partial(GUI.display_command,self,True))
self.button.bind("<Leave>", partial(GUI.display_command,self,False))
def reset(self):
# Just resetting the appearance)
self.relief = tk.RAISED
def press(self):
self.relief = tk.SUNKEN
def pack(self):
class GUI:
''' The top line of the GUI will be an inert button labelled 'search' (purely used as a label)
alongside a text entry box, into which the user can type a regex to pull up the appropriate menu
buttons as opposed to navigating the menu itself. Underneath will a field used to display the
actual underlying commad whenever the mouse hovers over a command button. Under that, the actual
menu buttons - the main tree on the left, and each time a button is pressed the buttons on the next
branch will appear alongside it. Button colours will indicate whether an option is leading to
a submenu or whether it will actually execute a command.'''
def __init__(self, master, menu): = menu
self.master = master
self.colour_scheme = dict([
self.buttons = {} # key is the position as a tuple
self.button_frames = {} # key is the position as a tuple
# There will be three frames - one for the 'search' label and input box,
# one to display the underlying actual-command whenever the mouse hovers
# over a command button and one for all the buttons.
self.search_frame = tk.Frame(self.master)
self.command_display_frame = tk.Frame(self.master)
self.command_display_contents = tk.StringVar()
self.command_display_button = tk.Entry(self.command_display_frame,textvariable = self.command_display_contents,width=len(self.command_display_contents.get()),state=tk.DISABLED,disabledforeground='black')
self.button_frame = tk.Frame(self.master)
self.test = tk.Frame(self.button_frame)
# Putting the 'search label' and input box into the search frame
self.search_label = object()
self.search_label.button = tk.Button(self.search_frame,text='Search',state=tk.DISABLED,disabledforeground='black')
self.search_entry = object()
self.search_entry.input = tk.StringVar() # Variable to keep the contents of the search
self.search_entry.colour = tk.StringVar()
self.search_entry.button = tk.Entry(self.search_frame,textvariable=self.search_entry.input,bg=self.search_entry.colour.get(),state=tk.NORMAL,)
# The binding on the line below triggers the search event on each key press
# Display buttons for current position
def display_command(self,button,true_or_false,event):
''' when the mouse hovers over a command, this function displays the actual command underneath
in the command_display_buttons. If it is a submenu, the position is displayed.'''
# For some reason, in unix, when the mouse hovers over the button, it loses it's colour.
if button.type == 'command': text = button.actual_command
else: text = str(button.position)
if true_or_false == True:
# Don't seem to need to call 'configure' to get this to update
# A property of bindings, perhaps?
def display_buttons(self,position):
# We're supposing here someone has just clicked a button, as opposed to doing a search.
# Position is a list defining the current position for which we want to display buttons.
# Think I will have to use a different function to display the results of a search.
# eg. ['level1','level2','level3']
# First thing is to remove unwanted button frames and their associated buttons
for frame in self.button_frames.keys()[:]:
if frame != tuple(position[:len(frame)]):
# Above if statement means we are talking about a frame we don't want displayed any more
# First, remove the stored references to all its buttons
for button in self.buttons.keys()[:]:
if self.buttons[button].frame == self.button_frames[frame]:
# Now stop displaying the frame (and thus all it's buttons) and the reference to that
#self.button_frames[frame].destroy() # don't think I need this
# Now we create all the frames and buttons we need, starting with the base frame
# This would only ever be deleted when someone performs a search as opposed to clicking through the menu
# (the following looks complicated - it's just that get_options returns a dict, and '()' is the key
# for the root of the menu
# this is probably a mistake - it was me trying to be consistent, but things would look much
# simpler if it just returned a list of the options rather than a dictionary with a single entry!)
if () not in self.button_frames:
self.button_frames[()] = tk.Frame(self.button_frame)
for option in[])[()]:
button = Button(self.button_frames[()],[option],self)
# Now I build up the menu from left to right, one level at a time,
# until I've displayed the level required.
# If the button that has this position is an actual command, we don't want to
# create a frame for it, as that would only contain the underlying 'actual-command'
# (the 'actual command' isn't supposed to be a button -
# it's a command that's executed by clicking the parent 'command' button).
for i in range(len(position)):
# A new frame for the next lot of buttons if it doesn't already exist,
# unless it's for a command
# (the 'actual command' isn't supposed to be a button -
# it's a command that's executed by clicking the parent 'command' button).
temp_position = position[:i+1]
if tuple(temp_position) not in self.button_frames:
if[:-1],temp_position[-1]) != 'command':
# We need to create the frame and populate it with buttons
self.button_frames[tuple(temp_position)] = tk.Frame(self.button_frame)
for option in[tuple(temp_position)]:
frame = self.button_frames[tuple(temp_position)]
button = Button(frame,temp_position + [option],self) # This also puts an entry in self.buttons
# Colour and set the relief of all the buttons.
# Reset appearance of all buttons except the current one
for other_button in self.buttons.values():
# Now ensure the correct buttons appear pressed
# The complication is that when you press a primed command, the command is executed and
# the button is then effectively un-pressed, so in this case I don't want to press it again
for other_button in self.buttons.values():
if tuple(other_button.position) == tuple(position[:len(other_button.position)]):
for button in self.buttons.values():
# If we've just executed a command, un-prime the command (set it back to its default colour)
if button.executed.get() == 'yes':
def search(self,event):
# I don't want this function doing a search unless a regular ASCII
# character is pressed (or backspace)
# We also don't want it doing a search unless we have a legitimate regex
# Idea is to turn the search box yellow whilst expression isn't valid
colour_var = self.search_entry.colour
if self.search_entry.input.get() == '':
# I want this to be the equivalent of not having done a search -
# effectively loading the menu for the first time.
# I set the base position and clear the menu.search_dict = []
if event.char != '' or event.keysym == 'BackSpace':
options_dict =
# The text menu relies on the stored search_dict. The GUI menu does not.
# Likely user has entered a partially complete regex
# Let's turn the colour yellow to let them know
options_dict = {}
# Search ran ok - string must be a valid regex
# Make sure colour of text box reflects that
# I don't seem to be able to remove individual buttons - just whole frames
# Therefore, for each search we remove all buttons and frames and re-populate
for button in self.buttons.keys()[:]: del(self.buttons[button])
for frame in self.button_frames.keys()[:]:
# Initially, when you've only pressed one character, the search function can return a LOT
# of values. There is an annoying bug in unix where the frame doesn't resize down after you've
# displayed more than 70 buttons in it, but also it's unpractical, of course, because you can't
# fit 70 buttons on a screen at once anyway. I should batch them up alongside each other in sets of 20.
batch_size = 20
button_list = []
for menu_level, options in options_dict.items():
for option in options:
list_of_batches = [ button_list[i:i+batch_size] for i in range(0,len(button_list),batch_size) ]
for batch in list_of_batches:
self.button_frames[tuple(batch)] = tk.Frame(self.button_frame)
for (menu_level, option) in batch:
button = Button(self.button_frames[tuple(batch)],list(menu_level) + [option],self)
self.button_frames['search'] = tk.Frame(self.button_frame)
for menu_level, options in options_dict.items():
for option in options:
button = Button(self.button_frames['search'],list(menu_level) + [option],self)
def button_press(self,button): = button.position
# If button is a primed command, execute the command
if button.type == 'command' and button.colour.get() == button.colour_when_pressed:
# Below is a bit of a silly bit of code to make the button flash. ooohhh!
class object:
def __init__(self):
def run_gui_menu(menu):
root = tk.Tk()
def main():
# Parse input options
options, args = parse_args(sys.argv[0:])
# Read in menu config file
menu_dict = parse_config(options.config)
# Make an instance of the menu class
menu = Menu(menu_dict)
# Run the menu GUI if user so wishes ...
if options.text == False: run_gui_menu(menu)
# ... else run the text based menu.
if options.text == True: run_text_menu(menu)
if __name__ == "__main__":
except KeyboardInterrupt:
Jump to Line
Something went wrong with that request. Please try again.