bracket-lang 0.1.0__tar.gz

bracket_lang-0.1.0/LICENSE

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

bracket_lang-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: bracket-lang
+Version: 0.1.0
+Requires-Python: >=3.8
+License-File: LICENSE
+Dynamic: license-file
+Dynamic: requires-python

bracket_lang-0.1.0/README.md

@@ -0,0 +1,106 @@
+# bracket
+python制作的转译型简单编程语言
+
+## 1 安装
+```bash
+pip install bracket
+```
+
+## 2 Hello world
+```bracket
+[INFO] ["Hello world!"]
+```
+
+## 3 基本语法
+```bracket
+# 打印
+[INFO] ["这是一段文本"]
+[INFO] ["Loading...", end=" "]
+[INFO] ["complete"]
+
+# 变量
+[VAR] [integer] [2]
+[VAR] [floating_point] [3.0]
+[VAR] [string] ["abc"]
+[VAR] [lst] [[1, 2, 3, 4, 5]]
+[VAR] [t] [(1, 2, 3)]
+[VAR] [dict] [{1: 1, 2: 4, 3: 9}]
+[INFO] [integer, floating_point, string, lst, t, dict]
+
+# 输入
+[VAR] [short] [INPUT] [单行文本] [False]
+[VAR] [long] [INPUT] [多行文本] [True]
+[INFO] ["您这两次分别输入了: "]
+[INFO] [short]
+[INFO] [long]
+
+# 分支语句
+[VAR] [a] [6]
+[IF] [a>0]
+    [INFO] ["正数"]
+[ELSEIF] [a==0]
+    [INFO] ["零"]
+[ELSE]
+    [INFO] ["负数"]
+
+# 循环
+[VAR] [total] [0]
+[FOR] [i] [1, 101, 1]
+    [VAR] [total] [total+i]
+[INFO] ["1~100的和:", total]
+[VAR] [i] [0]
+[WHILE] [i<10]
+    [INFO] [i]
+    [VAR] [i] [i+1]
+[LOOP]
+    [INFO] [i]
+    [IF] [i==100]
+        [BREAK]
+    [VAR] [i] [i+1]
+
+# GUI
+[USE] [TKGUI]
+[VAR] [root] [TKGUI.Tk()]
+root.title("Hello bracket")
+root.geometry("300x200")
+[VAR] [label] [TKGUI.Label(root, text="Hello, World!")]
+label.pack()
+root.mainloop()
+```
+输出: 
+```text
+这是一段文本
+Loading... complete
+2 3.0 abc [1, 2, 3, 4, 5] (1, 2, 3) {1: 1, 2: 4, 3: 9}
+单行文本: 1
+多行文本: 2
+3
+您这两次分别输入了
+1
+2
+3
+正数
+5050
+1
+2
+3
+...
+100
+```
+![窗口显示: ](./TKGUI_helloHello.jpg)
+
+## 4 命令行工具参数
+| 参数 | 用法 |
+| ------ | ------ |
+| `--help` `-h` | 帮助 |
+| `build` | 转译 |
+| `run` | 转译运行 |
+
+## 6 注意事项
+1. `INFO`的参数与python的`print`基本相同
+2. `[VAR] [lst] [[1, 2, 3, 4, 5]]`是真正的列表, `[VAR] [t] [1, 2, 3, 4, 5]`是元组
+3. `FOR`必须要写三个参数
+4. `[LOOP]`是无限循环, 与`[WHILE] [True]`等效
+5. 变量名不能与bracket关键字和python关键字重名
+6. bracket语言不兼容python的列表推导式, 三元表达式等
+7. bracket内置轻量编辑器bkted

bracket_lang-0.1.0/bracket/BRANCH.py

@@ -0,0 +1,49 @@
+#!/usr/bin/env python3
+# bracket/BRANCH.py
+# manage the branch sentences
+
+# [IF] [<cond>] → if <cond>:
+def IF_to_if(code: str):
+    code = code.lstrip()
+    keyword, cond = code.split(" ", 1)
+    if keyword!="[IF]":
+        raise SyntaxError(f"Expect `[IF]` got {keyword}")
+    text = cond.removeprefix("[").removesuffix("]")
+    return f"if {text}:"
+
+# [ELSEIF] [<cond>] → elif <cond>:
+def ELSEIF_to_elif(code: str):
+    code = code.lstrip()
+    keyword, cond = code.split(" ", 1)
+    if keyword!="[ELSEIF]":
+        raise SyntaxError(f"Expect `[ELSEIF]` got {keyword}")
+    text = cond.removeprefix("[").removesuffix("]")
+    return f"elif {text}:"
+
+# [ELSE] → else:
+def ELSE_to_else(code: str):
+    code = code.lstrip()
+    if code!="[ELSE]":
+        raise SyntaxError(f"Expect `[ELSE]` got {code}")
+    return "else:"
+
+def transpile_line(line: str):
+    indent = len(line) - len(line.lstrip())
+    stripped = line.lstrip()
+    if not stripped:
+        return ""
+    if stripped.startswith("[IF]"):
+        return " " * indent + IF_to_if(stripped)
+    elif stripped.startswith("[ELSEIF]"):
+        return " " * indent + ELSEIF_to_elif(stripped)
+    elif stripped == "[ELSE]":
+        return " " * indent + ELSE_to_else(stripped)
+    else:
+        return " " * indent + f"# UNKNOWN: {stripped}"
+
+def transpile(code: str):
+    lines = code.splitlines()
+    result = []
+    for line in lines:
+        result.append(transpile_line(line))
+    return "\n".join(result)

bracket_lang-0.1.0/bracket/IMPORTLIB.py

@@ -0,0 +1,14 @@
+# bracket/IMPORTLIB.py
+# manage libraries importing
+
+# [USE] [<lib>] → import <lib>
+def USE_to_import(code: str):
+    code = code.lstrip()
+    keyword, lib = code.split(" ", 1)
+    if keyword!="[USE]":
+        raise SyntaxError(f"Expect `[USE]` got {keyword}")
+    key = lib.removeprefix("[").removesuffix("]")
+    lib_dict = {
+        "TKGUI": "tkinter as TKGUI"
+    }
+    return f"import {lib_dict[key]}"

bracket_lang-0.1.0/bracket/IO.py

@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+# bracket/IO.py
+# manage I/O operation
+
+# [INFO] [<text>] → print(<text>)
+def INFO_to_print(code: str):
+    code = code.lstrip()
+    keyword, text = code.split(" ", 1)
+    if keyword!="[INFO]":
+        raise SyntaxError(f"Expected `INFO` got `{keyword}`.")
+    text = text.removeprefix("[").removesuffix("]")
+    return f"print({text})"
+
+# [VAR] [<var name>] [INPUT] [<tip word> (don't need quotation marks)] [<multilines> (bool)] → var = input(<tip word>)
+def INPUT_to_input(code: str) -> str:
+    code = code.lstrip()
+    rest = code.split(" ", 1)[1]
+    inner = rest.removeprefix("[").removesuffix("]")
+    parts = inner.split("] [")
+    if len(parts) != 4:
+        raise SyntaxError("Usage: [VAR] [<var name>] [INPUT] [<tip word> (don't need quotation marks)] [<multilines> (bool)]")
+    var_name = parts[0].strip()
+    keyword = parts[1]
+    tip_word = parts[2].strip()
+    multilines = parts[3].lower() in ("true", "1", "yes", "on")
+    if not var_name:
+        raise SyntaxError("Var name cannot be empty.")
+    if not var_name.isidentifier():
+        raise SyntaxError(f"Invalid var name: {var_name}.")
+    if keyword != "INPUT":
+        raise SyntaxError(f"Expected `INPUT`, got `{keyword}`.")
+    if not tip_word:
+        raise SyntaxError("Tip word cannot be empty")
+    if multilines:
+        return f'''\
+print("{tip_word} (use EOF to finish)")
+lines = []
+while True:
+    try:
+        line = input()
+    except EOFError:
+        break
+    except KeyboardInterrupt:
+        print("\\nCanceled input.")
+        break
+    lines.append(line)
+{var_name} = "\\n".join(lines)
+'''
+    else:
+        return f'{var_name} = input("{tip_word}: ")'
+
+def transpile_line(line: str): #Transpile one line of bracket code and handle the tabs.
+    indent = len(line) - len(line.lstrip())
+    stripped = line.lstrip()
+
+    if stripped.startswith("[INFO]"):
+        return " " * indent + INFO_to_print(stripped)
+    elif "[INPUT]" in stripped:
+        return " " * indent + INPUT_to_input(stripped)
+    elif stripped.startswith("[VAR]"):
+        return " " * indent + VAR_to_varname_equal(stripped)
+    else:
+        return " " * indent + f"# UNKNOWN: {stripped}"
+
+
+def transpile(code: str) -> str: #Transpile multiple lines of bracket code.
+    """转译多行 bracket 代码"""
+    lines = code.splitlines()
+    result = []
+    for line in lines:
+        if line.strip() == "":
+            result.append("")
+        else:
+            result.append(transpile_line(line))
+    return "\n".join(result)

bracket_lang-0.1.0/bracket/LOOP.py

@@ -0,0 +1,76 @@
+#!/usr/bin/env python3
+# bracket/LOOP.py
+# manage the loop sentences
+
+# [FOR] [<range var>] [<start>, <end>, <step length>] → for <range var> in range(<start>, <end>, <step length>)
+def FOR_to_for(code: str) -> str:
+    code = code.lstrip()
+    keyword, rest = code.split(" ", 1)
+    if keyword != "[FOR]":
+        raise SyntaxError(f"Expected `[FOR]` got `{keyword}`")
+    var_part, range_part = rest.split(" ", 1)
+    var = var_part.removeprefix("[").removesuffix("]")
+    range_args = range_part.removeprefix("[").removesuffix("]")
+    parts = [p.strip() for p in range_args.split(",")]
+    if len(parts)!=3:
+        raise SyntaxError("[FOR] needs 3 range arguments")
+    start, end, step = parts
+    return f"for {var} in range({start}, {end}, {step}):"
+
+# [WHILE] [<cond>] → while <cond>:
+def WHILE_to_while(code: str):
+    code = code.lstrip()
+    keyword, cond = code.split(" ", 1)
+    if keyword!="[WHILE]":
+        raise SyntaxError(f"Expect `[WHILE]` got {keyword}")
+    text = cond.removeprefix("[").removesuffix("]")
+    return f"while {text}:"
+
+# [LOOP] → while True:
+def LOOP_to_while_True(code: str):
+    code = code.lstrip()
+    if code!="[LOOP]":
+        raise SyntaxError(f"Expect `[LOOP]` got {code}")
+    return "while True:"
+
+# [CONTINUE] → continue
+def CONTINUE_to_continue(code: str):
+    code = code.lstrip()
+    if code!="[CONTINUE]":
+        raise SyntaxError(f"Expect `[CONTINUE]` got {code}")
+    return "continue"
+
+# [BREAK] → break
+def BREAK_to_break(code: str):
+    code = code.lstrip()
+    if code!="[BREAK]":
+        raise SyntaxError(f"Expect `[BREAK]` got {code}")
+    return "break"
+
+def transpile_line(line: str) -> str:
+    indent = len(line) - len(line.lstrip())
+    stripped = line.lstrip()
+    if not stripped:
+        return ""
+    if stripped.startswith("[FOR]"):
+        return " " * indent + FOR_to_for(stripped)
+    elif stripped.startswith("[WHILE]"):
+        return " " * indent + WHILE_to_while(stripped)
+    elif stripped == "[LOOP]":
+        return " " * indent + LOOP_to_while_True(stripped)
+    elif stripped == "[BREAK]":
+        return " " * indent + BREAK_to_break(stripped)
+    elif stripped == "[CONTINUE]":
+        return " " * indent + CONTINUE_to_continue(stripped)
+    else:
+        return " " * indent + f"# UNKNOWN: {stripped}"
+
+def transpile(code: str):
+    lines = code.splitlines()
+    result = []
+    for line in lines:
+        if line.strip():
+            result.append(transpile_line(line))
+        else:
+            result.append("")
+    return "\n".join(result)

bracket_lang-0.1.0/bracket/VAR.py

@@ -0,0 +1,45 @@
+#!/usr/bin/env python3
+# bracket/VAR.py
+# manage variables
+
+# [VAR] [<var name>] [<value>] → <var name> = <value>
+def VAR_to_varname_equal(code: str):
+    code = code.lstrip()
+    keyword, rest = code.split(" ", 1)
+    if keyword!="[VAR]":
+        raise SyntaxError(f"Expected `VAR` got `{keyword}`.")
+    inner = rest.removeprefix("[").removesuffix("]")
+    parts = inner.split("] [")
+    if len(parts) != 2:
+        raise SyntaxError("Usage: [VAR] [<var name>] [<value>]")
+    var_name = parts[0].strip()
+    value = parts[1].strip()
+    if not var_name:
+        raise SyntaxError("Var name cannot be empty.")
+    dangerous_list = ["INFO", "VAR", "INPUT", "IF", "ELSEIF", "ELSE", "FOR", "WHILE", "LOOP", "print", "input", "int", "float", "str", "def", "class", "exec", "import", "__import__"]
+    if not var_name.isidentifier():
+        raise SyntaxError(f"Invalid var name: {var_name}.")
+    if var_name in dangerous_list:
+        raise SyntaxError(f"Invalid var name: {var_name}.")
+    if not value:
+        raise SyntaxError("Value cannot be empty.")
+    return f"{var_name} = {value}"
+
+def transpile_line(line: str) -> str:
+    """转译一行 bracket 代码，自动处理缩进"""
+    indent = len(line) - len(line.lstrip())
+    stripped = line.lstrip()
+    if not stripped:
+        return ""
+    if stripped.startswith("[VAR]"):
+        return " " * indent + VAR_to_varname_equal(stripped)
+    else:
+        return " " * indent + f"# UNKNOWN: {stripped}"
+
+def transpile(code: str) -> str:
+    """转译多行 bracket 代码"""
+    lines = code.splitlines()
+    result = []
+    for line in lines:
+        result.append(transpile_line(line))
+    return "\n".join(result)

bracket_lang-0.1.0/bracket/__init__.py

@@ -0,0 +1,5 @@
+# bracket/__init__.py
+from .transpile import transpile, transpile_line
+from .cli import main
+
+__all__ = ["transpile", "transpile_line", "main"]

bracket_lang-0.1.0/bracket/bkted.py

@@ -0,0 +1,92 @@
+#!/usr/bin/python3
+# bracket/bkted.py
+# the editor of bracket-lang
+
+import tkinter as tk
+from tkinter import filedialog, scrolledtext, messagebox
+from .transpile import transpile
+import sys
+from io import StringIO
+
+class BracketEditor:
+    def __init__(self):
+        self.root = tk.Tk()
+        self.root.title("bkted - editor of btaracket")
+        self.root.geometry("800x600")
+
+        # Menu
+        menubar = tk.Menu(self.root)
+        file_menu = tk.Menu(menubar, tearoff=0)
+        file_menu.add_command(label="Open", command=self.open_file)
+        file_menu.add_command(label="Save", command=self.save_file)
+        file_menu.add_command(label="Transpile", command=self.show_transpile)
+        file_menu.add_command(label="Run", command=self.run_code)
+        menubar.add_cascade(label="File", menu=file_menu)
+        self.root.config(menu=menubar)
+
+        # Edit area
+        self.text = scrolledtext.ScrolledText(self.root, font=("Courier", 12))
+        self.text.pack(fill=tk.BOTH, expand=True)
+
+    def open_file(self):
+        path = filedialog.askopenfilename(filetypes=[("bracket file", "*.bracket")])
+        if path:
+            with open(path, "r", encoding="utf-8") as f:
+                self.text.delete("1.0", tk.END)
+                self.text.insert("1.0", f.read())
+
+    def save_file(self):
+        path = filedialog.asksaveasfilename(defaultextension=".bracket")
+        if path:
+            with open(path, "w", encoding="utf-8") as f:
+                f.write(self.text.get("1.0", tk.END))
+
+    def show_transpile(self):
+        """Transpile only and display the result"""
+        code = self.text.get("1.0", tk.END)
+        try:
+            py_code = transpile(code)
+            self._show_output("Transpile result", py_code)
+        except Exception as e:
+            import traceback
+            self._show_output("Transpile error", traceback.format_exc())
+
+    def run_code(self):
+        """Transpile and run"""
+        code = self.text.get("1.0", tk.END)
+        try:
+            py_code = transpile(code)
+
+            # Catch the output
+            old_stdout = sys.stdout
+            sys.stdout = StringIO()
+
+            # Run the transpiled code
+            exec(py_code, {})
+
+            output = sys.stdout.getvalue()
+            sys.stdout = old_stdout
+
+            # Display the running result
+            self._show_output("Running result", output or "[No output]")
+
+        except Exception as e:
+            import traceback
+            sys.stdout = old_stdout
+            self._show_output("Runtime error", traceback.format_exc())
+
+    def _show_output(self, title: str, content: str):
+        """Create a window and display the content"""
+        win = tk.Toplevel(self.root)
+        win.title(title)
+        win.geometry("600x400")
+        text = scrolledtext.ScrolledText(win, font=("Courier", 12))
+        text.pack(fill=tk.BOTH, expand=True)
+        text.insert("1.0", content)
+
+    def run(self):
+        self.root.mainloop()
+
+if __name__ == "__main__":
+    editor = BracketEditor()
+    editor.run()

bracket_lang-0.1.0/bracket/cli.py

@@ -0,0 +1,39 @@
+#!/usr/bin/env python3
+# bracket/cli.py
+# CLI entertainment of bracket-lang
+
+import sys
+import argparse
+from .transpile import transpile
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="bracket",
+        description="bracket-lang transpiler",
+        epilog="for example: bracket run main.bracket"
+    )
+    subparsers = parser.add_subparsers(dest="command", required=True)
+    # run command
+    run_parser = subparsers.add_parser("run", help="run .bracket file")
+    run_parser.add_argument("file", help="the .bracket file you want to run")
+    # build command
+    build_parser = subparsers.add_parser("build", help="transpile .bracket file to .py")
+    build_parser.add_argument("file", help="the .bracket file you want to transpile")
+    build_parser.add_argument("-o", "--output", help="output file name(default same name .py)")
+    args = parser.parse_args()
+    if args.command == "run":
+        with open(args.file, "r", encoding="utf-8") as f:
+            code = f.read()
+        py_code = transpile(code)
+        exec(py_code)
+    elif args.command == "build":
+        with open(args.file, "r", encoding="utf-8") as f:
+            code = f.read()
+        py_code = transpile(code)
+        output = args.output or args.file.replace(".bracket", ".py")
+        with open(output, "w", encoding="utf-8") as f:
+            f.write(py_code)
+        print(f"✓ transpile finished: {output}")
+
+if __name__ == "__main__":
+    main()

bracket_lang-0.1.0/bracket/transpile.py

@@ -0,0 +1,62 @@
+#!/usr/bin/env python3
+# bracket/transpile.py
+# Unification transpile interface
+
+import keyword
+
+from .IO import INFO_to_print, INPUT_to_input
+from .VAR import VAR_to_varname_equal
+from .BRANCH import IF_to_if, ELSEIF_to_elif, ELSE_to_else
+from .LOOP import (
+    FOR_to_for,
+    WHILE_to_while,
+    LOOP_to_while_True,
+    BREAK_to_break,
+    CONTINUE_to_continue,
+)
+from .IMPORTLIB import USE_to_import
+
+
+def transpile_line(line: str) -> str:
+    indent = len(line) - len(line.lstrip())
+    stripped = line.lstrip().split("#")[0].rstrip()
+    if not stripped:
+        return ""
+    for i in keyword.kwlist:
+        if i in stripped:
+            raise SyntaxError("Sorry, we don't support python syntax.")
+    if stripped.startswith("[USE]"):
+        return " " * indent + USE_to_import(stripped)
+    elif stripped.startswith("[FOR]"):
+        return " " * indent + FOR_to_for(stripped)
+    elif stripped.startswith("[WHILE]"):
+        return " " * indent + WHILE_to_while(stripped)
+    elif stripped == "[LOOP]":
+        return " " * indent + LOOP_to_while_True(stripped)
+    elif stripped == "[BREAK]":
+        return " " * indent + BREAK_to_break(stripped)
+    elif stripped == "[CONTINUE]":
+        return " " * indent + CONTINUE_to_continue(stripped)
+    elif stripped.startswith("[IF]"):
+        return " " * indent + IF_to_if(stripped)
+    elif stripped.startswith("[ELSEIF]"):
+        return " " * indent + ELSEIF_to_elif(stripped)
+    elif stripped == "[ELSE]":
+        return " " * indent + ELSE_to_else(stripped)
+    elif "[INPUT]" in stripped:
+        return " " * indent + INPUT_to_input(stripped)
+    elif stripped.startswith("[VAR]"):
+        return " " * indent + VAR_to_varname_equal(stripped)
+    elif stripped.startswith("[INFO]"):
+        return " " * indent + INFO_to_print(stripped)
+    return " " * indent + line
+
+def transpile(code: str) -> str:
+    lines = code.splitlines()
+    result = []
+    for line in lines:
+        if line.strip():
+            result.append(transpile_line(line))
+        else:
+            result.append("")
+    return "\n".join(result)

bracket_lang-0.1.0/bracket_lang.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: bracket-lang
+Version: 0.1.0
+Requires-Python: >=3.8
+License-File: LICENSE
+Dynamic: license-file
+Dynamic: requires-python

bracket_lang-0.1.0/bracket_lang.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+LICENSE
+README.md
+setup.py
+bracket/BRANCH.py
+bracket/IMPORTLIB.py
+bracket/IO.py
+bracket/LOOP.py
+bracket/VAR.py
+bracket/__init__.py
+bracket/bkted.py
+bracket/cli.py
+bracket/transpile.py
+bracket_lang.egg-info/PKG-INFO
+bracket_lang.egg-info/SOURCES.txt
+bracket_lang.egg-info/dependency_links.txt
+bracket_lang.egg-info/entry_points.txt
+bracket_lang.egg-info/top_level.txt

bracket_lang-0.1.0/bracket_lang.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bracket_lang-0.1.0/bracket_lang.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bracket = bracket.cli:main

bracket_lang-0.1.0/bracket_lang.egg-info/top_level.txt

@@ -0,0 +1 @@
+bracket

bracket_lang-0.1.0/setup.cfg

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

bracket_lang-0.1.0/setup.py

@@ -0,0 +1,14 @@
+# setup.py
+from setuptools import setup, find_packages
+
+setup(
+    name="bracket-lang",
+    version="0.1.0",
+    packages=find_packages(),
+    entry_points={
+        "console_scripts": [
+            "bracket = bracket.cli:main",
+        ],
+    },
+    python_requires=">=3.8",
+)