Function run_paste_osint

openosint/tools/search_paste.py:69–101

Search Pastebin dumps for query via psbdmp.ws. Returns a descriptive error string on failure rather than raising. Parameters ---------- query: Email address or username to search for. timeout_seconds: HTTP request timeout in seconds. Returns ------

(
    query: str,
    timeout_seconds: int = _DEFAULT_TIMEOUT,
)

async def run_paste_osint(
    query: str,
    timeout_seconds: int = _DEFAULT_TIMEOUT,
) -> str:
    """
    Search Pastebin dumps for query via psbdmp.ws.

    Returns a descriptive error string on failure rather than raising.

    Parameters
    ----------
    query:
        Email address or username to search for.
    timeout_seconds:
        HTTP request timeout in seconds.

    Returns
    -------
    str
        Formatted result string or a descriptive error message.
    """
    logger.info("Starting paste search for: %s", query)
    try:
        pastes = _fetch_paste_data(query, timeout_seconds)
        result = _format_paste_results(pastes, query)
        logger.info("Paste search complete for: %s", query)
        return result
    except OSINTError as exc:
        logger.warning("Paste search failed: %s", exc)
        return f"Scan error: {exc}"
    except Exception as exc:
        logger.exception("Unexpected error during paste search.")
        return f"Internal error: {exc}"