Method visitcommand

explainshell/matcher.py:260–314

(self, node, parts)

        return False

    def visitcommand(self, node, parts):
        assert parts

        # look for the first WordNode, which might not be at parts[0]
        idx_word_node = bashlex.ast.findfirstkind(parts, "word")
        if idx_word_node == -1:
            logger.info("no words found in command (probably contains only redirects)")
            return

        word_node = parts[idx_word_node]

        # check if this refers to a previously defined function
        if word_node.word in self.functions:
            logger.info(
                f"word {word_node} is a function, not trying to match it or it's arguments"
            )

            # first, add a MatchResult for the function call
            mr = MatchResult(
                word_node.pos[0],
                word_node.pos[1],
                help_constants._function_call % word_node.word,
                None,
                {"kind": "function_call"},
            )
            self.matches.append(mr)

            # this is a bit nasty: if we were to visit the command like we
            # normally do it would try to match it against a manpage. but
            # we don't have one here, we just want to take all the words and
            # consider them part of the function call
            for part in parts:
                # maybe it's a redirect...
                if part.kind != "word":
                    self.visit(part)
                else:
                    # this is an argument to the function
                    if part is not word_node:
                        mr = MatchResult(
                            part.pos[0],
                            part.pos[1],
                            help_constants._functionarg % word_node.word,
                            None,
                            {"kind": "function_arg"},
                        )
                        self.matches.append(mr)

                        # visit any expansions in there
                        for p_part in part.parts:
                            self.visit(p_part)

            # we're done with this commandnode, don't visit its children
            return False

        self.startcommand(node, parts, None)

    def visitif(self, *args):
        self.compound_stack.append("if")