pythonalize 0.0.1__tar.gz

pythonalize-0.0.1/LICENSE

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

pythonalize-0.0.1/PKG-INFO

@@ -0,0 +1,258 @@
+Metadata-Version: 2.4
+Name: pythonalize
+Version: 0.0.1
+Summary: Pythonalize: a localized representation layer for Python (Simplified Chinese).
+License: MIT License
+        
+        Copyright (c) 2026 Pythonalize 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.
+        
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Pythonalize
+
+**Pythonalize** 是 Python 的本地化表示层：让你用简体中文写 Python。
+
+它不是新语言，也不是翻译器之外的东西。它只做一件事——把中文写法的
+Python 源码，换成等价的英文 Python 源码，再交给 Python 执行。
+
+- 面向：想用中文阅读/编写 Python 的人，以及用 AI 快速出代码的 **vibe coder**。
+- 它**降低源码的阅读门槛**，但**不会替代 Python 概念学习**——你要理解
+  什么是函数、循环、类，仍是学 Python 本身。
+
+---
+
+## Pythonalize 是什么 / 不是什么
+
+**是：**
+
+- Python 的一个 **本地化表示层**——中文只是 Python 关键字/内置名的另一种写法。
+- 一个用 `tokenize` 做**词法映射**的小工具：把中文 token 换成英文 token。
+
+**不是：**
+
+- ❌ 一门**新语言**。
+- ❌ 一个新的 **runtime / 解释器**。
+- ❌ 一个新的 **VM**。
+- ❌ 一个 **compiler**（它只是把源码换成等价源码，不生成机器码）。
+- ❌ 一个**独立的 package ecosystem**（你不用装另一套包管理器）。
+- ❌ 一个**自然语言编程**系统（它是词法映射，不是理解你的程序意图）。
+
+**黄金规则：** Python 的 **grammar（语法）和 semantics（语义）是唯一标准**。
+Pythonalize 只改变字面写法，完全不改变 Python 的语法与运行语义。
+
+> **Pythonalize does not define program semantics. Python does.**
+
+---
+
+## 中英混写与标识符
+
+- 可以**中英混写**：中文词换英文词，其余一律原样保留。
+- **字符串、注释、数字** 绝不会被替换。
+- **项目自定义的中文 Unicode 标识符**（如函数名、变量名、类名）**不被猜译**，
+  原样保留。Pythonalize 只替换它内置映射表里的那几十个词。
+
+---
+
+## 版本
+
+- `v0.0.1` 目前**仅支持 `zh-CN`**（简体中文）一个语言。
+- 其他语言 / 更多词表将在后续版本加入。
+
+---
+
+## 安装
+
+安装发布版：
+
+```bash
+pip install pythonalize
+```
+
+从 PyPI 安装 `pythonalize` 发布版，执行需要 Python 3.9 及以上。
+
+从源码开发安装（在项目根目录执行）：
+
+```bash
+pip install .
+```
+
+这会从当前源码安装，是开发时用到的方式；执行同样需要 Python 3.9 及以上。
+
+安装后，`pthz` 命令进入 PATH（由 `pyproject.toml` 的 `[project.scripts]` 提供）。
+
+---
+
+## Hello 示例
+
+`examples/hello.pthz`：
+
+```python
+定义 主():
+    打印("你好，世界")
+
+若 __name__ == "__main__":
+    主()
+```
+
+它等价于 `examples/hello.py`：
+
+```python
+def main():
+    print("你好，世界")
+
+if __name__ == "__main__":
+    main()
+```
+
+两个文件**语义等价**，运行都输出：
+
+```text
+你好，世界
+```
+
+---
+
+## 命令
+
+所有命令都是 `pthz` 的子命令。
+
+### 运行（默认）
+
+```bash
+pthz examples/hello.pthz        # 裸文件 = run
+pthz run examples/hello.pthz    # 等价
+```
+
+### 查看规范化结果（推荐先看再跑）
+
+```bash
+pthz show examples/hello.pthz
+```
+
+把 `.pthz` 规范化后的等价 Python 打印到屏幕，方便你**审阅**。
+
+### 语法检查
+
+```bash
+pthz check examples/hello.pthz
+```
+
+只编译、不执行。成功打印 `OK: examples/hello.pthz`。
+
+### 双向转换
+
+**注意：** 目标文件默认是源文件同名的另一后缀（`hello.pthz` ↔ `hello.py`）。
+如果目标**已存在**，命令会拒绝（`-y` 也不会覆盖）。仓库自带的
+`examples/hello.py` 与 `examples/hello.pthz` **同时存在**，因此不要把其中
+一个当另一个的转换目标——先复制到一个**目标初始不存在**的新目录。
+
+下面的示例分成两个相互独立的目录，每个方向只执行一条命令，可整段照抄。
+
+**`.pthz` → `.py`（中文写 → 英文写），用 `from-pthz/`：**
+
+```bash
+mkdir -p from-pthz && cp examples/hello.pthz from-pthz/
+pthz normalize -y from-pthz/hello.pthz      # 创建 from-pthz/hello.py
+```
+
+**`.py` → `.pthz`（英文写 → 中文写），用 `from-py/`：**
+
+```bash
+mkdir -p from-py && cp examples/hello.py from-py/
+pthz represent -y from-py/hello.py        # 创建 from-py/hello.pthz
+```
+
+> 上面用 `-y` 跳过确认、直接创建。去掉 `-y` 会先显示
+> `Create <TARGET>? [y/N]: ` 提示，等你在输入 `y` 或 `Y` 之后才创建。
+
+转换行为：
+
+- 目标文件默认是源文件同名的另一后缀（`hello.pthz` ↔ `hello.py`）。
+- 目标**已存在时拒绝**，只报 `Error: <TARGET> already exists.` 并返回非零。
+- **`-y` 也不会覆盖已有文件**，它只是跳过“是否创建？”的询问。
+- 没有 `-y` 时会询问 `Create <TARGET>? [y/N]: `，只有输入 `y` 或 `Y`
+  才创建；回答其他内容则正常退出（返回 0）。
+
+### 帮助与版本
+
+```bash
+pthz --help
+pthz --version
+```
+
+`pthz --help` 列出全部子命令与参数；`pthz --version` 打印当前版本
+（`pthz 0.0.1`）。
+
+---
+
+## 一个需要知道的坑：内置名遮蔽也会被替换
+
+Pythonalize 是**纯词法映射**，不追踪变量绑定。
+
+也就是说：即使你在代码里把一个内置名（如 `print`、`len`、`range`）
+当普通变量重新赋值了，它的那个名字**依然会被替换**成对应的中文词。
+它**无法识别 shadowing（遮蔽）**。
+
+如果你要遮蔽内置名，请注意：被替换的仍然是那个词法 token。
+
+```python
+# .py 里：把 print 重新赋值，再调用
+print = my_logger        # 这个 print 会被替换成 打印
+print("hi")              # 这个也会被替换成 打印
+```
+
+---
+
+## ⚠️ 安全提示：不是沙箱
+
+**执行 `.pthz` 与执行等价 `.py` 一样不安全。**
+
+- Pythonalize **不是沙箱**，没有隔离能力。
+- 被运行的代码拥有与你完全相同的权限：能读写文件、访问网络、调用系统命令。
+- **运行前**请务必先用 `pthz show` 查看规范化结果、再用 `pthz check`，
+  并**审阅**代码内容，尤其是你从 AI 或其他渠道获得的代码。
+
+---
+
+## 给 AI 生成代码的建议
+
+如果你用 AI 帮你写 Pythonalize 代码：
+
+- 直接告诉它：“用 Pythonalize 写，输出 **`.pthz`**，语法就是 Python，只是把
+  `def/if/for/print` 等词换成了中文对应词。”
+- 让它**先写 `.pthz`**，你再 `pthz show` 检查；或让它**同时给 `.py`**，
+  你用 `pthz represent` 转成 `.pthz` 再运行。
+- ⚠️ 交代它：**不要编造 Pythonalize 不存在的语法**；Pythonalize 只用标准 Python
+  语法，只是关键字/内置名是中文。
+- 让 AI 遵守 `zh-CN` 当前词表（`定义/若/否则若/否则/返回/遍历/只要/停止/
+  继续/在/是/非/且/或/从/作为/类/略过/打印/长度/范围/枚举/总和/最小/最大...
+  等），避免它发明新词。
+- 提醒它：**项目自定义的中文标识符、字符串、注释不会被翻译**，别假设会被猜译。
+- **别让 AI 在没有审阅的情况下直接运行**外部代码——先 `show`/`check` 再看。
+
+---
+
+## License
+
+MIT —— 详见 [`LICENSE`](LICENSE)。

pythonalize-0.0.1/README.md

@@ -0,0 +1,227 @@
+# Pythonalize
+
+**Pythonalize** 是 Python 的本地化表示层：让你用简体中文写 Python。
+
+它不是新语言，也不是翻译器之外的东西。它只做一件事——把中文写法的
+Python 源码，换成等价的英文 Python 源码，再交给 Python 执行。
+
+- 面向：想用中文阅读/编写 Python 的人，以及用 AI 快速出代码的 **vibe coder**。
+- 它**降低源码的阅读门槛**，但**不会替代 Python 概念学习**——你要理解
+  什么是函数、循环、类，仍是学 Python 本身。
+
+---
+
+## Pythonalize 是什么 / 不是什么
+
+**是：**
+
+- Python 的一个 **本地化表示层**——中文只是 Python 关键字/内置名的另一种写法。
+- 一个用 `tokenize` 做**词法映射**的小工具：把中文 token 换成英文 token。
+
+**不是：**
+
+- ❌ 一门**新语言**。
+- ❌ 一个新的 **runtime / 解释器**。
+- ❌ 一个新的 **VM**。
+- ❌ 一个 **compiler**（它只是把源码换成等价源码，不生成机器码）。
+- ❌ 一个**独立的 package ecosystem**（你不用装另一套包管理器）。
+- ❌ 一个**自然语言编程**系统（它是词法映射，不是理解你的程序意图）。
+
+**黄金规则：** Python 的 **grammar（语法）和 semantics（语义）是唯一标准**。
+Pythonalize 只改变字面写法，完全不改变 Python 的语法与运行语义。
+
+> **Pythonalize does not define program semantics. Python does.**
+
+---
+
+## 中英混写与标识符
+
+- 可以**中英混写**：中文词换英文词，其余一律原样保留。
+- **字符串、注释、数字** 绝不会被替换。
+- **项目自定义的中文 Unicode 标识符**（如函数名、变量名、类名）**不被猜译**，
+  原样保留。Pythonalize 只替换它内置映射表里的那几十个词。
+
+---
+
+## 版本
+
+- `v0.0.1` 目前**仅支持 `zh-CN`**（简体中文）一个语言。
+- 其他语言 / 更多词表将在后续版本加入。
+
+---
+
+## 安装
+
+安装发布版：
+
+```bash
+pip install pythonalize
+```
+
+从 PyPI 安装 `pythonalize` 发布版，执行需要 Python 3.9 及以上。
+
+从源码开发安装（在项目根目录执行）：
+
+```bash
+pip install .
+```
+
+这会从当前源码安装，是开发时用到的方式；执行同样需要 Python 3.9 及以上。
+
+安装后，`pthz` 命令进入 PATH（由 `pyproject.toml` 的 `[project.scripts]` 提供）。
+
+---
+
+## Hello 示例
+
+`examples/hello.pthz`：
+
+```python
+定义 主():
+    打印("你好，世界")
+
+若 __name__ == "__main__":
+    主()
+```
+
+它等价于 `examples/hello.py`：
+
+```python
+def main():
+    print("你好，世界")
+
+if __name__ == "__main__":
+    main()
+```
+
+两个文件**语义等价**，运行都输出：
+
+```text
+你好，世界
+```
+
+---
+
+## 命令
+
+所有命令都是 `pthz` 的子命令。
+
+### 运行（默认）
+
+```bash
+pthz examples/hello.pthz        # 裸文件 = run
+pthz run examples/hello.pthz    # 等价
+```
+
+### 查看规范化结果（推荐先看再跑）
+
+```bash
+pthz show examples/hello.pthz
+```
+
+把 `.pthz` 规范化后的等价 Python 打印到屏幕，方便你**审阅**。
+
+### 语法检查
+
+```bash
+pthz check examples/hello.pthz
+```
+
+只编译、不执行。成功打印 `OK: examples/hello.pthz`。
+
+### 双向转换
+
+**注意：** 目标文件默认是源文件同名的另一后缀（`hello.pthz` ↔ `hello.py`）。
+如果目标**已存在**，命令会拒绝（`-y` 也不会覆盖）。仓库自带的
+`examples/hello.py` 与 `examples/hello.pthz` **同时存在**，因此不要把其中
+一个当另一个的转换目标——先复制到一个**目标初始不存在**的新目录。
+
+下面的示例分成两个相互独立的目录，每个方向只执行一条命令，可整段照抄。
+
+**`.pthz` → `.py`（中文写 → 英文写），用 `from-pthz/`：**
+
+```bash
+mkdir -p from-pthz && cp examples/hello.pthz from-pthz/
+pthz normalize -y from-pthz/hello.pthz      # 创建 from-pthz/hello.py
+```
+
+**`.py` → `.pthz`（英文写 → 中文写），用 `from-py/`：**
+
+```bash
+mkdir -p from-py && cp examples/hello.py from-py/
+pthz represent -y from-py/hello.py        # 创建 from-py/hello.pthz
+```
+
+> 上面用 `-y` 跳过确认、直接创建。去掉 `-y` 会先显示
+> `Create <TARGET>? [y/N]: ` 提示，等你在输入 `y` 或 `Y` 之后才创建。
+
+转换行为：
+
+- 目标文件默认是源文件同名的另一后缀（`hello.pthz` ↔ `hello.py`）。
+- 目标**已存在时拒绝**，只报 `Error: <TARGET> already exists.` 并返回非零。
+- **`-y` 也不会覆盖已有文件**，它只是跳过“是否创建？”的询问。
+- 没有 `-y` 时会询问 `Create <TARGET>? [y/N]: `，只有输入 `y` 或 `Y`
+  才创建；回答其他内容则正常退出（返回 0）。
+
+### 帮助与版本
+
+```bash
+pthz --help
+pthz --version
+```
+
+`pthz --help` 列出全部子命令与参数；`pthz --version` 打印当前版本
+（`pthz 0.0.1`）。
+
+---
+
+## 一个需要知道的坑：内置名遮蔽也会被替换
+
+Pythonalize 是**纯词法映射**，不追踪变量绑定。
+
+也就是说：即使你在代码里把一个内置名（如 `print`、`len`、`range`）
+当普通变量重新赋值了，它的那个名字**依然会被替换**成对应的中文词。
+它**无法识别 shadowing（遮蔽）**。
+
+如果你要遮蔽内置名，请注意：被替换的仍然是那个词法 token。
+
+```python
+# .py 里：把 print 重新赋值，再调用
+print = my_logger        # 这个 print 会被替换成 打印
+print("hi")              # 这个也会被替换成 打印
+```
+
+---
+
+## ⚠️ 安全提示：不是沙箱
+
+**执行 `.pthz` 与执行等价 `.py` 一样不安全。**
+
+- Pythonalize **不是沙箱**，没有隔离能力。
+- 被运行的代码拥有与你完全相同的权限：能读写文件、访问网络、调用系统命令。
+- **运行前**请务必先用 `pthz show` 查看规范化结果、再用 `pthz check`，
+  并**审阅**代码内容，尤其是你从 AI 或其他渠道获得的代码。
+
+---
+
+## 给 AI 生成代码的建议
+
+如果你用 AI 帮你写 Pythonalize 代码：
+
+- 直接告诉它：“用 Pythonalize 写，输出 **`.pthz`**，语法就是 Python，只是把
+  `def/if/for/print` 等词换成了中文对应词。”
+- 让它**先写 `.pthz`**，你再 `pthz show` 检查；或让它**同时给 `.py`**，
+  你用 `pthz represent` 转成 `.pthz` 再运行。
+- ⚠️ 交代它：**不要编造 Pythonalize 不存在的语法**；Pythonalize 只用标准 Python
+  语法，只是关键字/内置名是中文。
+- 让 AI 遵守 `zh-CN` 当前词表（`定义/若/否则若/否则/返回/遍历/只要/停止/
+  继续/在/是/非/且/或/从/作为/类/略过/打印/长度/范围/枚举/总和/最小/最大...
+  等），避免它发明新词。
+- 提醒它：**项目自定义的中文标识符、字符串、注释不会被翻译**，别假设会被猜译。
+- **别让 AI 在没有审阅的情况下直接运行**外部代码——先 `show`/`check` 再看。
+
+---
+
+## License
+
+MIT —— 详见 [`LICENSE`](LICENSE)。

pythonalize-0.0.1/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pythonalize"
+version = "0.0.1"
+description = "Pythonalize: a localized representation layer for Python (Simplified Chinese)."
+readme = "README.md"
+license = {file = "LICENSE"}
+requires-python = ">=3.9"
+
+[project.scripts]
+pthz = "pythonalize.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+pythonalize = ["schemes/*.json"]

pythonalize-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pythonalize-0.0.1/src/pythonalize/__init__.py

@@ -0,0 +1,5 @@
+"""Pythonalize: Python 的本地化表示层（简体中文）。"""
+
+__version__ = "0.0.1"
+
+__all__ = ["__version__"]

pythonalize-0.0.1/src/pythonalize/__main__.py

@@ -0,0 +1,5 @@
+"""``python -m pythonalize`` 入口，委托给 :func:`pythonalize.cli.main`。"""
+
+from .cli import main
+
+raise SystemExit(main())