ScratchAnalyzer 0.1.0__py3-none-any.whl

ScratchAnalyzer/assets/translator.python.json

@@ -0,0 +1,126 @@
+{
+    "motion_gotoxy": "await Scratch.goto_by_pos(instance, %[X]%, %[Y]%)",
+    "motion_glideto": "await Scratch.glide_to(instance, %[SECS]%, %[TO]%)",
+    "motion_turnright": "await Scratch.turn_right(instance, %[DEGREES]%)",
+    "motion_turnleft": "await Scratch.turn_left(instance, %[DEGREES]%)",
+    "motion_movesteps": "await Scratch.move_steps(instance, %[STEPS]%)",
+    "motion_goto": "await Scratch.goto(instance, %[TO]%)",
+    "motion_glidesecstoxy": "await Scratch.glide_to_xy(instance, %[SECS]%, %[X]%, %[Y]%)",
+    "motion_pointtowards": "await Scratch.set_direction_to(instance, %[TOWARDS]%)",
+    "motion_pointindirection": "await Scratch.set_direction(instance, %[DIRECTION]%)",
+    "motion_changexby": "await Scratch.change_x_by(instance, %[DX]%)",
+    "motion_setx": "await Scratch.set_x(instance, %[X]%)",
+    "motion_changeyby": "await Scratch.change_y_by(instance, %[DY]%)",
+    "motion_sety": "await Scratch.set_y(instance, %[Y]%)",
+    "motion_ifonedgebounce": "await Scratch.set_RWTE(instance)",
+    "motion_setrotationstyle": "await Scratch.set_rotation_style(instance, %[STYLE]%)",
+    "motion_xposition": "instance.x",
+    "motion_yposition": "instance.y",
+    "motion_direction": "instance.direction",
+    "looks_say": "await Scratch.say(instance, %[MESSAGE]%)",
+    "looks_sayforsecs": "await Scratch.say_for(instance, %[MESSAGE]%, %[SECS]%)",
+    "looks_switchcostumeto": "await Scratch.switch_costume_to(instance, %[COSTUME]%)",
+    "looks_nextcostume": "await Scratch.next_costume(instance)",
+    "looks_switchbackdropto": "await Scratch.switch_backdrop_to(instance, %[BACKDROP]%)",
+    "looks_nextbackdrop": "await Scratch.next_backdrop(instance)",
+    "looks_changesizeby": "await Scratch.change_size_by(instance, %[CHANGE]%)",
+    "looks_setsizeto": "await Scratch.set_size_to(instance, %[SIZE]%)",
+    "looks_seteffectto": "await Scratch.set_effect_to(instance, %[EFFECT]%, %[VALUE]%)",
+    "looks_changeeffectby": "await Scratch.change_effect_by(instance, %[EFFECT]%, %[CHANGE]%)",
+    "looks_cleargraphiceffects": "await Scratch.clear_effects(instance)",
+    "looks_show": "await Scratch.show(instance)",
+    "looks_hide": "await Scratch.hide(instance)",
+    "looks_gotofrontback": "await Scratch.move_to_by_layer_order(instance, %[FRONT_BACK]%)",
+    "looks_goforwardbackwardlayers": "await Scratch.move_by_by_layer_order(instance, %[NUM]%, %[FORWARD_BACKWARD]%)",
+    "looks_size": "instance.size",
+    "looks_costumenumbername": "Scratch.getCostume(instance, %[NUMBER_NAME]%)",
+    "looks_backdropnumbername": "Scratch.getBackdrop(instance, %[NUMBER_NAME]%)",
+    "sound_play": "await Scratch.play(instance, %[SOUND_MENU]%)",
+    "sound_playuntildone": "await Scratch.play_until_done(instance, %[SOUND_MENU]%)",
+    "sound_stopallsounds": "await Scratch.stop_all_from(instance)",
+    "sound_seteffectto": "await Scratch.set_sound_effect_to(instance, %[EFFECT]%, %[VALUE]%)",
+    "sound_changeeffectby": "await Scratch.change_sound_effect_by(instance, %[EFFECT]%, %[VALUE]%)",
+    "sound_cleareffects": "await Scratch.clear_sound_effects(instance)",
+    "sound_changevolumeby": "await Scratch.change_volume_by(instance, %[VOLUME]%)",
+    "sound_setvolumeto": "await Scratch.set_volume_to(instance, %[VOLUME]%)",
+    "sound_volume": "instance.sprite.volume",
+    "event_broadcast": "await Scratch.broadcast(instance, %[BROADCAST_INPUT]%)",
+    "event_broadcastandwait": "await Scratch.broadcast_and_wait(instance, %[BROADCAST_INPUT]%)",
+    "control_wait": "await Scratch.wait(instance, %[DURATION]%)",
+    "control_repeat": "for _ in range(Scratch.Cast.toNumber(%[TIMES]%)):",
+    "control_forever": "while True:",
+    "control_if": "if %[CONDITION]%:",
+    "control_if_else": "if %[CONDITION]%:",
+    "control_if_else_before_2": "else:",
+    "control_wait_until": "await Scratch.wait_until(instance, lambda instance: %[CONDITION]%)",
+    "control_repeat_until": "while not (%[CONDITION]%):",
+    "control_while": "while (%[CONDITION]%):",
+    "control_stop": "await Scratch.c_stop(instance, %[STOP_OPTION]%, task_id)",
+    "control_create_clone_of": "await Scratch.clone(instance, %[CLONE_OPTION]%)",
+    "control_delete_this_clone": "await Scratch.deleteThisClone(instance, task_id)",
+    "sensing_touchingobject": "Scratch.is_touching(instance, %[TOUCHINGOBJECTMENU]%)",
+    "sensing_touchingcolor": "Scratch.is_touching_color(instance, %[COLOR]%)",
+    "sensing_coloristouchingcolor": "Scratch.is_color_touching_color(%[COLOR]%, %[COLOR2]%)",
+    "sensing_distanceto": "Scratch.get_distance_to(instance, %[DISTANCETOMENU]%)",
+    "sensing_askandwait": "await Scratch.ask(instance, %[QUESTION]%)",
+    "sensing_answer": "Scratch.get_last_answer()",
+    "sensing_keypressed": "Scratch.is_key_pressed(%[KEY_OPTION]%)",
+    "sensing_mousedown": "Scratch.is_mouse_down()",
+    "sensing_mousex": "Scratch.get_mouse_x()",
+    "sensing_mousey": "Scratch.get_mouse_y()",
+    "sensing_setdragmode": "Scratch.set_drag_mode(instance, %[DRAG_MODE]%)",
+    "sensing_loudness": "(-1)",
+    "sensing_timer": "Scratch.getTimer()",
+    "sensing_resettimer": "Scratch.resetTimer()",
+    "sensing_of": "Scratch.obj_of_sprite(%[OBJECT]%, %[PROPERTY]%)",
+    "sensing_current": "Scratch.get_part_of_current_time(%[CURRENTMENU]%)",
+    "sensing_dayssince2000": "Scratch.get_days_since_2000()",
+    "sensing_username": "Scratch.get_user_name()",
+    "operator_add": "(Scratch.Cast.toNumber(%[NUM1]%, error=False) + Scratch.Cast.toNumber(%[NUM2]%, error=False))",
+    "operator_subtract": "(Scratch.Cast.toNumber(%[NUM1]%, error=False) - Scratch.Cast.toNumber(%[NUM2]%, error=False))",
+    "operator_multiply": "(Scratch.Cast.toNumber(%[NUM1]%, error=False) * Scratch.Cast.toNumber(%[NUM2]%, error=False))",
+    "operator_divide": "Scratch.safe_divide(Scratch.Cast.toNumber(%[NUM1]%, error=False), Scratch.Cast.toNumber(%[NUM2]%, error=False))",
+    "operator_random": "Scratch.randnum(Scratch.Cast.toNumber(%[FROM]%, error=False), Scratch.Cast.toNumber(%[TO]%, error=False))",
+    "operator_lt": "(Scratch.Cast.toNumber(%[OPERAND1]%, error=False) < Scratch.Cast.toNumber(%[OPERAND2]%, error=False))",
+    "operator_gt": "(Scratch.Cast.toNumber(%[OPERAND1]%, error=False) > Scratch.Cast.toNumber(%[OPERAND2]%, error=False))",
+    "operator_equals": "(Scratch.Cast.toVar(%[OPERAND1]%) == Scratch.Cast.toVar(%[OPERAND2]%))",
+    "operator_and": "(Scratch.Cast.toBool(%[OPERAND1]%) and Scratch.Cast.toBool(%[OPERAND2]%))",
+    "operator_or": "(Scratch.Cast.toBool(%[OPERAND1]%) or Scratch.Cast.toBool(%[OPERAND2]%))",
+    "operator_not": "(not Scratch.Cast.toBool(%[OPERAND]%))",
+    "operator_join": "(Scratch.Cast.toStr(%[STRING1]%) + Scratch.Cast.toStr(%[STRING2]%))",
+    "operator_letter_of": "Scratch.letter_of(Scratch.Cast.toStr(%[STRING]%), Scratch.Cast.toNumber(%[LETTER]%, error=False))",
+    "operator_length": "len(Scratch.Cast.toStr(%[STRING]%))",
+    "operator_contains": "(Scratch.Cast.toStr(%[STRING2]%).lower() in Scratch.Cast.toStr(%[STRING1]%).lower())",
+    "operator_mod": "Scratch.mod(Scratch.Cast.toNumber(%[NUM1]%, error=False), Scratch.Cast.toNumber(%[NUM2]%, error=False))",
+    "operator_round": "round(Scratch.Cast.toNumber(%[NUM]%, error=False))",
+    "operator_mathop": "Scratch.math_operation(%[OPERATOR]%, Scratch.Cast.toNumber(%[NUM]%, error=False))",
+    "data_variable": "Scratch.getVariable(instance, %[VARIABLE]%)",
+    "data_setvariableto": "Scratch.setVariable(instance, %[VARIABLE]%, %[VALUE]%)",
+    "data_changevariableby": "Scratch.changeVariableBy(instance, %[VARIABLE]%, %[VALUE]%)",
+    "data_showvariable": "# BLANK. OPCODE: data_showvariable",
+    "data_hidevariable": "# BLANK. OPCODE: data_hidevariable",
+    "data_listcontents": "Scratch.getList(instance, %[LIST]%)",
+    "data_addtolist": "Scratch.addToList(instance, %[LIST]%, %[ITEM]%)",
+    "data_deleteoflist": "Scratch.deleteIndexOfList(instance, %[LIST]%, %[INDEX]%)",
+    "data_deletealloflist": "Scratch.clearList(instance, %[LIST]%)",
+    "data_insertatlist": "Scratch.insetAtList(instance, %[LIST]%, Scratch.Cast.toNumber(%[INDEX]%, error=False), %[ITEM]%)",
+    "data_replaceitemoflist": "Scratch.replaceItemOfList(instance, %[LIST]%, Scratch.Cast.toNumber(%[INDEX]%, error=False), %[ITEM]%)",
+    "data_itemoflist": "Scratch.getItemOfList(instance, %[LIST]%, Scratch.Cast.toNumber(%[INDEX]%, error=False))",
+    "data_itemnumoflist": "Scratch.findIndexOfList(instance, %[LIST]%, %[ITEM]%)",
+    "data_lengthoflist": "Scratch.getLengthOfList(instance, %[LIST]%)",
+    "data_listcontainsitem": "Scratch.containItemOfList(instance, %[LIST]%, %[ITEM]%)",
+    "data_showlist": "# BLANK. OPCODE: data_showlist",
+    "data_hidelist": "# BLANK. OPCODE: data_hidelist",
+    "procedures_call": "await Scratch.call(%[FUNC_NAME]%, instance, task_id, %[ARGS]%)",
+    "argument_reporter_string_number": "Scratch.get_param(task_id, Scratch.Cast.toStr(%[VALUE]%))",
+    "argument_reporter_boolean": "Scratch.get_param(task_id, Scratch.Cast.toStr(%[VALUE]%))",
+    "pen_clear": "Scratch.pen_clear()",
+    "pen_penDown": "Scratch.pen_pen_down(instance)",
+    "pen_penUp": "Scratch.pen_pen_up(instance)",
+    "pen_setPenColorToColor": "Scratch.pen_set_color(instance, %[COLOR]%)",
+    "changePenColorParamBy": "Scratch.pen_change_color_param(instance, %[COLOR_PARAM]%, %[VALUE]%)",
+    "pen_setPenColorParamTo": "Scratch.pen_set_color_param(instance, %[COLOR_PARAM]%, %[VALUE]%)",
+    "pen_changePenSizeBy": "Scratch.pen_change_width(instance, %[SIZE]%)",
+    "pen_setPenSizeTo": "Scratch.pen_set_width(instance, %[SIZE]%)",
+    "pen_menu_colorParam": "%[colorParam]%"
+}

ScratchAnalyzer/errors.py

@@ -0,0 +1,2 @@
+class UnsupportedError(Exception):
+    """ 不支持错误 """

ScratchAnalyzer/iostream.py

@@ -0,0 +1,103 @@
+from colorama import init, Fore
+import tqdm
+
+init()
+
+def Reset():
+    print(Fore.RESET, end="")
+
+def _PrinterGenerator(color):
+    def Printer(*args, sep=" "):
+        string = sep.join([str(item) for item in args])
+        return getattr(Fore, color)+string+Fore.RESET
+    return Printer
+
+def _StarterGenerator(color):
+    def Starter():
+        print(getattr(Fore, color), end="")
+    return Starter
+
+class ColoredTqdm(tqdm.tqdm):
+    def __init__(self, iterable=None, desc=None, total=None, leave=True, file=None,
+                 ncols=None, mininterval=0.1, maxinterval=10.0, miniters=None,
+                 ascii=None, disable=False, unit='it', unit_scale=False,
+                 dynamic_ncols=False, smoothing=0.3, bar_format=None, initial=0,
+                 position=None, postfix=None, unit_divisor=1000, write_bytes=False,
+                 lock_args=None, nrows=None, colour=None, delay=0.0, gui=False,
+                 color1=Fore.LIGHTYELLOW_EX, color2=Fore.LIGHTGREEN_EX,
+                 **kwargs):
+        print(color1, end="", flush=True)
+        self.color2 = color2
+        super().__init__(iterable, desc, total, leave, file,
+                 ncols, mininterval, maxinterval, miniters,
+                 ascii, disable, unit, unit_scale,
+                 dynamic_ncols, smoothing, bar_format, initial,
+                 position, postfix, unit_divisor, write_bytes,
+                 lock_args, nrows, colour, delay, gui,
+                 **kwargs)
+    def close(self):
+        print(self.color2, end="", flush=True)
+        super().close()
+        print(Fore.RESET, end="", flush=True)
+
+def _makeAll():
+    colors = [
+        "Black",
+        "Red",
+        "Green",
+        "Yellow",
+        "Blue",
+        "Magenta",
+        "Cyan",
+        "White",
+        "LightBlack_EX",
+        "LightRed_EX",
+        "LightGreen_EX",
+        "LightYellow_EX",
+        "LightBlue_EX",
+        "LightMagenta_EX",
+        "LightCyan_EX",
+        "LightWhite_EX",
+    ]
+    for color in colors:
+        globals()[f"Fore{color.replace('_EX', '')}"] =  _PrinterGenerator(color.upper())
+        globals()[f"Start{color.replace('_EX', '')}"] =  _StarterGenerator(color.upper())
+
+_makeAll()
+
+__all__ = [
+    "Reset",
+    "ColoredTqdm",
+    "ForeBlack",
+    "ForeRed",
+    "ForeGreen",
+    "ForeYellow",
+    "ForeBlue",
+    "ForeMagenta",
+    "ForeCyan",
+    "ForeWhite",
+    "ForeLightBlack",
+    "ForeLightRed",
+    "ForeLightGreen",
+    "ForeLightYellow",
+    "ForeLightBlue",
+    "ForeLightMagenta",
+    "ForeLightCyan",
+    "ForeLightWhite",
+    "StartBlack",
+    "StartRed",
+    "StartGreen",
+    "StartYellow",
+    "StartBlue",
+    "StartMagenta",
+    "StartCyan",
+    "StartWhite",
+    "StartLightBlack",
+    "StartLightRed",
+    "StartLightGreen",
+    "StartLightYellow",
+    "StartLightBlue",
+    "StartLightMagenta",
+    "StartLightCyan",
+    "StartLightWhite",
+]

ScratchAnalyzer/iostream.pyi

@@ -0,0 +1,116 @@
+import tqdm
+from colorama import Fore
+
+def Reset() -> None:
+    ...
+
+class ColoredTqdm(tqdm.tqdm):
+    color2: str
+
+    def __init__(self, iterable=None, desc=None, total=None, leave=True, file=None,
+                 ncols=None, mininterval=0.1, maxinterval=10.0, miniters=None,
+                 ascii=None, disable=False, unit='it', unit_scale=False,
+                 dynamic_ncols=False, smoothing=0.3, bar_format=None, initial=0,
+                 position=None, postfix=None, unit_divisor=1000, write_bytes=False,
+                 lock_args=None, nrows=None, colour=None, delay=0.0, gui=False,
+                 color1: str=Fore.LIGHTYELLOW_EX, color2: str=Fore.LIGHTGREEN_EX,
+                 **kwargs):
+        ...
+    def close(self):
+        ...
+
+def ForeBlack(*args, sep:str=" ") -> str:
+    ...
+
+def ForeRed(*args, sep:str=" ") -> str:
+    ...
+
+def ForeGreen(*args, sep:str=" ") -> str:
+    ...
+
+def ForeYellow(*args, sep:str=" ") -> str:
+    ...
+
+def ForeBlue(*args, sep:str=" ") -> str:
+    ...
+
+def ForeMagenta(*args, sep:str=" ") -> str:
+    ...
+
+def ForeCyan(*args, sep:str=" ") -> str:
+    ...
+
+def ForeWhite(*args, sep:str=" ") -> str:
+    ...
+
+def ForeLightBlack(*args, sep:str=" ") -> str:
+    ...
+
+def ForeLightRed(*args, sep:str=" ") -> str:
+    ...
+
+def ForeLightGreen(*args, sep:str=" ") -> str:
+    ...
+
+def ForeLightYellow(*args, sep:str=" ") -> str:
+    ...
+
+def ForeLightBlue(*args, sep:str=" ") -> str:
+    ...
+
+def ForeLightMagenta(*args, sep:str=" ") -> str:
+    ...
+
+def ForeLightCyan(*args, sep:str=" ") -> str:
+    ...
+
+def ForeLightWhite(*args, sep:str=" ") -> str:
+    ...
+
+def StartBlack() -> None:
+    ...
+
+def StartRed() -> None:
+    ...
+
+def StartGreen() -> None:
+    ...
+
+def StartYellow() -> None:
+    ...
+
+def StartBlue() -> None:
+    ...
+
+def StartMagenta() -> None:
+    ...
+
+def StartCyan() -> None:
+    ...
+
+def StartWhite() -> None:
+    ...
+
+def StartLightBlack() -> None:
+    ...
+
+def StartLightRed() -> None:
+    ...
+
+def StartLightGreen() -> None:
+    ...
+
+def StartLightYellow() -> None:
+    ...
+
+def StartLightBlue() -> None:
+    ...
+
+def StartLightMagenta() -> None:
+    ...
+
+def StartLightCyan() -> None:
+    ...
+
+def StartLightWhite() -> None:
+    ...

ScratchAnalyzer/main.py

@@ -0,0 +1,78 @@
+import zipfile
+import os
+import sys
+import argparse
+import json
+import shutil
+import traceback
+from pathlib import Path
+
+from .iostream import ForeLightRed, ForeLightGreen, StartLightRed, Reset, ColoredTqdm
+from .Project import Project
+from .Scratch import Scratch
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--input", "-i", type=str, required=True, help="输入文件（必须是Scratch3.0文件）")
+    parser.add_argument("--output", "-o", type=str, required=True, help="输出目录")
+    parser.add_argument("--language", "-l", default="python", choices=["python", "java"], type=str, required=False, help="转换成的语言")
+    args = parser.parse_args()
+
+    if os.path.isfile(args.output):
+        print(ForeLightRed("输出路径指向了文件！"))
+        return -1
+
+    if not os.path.exists(args.input) or not os.path.isfile(args.input):
+        print(ForeLightRed("输入文件不存在或不是文件！"))
+        return -1
+
+    if not args.input.endswith(".sb3"):
+        if args.input.endswith(".sb2") or args.input.endswith(".sb1"):
+            print(ForeLightRed("仅支持 Scratch 3.0 项目文件！"))
+            return -1
+        print(ForeLightRed("输入文件不是 Scratch 项目文件！"))
+        return -1
+
+    print(ForeLightGreen("正在初始化输出目录..."))
+    if os.path.exists(args.output) and os.path.isdir(args.output):
+        shutil.rmtree(args.output)
+    os.makedirs(args.output)
+
+    # 步骤1：解压数据
+    out = os.path.join(args.output, "assets") # 全部解压至输出目录
+    with zipfile.ZipFile(args.input, "r") as zip_ref:
+        try:
+            for member in ColoredTqdm(zip_ref.infolist(), desc="正在解压中", unit="文件"):
+                zip_ref.extract(member, out)
+        except:
+            StartLightRed()
+            print("解压时出错：")
+            traceback.print_exc()
+            Reset()
+            return -1
+
+    # 步骤2：解析project.json
+    print(f"正在解析项目数据...")
+    project_json = os.path.join(out, "project.json")
+    with open(project_json, "r", encoding="utf-8") as f:
+        data = json.load(f)
+
+    # 步骤3：解析数据
+    project = Project(data)
+
+    # 步骤4：生成数据
+    scratch = Scratch(project)
+    scratch.generate(Path(args.output))
+
+    return 0
+
+if __name__ == "__main__":
+    try:
+        sys.exit(main())
+    except Exception as e:
+        StartLightRed()
+        print("主程序遇到未捕获错误：")
+        traceback.print_exc()
+        Reset()
+        sys.exit(-1)

ScratchAnalyzer/public.py

@@ -0,0 +1,41 @@
+from pathlib import Path
+
+
+supported_languages = [
+    "python"
+]
+
+head_block_opcodes = [
+    "event_whenflagclicked",
+    "event_whenkeypressed",
+    "event_whenthisspriteclicked",
+    "event_whenbackdropswitchesto",
+    "event_whengreaterthan",
+    "event_whenbroadcastreceived",
+    "control_start_as_clone",
+    "procedures_definition"
+]
+
+entries_block_opcodes = [
+    "event_whenflagclicked"
+]
+
+substack_opcodes = [
+    "control_repeat",
+    "control_forever",
+    "control_if",
+    "control_if_else",
+    "control_repeat_until",
+    "control_while"
+]
+
+substack_opcodes_need_flush = {
+    "control_repeat": True,
+    "control_forever": True,
+    "control_if": False,
+    "control_if_else": False,
+    "control_repeat_until": True,
+    "control_while": True
+}
+
+assets_root_path = Path(__file__).parent / "assets"

ScratchAnalyzer/translator.py

@@ -0,0 +1,20 @@
+import json
+from .public import assets_root_path
+
+
+class WrappedTranslator(object):
+    def __init__(self, translator):
+        self.translator = translator
+    def __getattr__(self, item):
+        translator = super().__getattribute__('translator')
+        # 先在字典属性translator中查找
+        if item in translator:
+            return translator[item]
+        else:
+            # 如果找不到，调用父类的__getattribute__方法
+            return super().__getattribute__(item)
+
+def load_translator(language):
+    with open(assets_root_path / f"translator.{language.lower()}.json", "r", encoding="utf-8") as file:
+        data = json.load(file)
+    return WrappedTranslator(data)

scratchanalyzer-0.1.0.dist-info/METADATA

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: ScratchAnalyzer
+Version: 0.1.0
+Summary: A Scratch parser that can generate Python code, ensuring that the logic remains as it is, only unable to run.
+Author-email: PerfectMYGHY <916881890@qq.com>
+License: MIT
+Project-URL: Homepage, https://github.com/PerfectMYGHY/scratch-analyzer
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: colorama==0.4.6
+Requires-Dist: tqdm==4.67.3
+Dynamic: license-file
+
+# scratch-analyzer
+
+English version README.md: [README.english.md](README.english.md)
+
+Scratch 解析库。一个使用Python制作的能够分析Python代码的软件包。
+
+## 介绍
+
+### 历史
+
+基础代码再2025年（发布仓库的1年前）编写，当时我有一个梦想，将Scratch翻译成一个Python上能够运行的程序，于是我写下了这个程序，原名`Scratch2Python`。
+
+我~~凭借着我惊人的智慧~~写出了`Scratch2Python`的Scratch转换Python代码功能，虽然代码有一丢烂，但是转换相当成功。
+
+然而，接下来的问题是，Scratch运行时阻挠了我。从代码历史你能看到，本项目最终使用`Scratch4Python`作为运行时库，但是很可惜，我跟他耗了几个月，最终失败。
+
+### 那么此库为何而在
+
+因为我的这个翻译器还是太好了，理论上还可以做到翻译成各种语言，虽然目前仅保证转换为Python是正常的。
+
+我认为这个功能很不错，于是建立存储库并单独提取其代码转换功能。
+
+### 那Scratch4Python呢
+
+我不打算完全放弃他，但是请等我深造几年，吃透OpenGL后，再管它吧。我想到时候将他作为独立库发布，同时更名`python-scratch-vm`。到时候可以两个库结合使用。
+
+### 目录结构
+
+```folder
+├── docs # 文档注释文件夹
+│   ├── README.chinese.md # 中文文档
+│   └── README.english.md # 英文文档
+├── LICENSE # MIT
+├── pyproject.toml # 项目配置
+├── README.md -> docs/README.chinese.md # 自述文件符号链接
+├── requirements.txt # 需求文件
+└── src # 源代码
+    └── ScratchAnalyzer # 软件包目录
+```
+
+## 使用
+
+首先下载软件包。注意使用时软件包名为`ScratchAnalyzer`。
+
+### 准备
+
+首先，请准备好Scratch项目的`project.json`，将Scratch文件的后缀名更改为`.zip`，然后解压，即可得到素材文件和`project.json`。分析文件只需要`project.json`，但是如果需要运行等，请加上素材文件。
+
+### 分析
+
+假设已经准备好环境，使用方法如下：
+
+```python
+from ScratchAnalyzer import Project, Scratch
+import json
+from pathlib import Path
+
+# 1.读取文件，需要解析为字典
+with open("project.json", "r", encoding="utf-8") as file: # 使用UTF-8确保不会编码错误
+    data = json.load(file)
+
+# 2.创建Project对象，自动建立代码分析树，并存储项目元数据
+project = Project(data)
+
+# 3.创建Scratch对象，自动分析素材列表等元数据
+scratch = Scratch(project) # 要传入project，这样就能得到所有数据
+
+# 4.生产，由于生产的是多文件，所以要指定输出目录
+scratch.generate(Path("output"), language="python") # 第一个参数为输出目录，language为可选参数，默认为"python"，暂不支持其他语言，在此留个TODO
+
+# 5.output下即生产结果，对象析构安全，不需要手动管理
+```
+
+## 注意
+
+目前我还没有修改软件包接口，因此用起来有些困难。请等待我重构接口，以让这个软件包更好使用。

scratchanalyzer-0.1.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+ScratchAnalyzer/Cast.py,sha256=3bGZgoQvSfFiJEpVInZLPIoZ3rEjbBGDv8M2hgKoSIM,377
+ScratchAnalyzer/Project.py,sha256=DnVk5HdlAiTY3YMB2-a0k1DR654Pqm0PqVjs6O_uaok,12548
+ScratchAnalyzer/Project.pyi,sha256=zamenmUewwHV6IVgBIlNIXhDvLE7TIk4nwEGOSTvPQ8,5334
+ScratchAnalyzer/Scratch.py,sha256=UdIJiy4mA82a3-1X9HZm5F8V642LxkSgBXdDLczUAkc,19301
+ScratchAnalyzer/Scratch.pyi,sha256=f2_kOtOMkbaHF0oBHZSYN-4_qGHdEQIjm912WEDktFA,2161
+ScratchAnalyzer/__init__.py,sha256=mOu3Ny8NlRIVf2a0BlMLyL82h4gSmpjcgp9TYR9xbXw,101
+ScratchAnalyzer/__main__.py,sha256=4rngtsfRe8uuplAOzG_zfDYMiiKpb_egxRMTFXQbCKY,83
+ScratchAnalyzer/errors.py,sha256=P-GzGJglPeTITkotHX5TnRSv5qri_c7gtY9oqVMAvlM,62
+ScratchAnalyzer/iostream.py,sha256=rXRPiF5V0M267Hvdb4UJdI_eifxEjKZt5HZtRe92JbY,2875
+ScratchAnalyzer/iostream.pyi,sha256=eiPtjKPbLgjuwQ0dqgm-IAfdSp3pXI9MHbutZ95dWOU,2204
+ScratchAnalyzer/main.py,sha256=zDTu4hv1mP9iZKFKi2gbFNMO6XbADRnWsCtg-E11rWk,2572
+ScratchAnalyzer/public.py,sha256=CBtaYiSpJHVu-tLh-1b6fjeYL3z9VZmfqN3nQpHGDSc,817
+ScratchAnalyzer/translator.py,sha256=W5urML2dmCrKGEEvAv-4oW-bJB6GZCmSJefsg4WYpm0,700
+ScratchAnalyzer/assets/codeMain.python.tpl,sha256=SDOVf7GQE4FzNLa50TvRoIdt3jK4yrZAEyYw1ZOE9Fk,538
+ScratchAnalyzer/assets/progMain.python.tpl,sha256=EdtfeEFP8qgNobmpY3lhZo_cYHfiUS1Yy2Ec9jztpuw,761
+ScratchAnalyzer/assets/translator.python.json,sha256=caHGFBa4N0KQkPWXkwJS9S7LejosDo28CPo499nj8_k,9580
+scratchanalyzer-0.1.0.dist-info/licenses/LICENSE,sha256=xR2fRS8P5gOUdAyfoPox79F1AxbCHWiLZf5QR02QN1M,1069
+scratchanalyzer-0.1.0.dist-info/METADATA,sha256=Yf1JV04otOr3KGYHolqD5Q1AL_8eoOJeSxJ7NQ_NYpI,3672
+scratchanalyzer-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+scratchanalyzer-0.1.0.dist-info/entry_points.txt,sha256=5BrROCFmY8F9t16Aj20PQj-k1Qa782GHg_3B5d05MQE,66
+scratchanalyzer-0.1.0.dist-info/top_level.txt,sha256=1ztG_Nyee1TdYh94S0hIDn3Vjl8z2w7XwjQydPiHzlk,16
+scratchanalyzer-0.1.0.dist-info/RECORD,,

scratchanalyzer-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

scratchanalyzer-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+analyze-scratch = ScratchAnalyzer.__main__:main

scratchanalyzer-0.1.0.dist-info/licenses/LICENSE

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

scratchanalyzer-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ScratchAnalyzer