1.中英双语文档 2.对路径不存在等情况进行处理

Author: EVA-JianJun

AutoCython/AutoCython.py

@@ -1,28 +1,36 @@
+import os
 from .run_tasks import run_tasks
 from .compile import compile_to_binary
-from .tools import parse_arguments, find_python_files, show_not_find_file
+from .tools import parse_arguments, find_python_files
+from .tools import show_path_not_find_file, show_file_find_file, show_path_find_file
 
 def compile():
     args = parse_arguments()
 
     if args.file:
-        compile_file = args.file
-        del_source = args.del_source
-        tasks = [
-            # 函数, 位置参数, 关键字参数
-            (compile_to_binary, compile_file, (compile_file, del_source), {}),
-        ]
-        run_tasks(tasks, max_workers=1) # 执行编译
+        if os.path.isfile(args.file):
+            compile_file = args.file
+            del_source = args.del_source
+            tasks = [
+                # 函数, 位置参数, 关键字参数
+                (compile_to_binary, compile_file, (compile_file, del_source), {}),
+            ]
+            run_tasks(tasks, max_workers=1) # 执行编译
+        else:
+            show_file_find_file(args.file)
     elif args.path:
-        compile_file_list = find_python_files(args.path)
-        del_source = args.del_source
-        if compile_file_list:
-            tasks = []
-            for compile_file in compile_file_list:
-                tasks.append(
-                    # 函数, 位置参数, 关键字参数
-                    (compile_to_binary, compile_file, (compile_file, del_source), {}),
-                )
-            run_tasks(tasks, max_workers=args.conc) # 执行编译
+        if os.path.exists(args.path) and not os.path.isfile(args.path):
+            compile_file_list = find_python_files(args.path)
+            if compile_file_list:
+                del_source = args.del_source
+                tasks = []
+                for compile_file in compile_file_list:
+                    tasks.append(
+                        # 函数, 位置参数, 关键字参数
+                        (compile_to_binary, compile_file, (compile_file, del_source), {}),
+                    )
+                run_tasks(tasks, max_workers=args.conc) # 执行编译
+            else:
+                show_path_not_find_file(args.path)
         else:
-            show_not_find_file()
+            show_path_find_file(args.path)

AutoCython/tools.py

@@ -127,18 +127,41 @@ def error(self, message):
 
     return args
 
-def show_not_find_file():
-    # 获取系统语言
+def show_path_not_find_file(path):
+    try:
+        sys_language, _ = locale.getdefaultlocale()
+        lang = 'zh' if sys_language and sys_language.startswith('zh') else 'en'
+    except Exception:
+        lang = 'en'  # 异常时默认英文
+
+    if lang == 'zh':
+        print(f"{path} 目录下没有任何需要编译的文件!")
+    else:
+        print(f"The {path} directory does not contain any files that need to be compiled!")
+
+def show_file_find_file(file):
+    try:
+        sys_language, _ = locale.getdefaultlocale()
+        lang = 'zh' if sys_language and sys_language.startswith('zh') else 'en'
+    except Exception:
+        lang = 'en'  # 异常时默认英文
+
+    if lang == 'zh':
+        print(f"文件 {file} 不存在!")
+    else:
+        print(f"File {file} does not exist!")
+
+def show_path_find_file(path):
     try:
         sys_language, _ = locale.getdefaultlocale()
         lang = 'zh' if sys_language and sys_language.startswith('zh') else 'en'
     except Exception:
         lang = 'en'  # 异常时默认英文
 
     if lang == 'zh':
-        print("没有找到任何需要编译的文件!")
+        print(f"路径 {path} 不存在!")
     else:
-        print("No files found that need to be compiled!")
+        print(f"Path {path} does not exist!")
 
 if __name__ == "__main__":
     args = parse_arguments()

README.en.md

@@ -0,0 +1,66 @@
+# AutoCython
+[中文](https://github.com/EVA-JianJun/AutoCython/blob/master/README.md) | English
+
+**AutoCython: Batch Compile Python Files to PYD Files with One Click**
+![py_pyd](https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20210824.png)
+
+## ✨ Key Features
+- Single-file/Multi-file batch compilation
+- Cross-platform support (Windows/Linux/MacOS)
+- Clean command-line interface
+
+## 📦 Installation
+```bash
+pip install AutoCython-jianjun
+```
+
+## ⚙️ Dependencies
+### C/C++ Compiler Requirements
+- **Windows**: Visual Studio
+- **Linux**: gcc & g++
+
+**Important**: Compiler architecture must match Python interpreter (64-bit Python requires 64-bit compiler)
+
+> For other compiler configurations, refer to [Cython](https://github.com/cython/cython) project
+
+## 🚀 Usage Guide
+### Command Line Operations
+![CLI Demo](https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20250609_3.png)
+
+```bash
+# Compile single file
+AutoCython -f test.py
+
+# Compile entire directory
+AutoCython -p D:/python_code/ProjectPath
+
+# Delete source after compilation (disabled by default)
+AutoCython -d True -f test.py
+AutoCython -d True -p D:/python_code/ProjectPath
+```
+
+### Compilation Interface
+![AutoCython GUI](https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20250609_4.png)
+
+### Manually Exclude Files from Compilation
+Add declaration in the **first two lines** of file header:
+```python
+# AutoCython No Compile
+# This file will be skipped during compilation
+```
+
+## ⚠️ Troubleshooting
+
+Typically caused by Cython-unsupported statements or invalid filenames.
+Consult [Cython Wiki](https://github.com/cython/cython/wiki) official documentation or submit an Issue.
+
+## 📅 Changelog
+### V2 Releases
+1. 20250609 release V2.0.0: Codebase refactored with new UI
+
+### V1 Releases
+1. 20220613: Added Linux support (requires gcc & g++ configuration)
+2. 20221123: Added manual file exclusion via file header comments
+3. 20230306: Added CLI header specification (e.g., `Python310`) for non-Windows compilation
+4. 20230324: Documentation updates
+5. 20240506: Fixed issue with `__init__.py` restoration after failed compilation

README.md

@@ -1,107 +1,66 @@
 # AutoCython
+中文 | [English](https://github.com/EVA-JianJun/AutoCython/blob/master/README.en.md)
 
-**自动 Cython, 使用 Cython 批量编译 `.py` 文件为 `.pyd` 文件！**
-![py_pyd][1]
+**自动 Cython：一键将 Python 文件批量编译为 PYD 文件**
+![py_pyd](https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20210824.png)
 
-## 安装
+## ✨ 特性亮点
+- 单文件/多文件批量编译
+- 跨平台支持 (Windows/Linux/MacOS)
+- 简洁命令行界面
 
-    pip install AutoCython-jianjun
-
-## 依赖
-
-[Cython](https://github.com/cython/cython) 和 C/C++ 编译器
-
-**如果你都配置完毕了你可以跳过本节.**
-
-### Cython
-
-```
-pip install Cython
+## 📦 安装
+```bash
+pip install AutoCython-jianjun
 ```
 
+## ⚙️ 依赖环境
 ### C/C++ 编译器
+- **Windows**: Visual Studio
+- **Linux**: gcc & g++
 
-推荐 `gcc` 和 `visual studio` 选一个, 其他编译器请查阅 Cython 文档.
-
-* `VS` 安装简便, 占用空间大, 配置简单.
-* `gcc` 安装简便, 占用空间小, 配置比较复杂.
-
-不想折腾或者你是 Windows 的话推荐安装 VS, Linux 等系统可以直接使用自带的 gcc。
-
-大部分的编译环境都可以使用, 我在 Win, Linux, Mac, Python3.6 到 Python3.10 都可以使用.
-
-**需要注意的是, 如果你使用的 Python 是64位的, 那么对应的 C、C++ 编译器也必须为64位；**
-
-**win下gcc推荐安装MinGW**：
-
-* 64位：<http://mingw-w64.org/>
-* 32位：<http://www.mingw.org/>
+**重要提示**：编译器架构必须与Python解释器一致（64位Python需64位编译器）
 
-## 使用
+> 其他编译器配置请参考 [Cython](https://github.com/cython/cython) 项目
 
-![命令行][11]
+## 🚀 使用指南
+### 命令行操作
+![命令行演示](https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20250609_1.png)
 
-### 命令行
+```bash
+# 编译单个文件
+AutoCython -f test.py
 
-使用命令行进行编译：
+# 编译整个目录
+AutoCython -p D:/python_code/ProjectPath
 
-`AutoCython -h` 或者 `AutoCython --ch` 查看英文和中文帮助.
-
-    # 编译一个文件
-    AutoCython -f test.py
-
-    # 编译一个目录
-    AutoCython -C D:/python_code/ProjectPath
-
-![AutoCython][2]
-
-**例子**
-
-编译目录 `D:/python_code/ProjectPath`\
-排除所有名为 `tmp.py` 的文件\
-排除 `./ProjectPath/print_cy.py` 文件\
-排除 `./ProjectPath/data/tmp` 目录下的文件不编译\
-使用2个CPU核心\
-只删除编译后产生的 `build` 文件夹和中间文件 `setup_file`, 保留自动生成的 `C` 代码.\
-
-    AutoCython -C D:/python_code/ProjectPath -E tmp.py;./ProjectPath/print_cy.py;./ProjectPath/data/tmp -M 2 -D bp
-
-## 特性
-
-* **全自动**：自动编译当前目录下所有.py文件, 支持指定目录编译或单文件编译；
-* **个性化**：支持指定排除目录或排除文件跳过编译；
-* **高效率**：默认启动进程数为cpu核心数四分之一, 大多数情况下可以把cpu跑满；
-* **易纠错**：快速纠错, 在编译失败时能极快的获取错误信息；
-
-### 常见错误
+# 编译后删除源代码 (默认不删除)
+AutoCython -d True -f test.py
+AutoCython -d True -p D:/python_code/ProjectPath
+```
 
-* `print(end='')`\
-Cython 不支持 print 函数的 end 参数, 可以在外部定义 `def my_print(*args, **kwargs): print(*args, end='', **kwargs)`, 然后在需要编译的文件中导入这个外部函数.
+### 编译界面
+![AutoCython GUI](https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20250609_2.png)
 
-* `新建文本文档.py`\
-文件名需要符合  `C` 命名规范
+### 手动排除文件不编译
+在文件头部 **前两行** 添加声明：
+```python
+# AutoCython No Compile
+# 此文件将跳过编译处理
+```
 
-其他问题请查阅 `Cython` 官方文档.
+## ⚠️ 常见问题解决
 
-### 手动指定不编译
+一般是源代码中有 Cython 不支持的语句, 或者文件名不支持等.
+ 可以查阅 [Cython Wiki](https://github.com/cython/cython/wiki) 项目 官方文档, 或者提 Issue.
 
-在不需要编译的文件 **头两行** 任意一行写上 `# AucoCython No Compile` 则该文件会跳过编译.
+## 📅 更新记录
+### V2 版本
+1. 20250609 release V2.0.0 重构了代码, 使用新的界面
 
-## 更新记录
+### V1 版本
 1. 20220613 更新对Linux的支持, Linux下需要配置gcc&g++
 2. 20221123 可以通过文件头手动指定不编译的文件
 3. 20230306 更新可以指定命令行头如 `Python310` 以此支持非Widnows系统下编译
 4. 20230324 更新文档
-5. 20240506 修复编译失败时遗漏复原 \_\_init\_\_.py 的问题
-
-  [1]: https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20210824.png
-  [2]: https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20200316_2.jpg
-  [3]: https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20200316_3.jpg
-  [4]: https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20200316_4.jpg
-  [5]: https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20200316_5.jpg
-  [6]: https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20200316_6.jpg
-  [7]: https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20200316_7.jpg
-  [8]: https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20200316_8.jpg
-  [9]: https://github.com/EVA-JianJun/AutoCython/releases
-  [10]: https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20200316_10.jpg
-  [11]: https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/AutoCython_20200316_11.jpg
+5. 20240506 修复编译失败时遗漏复原 \_\_init\_\_.py 的问题