#!/usr/bin/env python3 # -*- coding: utf-8 -*- ''' auto-auto-complete – Autogenerate shell auto-completion scripts Copyright © 2012 Mattias Andrée (maandree@kth.se) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . ''' import sys ''' Hack to enforce UTF-8 in output (in the future, if you see anypony not using utf-8 in programs by default, report them to Princess Celestia so she can banish them to the moon) @param text:str The text to print (empty string is default) @param end:str The appendix to the text to print (line breaking is default) ''' def print(text = '', end = '\n'): sys.stdout.buffer.write((str(text) + end).encode('utf-8')) ''' stderr equivalent to print() @param text:str The text to print (empty string is default) @param end:str The appendix to the text to print (line breaking is default) ''' def printerr(text = '', end = '\n'): sys.stderr.buffer.write((str(text) + end).encode('utf-8')) ''' Bracket tree parser ''' class Parser: ''' Parse a code and return a tree @param code:str The code to parse @return :list<↑|str> The root node in the tree ''' @staticmethod def parse(code): stack = [] stackptr = -1 comment = False escape = False quote = None buf = None for charindex in range(0, len(code)): c = code[charindex] if comment: if c in '\n\r\f': comment = False elif escape: escape = False if c == 'a': buf += '\a' elif c == 'b': buf += chr(8) elif c == 'e': buf += '\033' elif c == 'f': buf += '\f' elif c == 'n': buf += '\n' elif c == 'r': buf += '\r' elif c == 't': buf += '\t' elif c == 'v': buf += chr(11) elif c == '0': buf += '\0' else: buf += c elif c == quote: quote = None elif (c in ';#') and (quote is None): if buf is not None: stack[stackptr].append(buf) buf = None comment = True elif (c == '(') and (quote is None): if buf is not None: stack[stackptr].append(buf) buf = None stackptr += 1 if stackptr == len(stack): stack.append([]) else: stack[stackptr] = [] elif (c == ')') and (quote is None): if buf is not None: stack[stackptr].append(buf) buf = None if stackptr == 0: return stack[0] stackptr -= 1 stack[stackptr].append(stack[stackptr + 1]) elif (c in ' \t\n\r\f') and (quote is None): if buf is not None: stack[stackptr].append(buf) buf = None else: if buf is None: buf = '' if c == '\\': escape = True elif (c in '\'\"') and (quote is None): quote = c else: buf += c raise Exception('premature end of file') ''' Simplifies a tree @param tree:list<↑|str> The tree ''' @staticmethod def simplify(tree): program = tree[0] stack = [tree] while len(stack) > 0: node = stack.pop() new = [] edited = False for item in node: if isinstance(item, list): if item[0] == 'multiple': master = item[1] for slave in item[2:]: new.append([master] + slave) edited = True elif item[0] == 'case': for alt in item[1:]: if alt[0] == program: new.append(alt[1]) break edited = True else: new.append(item) else: new.append(item) if edited: node[:] = new for item in node: if isinstance(item, list): stack.append(item) ''' Completion script generator for GNU Bash ''' class GeneratorBASH: ''' Constructor @param program:str The command to generate completion for @param unargumented:list>> Specification of unargumented options @param argumented:list>> Specification of argumented options @param variadic:list>> Specification of variadic options @param suggestion:list> Specification of argument suggestions ''' def __init__(self, program, unargumented, argumented, variadic, suggestion): self.program = program self.unargumented = unargumented self.argumented = argumented self.variadic = variadic self.suggestion = suggestion ''' Gets the argument suggesters for each option @param :dist Map from option to suggester ''' def __getSuggesters(self): suggesters = {} for group in (self.unargumented, self.argumented, self.variadic): for item in group: if 'suggest' in item: suggester = item['suggest'] for option in item['options']: suggesters[option] = suggester[0] for group in (self.unargumented, self.argumented, self.variadic): for item in group: if ('suggest' not in item) and ('bind' in item): bind = item['bind'][0] if bind in suggesters: suggester = suggesters[bind] for option in item['options']: suggesters[option] = suggester return suggesters ''' Returns the generated code @return :str The generated code ''' def get(self): buf = '# bash completion for %s -*- shell-script -*-\n\n' % self.program buf += '_%s()\n{\n' % self.program buf += ' local cur prev words cword\n' buf += ' _init_completion -n = || return\n\n' options = [] for group in (self.unargumented, self.argumented, self.variadic): for item in group: if 'complete' in item: options += item['complete'] buf += ' options="%s"\n' % (' '.join(options)) buf += ' COMPREPLY=( $( compgen -W "$options" -- "$cur" ) )\n\n' suggesters = self.__getSuggesters(); suggestFunctions = {} for function in self.suggestion: suggestFunctions[function[0]] = function[1:] indenticals = {} for option in suggesters: suggester = suggestFunctions[suggesters[option]] _suggester = str(suggester) if _suggester not in indenticals: indenticals[_suggester] = (suggester, [option]) else: indenticals[_suggester][1].append(option) def verb(text): temp = text for char in 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-+=/@:\'': temp = temp.replace(char, '') if len(temp) == 0: return text return '\'' + text.replace('\'', '\'\\\'\'') + '\'' def makeexec(functionType, function): if functionType in ('exec', 'pipe', 'fullpipe', 'cat', 'and', 'or'): elems = [(' %s ' % makeexec(item[0], item[1:]) if isinstance(item, list) else verb(item)) for item in function] if functionType == 'exec': return ' "$( %s )" ' % (' '.join(elems)) if functionType == 'pipe': return ' ( %s ) ' % (' | '.join(elems)) if functionType == 'fullpipe': return ' ( %s ) ' % (' |% '.join(elems)) if functionType == 'cat': return ' ( %s ) ' % (' ; '.join(elems)) if functionType == 'and': return ' ( %s ) ' % (' && '.join(elems)) if functionType == 'or': return ' ( %s ) ' % (' || '.join(elems)) if functionType in ('params', 'verbatim'): return ' '.join([verb(item) for item in function]) return ' '.join([verb(functionType)] + [verb(item) for item in function]) index = 0 for _suggester in indenticals: (suggester, options) = indenticals[_suggester] conds = [] for option in options: conds.append('[ $prev = "%s" ]' % option) buf += ' %s %s; then\n' % ('if' if index == 0 else 'elif', ' || '.join(conds)) suggestion = ''; for function in suggester: functionType = function[0] function = function[1:] if functionType == 'verbatim': suggestion += '" %s"' % (' '.join([verb(item) for item in function])) elif functionType == 'ls': filter = '' if len(function) > 1: filter = ' | grep -v \\/%s\\$ | grep %s\\$' % (function[1], function[1]) suggestion += '" $(ls -1 --color=no %s%s)"' % (function[0], filter) elif functionType in ('exec', 'pipe', 'fullpipe', 'cat', 'and', 'or'): suggestion += ('" %s"' if functionType == 'exec' else '" $(%s)"') % makeexec(functionType, function) elif functionType == 'calc': expression = [] for item in function: if isinstance(item, list): expression.append(('%s' if item[0] == 'exec' else '$(%s)') % makeexec(item[0], item[1:])) else: expression.append(verb(item)) suggestion += '" $(( %s ))"' % (' '.join(expression)) if len(suggestion) > 0: buf += ' suggestions=%s\n' % str(suggestion) buf += ' COMPREPLY=( $( compgen -W "$suggestions" -- "$cur" ) )\n' index += 1 if index > 0: buf += ' fi\n' buf += '}\n\ncomplete -o default -F _%s %s\n\n' % (self.program, self.program) return buf ''' mane! @param shell:str Shell to generato completion for @param output:str Output file @param source:str Source file ''' def main(shell, output, source): with open(source, 'rb') as file: source = file.read().decode('utf8', 'replace') source = Parser.parse(source) Parser.simplify(source) program = source[0] unargumented = [] argumented = [] variadic = [] suggestion = [] for item in source[1:]: if item[0] == 'unargumented': unargumented.append(item[1:]); elif item[0] == 'argumented': argumented.append(item[1:]); elif item[0] == 'variadic': variadic.append(item[1:]); elif item[0] == 'suggestion': suggestion.append(item[1:]); for group in (unargumented, argumented, variadic): for index in range(0, len(group)): item = group[index] map = {} for elem in item: map[elem[0]] = elem[1:] group[index] = map generator = 'Generator' + shell.upper() generator = globals()[generator] generator = generator(program, unargumented, argumented, variadic, suggestion) code = generator.get() with open(output, 'wb') as file: file.write(code.encode('utf-8')) ''' mane! ''' if __name__ == '__main__': if len(sys.argv) != 6: print("USAGE: auto-auto-complete SHELL --output OUTPUT_FILE --source SOURCE_FILE") exit(1) shell = sys.argv[1] output = None source = None option = None aliases = {'-o' : '--output', '-f' : '--source', '--file' : '--source', '-s' : '--source'} def useopt(option, arg): global source global output old = None if option == '--output': old = output; output = arg elif option == '--source': old = source; source = arg else: raise Exception('Unrecognised option: ' + option) if old is not None: raise Exception('Duplicate option: ' + option) for arg in sys.argv[2:]: if option is not None: if option in aliases: option = aliases[option] useopt(option, arg) option = None else: if '=' in arg: useopt(arg[:index('=')], arg[index('=') + 1:]) else: option = arg if output is None: raise Exception('Unused option: --output') if source is None: raise Exception('Unused option: --source') main(shell= shell, output= output, source= source)