pybrace 0.1.0__tar.gz

pybrace-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+build/
+dist/
+*.egg-info/
+.venv/
+venv/
+# pyj build 生成的文件
+examples/*.py

pybrace-0.1.0/LICENSE

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

pybrace-0.1.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.5
+Name: pybrace
+Version: 0.1.0
+Summary: Write Python with braces and semicolons; .pyj files run transparently and tracebacks point back to the source
+Project-URL: Homepage, https://github.com/yyszh01/pyj
+Project-URL: Issues, https://github.com/yyszh01/pyj/issues
+Project-URL: Source, https://github.com/yyszh01/pyj
+Author: yyszh01
+License-Expression: MIT
+License-File: LICENSE
+Keywords: braces,curly-braces,import-hook,python,syntax,transpiler,whitespace
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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 :: Compilers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# pyj — Python with braces
+
+[![CI](https://github.com/yyszh01/pyj/actions/workflows/ci.yml/badge.svg)](https://github.com/yyszh01/pyj/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/pybrace)](https://pypi.org/project/pybrace/)
+![Python](https://img.shields.io/badge/python-3.10%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+English | [简体中文](https://github.com/yyszh01/pyj/blob/main/README.zh-CN.md)
+
+Write Python like JavaScript: blocks in `{ }`, statements separated by `;` or newlines, and no significant whitespace. `.pyj` files are converted to standard Python transparently at import and run time, and errors point back to the original `.pyj` lines and columns.
+
+```python
+def fib(n) { a, b = 0, 1; for _ in range(n) { a, b = b, a + b }; return a }
+
+if n < 0 { print("negative") } else if n == 0 { print("zero") }
+    else { print("positive") }
+```
+
+## Features
+
+- **Single file, zero dependencies**: the whole tool is one `pyj.py` that uses only the standard library.
+- **Transparent execution**: once installed, `python app.pyj` just works, any program can `import` a `.pyj` module, and `.py` and `.pyj` files can be mixed freely.
+- **Errors point to your source**: tracebacks, syntax errors and `inspect.getsource` all show `.pyj` lines and columns.
+- **Dicts and sets work as usual**: pyj tells a block `{` apart from a literal `{`.
+- **Cross-platform**: Python 3.10+, tested in CI on Linux, macOS and Windows.
+
+## Installation
+
+### With pip (recommended)
+
+```bash
+pip install pybrace
+```
+
+After installing, every Python process in that environment understands `.pyj` files. `pip uninstall pybrace` removes it completely. The package is named `pybrace` on PyPI, but the module and the command are both `pyj`.
+
+```bash
+python app.pyj arg1 arg2           # run directly
+python -c "import mymod"           # import any .pyj module; packages can use __init__.pyj
+pyj build app.pyj                  # convert to app.py
+```
+
+- `.pyj` and `.py` modules can import each other. If both `foo.py` and `foo.pyj` exist, `foo.pyj` wins.
+- Compiled code is cached in `__pycache__/<module>.pyj.cpython-XY.pyc`. The cache is invalidated when the source file or pyj itself changes.
+- How `python app.pyj` works: at startup Python runs `pyj_autoload.pth` from site-packages. When it sees that the script is a `.pyj` file, it replaces the process with `python -m pyj app.pyj` (on Windows it starts a child process instead). Interpreter flags are preserved.
+
+### Single file, no pip
+
+Put `pyj.py` anywhere and run:
+
+```bash
+python pyj.py install     # writes pyj_autoload.pth; same effect as pip install (inside a venv, only that venv)
+python pyj.py uninstall   # undo
+```
+
+### Without installing anything
+
+```bash
+python pyj.py run app.pyj [args...]    # or: python pyj.py app.pyj
+python pyj.py build app.pyj            # writes app.py
+python pyj.py build app.pyj -o -       # prints to stdout
+```
+
+From Python code:
+
+```python
+import pyj
+pyj.install_import_hook()                 # .pyj modules become importable
+print(pyj.transpile("if x { y() }"))
+code = pyj.compile_pyj(src, "file.pyj")   # code object with positions mapped to the .pyj source
+```
+
+## Error locations
+
+Runtime exceptions, syntax errors, `inspect.getsource` and `linecache` all point to the exact **line and column** in the `.pyj` source. This holds even when several statements share a line or one expression spans several lines:
+
+```
+  File "util.pyj", line 3, in divide
+    return a /
+           ~~^
+           b }
+           ~
+ZeroDivisionError: division by zero
+```
+
+How it works: while converting, pyj records where each token came from in the source. It parses the generated code with `ast.parse`, rewrites every AST node's position back to the source position, and then compiles.
+
+## Syntax
+
+| Rule | Example |
+|---|---|
+| Blocks use `{ }`; indentation is free-form | `while x { x -= 1 }` |
+| The colon is optional | `def f(): { ... }` is the same as `def f() { ... }` |
+| Statements are separated by `;` | `a = 1; b = 2` |
+| A newline ends a statement when the statement is clearly complete | One statement per line needs no `;` |
+| Newlines inside brackets, or after a trailing operator or comma, are ignored | `total = 1 +`⏎`2` |
+| A line starting with `.` `,` `and` `or` etc. continues the previous line | `s = text`⏎`.strip()` |
+| `else if` is shorthand for `elif` | `} else if x {` |
+| Empty blocks get `pass` automatically | `class E {}` |
+| Dicts and sets are written as usual | `if k in {1, 2} { d = {} }` |
+
+**How does pyj tell blocks from dicts?** A `{` opens a block only when it ends the header of an `if/for/while/def/class/try/with/match/case…` statement, that is, when it follows a name, number, string, closing bracket, `:`, or `else/try/finally/except`. In Python an expression followed by `{` is never valid, so this is unambiguous.
+
+## Caveats
+
+- A line starting with `(`, `[`, `-` or `*` does **not** continue the previous line. This avoids the JavaScript pitfall where `a`⏎`(b)` becomes a function call. To continue a line, put the operator at the end of the line or wrap the expression in parentheses.
+- In a compound statement header written as `if x: {...}`, the `{` always opens a block. To put a dict expression after a one-line `if`, wrap it in a normal `{ }` block.
+- Comments are preserved. A comment in the middle of an expression is moved to the end of that statement's line.
+
+## Development
+
+```bash
+python -m unittest discover -s tests -v
+```
+
+## License
+
+[MIT](https://github.com/yyszh01/pyj/blob/main/LICENSE)

pybrace-0.1.0/README.md

@@ -0,0 +1,118 @@
+# pyj — Python with braces
+
+[![CI](https://github.com/yyszh01/pyj/actions/workflows/ci.yml/badge.svg)](https://github.com/yyszh01/pyj/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/pybrace)](https://pypi.org/project/pybrace/)
+![Python](https://img.shields.io/badge/python-3.10%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+English | [简体中文](https://github.com/yyszh01/pyj/blob/main/README.zh-CN.md)
+
+Write Python like JavaScript: blocks in `{ }`, statements separated by `;` or newlines, and no significant whitespace. `.pyj` files are converted to standard Python transparently at import and run time, and errors point back to the original `.pyj` lines and columns.
+
+```python
+def fib(n) { a, b = 0, 1; for _ in range(n) { a, b = b, a + b }; return a }
+
+if n < 0 { print("negative") } else if n == 0 { print("zero") }
+    else { print("positive") }
+```
+
+## Features
+
+- **Single file, zero dependencies**: the whole tool is one `pyj.py` that uses only the standard library.
+- **Transparent execution**: once installed, `python app.pyj` just works, any program can `import` a `.pyj` module, and `.py` and `.pyj` files can be mixed freely.
+- **Errors point to your source**: tracebacks, syntax errors and `inspect.getsource` all show `.pyj` lines and columns.
+- **Dicts and sets work as usual**: pyj tells a block `{` apart from a literal `{`.
+- **Cross-platform**: Python 3.10+, tested in CI on Linux, macOS and Windows.
+
+## Installation
+
+### With pip (recommended)
+
+```bash
+pip install pybrace
+```
+
+After installing, every Python process in that environment understands `.pyj` files. `pip uninstall pybrace` removes it completely. The package is named `pybrace` on PyPI, but the module and the command are both `pyj`.
+
+```bash
+python app.pyj arg1 arg2           # run directly
+python -c "import mymod"           # import any .pyj module; packages can use __init__.pyj
+pyj build app.pyj                  # convert to app.py
+```
+
+- `.pyj` and `.py` modules can import each other. If both `foo.py` and `foo.pyj` exist, `foo.pyj` wins.
+- Compiled code is cached in `__pycache__/<module>.pyj.cpython-XY.pyc`. The cache is invalidated when the source file or pyj itself changes.
+- How `python app.pyj` works: at startup Python runs `pyj_autoload.pth` from site-packages. When it sees that the script is a `.pyj` file, it replaces the process with `python -m pyj app.pyj` (on Windows it starts a child process instead). Interpreter flags are preserved.
+
+### Single file, no pip
+
+Put `pyj.py` anywhere and run:
+
+```bash
+python pyj.py install     # writes pyj_autoload.pth; same effect as pip install (inside a venv, only that venv)
+python pyj.py uninstall   # undo
+```
+
+### Without installing anything
+
+```bash
+python pyj.py run app.pyj [args...]    # or: python pyj.py app.pyj
+python pyj.py build app.pyj            # writes app.py
+python pyj.py build app.pyj -o -       # prints to stdout
+```
+
+From Python code:
+
+```python
+import pyj
+pyj.install_import_hook()                 # .pyj modules become importable
+print(pyj.transpile("if x { y() }"))
+code = pyj.compile_pyj(src, "file.pyj")   # code object with positions mapped to the .pyj source
+```
+
+## Error locations
+
+Runtime exceptions, syntax errors, `inspect.getsource` and `linecache` all point to the exact **line and column** in the `.pyj` source. This holds even when several statements share a line or one expression spans several lines:
+
+```
+  File "util.pyj", line 3, in divide
+    return a /
+           ~~^
+           b }
+           ~
+ZeroDivisionError: division by zero
+```
+
+How it works: while converting, pyj records where each token came from in the source. It parses the generated code with `ast.parse`, rewrites every AST node's position back to the source position, and then compiles.
+
+## Syntax
+
+| Rule | Example |
+|---|---|
+| Blocks use `{ }`; indentation is free-form | `while x { x -= 1 }` |
+| The colon is optional | `def f(): { ... }` is the same as `def f() { ... }` |
+| Statements are separated by `;` | `a = 1; b = 2` |
+| A newline ends a statement when the statement is clearly complete | One statement per line needs no `;` |
+| Newlines inside brackets, or after a trailing operator or comma, are ignored | `total = 1 +`⏎`2` |
+| A line starting with `.` `,` `and` `or` etc. continues the previous line | `s = text`⏎`.strip()` |
+| `else if` is shorthand for `elif` | `} else if x {` |
+| Empty blocks get `pass` automatically | `class E {}` |
+| Dicts and sets are written as usual | `if k in {1, 2} { d = {} }` |
+
+**How does pyj tell blocks from dicts?** A `{` opens a block only when it ends the header of an `if/for/while/def/class/try/with/match/case…` statement, that is, when it follows a name, number, string, closing bracket, `:`, or `else/try/finally/except`. In Python an expression followed by `{` is never valid, so this is unambiguous.
+
+## Caveats
+
+- A line starting with `(`, `[`, `-` or `*` does **not** continue the previous line. This avoids the JavaScript pitfall where `a`⏎`(b)` becomes a function call. To continue a line, put the operator at the end of the line or wrap the expression in parentheses.
+- In a compound statement header written as `if x: {...}`, the `{` always opens a block. To put a dict expression after a one-line `if`, wrap it in a normal `{ }` block.
+- Comments are preserved. A comment in the middle of an expression is moved to the end of that statement's line.
+
+## Development
+
+```bash
+python -m unittest discover -s tests -v
+```
+
+## License
+
+[MIT](https://github.com/yyszh01/pyj/blob/main/LICENSE)

pybrace-0.1.0/README.zh-CN.md

@@ -0,0 +1,117 @@
+# pyj — 用花括号写 Python
+
+[![CI](https://github.com/yyszh01/pyj/actions/workflows/ci.yml/badge.svg)](https://github.com/yyszh01/pyj/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/pybrace)](https://pypi.org/project/pybrace/)
+![Python](https://img.shields.io/badge/python-3.10%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+[English](https://github.com/yyszh01/pyj/blob/main/README.md) | 简体中文
+
+不用管换行和缩进，像 JS 一样写 Python。`.pyj` 文件在运行时透明地转换成标准 Python，报错直接指回 `.pyj` 源码的行号和列号。
+```python
+def fib(n) { a, b = 0, 1; for _ in range(n) { a, b = b, a + b }; return a }
+
+if n < 0 { print("负数") } else if n == 0 { print("零") }
+    else { print("正数") }
+```
+
+## 特点
+
+- **单文件、零依赖**：整个工具就是一个 `pyj.py`，只用标准库。
+- **透明运行**：安装后 `python app.pyj` 直接跑，任何程序都能 `import` `.pyj` 模块，`.py` 和 `.pyj` 可以混用。
+- **报错指回源码**：traceback、语法错误、`inspect.getsource` 都显示 `.pyj` 源码的行和列。
+- **字典、集合照常写**：能自动区分代码块的 `{` 和字面量的 `{`。
+- **跨平台**：Python 3.10+，在 Linux / macOS / Windows 上由 CI 测试。
+
+## 安装
+
+### 用 pip 安装（推荐）
+
+```bash
+pip install pybrace
+```
+
+装好后当前 Python 环境里的所有进程都自动支持 `.pyj`，`pip uninstall pybrace` 即可完全移除。PyPI 上的包名是 `pybrace`，模块名和命令仍然是 `pyj`。
+
+```bash
+python app.pyj arg1 arg2           # 直接运行
+python -c "import mymod"           # import 任意 .pyj 模块，包可以用 __init__.pyj
+pyj build app.pyj                  # 转成 app.py
+```
+
+- `.pyj` 和 `.py` 可以互相 import；同名时 `.pyj` 优先。
+- 编译结果缓存在 `__pycache__/<模块名>.pyj.cpython-XY.pyc`；源文件或 pyj 本身改动后会自动失效。
+- `python app.pyj` 的原理：Python 启动时会执行 site-packages 中的 `pyj_autoload.pth`，它发现启动的是 `.pyj` 文件，就把进程替换成 `python -m pyj app.pyj`（Windows 上是启动子进程），解释器参数原样保留。
+
+### 只下载单个文件
+
+把 `pyj.py` 放到任意位置即可：
+
+```bash
+python pyj.py install     # 写入 pyj_autoload.pth，效果同 pip 安装（在 venv 中运行则只装进该 venv）
+python pyj.py uninstall   # 卸载
+```
+
+### 不安装也能用
+
+```bash
+python3 pyj.py run  app.pyj [参数...]   # 或 python3 pyj.py app.pyj
+python3 pyj.py build app.pyj            # 生成 app.py
+python3 pyj.py build app.pyj -o -       # 输出到终端
+```
+
+在 Python 代码里使用：
+
+```python
+import pyj
+pyj.install_import_hook()          # 之后可以 import .pyj 模块
+print(pyj.transpile("if x { y() }"))
+code = pyj.compile_pyj(src, "file.pyj")   # 位置已映射回源码的 code 对象
+```
+
+## 报错定位
+
+运行时异常、语法错误、`inspect.getsource`、`linecache` 都直接指向 `.pyj` 源码的**行号和列号**，即使多条语句写在同一行、一个表达式跨了多行也一样准确：
+
+```
+  File "util.pyj", line 3, in 除法
+    return a /
+           ~~^
+           b }
+           ~
+ZeroDivisionError: division by zero
+```
+
+原理：转译时记录每个记号在生成代码和源码中的位置，用 `ast.parse` 解析生成的代码后，把每个 AST 节点的位置改写回源码位置，再编译。
+
+## 语法规则
+
+| 规则 | 示例 |
+|---|---|
+| 代码块用 `{ }`，缩进随意 | `while x { x -= 1 }` |
+| 冒号可写可不写 | `def f(): { ... }` 等同 `def f() { ... }` |
+| 语句用 `;` 分隔 | `a = 1; b = 2` |
+| 换行时语句明显结束会自动断句 | 每行一条语句可以省略 `;` |
+| 括号里、或行尾是运算符/逗号时，换行被忽略 | `total = 1 +`⏎`2` |
+| 下一行以 `.` `,` `and` `or` 等开头时接上一行 | `s = text`⏎`.strip()` |
+| `else if` 是 `elif` 的语法糖 | `} else if x {` |
+| 空代码块自动补 `pass` | `class E {}` |
+| 字典/集合照常写 | `if k in {1, 2} { d = {} }` |
+
+**如何区分代码块和字典？** 只有当 `{` 出现在 `if/for/while/def/class/try/with/match/case…` 语句头部末尾（前面是名字、数字、字符串、右括号、`:`，或 `else/try/finally/except`）时才是代码块。在 Python 里 `表达式 {` 本来就不合法，所以不会产生歧义。
+
+## 注意事项
+
+- 下一行以 `(`、`[`、`-`、`*` 开头时**不会**接到上一行（避免 JS 那种 `a`⏎`(b)` 被当成函数调用的坑）。需要时把运算符放在行尾，或用括号包起来。
+- 复合语句头部写成 `if x: {...}` 时，`{` 总被当成代码块；如果真想在单行 `if` 后写一个字典表达式语句，请用普通的 `{ }` 块包一层。
+- 注释会保留；表达式中间的注释会被移到该语句行尾。
+
+## 开发
+
+```bash
+python -m unittest discover -s tests -v
+```
+
+## 许可证
+
+[MIT](https://github.com/yyszh01/pyj/blob/main/LICENSE)

pybrace-0.1.0/examples/demo.pyj

@@ -0,0 +1,35 @@
+# pyj 示例：随便换行、随便缩进
+import math; from dataclasses import dataclass
+
+@dataclass
+class Point { x: float; y: float
+  def dist(self, other) -> float { return math.hypot(self.x - other.x,
+                                                     self.y - other.y) } }
+
+def fib(n) { a, b = 0, 1; for _ in range(n) { a, b = b, a + b }; return a }
+
+def classify(n) {
+if n < 0 { return "负数" } else if n == 0 { return "零" }
+    else { return "正数" }
+}
+
+config = {"name": "pyj", "tags": {"a", "b"}}   # 字典和集合照常用
+if "pyj" in {config["name"]} { print(f"hello {config['name']}! {{literal}} {len({1, 2})}") }
+
+total = 1 +
+    2 +
+    3
+print(total)
+
+p = Point(0, 0); q = Point(3, 4)
+print(p.dist(q), [fib(i) for i in range(10)], classify(-5), classify(0), classify(7))
+
+try { 1 / 0 } except ZeroDivisionError as e { print("捕获:", e) } finally { print("finally") }
+
+def http(code) { match code { case 200 | 201 { return "ok" } case _ { return "err" } } }
+print(http(200), http(500))
+
+class Empty {}
+while False {}
+squares = {k: k * k for k in range(4)}
+print(squares)