cannlog 0.1.7__tar.gz

cannlog-0.1.7/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CANN Log Parser Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cannlog-0.1.7/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+recursive-include cann_log_parser/static *.html *.css *.js
+global-exclude __pycache__ *.py[cod]

cannlog-0.1.7/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: cannlog
+Version: 0.1.7
+Summary: cannlog: CANN simulation log parser and web viewer
+Author: CANN Log Parser Contributors
+License-Expression: MIT
+Keywords: cann,simulator,log,viewer,visualization
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cannlog
+
+用于浏览和解析 `cannsim` 仿真日志的本地 Web 可视化工具。后端给定日志目录启动，前端在浏览器中动态查看日志、访存数据和指令关联关系。
+
+## 安装
+
+从 PyPI 安装：
+
+```bash
+pip install cannlog
+```
+
+从源码安装：
+
+```bash
+pip install .
+```
+
+开发模式安装：
+
+```bash
+pip install -e .
+```
+
+安装后主命令是 `cannlog`：
+
+```bash
+cannlog /path/to/log_dir --host localhost --port 18000
+```
+
+也保留了兼容别名：`cann-log-parser`、`cann-log-viewer`。
+
+也可以继续使用模块入口：
+
+```bash
+python -m cannlog.server /path/to/log_dir --host localhost --port 18000
+python -m app.server /path/to/log_dir --host localhost --port 18000
+```
+
+打开：`http://localhost:18000`
+
+默认 host 是 `localhost`，默认端口是 `18000`。如果不传 `--port` 且 `18000` 被占用，会自动尝试后续端口；如果显式传了 `--port`，端口被占用时会直接提示并退出。
+
+远程机器上运行时：
+
+- 如果使用 VS Code Remote，可以在 `Ports/端口` 面板中转发服务提示的端口，然后点浏览器图标打开。
+- 如果没有 VS Code 端口转发功能，在本地终端建立 SSH 隧道：
+
+```bash
+ssh -N -L 18000:127.0.0.1:18000 <user>@<ip>
+```
+
+然后在本地浏览器打开：`http://localhost:18000`。如果服务自动切换到了其它端口，把命令里的 `18000` 换成实际提示的端口。
+
+## 已支持的日志类型
+
+- 指令日志：`*.instr_log.dump`、`*.instr_popped_log.dump`
+- 访存日志：`*.rd_log.dump`、`*.wr_log.dump`
+- PV 访存日志：`*rvec_pv.dump`，按指令 ID 合并 `Rd/Wr` 数据块并支持解码
+- CCU/队列事件：`*.ccu_log.dump`、`*issque.dump`、`*.OOO.dump`
+- PMU/summary：`*.perf_pmu.log`、`*.perf_pmu_per_vf.log`、`*summary_log`
+
+## 功能
+
+- 给定日志目录启动本地 Web 服务
+- 前端动态加载文件树和事件页，大日志分页读取
+- 访存日志按指令 ID 合并展示；PV 日志中同一指令下相同读写和寄存器会合并，不同读写或寄存器会分块展示
+- 支持 `hex32`、`uint8/int8`、`uint16/int16/float16/bfloat16`、`uint32/int32/float32`、`uint64/int64/float64` 解码
+- 按 `instructionId` 跨文件查询关联访存事件，并可跳转定位到具体事件
+- 支持分类、Core、Unit、文件名过滤
+- 支持多日志页签、右键菜单、新窗口打开、重载日志
+- 日志文件树和详情面板支持收起/展开
+
+## 使用示例
+
+```bash
+cannlog /mnt/workspace/log/cann-sim/log_ca --host 0.0.0.0 --port 18000
+```
+
+打开：`http://localhost:18000`
+
+## API
+
+- `GET /api/overview`
+- `GET /api/files`
+- `GET /api/file?path=...&page=1&pageSize=50`
+- `GET /api/stats?path=...`
+- `GET /api/instruction-memory?instructionId=4309`
+- `GET /api/decode-memory?path=core0.veccore0.ub.wr_log.dump&eventIndex=0&dtype=float32`
+- `POST /api/reload`
+
+## 打包发布到 PyPI
+
+安装构建和上传工具：
+
+```bash
+python -m pip install build twine
+```
+
+构建源码包和 wheel：
+
+```bash
+python -m build
+```
+
+检查包元数据：
+
+```bash
+python -m twine check dist/*
+```
+
+上传到 TestPyPI：
+
+```bash
+python -m twine upload --repository testpypi dist/*
+```
+
+上传到正式 PyPI：
+
+```bash
+python -m twine upload dist/*
+```
+
+发布前建议：
+
+- 确认 `pyproject.toml` 中的 `name = "cannlog"` 没有被 PyPI 占用
+- 为每次发布递增 `version`
+- 许可证已在 `LICENSE` 和 `pyproject.toml` 中声明为 MIT
+
+## 实现说明
+
+- 后端仅使用 Python 标准库，无运行时依赖
+- 前端为原生 HTML/CSS/JS，无需构建
+- 静态资源已作为 package data 打进 wheel，pip 安装后可直接运行
+
+## 许可证
+
+本项目使用 MIT License，详见 `LICENSE`。

cannlog-0.1.7/README.md

@@ -0,0 +1,138 @@
+# cannlog
+
+用于浏览和解析 `cannsim` 仿真日志的本地 Web 可视化工具。后端给定日志目录启动，前端在浏览器中动态查看日志、访存数据和指令关联关系。
+
+## 安装
+
+从 PyPI 安装：
+
+```bash
+pip install cannlog
+```
+
+从源码安装：
+
+```bash
+pip install .
+```
+
+开发模式安装：
+
+```bash
+pip install -e .
+```
+
+安装后主命令是 `cannlog`：
+
+```bash
+cannlog /path/to/log_dir --host localhost --port 18000
+```
+
+也保留了兼容别名：`cann-log-parser`、`cann-log-viewer`。
+
+也可以继续使用模块入口：
+
+```bash
+python -m cannlog.server /path/to/log_dir --host localhost --port 18000
+python -m app.server /path/to/log_dir --host localhost --port 18000
+```
+
+打开：`http://localhost:18000`
+
+默认 host 是 `localhost`，默认端口是 `18000`。如果不传 `--port` 且 `18000` 被占用，会自动尝试后续端口；如果显式传了 `--port`，端口被占用时会直接提示并退出。
+
+远程机器上运行时：
+
+- 如果使用 VS Code Remote，可以在 `Ports/端口` 面板中转发服务提示的端口，然后点浏览器图标打开。
+- 如果没有 VS Code 端口转发功能，在本地终端建立 SSH 隧道：
+
+```bash
+ssh -N -L 18000:127.0.0.1:18000 <user>@<ip>
+```
+
+然后在本地浏览器打开：`http://localhost:18000`。如果服务自动切换到了其它端口，把命令里的 `18000` 换成实际提示的端口。
+
+## 已支持的日志类型
+
+- 指令日志：`*.instr_log.dump`、`*.instr_popped_log.dump`
+- 访存日志：`*.rd_log.dump`、`*.wr_log.dump`
+- PV 访存日志：`*rvec_pv.dump`，按指令 ID 合并 `Rd/Wr` 数据块并支持解码
+- CCU/队列事件：`*.ccu_log.dump`、`*issque.dump`、`*.OOO.dump`
+- PMU/summary：`*.perf_pmu.log`、`*.perf_pmu_per_vf.log`、`*summary_log`
+
+## 功能
+
+- 给定日志目录启动本地 Web 服务
+- 前端动态加载文件树和事件页，大日志分页读取
+- 访存日志按指令 ID 合并展示；PV 日志中同一指令下相同读写和寄存器会合并，不同读写或寄存器会分块展示
+- 支持 `hex32`、`uint8/int8`、`uint16/int16/float16/bfloat16`、`uint32/int32/float32`、`uint64/int64/float64` 解码
+- 按 `instructionId` 跨文件查询关联访存事件，并可跳转定位到具体事件
+- 支持分类、Core、Unit、文件名过滤
+- 支持多日志页签、右键菜单、新窗口打开、重载日志
+- 日志文件树和详情面板支持收起/展开
+
+## 使用示例
+
+```bash
+cannlog /mnt/workspace/log/cann-sim/log_ca --host 0.0.0.0 --port 18000
+```
+
+打开：`http://localhost:18000`
+
+## API
+
+- `GET /api/overview`
+- `GET /api/files`
+- `GET /api/file?path=...&page=1&pageSize=50`
+- `GET /api/stats?path=...`
+- `GET /api/instruction-memory?instructionId=4309`
+- `GET /api/decode-memory?path=core0.veccore0.ub.wr_log.dump&eventIndex=0&dtype=float32`
+- `POST /api/reload`
+
+## 打包发布到 PyPI
+
+安装构建和上传工具：
+
+```bash
+python -m pip install build twine
+```
+
+构建源码包和 wheel：
+
+```bash
+python -m build
+```
+
+检查包元数据：
+
+```bash
+python -m twine check dist/*
+```
+
+上传到 TestPyPI：
+
+```bash
+python -m twine upload --repository testpypi dist/*
+```
+
+上传到正式 PyPI：
+
+```bash
+python -m twine upload dist/*
+```
+
+发布前建议：
+
+- 确认 `pyproject.toml` 中的 `name = "cannlog"` 没有被 PyPI 占用
+- 为每次发布递增 `version`
+- 许可证已在 `LICENSE` 和 `pyproject.toml` 中声明为 MIT
+
+## 实现说明
+
+- 后端仅使用 Python 标准库，无运行时依赖
+- 前端为原生 HTML/CSS/JS，无需构建
+- 静态资源已作为 package data 打进 wheel，pip 安装后可直接运行
+
+## 许可证
+
+本项目使用 MIT License，详见 `LICENSE`。

cannlog-0.1.7/cann_log_parser/__init__.py

@@ -0,0 +1,3 @@
+"""CANN simulation log parser and viewer."""
+
+__version__ = "0.1.7"