zylab 0.1.1__tar.gz

zylab-0.1.1/.bumpversion.toml

@@ -0,0 +1,18 @@
+[tool.bumpversion]
+current_version = "0.1.1"
+commit = true
+exclude = ["template/*"]
+message = "chore: 更新版本 {current_version} → {new_version}"
+tag = true
+tag_name = "v{new_version}"
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+regex = true
+search = '(version\s+=\s+)"{current_version}"'
+replace = '\1"{new_version}"'
+
+[[tool.bumpversion.files]]
+filename = "src/zylab/__init__.py"
+search = '__version__ = "{current_version}"'
+replace = '__version__ = "{new_version}"'

zylab-0.1.1/.copier-answers.yml

@@ -0,0 +1,19 @@
+# Changes here will be overwritten by Copier
+_commit: v0.9.2
+_src_path: https://gitee.com/gooker_young/coopie.git
+author_email: gooker_young@qq.com
+author_name: gookeryoung
+coverage_fail_under: 95
+description: 通用科学计算仿真分析平台。
+license: MIT
+max_python_version: '3.14'
+min_python_version: '3.11'
+package_name: zylab
+project_name: zylab
+project_type: gui
+use_cicd: true
+use_docker: true
+use_docs: true
+use_domestic_mirrors: true
+use_tox: true
+

zylab-0.1.1/.coveragerc

@@ -0,0 +1,14 @@
+[run]
+branch = true
+concurrency = thread
+omit = tests/*
+source = zylab
+
+[report]
+fail_under = 95
+exclude_lines =
+    if TYPE_CHECKING:
+    if __name__ == .__main__.:
+    pragma: no cover
+    raise NotImplementedError
+show_missing = true

zylab-0.1.1/.dockerignore

@@ -0,0 +1,46 @@
+# 版本控制
+.git
+.gitignore
+.github
+
+# Python 缓存与构建产物
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+*.egg-info
+*.egg
+dist
+build
+.eggs
+
+# 测试与覆盖率
+.pytest_cache
+.coverage
+htmlcov
+.tox
+coverage.xml
+
+# 虚拟环境
+.venv
+venv
+env
+
+# 工具缓存
+.uv-cache
+.ruff_cache
+.pyrefly_cache
+.mypy_cache
+
+# IDE 与编辑器
+.idea
+.vscode
+*.swp
+*.swo
+
+# 文档（按需保留）
+docs
+
+# 系统文件
+.DS_Store
+Thumbs.db

zylab-0.1.1/.gitattributes

@@ -0,0 +1,30 @@
+# Git 行尾规范化
+# 默认所有文本文件使用 LF 行尾（跨平台一致）
+* text=auto eol=lf
+
+# Windows 脚本使用 CRLF
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+
+# 二进制文件（不做行尾转换）
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.icns binary
+*.pdf binary
+*.zip binary
+*.gz binary
+*.tar binary
+*.tgz binary
+*.whl binary
+*.egg binary
+*.pyc binary
+*.pyo binary
+*.so binary
+*.dll binary
+*.dylib binary
+*.qrc binary
+*.qss binary

zylab-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint & Typecheck
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Sync dependencies
+        run: uv sync --frozen --extra lint
+
+      - name: Ruff check
+        run: uv run ruff check src tests
+
+      - name: Ruff format check
+        run: uv run ruff format --check src tests
+
+      - name: Pyrefly check
+        run: uv run pyrefly check
+
+  test:
+    name: Test (Python 3.8 & 3.13)
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.8", "3.13"]
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install Qt offscreen system dependencies
+        run: sudo apt-get update && sudo apt-get install -y libegl1 libgl1 libxkbcommon0 libdbus-1-3 libfontconfig1
+
+      - name: Sync dependencies
+        run: uv sync --frozen --extra test --python ${{ matrix.python-version }}
+
+      - name: Run tests
+        env:
+          QT_QPA_PLATFORM: offscreen
+        run: uv run pytest -m "not slow" --cov=zylab --cov-fail-under=95 --cov-report=term-missing

zylab-0.1.1/.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+
+on:
+  push:
+    tags: ['v*.*.*']
+
+permissions:
+  contents: write
+  id-token: write
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release:
+    name: Build & Publish
+    runs-on: ubuntu-latest
+    environment: pypi
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Publish to PyPI (OIDC)
+        run: uv publish
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG_NAME: ${{ github.ref_name }}
+        run: |
+          gh release create "$TAG_NAME" \
+            --title "Release $TAG_NAME" \
+            --generate-notes \
+            dist/*

zylab-0.1.1/.gitignore

@@ -0,0 +1,37 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.venv38
+
+# 测试与覆盖率
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+.tox/
+
+# 工具缓存
+.ruff_cache/
+.pyrefly_cache/
+.mypy_cache/
+.uv-cache/
+
+# IDE
+.idea/
+*_profile.html
+
+# 环境变量与凭证（勿提交）
+.env
+.env.*
+
+# Sphinx 文档构建输出
+docs/_build/
+# 本地协作产物（需求/迭代/规则记录，勿提交）
+/.trae/

zylab-0.1.1/.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+# prek / pre-commit 配置
+# See https://pre-commit.com for more information
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    # Ruff 版本 - 与 pyproject.toml 保持同步
+    rev: v0.15.21
+    hooks:
+      # 运行 linter
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      # 运行格式化
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-merge-conflict
+      - id: debug-statements
+      - id: fix-byte-order-marker
+      - id: trailing-whitespace
+        args: [--markdown-linebreak-ext=md]
+      - id: end-of-file-fixer

zylab-0.1.1/.python-version

@@ -0,0 +1 @@
+3.10

zylab-0.1.1/.readthedocs.yaml

@@ -0,0 +1,23 @@
+# ReadTheDocs 配置
+# https://docs.readthedocs.io/en/stable/config-file/v2.html
+version: 2
+
+# 构建配置
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.11"
+
+# Python 依赖与构建命令
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs
+
+# Sphinx 构建
+sphinx:
+  configuration: docs/conf.py
+  builder: html
+  fail_on_warning: false

zylab-0.1.1/Dockerfile

@@ -0,0 +1,53 @@
+# CI/容器化用 Dockerfile
+# 使用国内镜像源拉取基础镜像（如不需要可替换为官方镜像）
+# 备选镜像源前缀：docker.1ms.run / dockerpull.com / docker.xuanyuan.me
+FROM docker.m.daocloud.io/python:3.14-slim
+
+# ---- 国内镜像源 ----
+ENV PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
+ENV PIP_TRUSTED_HOST=pypi.tuna.tsinghua.edu.cn
+ENV UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
+ENV UV_TRUSTED_HOST=pypi.tuna.tsinghua.edu.cn
+
+# 环境变量：非交互 + 路径配置
+ENV DEBIAN_FRONTEND=noninteractive \
+    LANG=C.UTF-8 \
+    LC_ALL=C.UTF-8 \
+    UV_LINK_MODE=copy \
+    UV_CACHE_DIR=/uv-cache \
+    UV_PROJECT_ENVIRONMENT=/opt/venv \
+    PATH="/opt/venv/bin:${PATH}"
+
+# 配置 apt 国内镜像（阿里云）并安装系统依赖
+RUN sed -i 's|deb.debian.org|mirrors.aliyun.com|g' /etc/apt/sources.list.d/debian.sources \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends \
+        ca-certificates \
+        curl \
+        git \
+        build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+
+# 安装 uv（国内镜像）
+RUN pip install --no-cache-dir uv -i https://mirrors.aliyun.com/pypi/simple/
+
+# 预装项目所需 Python 版本
+RUN uv python install 3.11 3.14
+
+# 预装项目 dev 依赖（仅复制依赖描述文件，利用 Docker 层缓存）
+WORKDIR /workspace
+COPY pyproject.toml uv.toml tox.ini README.md ./
+COPY src/ ./src/
+
+# 同步依赖到 /opt/venv（CI 时直接复用）
+RUN uv sync --frozen --no-install-project 2>/dev/null || uv sync --no-install-project
+
+# 预装 tox 环境（首尾两个版本）
+RUN uvx tox run -e py311,py314 --notest 2>/dev/null || true
+
+# 持久化 uv 缓存目录（CI 可挂载到宿主机加速）
+VOLUME ["/uv-cache"]
+
+# 默认入口
+CMD ["/bin/bash"]

zylab-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gookeryoung
+
+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.

zylab-0.1.1/Makefile

@@ -0,0 +1,62 @@
+# Makefile - zylab 项目快捷命令
+# 运行 `make help` 查看所有可用命令
+
+PACKAGE := zylab
+COV_THRESHOLD := 95
+
+.PHONY: help sync build b clean c test cov lint typecheck typecheck-ci check doc tox bump patch minor major push
+
+help: ## 显示帮助信息
+	@awk 'BEGIN {FS = ":.*##"} /^[a-zA-Z].*:.*##/ {printf "  \033[36m%-14s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
+
+sync: ## 安装开发依赖
+	uv sync --extra dev
+
+build b: ## 构建分发包 (wheel + sdist)
+	uv build
+
+clean c: ## 清理构建产物与缓存
+	rm -rf build/ dist/ wheels/ *.egg-info htmlcov/ .coverage .coverage.* coverage.xml docs/_build/ .tox/
+	rm -rf .ruff_cache/ .pyrefly_cache/ .mypy_cache/
+	find src tests -type d -name __pycache__ -exec rm -rf {} +
+	find src tests -type f -name "*.py[oc]" -delete
+
+test: ## 运行测试（不含覆盖率）
+	uv run pytest -m "not slow"
+
+cov: ## 运行测试并检查覆盖率
+	uv run pytest -m "not slow" --cov=$(PACKAGE) --cov-fail-under=$(COV_THRESHOLD)
+
+lint: ## 代码风格检查 (ruff)
+	uv run ruff check .
+	uv run ruff format --check .
+
+typecheck: ## 类型检查 (pyrefly)
+	uv run pyrefly check
+
+typecheck-ci: ## 类型检查 (pyrefly, CI 平台 linux — 捕获跨平台问题)
+	uv run pyrefly check --python-platform linux
+
+check: lint typecheck typecheck-ci cov ## 运行全套门禁 (lint + typecheck + typecheck-ci + cov)
+
+doc: ## 构建 Sphinx 文档
+	uv run sphinx-build -b html docs docs/_build/html
+
+
+tox: ## 多版本测试 (tox)
+	uvx tox -p auto
+
+BUMP_PART := $(filter-out bump,$(MAKECMDGOALS))
+
+bump: ## 版本号 bump (默认 patch，用法: make bump [minor|major])
+	@uvx bump-my-version bump $(if $(BUMP_PART),$(firstword $(BUMP_PART)),patch) --tag
+
+patch minor major:
+	@:
+
+pub:  ## 推送到pypi
+	uvx twine upload ./dist/**
+
+push: ## 推送代码到所有远程仓库
+	@uv run python -c "import subprocess as sp; [print(f'\u63a8\u9001 {r}...',flush=True) or (sp.run(['git','push',r],check=True) and sp.run(['git','push',r,'--tags'],check=True)) for r in sp.check_output(['git','remote'],text=True).split()]"
+

zylab-0.1.1/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.5
+Name: zylab
+Version: 0.1.1
+Summary: 通用科学计算仿真分析平台。
+Author-email: gookeryoung <gooker_young@qq.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Requires-Dist: h5py>=3.9
+Requires-Dist: numba>=0.56.4
+Requires-Dist: numpy<2,>=1.24; python_version <= '3.10'
+Requires-Dist: numpy>=1.24; python_version >= '3.11'
+Requires-Dist: psutil>=5.9
+Requires-Dist: pyqtgraph>=0.13
+Requires-Dist: pyside2>=5.15.2.1; python_version <= '3.10'
+Requires-Dist: pyside6>=6.5.0; python_version >= '3.11'
+Requires-Dist: scipy>=1.10.1
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Provides-Extra: dev
+Requires-Dist: prek>=0.4.5; extra == 'dev'
+Requires-Dist: py>=1.11; (python_version <= '3.10') and extra == 'dev'
+Requires-Dist: pyrefly>=1.1.1; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest-html>=4.1.1; extra == 'dev'
+Requires-Dist: pytest-qt<4,>=3.3; (python_version <= '3.10') and extra == 'dev'
+Requires-Dist: pytest-qt>=4.2; (python_version >= '3.11') and extra == 'dev'
+Requires-Dist: pytest-xdist>=3.6.1; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Requires-Dist: tox-uv>=1.13.1; extra == 'dev'
+Requires-Dist: tox>=4.25.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: myst-parser>=3.0; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=2.0; extra == 'docs'
+Requires-Dist: sphinx>=7.0; extra == 'docs'
+Provides-Extra: lint
+Requires-Dist: pyrefly>=1.1.1; extra == 'lint'
+Requires-Dist: ruff>=0.8.0; extra == 'lint'
+Provides-Extra: test
+Requires-Dist: py>=1.11; (python_version <= '3.10') and extra == 'test'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'test'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
+Requires-Dist: pytest-html>=4.1.1; extra == 'test'
+Requires-Dist: pytest-qt<4,>=3.3; (python_version <= '3.10') and extra == 'test'
+Requires-Dist: pytest-qt>=4.2; (python_version >= '3.11') and extra == 'test'
+Requires-Dist: pytest-xdist>=3.6.1; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# zylab
+
+> 通用科学计算仿真分析平台。
+
+[![PyPI](https://img.shields.io/pypi/v/zylab)](https://pypi.org/project/zylab/)
+[![CI](https://github.com/gookeryoung/zylab/actions/workflows/ci.yml/badge.svg)](https://github.com/gookeryoung/zylab/actions/workflows/ci.yml)
+![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Coverage](https://img.shields.io/badge/coverage-%E2%89%A595%25-brightgreen.svg)
+
+## 特性
+
+- **构建工具链**：hatchling + uv + ruff + pyrefly + pytest + coverage
+- **Python 版本**：3.11 ~ 3.14
+- **代码质量**：pre-commit 钩子 + ruff lint/format，覆盖率阈值 95%
+- **CI/CD**：GitHub Actions（lint + typecheck + 多版本测试 + 自动发布到 PyPI）
+- **文档**：Sphinx + ReadTheDocs（中文 zh_CN）
+- **多版本测试**：tox + tox-uv（py311, py312, py313, py314）
+- **容器化**：Dockerfile（含国内镜像源配置）
+- **GUI 框架**：PySide2（Qt5，Python≤3.10）/ PySide6（Qt6，Python≥3.11），按版本自动区分
+- **项目结构**：src layout + py.typed 类型标记
+
+## 安装
+
+```bash
+pip install zylab
+```
+
+或使用 [uv](https://docs.astral.sh/uv/)：
+
+```bash
+uv add zylab
+```
+
+## 快速上手
+
+```python
+import zylab
+
+print(zylab.__version__)
+```
+
+命令行（无界面求解模板/工程，支持参数覆盖与扫描）：
+
+```bash
+zylab                       # 启动图形界面
+zylab templates             # 列出可用模板
+zylab run structural.cantilever_static -p model.nx=20
+zylab run demo.zprj --scan "model.tip_load=-50:-100:5"
+```
+
+## 开发
+
+```bash
+# 安装开发依赖
+uv sync --extra dev
+
+# 运行测试（含覆盖率，阈值 95%）
+uv run pytest -m "not slow" --cov=zylab --cov-fail-under=95
+
+# 类型检查
+uv run pyrefly check .
+
+# 代码风格
+uv run ruff check src tests
+uv run ruff format --check src tests
+```
+
+### Make 快捷命令
+
+项目提供 Makefile 封装常用操作，运行 `make help` 查看全部命令：
+
+```bash
+make sync     # 安装开发依赖
+make check    # 全套门禁 (lint + typecheck + cov)
+make build    # 构建分发包
+make clean    # 清理构建产物
+make bump PART=patch  # 版本号 bump
+```
+
+
+## 文档
+
+文档由 Sphinx 构建，托管在 ReadTheDocs：
+
+```bash
+# 本地构建文档
+make doc
+```
+
+
+## 多版本测试
+
+使用 tox 在多个 Python 版本（py311, py312, py313, py314）下运行测试：
+
+```bash
+make tox
+```
+
+## 许可证
+
+MIT