Function _handle_explain_cmd

explainshell/web/views.py:231–305

(url_distro, url_release)

def _handle_explain_cmd(url_distro, url_release):
    if not request.args.get("cmd", "").strip():
        return redirect("/")
    command = request.args["cmd"].strip()
    command = command[:1000]
    if "\n" in command:
        return render_template(
            "errors/error.html", title="parsing error!", message="no newlines please"
        )

    prefix = _explain_prefix(url_distro, url_release)
    if url_distro:
        # Explicit URL distro — strict scoping, no fallback.
        distro, release = url_distro, url_release
        distro_preference = None
    else:
        # No explicit distro — let the preference list drive lookups.
        distro, release = None, None
        distro_preference = sorted(
            get_distros(),
            key=lambda dr: (dr[0] == "ubuntu", dr[1]),
            reverse=True,
        )
    try:
        matches, helptext, debug_info = explain_cmd(
            command,
            get_store(),
            distro=distro,
            release=release,
            explain_prefix=prefix,
            distro_preference=distro_preference,
        )
        helptext = [(render_markdown(text), id_) for text, id_ in helptext]

        # Compute distros scoped to the matched commands (intersection).
        cmd_names = [m["name"] for m in matches if "name" in m]
        if cmd_names:
            sets = [set(get_store().distros_for_name(n)) for n in cmd_names]
            cmd_distros = sorted(sets[0].intersection(*sets[1:]))
        else:
            cmd_distros = list(get_distros())

        body = render_template(
            "explain.html",
            matches=matches,
            helptext=helptext,
            getargs=command,
            debug_info=debug_info,
            available_distros=cmd_distros,
        )
        return _cacheable_explain_response(body)

    except errors.ProgramDoesNotExist as error_msg:
        return render_template(
            "errors/missingmanpage.html", title="missing man page", e=error_msg
        )
    except bashlex.errors.ParsingError as error_msg:
        logger.warning("%r parsing error: %s", command, error_msg.message)