scratchattach 2.1.14__py3-none-any.whl → 3.0.0b0__py3-none-any.whl

scratchattach/editor/blockshape.py

@@ -1,357 +0,0 @@
-"""
-Enums stating the shape of a block from its opcode (i.e: stack, c-mouth, cap, hat etc)
-"""
-from __future__ import annotations
-
-# Perhaps this should be merged with pallete.py
-from dataclasses import dataclass
-from typing import Final
-
-from . import commons
-from scratchattach.utils.enums import _EnumWrapper
-
-
-class _MutationDependent(commons.Singleton):
-    """
-    Singleton value that represents the uncertainty of a vablue because it depends on block mutation data.
-    """
-    INSTANCE = 0
-    def __bool__(self):
-        raise TypeError("Need mutation data to work out attribute value.")
-
-
-MUTATION_DEPENDENT: Final[_MutationDependent] = _MutationDependent()
-"""Value used when mutation data is required to work out the attribute value"""
-
-
-@dataclass(init=True, repr=True)
-class BlockShape:
-    """
-    The shape of a block; e.g. is it a stack, c-mouth, cap, hat reporter, boolean or menu block?
-    """
-    is_stack: bool | _MutationDependent = False  # Most blocks - e.g. move [10] steps
-    is_c_mouth: bool | _MutationDependent = False  # Has substack - e.g. repeat
-    is_cap: bool | _MutationDependent = False  # No next - e.g. forever
-    is_hat: bool | _MutationDependent = False  # No parent - e.g. when gf clicked
-    is_reporter: bool | _MutationDependent = False  # (reporter)
-    is_boolean: bool | _MutationDependent = False  # <reporter>
-    is_menu: bool | _MutationDependent = False  # Shadow reporters, e.g. costume menu
-    opcode: str = None
-
-    @property
-    def is_attachable(self):
-        if self.is_cap is MUTATION_DEPENDENT:
-            raise TypeError(
-                "Can't tell if the block is attachable because we can't be sure if it is a cap block or not (stop block)")
-        return not self.is_cap and not self.is_reporter
-
-
-class BlockShapes(_EnumWrapper):
-    MOTION_MOVESTEPS = BlockShape(is_stack=True, opcode="motion_movesteps")
-    MOTION_TURNRIGHT = BlockShape(is_stack=True, opcode="motion_turnright")
-    MOTION_TURNLEFT = BlockShape(is_stack=True, opcode="motion_turnleft")
-    MOTION_GOTO = BlockShape(is_stack=True, opcode="motion_goto")
-    MOTION_GOTOXY = BlockShape(is_stack=True, opcode="motion_gotoxy")
-    MOTION_GLIDETO = BlockShape(is_stack=True, opcode="motion_glideto")
-    MOTION_GLIDESECSTOXY = BlockShape(is_stack=True, opcode="motion_glidesecstoxy")
-    MOTION_POINTINDIRECTION = BlockShape(is_stack=True, opcode="motion_pointindirection")
-    MOTION_POINTTOWARDS = BlockShape(is_stack=True, opcode="motion_pointtowards")
-    MOTION_CHANGEXBY = BlockShape(is_stack=True, opcode="motion_changexby")
-    MOTION_SETX = BlockShape(is_stack=True, opcode="motion_setx")
-    MOTION_CHANGEYBY = BlockShape(is_stack=True, opcode="motion_changeyby")
-    MOTION_SETY = BlockShape(is_stack=True, opcode="motion_sety")
-    MOTION_IFONEDGEBOUNCE = BlockShape(is_stack=True, opcode="motion_ifonedgebounce")
-    MOTION_SETROTATIONSTYLE = BlockShape(is_stack=True, opcode="motion_setrotationstyle")
-    MOTION_XPOSITION = BlockShape(is_reporter=True, opcode="motion_xposition")
-    MOTION_YPOSITION = BlockShape(is_reporter=True, opcode="motion_yposition")
-    MOTION_DIRECTION = BlockShape(is_reporter=True, opcode="motion_direction")
-    MOTION_SCROLL_RIGHT = BlockShape(is_stack=True, opcode="motion_scroll_right")
-    MOTION_SCROLL_UP = BlockShape(is_stack=True, opcode="motion_scroll_up")
-    MOTION_ALIGN_SCENE = BlockShape(is_stack=True, opcode="motion_align_scene")
-    MOTION_XSCROLL = BlockShape(is_reporter=True, opcode="motion_xscroll")
-    MOTION_YSCROLL = BlockShape(is_reporter=True, opcode="motion_yscroll")
-    MOTION_GOTO_MENU = BlockShape(is_reporter=True, is_menu=True, opcode="motion_goto_menu")
-    MOTION_GLIDETO_MENU = BlockShape(is_reporter=True, is_menu=True, opcode="motion_glideto_menu")
-    MOTION_POINTTOWARDS_MENU = BlockShape(is_reporter=True, is_menu=True, opcode="motion_pointtowards_menu")
-
-    LOOKS_SAYFORSECS = BlockShape(is_stack=True, opcode="looks_sayforsecs")
-    LOOKS_SAY = BlockShape(is_stack=True, opcode="looks_say")
-    LOOKS_THINKFORSECS = BlockShape(is_stack=True, opcode="looks_thinkforsecs")
-    LOOKS_THINK = BlockShape(is_stack=True, opcode="looks_think")
-    LOOKS_SWITCHCOSTUMETO = BlockShape(is_stack=True, opcode="looks_switchcostumeto")
-    LOOKS_NEXTCOSTUME = BlockShape(is_stack=True, opcode="looks_nextcostume")
-    LOOKS_SWITCHBACKDROPTO = BlockShape(is_stack=True, opcode="looks_switchbackdropto")
-    LOOKS_SWITCHBACKDROPTOANDWAIT = BlockShape(is_stack=True, opcode="looks_switchbackdroptoandwait")
-    LOOKS_NEXTBACKDROP = BlockShape(is_stack=True, opcode="looks_nextbackdrop")
-    LOOKS_CHANGESIZEBY = BlockShape(is_stack=True, opcode="looks_changesizeby")
-    LOOKS_SETSIZETO = BlockShape(is_stack=True, opcode="looks_setsizeto")
-    LOOKS_CHANGEEFFECTBY = BlockShape(is_stack=True, opcode="looks_changeeffectby")
-    LOOKS_SETEFFECTTO = BlockShape(is_stack=True, opcode="looks_seteffectto")
-    LOOKS_CLEARGRAPHICEFFECTS = BlockShape(is_stack=True, opcode="looks_cleargraphiceffects")
-    LOOKS_SHOW = BlockShape(is_stack=True, opcode="looks_show")
-    LOOKS_HIDE = BlockShape(is_stack=True, opcode="looks_hide")
-    LOOKS_GOTOFRONTBACK = BlockShape(is_stack=True, opcode="looks_gotofrontback")
-    LOOKS_GOFORWARDBACKWARDLAYERS = BlockShape(is_stack=True, opcode="looks_goforwardbackwardlayers")
-    LOOKS_COSTUMENUMBERNAME = BlockShape(is_reporter=True, opcode="looks_costumenumbername")
-    LOOKS_BACKDROPNUMBERNAME = BlockShape(is_reporter=True, opcode="looks_backdropnumbername")
-    LOOKS_SIZE = BlockShape(is_reporter=True, opcode="looks_size")
-    LOOKS_HIDEALLSPRITES = BlockShape(is_stack=True, opcode="looks_hideallsprites")
-    LOOKS_SETSTRETCHTO = BlockShape(is_stack=True, opcode="looks_setstretchto")
-    LOOKS_CHANGESTRETCHBY = BlockShape(is_stack=True, opcode="looks_changestretchby")
-    LOOKS_COSTUME = BlockShape(is_reporter=True, is_menu=True, opcode="looks_costume")
-    LOOKS_BACKDROPS = BlockShape(is_reporter=True, is_menu=True, opcode="looks_backdrops")
-
-    SOUND_PLAYUNTILDONE = BlockShape(is_stack=True, opcode="sound_playuntildone")
-    SOUND_PLAY = BlockShape(is_stack=True, opcode="sound_play")
-    SOUND_STOPALLSOUNDS = BlockShape(is_stack=True, opcode="sound_stopallsounds")
-    SOUND_CHANGEEFFECTBY = BlockShape(is_stack=True, opcode="sound_changeeffectby")
-    SOUND_SETEFFECTTO = BlockShape(is_stack=True, opcode="sound_seteffectto")
-    SOUND_CLEAREFFECTS = BlockShape(is_stack=True, opcode="sound_cleareffects")
-    SOUND_CHANGEVOLUMEBY = BlockShape(is_stack=True, opcode="sound_changevolumeby")
-    SOUND_SETVOLUMETO = BlockShape(is_stack=True, opcode="sound_setvolumeto")
-    SOUND_VOLUME = BlockShape(is_reporter=True, opcode="sound_volume")
-    SOUND_SOUNDS_MENU = BlockShape(is_reporter=True, is_menu=True, opcode="sound_sounds_menu")
-
-    EVENT_WHENFLAGCLICKED = BlockShape(is_hat=True, opcode="event_whenflagclicked")
-    EVENT_WHENKEYPRESSED = BlockShape(is_hat=True, opcode="event_whenkeypressed")
-    EVENT_WHENTHISSPRITECLICKED = BlockShape(is_hat=True, opcode="event_whenthisspriteclicked")
-    EVENT_WHENSTAGECLICKED = BlockShape(is_hat=True, opcode="event_whenstageclicked")
-    EVENT_WHENBACKDROPSWITCHESTO = BlockShape(is_hat=True, opcode="event_whenbackdropswitchesto")
-    EVENT_WHENGREATERTHAN = BlockShape(is_hat=True, opcode="event_whengreaterthan")
-    EVENT_WHENBROADCASTRECEIVED = BlockShape(is_hat=True, opcode="event_whenbroadcastreceived")
-    EVENT_BROADCAST = BlockShape(is_stack=True, opcode="event_broadcast")
-    EVENT_BROADCASTANDWAIT = BlockShape(is_stack=True, opcode="event_broadcastandwait")
-    EVENT_WHENTOUCHINGOBJECT = BlockShape(is_hat=True, opcode="event_whentouchingobject")
-    EVENT_BROADCAST_MENU = BlockShape(is_reporter=True, is_menu=True, opcode="event_broadcast_menu")
-    EVENT_TOUCHINGOBJECTMENU = BlockShape(is_reporter=True, is_menu=True, opcode="event_touchingobjectmenu")
-
-    CONTROL_WAIT = BlockShape(is_stack=True, opcode="control_wait")
-    CONTROL_FOREVER = BlockShape(is_c_mouth=True, is_stack=True, is_cap=True, opcode="control_forever")
-    CONTROL_IF = BlockShape(is_c_mouth=True, is_stack=True, opcode="control_if")
-    CONTROL_IF_ELSE = BlockShape(is_c_mouth=True, is_stack=True, opcode="control_if_else")
-    CONTROL_WAIT_UNTIL = BlockShape(is_stack=True, opcode="control_wait_until")
-    CONTROL_REPEAT_UNTIL = BlockShape(is_c_mouth=True, is_stack=True, opcode="control_repeat_until")
-    CONTROL_STOP = BlockShape(is_stack=True, is_cap=MUTATION_DEPENDENT, opcode="control_stop")
-    CONTROL_START_AS_CLONE = BlockShape(is_hat=True, opcode="control_start_as_clone")
-    CONTROL_CREATE_CLONE_OF = BlockShape(is_stack=True, opcode="control_create_clone_of")
-    CONTROL_DELETE_THIS_CLONE = BlockShape(is_stack=True, is_cap=True, opcode="control_delete_this_clone")
-    CONTROL_FOR_EACH = BlockShape(is_c_mouth=True, is_stack=True, opcode="control_for_each")
-    CONTROL_WHILE = BlockShape(is_c_mouth=True, is_stack=True, opcode="control_while")
-    CONTROL_GET_COUNTER = BlockShape(is_reporter=True, opcode="control_get_counter")
-    CONTROL_INCR_COUNTER = BlockShape(is_stack=True, opcode="control_incr_counter")
-    CONTROL_CLEAR_COUNTER = BlockShape(is_stack=True, opcode="control_clear_counter")
-    CONTROL_ALL_AT_ONCE = BlockShape(is_c_mouth=True, is_stack=True, opcode="control_all_at_once")
-    CONTROL_CREATE_CLONE_OF_MENU = BlockShape(is_reporter=True, is_menu=True, opcode="control_create_clone_of_menu")
-
-    SENSING_TOUCHINGOBJECT = BlockShape(is_reporter=True, is_boolean=True, opcode="sensing_touchingobject")
-    SENSING_TOUCHINGCOLOR = BlockShape(is_reporter=True, is_boolean=True, opcode="sensing_touchingcolor")
-    SENSING_COLORISTOUCHINGCOLOR = BlockShape(is_reporter=True, is_boolean=True, opcode="sensing_coloristouchingcolor")
-    SENSING_DISTANCETO = BlockShape(is_reporter=True, opcode="sensing_distanceto")
-    SENSING_ASKANDWAIT = BlockShape(is_stack=True, opcode="sensing_askandwait")
-    SENSING_ANSWER = BlockShape(is_reporter=True, opcode="sensing_answer")
-    SENSING_KEYPRESSED = BlockShape(is_reporter=True, is_boolean=True, opcode="sensing_keypressed")
-    SENSING_MOUSEDOWN = BlockShape(is_reporter=True, is_boolean=True, opcode="sensing_mousedown")
-    SENSING_MOUSEX = BlockShape(is_reporter=True, opcode="sensing_mousex")
-    SENSING_MOUSEY = BlockShape(is_reporter=True, opcode="sensing_mousey")
-    SENSING_SETDRAGMODE = BlockShape(is_stack=True, opcode="sensing_setdragmode")
-    SENSING_LOUDNESS = BlockShape(is_reporter=True, opcode="sensing_loudness")
-    SENSING_TIMER = BlockShape(is_reporter=True, opcode="sensing_timer")
-    SENSING_RESETTIMER = BlockShape(is_stack=True, opcode="sensing_resettimer")
-    SENSING_OF = BlockShape(is_reporter=True, opcode="sensing_of")
-    SENSING_CURRENT = BlockShape(is_reporter=True, opcode="sensing_current")
-    SENSING_DAYSSINCE2000 = BlockShape(is_reporter=True, opcode="sensing_dayssince2000")
-    SENSING_USERNAME = BlockShape(is_reporter=True, opcode="sensing_username")
-    SENSING_LOUD = BlockShape(is_reporter=True, is_boolean=True, opcode="sensing_loud")
-    SENSING_USERID = BlockShape(is_reporter=True, opcode="sensing_userid")
-    SENSING_TOUCHINGOBJECTMENU = BlockShape(is_reporter=True, is_menu=True, opcode="sensing_touchingobjectmenu")
-    SENSING_DISTANCETOMENU = BlockShape(is_reporter=True, is_menu=True, opcode="sensing_distancetomenu")
-    SENSING_KEYOPTIONS = BlockShape(is_reporter=True, is_menu=True, opcode="sensing_keyoptions")
-    SENSING_OF_OBJECT_MENU = BlockShape(is_reporter=True, is_menu=True, opcode="sensing_of_object_menu")
-
-    OPERATOR_ADD = BlockShape(is_reporter=True, opcode="operator_add")
-    OPERATOR_SUBTRACT = BlockShape(is_reporter=True, opcode="operator_subtract")
-    OPERATOR_MULTIPLY = BlockShape(is_reporter=True, opcode="operator_multiply")
-    OPERATOR_DIVIDE = BlockShape(is_reporter=True, opcode="operator_divide")
-    OPERATOR_RANDOM = BlockShape(is_reporter=True, opcode="operator_random")
-    OPERATOR_GT = BlockShape(is_reporter=True, is_boolean=True, opcode="operator_gt")
-    OPERATOR_LT = BlockShape(is_reporter=True, is_boolean=True, opcode="operator_lt")
-    OPERATOR_EQUALS = BlockShape(is_reporter=True, is_boolean=True, opcode="operator_equals")
-    OPERATOR_AND = BlockShape(is_reporter=True, is_boolean=True, opcode="operator_and")
-    OPERATOR_OR = BlockShape(is_reporter=True, is_boolean=True, opcode="operator_or")
-    OPERATOR_NOT = BlockShape(is_reporter=True, is_boolean=True, opcode="operator_not")
-    OPERATOR_JOIN = BlockShape(is_reporter=True, opcode="operator_join")
-    OPERATOR_LETTER_OF = BlockShape(is_reporter=True, opcode="operator_letter_of")
-    OPERATOR_LENGTH = BlockShape(is_reporter=True, opcode="operator_length")
-    OPERATOR_CONTAINS = BlockShape(is_reporter=True, is_boolean=True, opcode="operator_contains")
-    OPERATOR_MOD = BlockShape(is_reporter=True, opcode="operator_mod")
-    OPERATOR_ROUND = BlockShape(is_reporter=True, opcode="operator_round")
-    OPERATOR_MATHOP = BlockShape(is_reporter=True, opcode="operator_mathop")
-
-    DATA_VARIABLE = BlockShape(is_reporter=True, opcode="data_variable")
-    DATA_SETVARIABLETO = BlockShape(is_stack=True, opcode="data_setvariableto")
-    DATA_CHANGEVARIABLEBY = BlockShape(is_stack=True, opcode="data_changevariableby")
-    DATA_SHOWVARIABLE = BlockShape(is_stack=True, opcode="data_showvariable")
-    DATA_HIDEVARIABLE = BlockShape(is_stack=True, opcode="data_hidevariable")
-    DATA_LISTCONTENTS = BlockShape(is_reporter=True, opcode="data_listcontents")
-    DATA_ADDTOLIST = BlockShape(is_stack=True, opcode="data_addtolist")
-    DATA_DELETEOFLIST = BlockShape(is_stack=True, opcode="data_deleteoflist")
-    DATA_DELETEALLOFLIST = BlockShape(is_stack=True, opcode="data_deletealloflist")
-    DATA_INSERTATLIST = BlockShape(is_stack=True, opcode="data_insertatlist")
-    DATA_REPLACEITEMOFLIST = BlockShape(is_stack=True, opcode="data_replaceitemoflist")
-    DATA_ITEMOFLIST = BlockShape(is_reporter=True, is_boolean=True, opcode="data_itemoflist")
-    DATA_ITEMNUMOFLIST = BlockShape(is_reporter=True, opcode="data_itemnumoflist")
-    DATA_LENGTHOFLIST = BlockShape(is_reporter=True, opcode="data_lengthoflist")
-    DATA_LISTCONTAINSITEM = BlockShape(is_reporter=True, is_boolean=True, opcode="data_listcontainsitem")
-    DATA_SHOWLIST = BlockShape(is_stack=True, opcode="data_showlist")
-    DATA_HIDELIST = BlockShape(is_stack=True, opcode="data_hidelist")
-    DATA_LISTINDEXALL = BlockShape(is_reporter=True, is_menu=True, opcode="data_listindexall")
-    DATA_LISTINDEXRANDOM = BlockShape(is_reporter=True, is_menu=True, opcode="data_listindexrandom")
-
-    PROCEDURES_DEFINITION = BlockShape(is_hat=True, opcode="procedures_definition")
-    PROCEDURES_CALL = BlockShape(is_stack=True, opcode="procedures_call")
-    PROCEDURES_DECLARATION = BlockShape(is_stack=True, opcode="procedures_declaration")
-    PROCEDURES_PROTOTYPE = BlockShape(is_stack=True, opcode="procedures_prototype")
-
-    ARGUMENT_REPORTER_STRING_NUMBER = BlockShape(is_reporter=True, opcode="argument_reporter_string_number")
-    ARGUMENT_REPORTER_BOOLEAN = BlockShape(is_reporter=True, is_boolean=True, opcode="argument_reporter_boolean")
-    ARGUMENT_EDITOR_REPORTER = BlockShape(is_reporter=True, is_boolean=True, opcode="argument_editor_reporter")
-    ARGUMENT_EDITOR_STRING_NUMBER = BlockShape(is_reporter=True, opcode="argument_editor_string_number")
-
-    MUSIC_PLAYDRUMFORBEATS = BlockShape(is_stack=True, opcode="music_playDrumForBeats")
-    MUSIC_RESTFORBEATS = BlockShape(is_stack=True, opcode="music_restForBeats")
-    MUSIC_PLAYNOTEFORBEATS = BlockShape(is_stack=True, opcode="music_playNoteForBeats")
-    MUSIC_SETINSTRUMENT = BlockShape(is_stack=True, opcode="music_setInstrument")
-    MUSIC_SETTEMPO = BlockShape(is_stack=True, opcode="music_setTempo")
-    MUSIC_CHANGETEMPO = BlockShape(is_stack=True, opcode="music_changeTempo")
-    MUSIC_GETTEMPO = BlockShape(is_reporter=True, opcode="music_getTempo")
-    MUSIC_MIDIPLAYDRUMFORBEATS = BlockShape(is_stack=True, opcode="music_midiPlayDrumForBeats")
-    MUSIC_MIDISETINSTRUMENT = BlockShape(is_stack=True, opcode="music_midiSetInstrument")
-    MUSIC_MENU_DRUM = BlockShape(is_reporter=True, is_menu=True, opcode="music_menu_DRUM")
-    MUSIC_MENU_INSTRUMENT = BlockShape(is_reporter=True, is_menu=True, opcode="music_menu_INSTRUMENT")
-
-    PEN_CLEAR = BlockShape(is_stack=True, opcode="pen_clear")
-    PEN_STAMP = BlockShape(is_stack=True, opcode="pen_stamp")
-    PEN_PENDOWN = BlockShape(is_stack=True, opcode="pen_penDown")
-    PEN_PENUP = BlockShape(is_stack=True, opcode="pen_penUp")
-    PEN_SETPENCOLORTOCOLOR = BlockShape(is_stack=True, opcode="pen_setPenColorToColor")
-    PEN_CHANGEPENCOLORPARAMBY = BlockShape(is_stack=True, opcode="pen_changePenColorParamBy")
-    PEN_SETPENCOLORPARAMTO = BlockShape(is_stack=True, opcode="pen_setPenColorParamTo")
-    PEN_CHANGEPENSIZEBY = BlockShape(is_stack=True, opcode="pen_changePenSizeBy")
-    PEN_SETPENSIZETO = BlockShape(is_stack=True, opcode="pen_setPenSizeTo")
-    PEN_SETPENHUETONUMBER = BlockShape(is_stack=True, opcode="pen_setPenHueToNumber")
-    PEN_CHANGEPENHUEBY = BlockShape(is_stack=True, opcode="pen_changePenHueBy")
-    PEN_SETPENSHADETONUMBER = BlockShape(is_stack=True, opcode="pen_setPenShadeToNumber")
-    PEN_CHANGEPENSHADEBY = BlockShape(is_stack=True, opcode="pen_changePenShadeBy")
-    PEN_MENU_COLORPARAM = BlockShape(is_reporter=True, is_menu=True, opcode="pen_menu_colorParam")
-
-    VIDEOSENSING_WHENMOTIONGREATERTHAN = BlockShape(is_hat=True, opcode="videoSensing_whenMotionGreaterThan")
-    VIDEOSENSING_VIDEOON = BlockShape(is_reporter=True, opcode="videoSensing_videoOn")
-    VIDEOSENSING_VIDEOTOGGLE = BlockShape(is_stack=True, opcode="videoSensing_videoToggle")
-    VIDEOSENSING_SETVIDEOTRANSPARENCY = BlockShape(is_stack=True, opcode="videoSensing_setVideoTransparency")
-    VIDEOSENSING_MENU_ATTRIBUTE = BlockShape(is_reporter=True, is_menu=True, opcode="videoSensing_menu_ATTRIBUTE")
-    VIDEOSENSING_MENU_SUBJECT = BlockShape(is_reporter=True, is_menu=True, opcode="videoSensing_menu_SUBJECT")
-    VIDEOSENSING_MENU_VIDEO_STATE = BlockShape(is_reporter=True, is_menu=True, opcode="videoSensing_menu_VIDEO_STATE")
-
-    TEXT2SPEECH_SPEAKANDWAIT = BlockShape(is_stack=True, opcode="text2speech_speakAndWait")
-    TEXT2SPEECH_SETVOICE = BlockShape(is_stack=True, opcode="text2speech_setVoice")
-    TEXT2SPEECH_SETLANGUAGE = BlockShape(is_stack=True, opcode="text2speech_setLanguage")
-    TEXT2SPEECH_MENU_VOICES = BlockShape(is_reporter=True, is_menu=True, opcode="text2speech_menu_voices")
-    TEXT2SPEECH_MENU_LANGUAGES = BlockShape(is_reporter=True, is_menu=True, opcode="text2speech_menu_languages")
-    TRANSLATE_GETTRANSLATE = BlockShape(is_reporter=True, opcode="translate_getTranslate")
-    TRANSLATE_GETVIEWERLANGUAGE = BlockShape(is_reporter=True, opcode="translate_getViewerLanguage")
-    TRANSLATE_MENU_LANGUAGES = BlockShape(is_reporter=True, is_menu=True, opcode="translate_menu_languages")
-
-    MAKEYMAKEY_WHENMAKEYKEYPRESSED = BlockShape(is_hat=True, opcode="makeymakey_whenMakeyKeyPressed")
-    MAKEYMAKEY_WHENCODEPRESSED = BlockShape(is_hat=True, opcode="makeymakey_whenCodePressed")
-    MAKEYMAKEY_MENU_KEY = BlockShape(is_reporter=True, is_menu=True, opcode="makeymakey_menu_KEY")
-    MAKEYMAKEY_MENU_SEQUENCE = BlockShape(is_reporter=True, is_menu=True, opcode="makeymakey_menu_SEQUENCE")
-
-    MICROBIT_WHENBUTTONPRESSED = BlockShape(opcode="microbit_whenButtonPressed")  # todo: finish this
-    MICROBIT_ISBUTTONPRESSED = BlockShape(opcode="microbit_isButtonPressed")
-    MICROBIT_WHENGESTURE = BlockShape(opcode="microbit_whenGesture")
-    MICROBIT_DISPLAYSYMBOL = BlockShape(opcode="microbit_displaySymbol")
-    MICROBIT_DISPLAYTEXT = BlockShape(opcode="microbit_displayText")
-    MICROBIT_DISPLAYCLEAR = BlockShape(opcode="microbit_displayClear")
-    MICROBIT_WHENTILTED = BlockShape(opcode="microbit_whenTilted")
-    MICROBIT_ISTILTED = BlockShape(opcode="microbit_isTilted")
-    MICROBIT_GETTILTANGLE = BlockShape(opcode="microbit_getTiltAngle")
-    MICROBIT_WHENPINCONNECTED = BlockShape(opcode="microbit_whenPinConnected")
-    MICROBIT_MENU_BUTTONS = BlockShape(opcode="microbit_menu_buttons")
-    MICROBIT_MENU_GESTURES = BlockShape(opcode="microbit_menu_gestures")
-    MICROBIT_MENU_TILTDIRECTIONANY = BlockShape(opcode="microbit_menu_tiltDirectionAny")
-    MICROBIT_MENU_TILTDIRECTION = BlockShape(opcode="microbit_menu_tiltDirection")
-    MICROBIT_MENU_TOUCHPINS = BlockShape(opcode="microbit_menu_touchPins")
-    MICROBIT_MENU_PINSTATE = BlockShape(opcode="microbit_menu_pinState")
-
-    EV3_MOTORTURNCLOCKWISE = BlockShape(opcode="ev3_motorTurnClockwise")
-    EV3_MOTORTURNCOUNTERCLOCKWISE = BlockShape(opcode="ev3_motorTurnCounterClockwise")
-    EV3_MOTORSETPOWER = BlockShape(opcode="ev3_motorSetPower")
-    EV3_GETMOTORPOSITION = BlockShape(opcode="ev3_getMotorPosition")
-    EV3_WHENBUTTONPRESSED = BlockShape(opcode="ev3_whenButtonPressed")
-    EV3_WHENDISTANCELESSTHAN = BlockShape(opcode="ev3_whenDistanceLessThan")
-    EV3_WHENBRIGHTNESSLESSTHAN = BlockShape(opcode="ev3_whenBrightnessLessThan")
-    EV3_BUTTONPRESSED = BlockShape(opcode="ev3_buttonPressed")
-    EV3_GETDISTANCE = BlockShape(opcode="ev3_getDistance")
-    EV3_GETBRIGHTNESS = BlockShape(opcode="ev3_getBrightness")
-    EV3_BEEP = BlockShape(opcode="ev3_beep")
-    EV3_MENU_MOTORPORTS = BlockShape(opcode="ev3_menu_motorPorts")
-    EV3_MENU_SENSORPORTS = BlockShape(opcode="ev3_menu_sensorPorts")
-
-    BOOST_MOTORONFOR = BlockShape(opcode="boost_motorOnFor")
-    BOOST_MOTORONFORROTATION = BlockShape(opcode="boost_motorOnForRotation")
-    BOOST_MOTORON = BlockShape(opcode="boost_motorOn")
-    BOOST_MOTOROFF = BlockShape(opcode="boost_motorOff")
-    BOOST_SETMOTORPOWER = BlockShape(opcode="boost_setMotorPower")
-    BOOST_SETMOTORDIRECTION = BlockShape(opcode="boost_setMotorDirection")
-    BOOST_GETMOTORPOSITION = BlockShape(opcode="boost_getMotorPosition")
-    BOOST_WHENCOLOR = BlockShape(opcode="boost_whenColor")
-    BOOST_SEEINGCOLOR = BlockShape(opcode="boost_seeingColor")
-    BOOST_WHENTILTED = BlockShape(opcode="boost_whenTilted")
-    BOOST_GETTILTANGLE = BlockShape(opcode="boost_getTiltAngle")
-    BOOST_SETLIGHTHUE = BlockShape(opcode="boost_setLightHue")
-    BOOST_MENU_MOTOR_ID = BlockShape(opcode="boost_menu_MOTOR_ID")
-    BOOST_MENU_MOTOR_DIRECTION = BlockShape(opcode="boost_menu_MOTOR_DIRECTION")
-    BOOST_MENU_MOTOR_REPORTER_ID = BlockShape(opcode="boost_menu_MOTOR_REPORTER_ID")
-    BOOST_MENU_COLOR = BlockShape(opcode="boost_menu_COLOR")
-    BOOST_MENU_TILT_DIRECTION_ANY = BlockShape(opcode="boost_menu_TILT_DIRECTION_ANY")
-    BOOST_MENU_TILT_DIRECTION = BlockShape(opcode="boost_menu_TILT_DIRECTION")
-
-    WEDO2_MOTORONFOR = BlockShape(opcode="wedo2_motorOnFor")
-    WEDO2_MOTORON = BlockShape(opcode="wedo2_motorOn")
-    WEDO2_MOTOROFF = BlockShape(opcode="wedo2_motorOff")
-    WEDO2_STARTMOTORPOWER = BlockShape(opcode="wedo2_startMotorPower")
-    WEDO2_SETMOTORDIRECTION = BlockShape(opcode="wedo2_setMotorDirection")
-    WEDO2_SETLIGHTHUE = BlockShape(opcode="wedo2_setLightHue")
-    WEDO2_WHENDISTANCE = BlockShape(opcode="wedo2_whenDistance")
-    WEDO2_WHENTILTED = BlockShape(opcode="wedo2_whenTilted")
-    WEDO2_GETDISTANCE = BlockShape(opcode="wedo2_getDistance")
-    WEDO2_ISTILTED = BlockShape(opcode="wedo2_isTilted")
-    WEDO2_GETTILTANGLE = BlockShape(opcode="wedo2_getTiltAngle")
-    WEDO2_PLAYNOTEFOR = BlockShape(opcode="wedo2_playNoteFor")
-    WEDO2_MENU_MOTOR_ID = BlockShape(opcode="wedo2_menu_MOTOR_ID")
-    WEDO2_MENU_MOTOR_DIRECTION = BlockShape(opcode="wedo2_menu_MOTOR_DIRECTION")
-    WEDO2_MENU_OP = BlockShape(opcode="wedo2_menu_OP")
-    WEDO2_MENU_TILT_DIRECTION_ANY = BlockShape(opcode="wedo2_menu_TILT_DIRECTION_ANY")
-    WEDO2_MENU_TILT_DIRECTION = BlockShape(opcode="wedo2_menu_TILT_DIRECTION")
-
-    GDXFOR_WHENGESTURE = BlockShape(opcode="gdxfor_whenGesture")
-    GDXFOR_WHENFORCEPUSHEDORPULLED = BlockShape(opcode="gdxfor_whenForcePushedOrPulled")
-    GDXFOR_GETFORCE = BlockShape(opcode="gdxfor_getForce")
-    GDXFOR_WHENTILTED = BlockShape(opcode="gdxfor_whenTilted")
-    GDXFOR_ISTILTED = BlockShape(opcode="gdxfor_isTilted")
-    GDXFOR_GETTILT = BlockShape(opcode="gdxfor_getTilt")
-    GDXFOR_ISFREEFALLING = BlockShape(opcode="gdxfor_isFreeFalling")
-    GDXFOR_GETSPINSPEED = BlockShape(opcode="gdxfor_getSpinSpeed")
-    GDXFOR_GETACCELERATION = BlockShape(opcode="gdxfor_getAcceleration")
-    GDXFOR_MENU_GESTUREOPTIONS = BlockShape(opcode="gdxfor_menu_gestureOptions")
-    GDXFOR_MENU_PUSHPULLOPTIONS = BlockShape(opcode="gdxfor_menu_pushPullOptions")
-    GDXFOR_MENU_TILTANYOPTIONS = BlockShape(opcode="gdxfor_menu_tiltAnyOptions")
-    GDXFOR_MENU_TILTOPTIONS = BlockShape(opcode="gdxfor_menu_tiltOptions")
-    GDXFOR_MENU_AXISOPTIONS = BlockShape(opcode="gdxfor_menu_axisOptions")
-
-    COREEXAMPLE_EXAMPLEOPCODE = BlockShape(is_reporter=True, opcode="coreExample_exampleOpcode")
-    COREEXAMPLE_EXAMPLEWITHINLINEIMAGE = BlockShape(is_stack=True, opcode="coreExample_exampleWithInlineImage")
-
-    NOTE = BlockShape(is_reporter=True, is_menu=True, opcode="note")
-    MATRIX = BlockShape(is_reporter=True, is_menu=True, opcode="matrix")
-    UNDEFINED = BlockShape(is_hat=True, is_cap=True, opcode="red_hat_block")

scratchattach/editor/build_defaulting.py

@@ -1,51 +0,0 @@
-"""
-Module which stores the 'default' or 'current' selected Sprite/project (stored as a stack) which makes it easier to write scratch code directly in Python
-"""
-from __future__ import annotations
-
-from typing import Iterable, TYPE_CHECKING, Final, Literal
-
-if TYPE_CHECKING:
-    from . import sprite, block, prim, comment
-from . import commons
-
-
-class _SetSprite(commons.Singleton):
-    INSTANCE = 0
-    def __repr__(self):
-        return f'<Reminder to default your sprite to {current_sprite()}>'
-
-
-SPRITE_DEFAULT: Final[Literal[_SetSprite.INSTANCE]] = _SetSprite.INSTANCE
-
-_sprite_stack: list[sprite.Sprite] = []
-
-
-def stack_add_sprite(_sprite: sprite.Sprite):
-    _sprite_stack.append(_sprite)
-
-
-def current_sprite() -> sprite.Sprite | None:
-    """
-    Retrieve the default sprite from the top of the sprite stack
-    """
-    if len(_sprite_stack) == 0:
-        return None
-    return _sprite_stack[-1]
-
-
-def pop_sprite(_sprite: sprite.Sprite) -> sprite.Sprite | None:
-    assert _sprite_stack.pop() == _sprite
-    return _sprite
-
-
-def add_block(_block: block.Block | prim.Prim) -> block.Block | prim.Prim:
-    return current_sprite().add_block(_block)
-
-
-def add_chain(*chain: Iterable[block.Block, prim.Prim]) -> block.Block | prim.Prim:
-    return current_sprite().add_chain(*chain)
-
-
-def add_comment(_comment: comment.Comment):
-    return current_sprite().add_comment(_comment)

scratchattach/editor/code_translation/parse.py

@@ -1,177 +0,0 @@
-from __future__ import annotations
-from pathlib import Path
-from typing import Union, Generic, TypeVar
-from abc import ABC, abstractmethod
-from collections.abc import Sequence
-
-from lark import Lark, Transformer, Tree, Token, v_args
-from lark.reconstruct import Reconstructor
-
-R = TypeVar("R")
-class SupportsRead(ABC, Generic[R]):
-    @abstractmethod
-    def read(self, size: int | None = -1) -> R:
-        pass
-
-LANG_PATH = Path(__file__).parent / "language.lark"
-
-lang = Lark(LANG_PATH.read_text(), maybe_placeholders=False)
-reconstructor = Reconstructor(lang)
-
-def parse(script: Union[str, bytes, SupportsRead[str], Path]) -> Tree:
-    if isinstance(script, Path):
-        script = script.read_text()
-    if isinstance(script, SupportsRead):
-        read_data = script.read()
-        assert isinstance(read_data, str)
-        script = read_data
-    if isinstance(script, bytes):
-        script = script.decode("utf-8")
-    return lang.parse(script)
-
-def unparse(tree: Tree) -> str:
-    return reconstructor.reconstruct(tree)
-
-class PrettyUnparser(Transformer):
-    INDENT_STRING = "    "
-
-    @classmethod
-    def _indent(cls, text):
-        if not text:
-            return ""
-        return "\n".join(cls.INDENT_STRING + line for line in text.splitlines())
-
-    def PARAM_NAME(self, token):
-        return token.value
-
-    def BLOCK_NAME(self, token):
-        return token.value
-
-    def EVENT(self, token):
-        return token.value
-
-    def CONTROL_BLOCK_NAME(self, token):
-        return token.value
-        
-    def _PREPROC_INSTR_CONTENT(self, token):
-        return token.value
-        
-    def _COMMMENT_CONTENT(self, token):
-        return token.value
-    
-    @v_args(inline=True)
-    def hat(self, child):
-        return child
-
-    @v_args(inline=True)
-    def param(self, child):
-        return child
-
-    @v_args(inline=True)
-    def value_param(self, name):
-        return name
-
-    @v_args(inline=True)
-    def bool_param(self, name):
-        return f"<{name}>"
-
-    @v_args(inline=True)
-    def event_hat(self, event_name):
-        return f"when ({event_name})"
-
-    def block_hat(self, items):
-        name, *params = items
-        params_str = ", ".join(params)
-        return f"custom_block {name} ({params_str})"
-
-    @v_args(inline=True)
-    def PREPROC_INSTR(self, content):
-        return f"{content}"
-    
-    @v_args(inline=True)
-    def COMMMENT(self, content):
-        return f"{content}"
-    
-    def block(self, items):
-        params = []
-        inner_blocks = []
-        comments = []
-        for i in items[1:]:
-            if not isinstance(i, Tree):
-                continue
-            if str(i.data) == "block_content":
-                inner_blocks.extend(i.children)
-            if str(i.data) == "block_params":
-                params.extend(i.children)
-            if str(i.data) == "comments":
-                comments.extend(i.children)
-        block_name = items[0]
-        block_text = f"{block_name}({', '.join(params)})" if params or not inner_blocks else f"{block_name}"
-        if inner_blocks:
-            blocks_content = "\n".join(inner_blocks)
-            indented_content = self._indent(blocks_content)
-            block_text += f" {{\n{indented_content}\n}}"
-        if comments:
-            block_text += f" {'  '.join(comments)}"
-        return block_text
-    
-    def LITERAL_NUMBER(self, number: str):
-        return number
-    
-    def expr(self, items):
-        text = items[0]
-        if len(items) > 1:
-            text += f" {'  '.join(items[1].children)}"
-        return text
-    
-    def low_expr1(self, items):
-        text = f"({items[0]})" if " " in items[0] else items[0]
-        if len(items) > 1:
-            text += f" {'  '.join(items[1].children)}"
-        return text
-    
-    @v_args(inline=True)
-    def low_expr2(self, item):
-        return item
-    
-    def addition(self, items):
-        return items[0] + " + " + items[1]
-    
-    def subtraction(self, items):
-        return items[0] + " - " + items[1]
-
-    def multiplication(self, items):
-        return items[0] + " * " + items[1]
-    
-    def division(self, items):
-        return items[0] + " / " + items[1]
-    
-    def top_level_block(self, items):
-        first_item = items[0]
-        if first_item.startswith("%%") or first_item.startswith("##"):
-            return first_item
-
-        hat, *blocks = items
-        blocks_content = "\n".join(blocks)
-        indented_content = self._indent(blocks_content)
-        return f"{hat} {{\n{indented_content}\n}}"
-    
-    def start(self, items):
-        return "\n\n".join(items)
-
-def pretty_unparse(tree: Tree):
-    return PrettyUnparser().transform(tree)
-
-if __name__ == "__main__":
-    EXAMPLE_FILE = Path(__file__).parent / "example.txt"
-    tree = parse(EXAMPLE_FILE)
-    print(tree.pretty())
-    print()
-    print()
-    print(tree)
-    print()
-    print()
-    print(unparse(tree))
-    print()
-    print()
-    print(pretty_unparse(tree))

scratchattach/editor/comment.py

@@ -1,80 +0,0 @@
-from __future__ import annotations
-
-from . import base, block, sprite, build_defaulting
-from typing import Optional
-
-
-class Comment(base.IDComponent):
-    """
-    Represents a comment in the scratch editor.
-    """
-    def __init__(self, _id: Optional[str] = None, _block: Optional[block.Block] = None, x: int = 0, y: int = 0, width: int = 200,
-                 height: int = 200, minimized: bool = False, text: str = '', *, _block_id: Optional[str] = None,
-                 _sprite: sprite.Sprite = build_defaulting.SPRITE_DEFAULT, pos: Optional[tuple[int, int]] = None):
-        self.block = _block
-        self._block_id = _block_id
-        """
-        ID of connected block. Will be set to None upon sprite initialization when the block attribute is updated to the relevant Block.
-        """
-        if pos is not None:
-            x, y = pos
-
-        self.x = x
-        self.y = y
-
-        self.width = width
-        self.height = height
-
-        self.minimized = minimized
-        self.text = text
-
-        super().__init__(_id, _sprite)
-
-    def __repr__(self):
-        return f"Comment<{self.text[:10]!r}...>"
-
-    @property
-    def block_id(self):
-        """
-        Retrieve the id of the associateed block (if applicable)
-        """
-        if self.block is not None:
-            return self.block.id
-        elif self._block_id is not None:
-            return self._block_id
-        else:
-            return None
-
-    @staticmethod
-    def from_json(data: tuple[str, dict]):
-        assert len(data) == 2
-        _id, data = data
-
-        _block_id = data.get("blockId")
-
-        x = data.get("x", 0)
-        y = data.get("y", 0)
-
-        width = data.get("width", 100)
-        height = data.get("height", 100)
-
-        minimized = data.get("minimized", False)
-        text = data.get("text")
-
-        ret = Comment(_id, None, x, y, width, height, minimized, text, _block_id=_block_id)
-        return ret
-
-    def to_json(self) -> dict:
-        return {
-            "blockId": self.block_id,
-            "x": self.x, "y": self.y,
-            "width": self.width, "height": self.height,
-            "minimized": self.minimized,
-            "text": self.text,
-        }
-
-    def link_using_sprite(self):
-        if self._block_id is not None:
-            self.block = self.sprite.find_block(self._block_id, "id")
-            if self.block is not None:
-                self._block_id = None