scylla-cqlsh 6.0.29__cp310-cp310-win_amd64.whl

cqlshlib/cqlhandling.py

@@ -0,0 +1,333 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# code for dealing with CQL's syntax, rules, interpretation
+# i.e., stuff that's not necessarily cqlsh-specific
+
+import traceback
+
+import cassandra
+from cqlshlib import pylexotron, util
+
+Hint = pylexotron.Hint
+
+cql_keywords_reserved = {'add', 'allow', 'alter', 'and', 'apply', 'asc', 'authorize', 'batch', 'begin', 'by',
+                         'columnfamily', 'create', 'delete', 'desc', 'describe', 'drop', 'entries', 'execute', 'from',
+                         'full', 'grant', 'if', 'in', 'index', 'infinity', 'insert', 'into', 'is', 'keyspace', 'limit',
+                         'materialized', 'modify', 'nan', 'norecursive', 'not', 'null', 'of', 'on', 'or', 'order',
+                         'primary', 'rename', 'revoke', 'schema', 'select', 'set', 'table', 'to', 'token', 'truncate',
+                         'unlogged', 'update', 'use', 'using', 'view', 'where', 'with'}
+"""
+Set of reserved keywords in CQL.
+
+Derived from .../cassandra/src/java/org/apache/cassandra/cql3/ReservedKeywords.java
+"""
+
+
+class CqlParsingRuleSet(pylexotron.ParsingRuleSet):
+
+    available_compression_classes = (
+        'DeflateCompressor',
+        'SnappyCompressor',
+        'LZ4Compressor',
+        'ZstdCompressor',
+    )
+
+    available_compaction_classes = (
+        'LeveledCompactionStrategy',
+        'SizeTieredCompactionStrategy',
+        'DateTieredCompactionStrategy',
+        'TimeWindowCompactionStrategy'
+    )
+
+    replication_strategies = (
+        'SimpleStrategy',
+        'NetworkTopologyStrategy'
+    )
+
+    def __init__(self, *args, **kwargs):
+        pylexotron.ParsingRuleSet.__init__(self)
+
+        # note: commands_end_with_newline may be extended by callers.
+        self.commands_end_with_newline = set()
+        self.set_reserved_keywords()
+
+    def set_reserved_keywords(self):
+        """
+        We cannot let reserved cql keywords be simple 'identifier' since this caused
+        problems with completion, see CASSANDRA-10415
+        """
+        cassandra.metadata.cql_keywords_reserved = cql_keywords_reserved
+        syntax = '<reserved_identifier> ::= /(' + '|'.join(r'\b{}\b'.format(k) for k in cql_keywords_reserved) + ')/ ;'
+        self.append_rules(syntax)
+
+    def completer_for(self, rulename, symname):
+        def registrator(f):
+            def completerwrapper(ctxt):
+                cass = ctxt.get_binding('cassandra_conn', None)
+                if cass is None:
+                    return ()
+                return f(ctxt, cass)
+            completerwrapper.__name__ = 'completerwrapper_on_' + f.__name__
+            self.register_completer(completerwrapper, rulename, symname)
+            return completerwrapper
+        return registrator
+
+    def explain_completion(self, rulename, symname, explanation=None):
+        if explanation is None:
+            explanation = '<%s>' % (symname,)
+
+        @self.completer_for(rulename, symname)
+        def explainer(ctxt, cass):
+            return [Hint(explanation)]
+
+        return explainer
+
+    def cql_massage_tokens(self, toklist):
+        curstmt = []
+        output = []
+
+        term_on_nl = False
+
+        for t in toklist:
+            if t[0] == 'endline':
+                if term_on_nl:
+                    t = ('endtoken',) + t[1:]
+                else:
+                    # don't put any 'endline' tokens in output
+                    continue
+
+            curstmt.append(t)
+            if t[0] == 'endtoken':
+                term_on_nl = False
+                output.extend(curstmt)
+                curstmt = []
+            else:
+                if len(curstmt) == 1:
+                    # first token in statement; command word
+                    cmd = t[1].lower()
+                    term_on_nl = bool(cmd in self.commands_end_with_newline)
+
+        output.extend(curstmt)
+        return output
+
+    def cql_parse(self, text, startsymbol='Start'):
+        tokens = self.lex(text)
+        tokens = self.cql_massage_tokens(tokens)
+        return self.parse(startsymbol, tokens, init_bindings={'*SRC*': text})
+
+    def cql_whole_parse_tokens(self, toklist, srcstr=None, startsymbol='Start'):
+        return self.whole_match(startsymbol, toklist, srcstr=srcstr)
+
+    def cql_split_statements(self, text):
+        tokens = self.lex(text)
+        tokens = self.cql_massage_tokens(tokens)
+        stmts = util.split_list(tokens, lambda t: t[0] == 'endtoken')
+        output = []
+        in_batch = False
+        in_pg_string = len([st for st in tokens if len(st) > 0 and st[0] == 'unclosedPgString']) == 1
+        for stmt in stmts:
+            if in_batch:
+                output[-1].extend(stmt)
+            else:
+                output.append(stmt)
+            if len(stmt) > 2:
+                if stmt[-3][1].upper() == 'APPLY':
+                    in_batch = False
+                elif stmt[0][1].upper() == 'BEGIN':
+                    in_batch = True
+        return output, in_batch or in_pg_string
+
+    def cql_complete_single(self, text, partial, init_bindings=None, ignore_case=True,
+                            startsymbol='Start'):
+        tokens = (self.cql_split_statements(text)[0] or [[]])[-1]
+        bindings = {} if init_bindings is None else init_bindings.copy()
+
+        # handle some different completion scenarios- in particular, completing
+        # inside a string literal
+        prefix = None
+        dequoter = util.identity
+        lasttype = None
+        if tokens:
+            lasttype = tokens[-1][0]
+            if lasttype == 'unclosedString':
+                prefix = self.token_dequote(tokens[-1])
+                tokens = tokens[:-1]
+                partial = prefix + partial
+                dequoter = self.dequote_value
+                requoter = self.escape_value
+            elif lasttype == 'unclosedName':
+                prefix = self.token_dequote(tokens[-1])
+                tokens = tokens[:-1]
+                partial = prefix + partial
+                dequoter = self.dequote_name
+                requoter = self.escape_name
+            elif lasttype == 'unclosedComment':
+                return []
+        bindings['partial'] = partial
+        bindings['*LASTTYPE*'] = lasttype
+        bindings['*SRC*'] = text
+
+        # find completions for the position
+        completions = self.complete(startsymbol, tokens, bindings)
+
+        hints, strcompletes = util.list_bifilter(pylexotron.is_hint, completions)
+
+        # it's possible to get a newline token from completion; of course, we
+        # don't want to actually have that be a candidate, we just want to hint
+        if '\n' in strcompletes:
+            strcompletes.remove('\n')
+            if partial == '':
+                hints.append(Hint('<enter>'))
+
+        # find matches with the partial word under completion
+        if ignore_case:
+            partial = partial.lower()
+            f = lambda s: s and dequoter(s).lower().startswith(partial)
+        else:
+            f = lambda s: s and dequoter(s).startswith(partial)
+        candidates = list(filter(f, strcompletes))
+
+        if prefix is not None:
+            # dequote, re-escape, strip quotes: gets us the right quoted text
+            # for completion. the opening quote is already there on the command
+            # line and not part of the word under completion, and readline
+            # fills in the closing quote for us.
+            candidates = [requoter(dequoter(c))[len(prefix) + 1:-1] for c in candidates]
+
+            # the above process can result in an empty string; this doesn't help for
+            # completions
+            candidates = [_f for _f in candidates if _f]
+
+        # prefix a space when desirable for pleasant cql formatting
+        if tokens:
+            newcandidates = []
+            for c in candidates:
+                if self.want_space_between(tokens[-1], c) \
+                        and prefix is None \
+                        and not text[-1].isspace() \
+                        and not c[0].isspace():
+                    c = ' ' + c
+                newcandidates.append(c)
+            candidates = newcandidates
+
+        # append a space for single, complete identifiers
+        if len(candidates) == 1 and candidates[0][-1].isalnum()  \
+                and lasttype != 'unclosedString' \
+                and lasttype != 'unclosedName':
+            candidates[0] += ' '
+        return candidates, hints
+
+    @staticmethod
+    def want_space_between(tok, following):
+        if following in (',', ')', ':'):
+            return False
+        if tok[0] == 'op' and tok[1] in (',', ')', '='):
+            return True
+        if tok[0] == 'stringLiteral' and following[0] != ';':
+            return True
+        if tok[0] == 'star' and following[0] != ')':
+            return True
+        if tok[0] == 'endtoken':
+            return True
+        if tok[1][-1].isalnum() and following[0] != ',':
+            return True
+        return False
+
+    def cql_complete(self, text, partial, cassandra_conn=None, ignore_case=True, debug=False,
+                     startsymbol='Start'):
+        init_bindings = {'cassandra_conn': cassandra_conn}
+        if debug:
+            init_bindings['*DEBUG*'] = True
+            print("cql_complete(%r, partial=%r)" % (text, partial))
+
+        completions, hints = self.cql_complete_single(text, partial, init_bindings,
+                                                      startsymbol=startsymbol)
+
+        if hints:
+            hints = [h.text for h in hints]
+            hints.append('')
+
+        if len(completions) == 1 and len(hints) == 0:
+            c = completions[0]
+            if debug:
+                print("** Got one completion: %r. Checking for further matches...\n" % (c,))
+            if not c.isspace():
+                new_c = self.cql_complete_multiple(text, c, init_bindings, startsymbol=startsymbol)
+                completions = [new_c]
+            if debug:
+                print("** New list of completions: %r" % (completions,))
+
+        return hints + completions
+
+    def cql_complete_multiple(self, text, first, init_bindings, startsymbol='Start'):
+        debug = init_bindings.get('*DEBUG*', False)
+        try:
+            completions, hints = self.cql_complete_single(text + first, '', init_bindings,
+                                                          startsymbol=startsymbol)
+        except Exception:
+            if debug:
+                print("** completion expansion had a problem:")
+                traceback.print_exc()
+            return first
+        if hints:
+            if not first[-1].isspace():
+                first += ' '
+            if debug:
+                print("** completion expansion found hints: %r" % (hints,))
+            return first
+        if len(completions) == 1 and completions[0] != '':
+            if debug:
+                print("** Got another completion: %r." % (completions[0],))
+            if completions[0][0] in (',', ')', ':') and first[-1] == ' ':
+                first = first[:-1]
+            first += completions[0]
+        else:
+            common_prefix = util.find_common_prefix(completions)
+            if common_prefix == '':
+                return first
+            if common_prefix[0] in (',', ')', ':') and first[-1] == ' ':
+                first = first[:-1]
+            if debug:
+                print("** Got a partial completion: %r." % (common_prefix,))
+            return first + common_prefix
+        if debug:
+            print("** New total completion: %r. Checking for further matches...\n" % (first,))
+        return self.cql_complete_multiple(text, first, init_bindings, startsymbol=startsymbol)
+
+    @staticmethod
+    def cql_extract_orig(toklist, srcstr):
+        # low end of span for first token, to high end of span for last token
+        return srcstr[toklist[0][2][0]:toklist[-1][2][1]]
+
+    @staticmethod
+    def token_dequote(tok):
+        if tok[0] == 'unclosedName':
+            # strip one quote
+            return tok[1][1:].replace('""', '"')
+        if tok[0] == 'quotedStringLiteral':
+            # strip quotes
+            return tok[1][1:-1].replace("''", "'")
+        if tok[0] == 'unclosedString':
+            # strip one quote
+            return tok[1][1:].replace("''", "'")
+        if tok[0] == 'unclosedComment':
+            return ''
+        return tok[1]
+
+    @staticmethod
+    def token_is_word(tok):
+        return tok[0] == 'identifier'

cqlshlib/cqlshhandling.py

@@ -0,0 +1,314 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+from cqlshlib import cqlhandling
+
+# we want the cql parser to understand our cqlsh-specific commands too
+my_commands_ending_with_newline = (
+    'help',
+    '?',
+    'consistency',
+    'serial',
+    'describe',
+    'desc',
+    'show',
+    'source',
+    'capture',
+    'login',
+    'debug',
+    'tracing',
+    'expand',
+    'paging',
+    'exit',
+    'quit',
+    'clear',
+    'cls'
+)
+
+cqlsh_syntax_completers = []
+
+
+def cqlsh_syntax_completer(rulename, termname):
+    def registrator(f):
+        cqlsh_syntax_completers.append((rulename, termname, f))
+        return f
+
+    return registrator
+
+
+cqlsh_cmd_syntax_rules = r'''
+<cqlshCommand> ::= <CQL_Statement>
+                 | <specialCommand> ( ";" | "\n" )
+                 ;
+'''
+
+cqlsh_special_cmd_command_syntax_rules = r'''
+<specialCommand> ::= <describeCommand>
+                   | <consistencyCommand>
+                   | <serialConsistencyCommand>
+                   | <showCommand>
+                   | <sourceCommand>
+                   | <captureCommand>
+                   | <copyCommand>
+                   | <loginCommand>
+                   | <debugCommand>
+                   | <helpCommand>
+                   | <tracingCommand>
+                   | <expandCommand>
+                   | <exitCommand>
+                   | <pagingCommand>
+                   | <clearCommand>
+                   ;
+'''
+
+cqlsh_describe_cmd_syntax_rules = r'''
+<describeCommand> ::= ( "DESCRIBE" | "DESC" )
+                                ( ( "FUNCTIONS"
+                                  | "FUNCTION" udf=<anyFunctionName>
+                                  | "AGGREGATES"
+                                  | "AGGREGATE" uda=<userAggregateName>
+                                  | "KEYSPACES"
+                                  | "ONLY"? "KEYSPACE" ksname=<keyspaceName>?
+                                  | ( "COLUMNFAMILY" | "TABLE" ) cf=<columnFamilyName>
+                                  | "INDEX" idx=<indexName>
+                                  | "MATERIALIZED" "VIEW" mv=<materializedViewName>
+                                  | ( "COLUMNFAMILIES" | "TABLES" )
+                                  | "FULL"? "SCHEMA"
+                                  | "CLUSTER"
+                                  | "TYPES"
+                                  | "TYPE" ut=<userTypeName>
+                                  | (ksname=<keyspaceName> | cf=<columnFamilyName> | idx=<indexName> | mv=<materializedViewName>)
+                                  ) ("WITH" "INTERNALS")?
+                                )
+                    ;
+'''
+
+cqlsh_consistency_cmd_syntax_rules = r'''
+<consistencyCommand> ::= "CONSISTENCY" ( level=<consistencyLevel> )?
+                       ;
+'''
+
+cqlsh_consistency_level_syntax_rules = r'''
+<consistencyLevel> ::= "ANY"
+                     | "ONE"
+                     | "TWO"
+                     | "THREE"
+                     | "QUORUM"
+                     | "ALL"
+                     | "LOCAL_QUORUM"
+                     | "EACH_QUORUM"
+                     | "SERIAL"
+                     | "LOCAL_SERIAL"
+                     | "LOCAL_ONE"
+                     | "NODE_LOCAL"
+                     ;
+'''
+
+cqlsh_serial_consistency_cmd_syntax_rules = r'''
+<serialConsistencyCommand> ::= "SERIAL" "CONSISTENCY" ( level=<serialConsistencyLevel> )?
+                             ;
+'''
+
+cqlsh_serial_consistency_level_syntax_rules = r'''
+<serialConsistencyLevel> ::= "SERIAL"
+                           | "LOCAL_SERIAL"
+                           ;
+'''
+
+cqlsh_show_cmd_syntax_rules = r'''
+<showCommand> ::= "SHOW" what=( "VERSION" | "HOST" | "SESSION" sessionid=<uuid> | "REPLICAS" token=<integer> (keyspace=<keyspaceName>)? )
+                ;
+'''
+
+cqlsh_source_cmd_syntax_rules = r'''
+<sourceCommand> ::= "SOURCE" fname=<stringLiteral>
+                  ;
+'''
+
+cqlsh_capture_cmd_syntax_rules = r'''
+<captureCommand> ::= "CAPTURE" ( fname=( <stringLiteral> | "OFF" ) )?
+                   ;
+'''
+
+cqlsh_copy_cmd_syntax_rules = r'''
+<copyCommand> ::= "COPY" cf=<columnFamilyName>
+                         ( "(" [colnames]=<colname> ( "," [colnames]=<colname> )* ")" )?
+                         ( dir="FROM" ( fname=<stringLiteral> | "STDIN" )
+                         | dir="TO"   ( fname=<stringLiteral> | "STDOUT" ) )
+                         ( "WITH" <copyOption> ( "AND" <copyOption> )* )?
+                ;
+'''
+
+cqlsh_copy_option_syntax_rules = r'''
+<copyOption> ::= [optnames]=(<identifier>|<reserved_identifier>) "=" [optvals]=<copyOptionVal>
+               ;
+'''
+
+cqlsh_copy_option_val_syntax_rules = r'''
+<copyOptionVal> ::= <identifier>
+                  | <reserved_identifier>
+                  | <term>
+                  ;
+'''
+
+cqlsh_debug_cmd_syntax_rules = r'''
+# avoiding just "DEBUG" so that this rule doesn't get treated as a terminal
+<debugCommand> ::= "DEBUG" "THINGS"?
+                 ;
+'''
+
+cqlsh_help_cmd_syntax_rules = r'''
+<helpCommand> ::= ( "HELP" | "?" ) [topic]=( /[a-z_]*/ )*
+                ;
+'''
+
+cqlsh_tracing_cmd_syntax_rules = r'''
+<tracingCommand> ::= "TRACING" ( switch=( "ON" | "OFF" ) )?
+                   ;
+'''
+
+cqlsh_expand_cmd_syntax_rules = r'''
+<expandCommand> ::= "EXPAND" ( switch=( "ON" | "OFF" ) )?
+                   ;
+'''
+
+cqlsh_paging_cmd_syntax_rules = r'''
+<pagingCommand> ::= "PAGING" ( switch=( "ON" | "OFF" | /[0-9]+/) )?
+                  ;
+'''
+
+cqlsh_login_cmd_syntax_rules = r'''
+<loginCommand> ::= "LOGIN" username=<username> (password=<stringLiteral>)?
+                 ;
+'''
+
+cqlsh_exit_cmd_syntax_rules = r'''
+<exitCommand> ::= "exit" | "quit"
+                ;
+'''
+
+cqlsh_clear_cmd_syntax_rules = r'''
+<clearCommand> ::= "CLEAR" | "CLS"
+                 ;
+'''
+
+cqlsh_question_mark = r'''
+<qmark> ::= "?" ;
+'''
+
+cqlsh_extra_syntax_rules = cqlsh_cmd_syntax_rules + \
+    cqlsh_special_cmd_command_syntax_rules + \
+    cqlsh_describe_cmd_syntax_rules + \
+    cqlsh_consistency_cmd_syntax_rules + \
+    cqlsh_consistency_level_syntax_rules + \
+    cqlsh_serial_consistency_cmd_syntax_rules + \
+    cqlsh_serial_consistency_level_syntax_rules + \
+    cqlsh_show_cmd_syntax_rules + \
+    cqlsh_source_cmd_syntax_rules + \
+    cqlsh_capture_cmd_syntax_rules + \
+    cqlsh_copy_cmd_syntax_rules + \
+    cqlsh_copy_option_syntax_rules + \
+    cqlsh_copy_option_val_syntax_rules + \
+    cqlsh_debug_cmd_syntax_rules + \
+    cqlsh_help_cmd_syntax_rules + \
+    cqlsh_tracing_cmd_syntax_rules + \
+    cqlsh_expand_cmd_syntax_rules + \
+    cqlsh_paging_cmd_syntax_rules + \
+    cqlsh_login_cmd_syntax_rules + \
+    cqlsh_exit_cmd_syntax_rules + \
+    cqlsh_clear_cmd_syntax_rules + \
+    cqlsh_question_mark
+
+
+def complete_source_quoted_filename(ctxt, cqlsh):
+    partial_path = ctxt.get_binding('partial', '')
+    head, tail = os.path.split(partial_path)
+    exhead = os.path.expanduser(head)
+    try:
+        contents = os.listdir(exhead or '.')
+    except OSError:
+        return ()
+    matches = [f for f in contents if f.startswith(tail)]
+    annotated = []
+    for f in matches:
+        match = os.path.join(head, f)
+        if os.path.isdir(os.path.join(exhead, f)):
+            match += '/'
+        annotated.append(match)
+    return annotated
+
+
+cqlsh_syntax_completer('sourceCommand', 'fname')(complete_source_quoted_filename)
+cqlsh_syntax_completer('captureCommand', 'fname')(complete_source_quoted_filename)
+
+
+@cqlsh_syntax_completer('copyCommand', 'fname')
+def copy_fname_completer(ctxt, cqlsh):
+    lasttype = ctxt.get_binding('*LASTTYPE*')
+    if lasttype == 'unclosedString':
+        return complete_source_quoted_filename(ctxt, cqlsh)
+    partial_path = ctxt.get_binding('partial')
+    if partial_path == '':
+        return ["'"]
+    return ()
+
+
+@cqlsh_syntax_completer('copyCommand', 'colnames')
+def complete_copy_column_names(ctxt, cqlsh):
+    existcols = list(map(cqlsh.cql_unprotect_name, ctxt.get_binding('colnames', ())))
+    ks = cqlsh.cql_unprotect_name(ctxt.get_binding('ksname', None))
+    cf = cqlsh.cql_unprotect_name(ctxt.get_binding('cfname'))
+    colnames = cqlsh.get_column_names(ks, cf)
+    if len(existcols) == 0:
+        return [colnames[0]]
+    return set(colnames[1:]) - set(existcols)
+
+
+COPY_COMMON_OPTIONS = ['DELIMITER', 'QUOTE', 'ESCAPE', 'HEADER', 'NULL', 'DATETIMEFORMAT',
+                       'MAXATTEMPTS', 'REPORTFREQUENCY', 'DECIMALSEP', 'THOUSANDSSEP', 'BOOLSTYLE',
+                       'NUMPROCESSES', 'CONFIGFILE', 'RATEFILE']
+COPY_FROM_OPTIONS = ['CHUNKSIZE', 'INGESTRATE', 'MAXBATCHSIZE', 'MINBATCHSIZE', 'MAXROWS',
+                     'SKIPROWS', 'SKIPCOLS', 'MAXPARSEERRORS', 'MAXINSERTERRORS', 'ERRFILE', 'PREPAREDSTATEMENTS',
+                     'TTL']
+COPY_TO_OPTIONS = ['ENCODING', 'PAGESIZE', 'PAGETIMEOUT', 'BEGINTOKEN', 'ENDTOKEN', 'MAXOUTPUTSIZE', 'MAXREQUESTS',
+                   'FLOATPRECISION', 'DOUBLEPRECISION']
+
+
+@cqlsh_syntax_completer('copyOption', 'optnames')
+def complete_copy_options(ctxt, cqlsh):
+    optnames = list(map(str.upper, ctxt.get_binding('optnames', ())))
+    direction = ctxt.get_binding('dir').upper()
+    if direction == 'FROM':
+        opts = set(COPY_COMMON_OPTIONS + COPY_FROM_OPTIONS) - set(optnames)
+    elif direction == 'TO':
+        opts = set(COPY_COMMON_OPTIONS + COPY_TO_OPTIONS) - set(optnames)
+    return opts
+
+
+@cqlsh_syntax_completer('copyOption', 'optvals')
+def complete_copy_opt_values(ctxt, cqlsh):
+    optnames = ctxt.get_binding('optnames', ())
+    lastopt = optnames[-1].lower()
+    if lastopt == 'header':
+        return ['true', 'false']
+    return [cqlhandling.Hint('<single_character_string>')]
+
+
+@cqlsh_syntax_completer('helpCommand', 'topic')
+def complete_help(ctxt, cqlsh):
+    return sorted([t.upper() for t in cqlsh.cqldocs.get_help_topics() + cqlsh.get_help_topics()])