-commands = {
- 'exit': exitcmd,
- 'help': helpcmd,
- 'open': sendcmd(tuerSock, 'open'),
- 'close': sendcmd(tuerSock, 'close'),
- 'buzz': sendcmd(tuerSock, 'buzz'),
-}
+CmdEntry = namedtuple('CmdEntry','function helpstring')
+
+commands = alias({
+ 'exit': CmdEntry(exitcmd, 'Quits this shell'),
+ 'help': CmdEntry(helpcmd, 'Helps you getting to know the available commands'),
+ 'unlock': CmdEntry(sendcmd(tuerSock, 'unlock'), 'Will try to unlock the apartment door'),
+ 'lock': CmdEntry(sendcmd(tuerSock, 'lock'), 'If in fallback mode, try to lock the apartment door. If not in fallback mode, you must use the switch near the door.'),
+ 'buzz': CmdEntry(sendcmd(tuerSock, 'buzz'), 'Will buzz the buzzer for the street door'),
+ 'who': CmdEntry(whocmd, 'Shows the list of people, who are allowed to control this system'),
+ 'fallback_mode_on': CmdEntry(prompt_sure(sendcmd(tuerSock, 'fallback_mode_on'),'WARNING: This action will be reported to the admins. Use this only in case of Sphinx hardware failure when you need to ignore erroneous sensor input!'), 'Sets the system in a state where it is less dependent on sensoric input. Use it only when sensors are broken.'),
+ 'fallback_mode_off': CmdEntry(prompt_sure(sendcmd(tuerSock, 'fallback_mode_off'),'WARNING: This action will be reported to the admins. Use this only if you have fixed the sensors of the Sphinx or activated fallback mode by accident!'), 'Resets the system to the default state. Use this when you have just repaired the sensors of the Sphinx.'),
+},{
+ # aliases
+ 'open': 'unlock',
+})
+
+def complete_command(cmd):
+ '''returns a list of commands (as strings) starting with cmd'''
+ return list(filter(lambda x: x.startswith(cmd), commands.keys()))
+readline.set_completer(lambda cmd, num: (complete_command(cmd)+[None])[num]) # wrap complete_command for readline's weird completer API
+readline.parse_and_bind("tab: complete") # run completion on tab