Function explain_router

explainshell/web/views.py:179–228

Unified router that handles all /explain/* URLs. Path disambiguation: - With ?cmd=: 0 segments = no distro, 2 segments = distro/release - Without ?cmd=: 1=program, 2=section/program, 3=distro/release/program, 4=distro/release/section/program

(path)

@bp.route("/explain", defaults={"path": ""})
@bp.route("/explain/<path:path>")
def explain_router(path):
    """Unified router that handles all /explain/* URLs.

    Path disambiguation:
    - With ?cmd=: 0 segments = no distro, 2 segments = distro/release
    - Without ?cmd=: 1=program, 2=section/program, 3=distro/release/program,
      4=distro/release/section/program
    """
    parts = [p for p in path.split("/") if p] if path else []
    has_cmd = "cmd" in request.args

    url_distro = None
    url_release = None
    section = None
    program = None

    if has_cmd:
        if len(parts) == 0:
            pass  # no distro
        elif len(parts) == 2 and _is_known_distro(parts[0]):
            url_distro, url_release = parts[0], parts[1]
        else:
            # invalid path with ?cmd
            return redirect("/")
    else:
        if len(parts) == 0:
            return redirect("/")
        elif len(parts) == 1:
            program = parts[0]
        elif len(parts) == 2:
            if _is_known_distro(parts[0]):
                # /explain/ubuntu/26.04 with no ?cmd → redirect to index
                return redirect("/")
            section, program = parts[0], parts[1]
        elif len(parts) == 3 and _is_known_distro(parts[0]):
            url_distro, url_release, program = parts[0], parts[1], parts[2]
        elif len(parts) == 4 and _is_known_distro(parts[0]):
            url_distro, url_release, section, program = (
                parts[0],
                parts[1],
                parts[2],
                parts[3],
            )
        else:
            return redirect("/")

    if has_cmd:
        return _handle_explain_cmd(url_distro, url_release)
    else:
        return _handle_explain_program(section, program, url_distro, url_release)


def _handle_explain_cmd(url_distro, url_release):