#!/usr/bin/env python3
# -*- coding: UTF-8 -*-
# ----------------------------------------------------------------------------
# This program is free software, you can redistribute it and/or modify it.
# Copyright (c) 2026 Huawei Technologies Co., Ltd.
# This file is a part of the CANN Open Software.
# Licensed under CANN Open Software License Agreement Version 2.0 (the "License").
# Please refer to the License for details. You may not use this file except in compliance with the License.
# THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING
# BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
# See LICENSE in the root of the software repository for the full text of the License.
# ----------------------------------------------------------------------------
__all__ = ["flash_attn_example"]

import torch
from torch import Tensor


def flash_attn_example(
    query: Tensor,
    key: Tensor,
    value: Tensor,
    attnMask: Tensor,
    softmaxScale: float,
    isCausal: bool,
) -> Tensor:
    return torch.ops.ascend_ops.flash_attn_example(
        query, key, value, attnMask, softmaxScale, isCausal
    )