refactor: reorganize project layout into docs scripts and src/native

Author: skhe

MANIFEST.in

@@ -1,4 +1,5 @@
-include *.c *.h LICENSE README.md setup.py pyproject.toml
+include LICENSE README.md setup.py pyproject.toml docs/README_zh.md
+recursive-include src/native *.c *.h
 recursive-include dpi_bridge *.go
 include dpi_bridge/go.mod dpi_bridge/go.sum
 exclude dpi_bridge/libdmdpi.dylib dpi_bridge/libdmdpi.h

README.md

@@ -71,18 +71,21 @@ DMPYTHON_SKIP_GO_BUILD=1 python -m build --wheel
 dmPython/
 ├── setup.py              # Build script
 ├── pyproject.toml        # Project metadata
+├── docs/                 # Project docs (zh README, technical notes)
+├── scripts/              # Local/ops scripts
+├── src/native/           # C extension sources and headers
 ├── dpi_bridge/           # Go-based DPI bridge (replaces proprietary libdmdpi)
 │   ├── main.go
 │   ├── go.mod / go.sum
 │   └── ...
 ├── dpi_include/          # DPI header files (not distributed, see README)
-├── py_Dameng.c/h         # Module entry, type registration, exception hierarchy
-├── strct.h               # Core struct definitions (Environment, Connection, Cursor)
-├── Connection.c          # Connection management
-├── Cursor.c              # Cursor operations, SQL execution
-├── var.c                 # Variable management core
-├── v*.c                  # Type-specific variable handlers
-├── ex*.c                 # External object interfaces (LOB, BFILE, Object)
+├── src/native/py_Dameng.c/h  # Module entry, type registration, exception hierarchy
+├── src/native/strct.h        # Core struct definitions (Environment, Connection, Cursor)
+├── src/native/Connection.c   # Connection management
+├── src/native/Cursor.c       # Cursor operations, SQL execution
+├── src/native/var.c          # Variable management core
+├── src/native/v*.c           # Type-specific variable handlers
+├── src/native/ex*.c          # External object interfaces (LOB, BFILE, Object)
 └── .github/workflows/    # CI: builds macOS ARM64 wheels for Python 3.9–3.13
 ```
 
@@ -92,4 +95,4 @@ Licensed under [Mulan PSL v2](http://license.coscl.org.cn/MulanPSL2).
 
 ---
 
-[中文文档 (README_zh.md)](README_zh.md)
+[中文文档 (docs/README_zh.md)](docs/README_zh.md)

README_zh.md docs/README_zh.mdREADME_zh.md renamed to docs/README_zh.md

@@ -9,7 +9,7 @@ dmPython 是达梦数据库（DM8）的原生 Python 驱动程序，遵循 [Pyth
 
 本项目是 [官方 dmPython](https://github.com/DamengDB/dmPython) 的社区 fork。上游项目依赖的专有 C 库 `libdmdpi` 不提供 macOS 版本，本 fork 使用 Go 编写的 DPI 桥接库（`dpi_bridge/`）替代，实现原生 macOS ARM64 支持，无需安装完整的达梦数据库。
 
-**当前版本：** 2.5.30
+**当前版本：** 2.5.31
 
 ## 特性
 
@@ -90,18 +90,21 @@ define_macros.append(('TRACE', None))
 dmPython/
 ├── setup.py              # 构建脚本
 ├── pyproject.toml        # 项目元数据
+├── docs/                 # 项目文档（中文 README、技术报告）
+├── scripts/              # 本地/运维脚本
+├── src/native/           # C 扩展源码与头文件
 ├── dpi_bridge/           # Go DPI 桥接库（替代专有 libdmdpi）
 │   ├── main.go
 │   ├── go.mod / go.sum
 │   └── ...
 ├── dpi_include/          # DPI 头文件（不随源码分发，见 README）
-├── py_Dameng.c/h         # 模块入口，类型注册，异常层次
-├── strct.h               # 核心结构定义 (Environment, Connection, Cursor)
-├── Connection.c          # 连接管理
-├── Cursor.c              # 游标操作，SQL 执行
-├── var.c                 # 变量管理核心
-├── v*.c                  # 各类型变量处理器
-├── ex*.c                 # 外部对象接口 (LOB, BFILE, Object)
+├── src/native/py_Dameng.c/h  # 模块入口，类型注册，异常层次
+├── src/native/strct.h        # 核心结构定义 (Environment, Connection, Cursor)
+├── src/native/Connection.c   # 连接管理
+├── src/native/Cursor.c       # 游标操作，SQL 执行
+├── src/native/var.c          # 变量管理核心
+├── src/native/v*.c           # 各类型变量处理器
+├── src/native/ex*.c          # 外部对象接口 (LOB, BFILE, Object)
 └── .github/workflows/    # CI：构建 macOS ARM64 wheels (Python 3.9–3.13)
 ```
 
@@ -111,4 +114,4 @@ dmPython/
 
 ---
 
-[English README (README.md)](README.md)
+[English README (README.md)](../README.md)

test_connection.py scripts/test_connection.pytest_connection.py renamed to scripts/test_connection.py

@@ -17,8 +17,13 @@
 
 BUILD_VERSION = "2.5.31"
 
+# Directories
+HERE = os.path.dirname(os.path.abspath(__file__))
+DPI_BRIDGE_DIR = os.path.join(HERE, "dpi_bridge")
+NATIVE_SRC_DIR = os.path.join("src", "native")
+
 # All C source files
-C_SOURCES = [
+C_SOURCE_FILES = [
     "py_Dameng.c",
     "row.c",
     "Cursor.c",
@@ -42,10 +47,7 @@
     "vBfile.c",
     "trc.c",
 ]
-
-# Directories
-HERE = os.path.dirname(os.path.abspath(__file__))
-DPI_BRIDGE_DIR = os.path.join(HERE, "dpi_bridge")
+C_SOURCES = [os.path.join(NATIVE_SRC_DIR, f) for f in C_SOURCE_FILES]
 
 
 def find_dpi_include():
@@ -130,7 +132,7 @@ def _build_go_bridge(self):
 extension = Extension(
     name="dmPython",
     sources=C_SOURCES,
-    include_dirs=[DPI_INCLUDE_DIR],
+    include_dirs=[DPI_INCLUDE_DIR, os.path.join(HERE, NATIVE_SRC_DIR)],
     library_dirs=[DPI_BRIDGE_DIR],
     libraries=["dmdpi"],
     define_macros=define_macros,