Metadata-Version: 2.4
Name: cannbot-dsl
Version: 0.0.3
Summary: Python DSL and MLIR compiler for AscendC kernels
Keywords: ascend,ascendc,compiler,dsl,mlir
Author: Huawei Technologies Co., Ltd.
License-Expression: LicenseRef-CANN-Open-Software-License-2.0
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: C++
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Compilers
Requires-Python: <3.13,>=3.12
Description-Content-Type: text/markdown

# CANNBotDSL

## 1. 项目简介 (Introduction)

---

## 2. 目录结构 (Directory Structure)

---

## 3. 构建指南 (Build Instructions)

请根据目标独立阅读对应文档。开发与发行指南各自包含完整步骤，不互为前置。

| 目标 | 文档入口 |
| ---- | -------- |
| 新环境搭建、native CMake、editable 和增量编译（开发） | [构建与增量开发指南](docs/BUILD.md) |
| PEP 517 raw Wheel、auditwheel、验证和发布（发行） | [Wheel 构建与发布指南](docs/WHEEL.md) |
| 运行时和调试环境变量 | [环境变量参考](docs/usage/ENV.md) |
| `for` 循环、后端 unroll 与前端静态展开 | [循环与 UNROLL](docs/usage/LOOPS.md) |
| 自定义组合参数、语义叶子与隔离 Registry | [Adapter 用户指南](docs/adapters.md) |
| 从旧扩展协议迁移 | [Adapter 迁移对照](docs/adapter_migration.md) |

---

## 4. Submodule 管理 (Submodule Management)

`cannbot-arena` 通过 Git submodule 引入。父仓库会锁定其提交版本。

首次克隆仓库时，可以同时初始化 submodule：

```bash
git clone --recurse-submodules https://gitcode.com/mabing1118/cannbot-dsl.git
```

对于已经克隆的仓库，或在更新父仓库后，将 submodule 同步到父仓库锁定的版本：

```bash
git submodule update --init --recursive
```

维护者如需将 `cannbot-arena` 更新到上游最新版本，应检查变化并提交新的 submodule 指针：

```bash
git submodule update --remote cannbot-arena
git diff --submodule=log -- cannbot-arena
git add cannbot-arena
git commit -m "chore: update cannbot-arena submodule"
```
