From 1924a8afe67cd74969952681057f6891ade0a6b8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=8E=8B=E7=AB=8B=E5=B8=AE?= <3294713004@qq.com> Date: Tue, 27 May 2025 16:54:17 +0800 Subject: [PATCH] =?UTF-8?q?feat(boards):=20mp=E4=B8=8B=E6=B7=BB=E5=8A=A0py?= =?UTF-8?q?thon=5Fgenerator=20(=E4=B8=8D=E5=AE=8C=E5=96=84)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- boards/default_src/micropython/export.js | 5 +- .../micropython/python_generator.js | 349 ++++++++++++++++++ .../default_src/micropython_esp32s3/index.js | 6 +- 3 files changed, 356 insertions(+), 4 deletions(-) create mode 100644 boards/default_src/micropython/python_generator.js diff --git a/boards/default_src/micropython/export.js b/boards/default_src/micropython/export.js index 32d28e33..52ac4d9e 100644 --- a/boards/default_src/micropython/export.js +++ b/boards/default_src/micropython/export.js @@ -54,6 +54,8 @@ import * as MicroPythonSerialGenerators from './generators/serial'; import * as MicroPythonSystemGenerators from './generators/system'; import * as MicroPythonWeatherGenerators from './generators/weather'; +import { Python } from './python_generator'; + export { MicroPythonActuatorExternBlocks, MicroPythonActuatorOnBoardBlocks, @@ -108,5 +110,6 @@ export { MicroPythonSensorGenerators, MicroPythonSerialGenerators, MicroPythonSystemGenerators, - MicroPythonWeatherGenerators + MicroPythonWeatherGenerators, + Python }; \ No newline at end of file diff --git a/boards/default_src/micropython/python_generator.js b/boards/default_src/micropython/python_generator.js new file mode 100644 index 00000000..bbf996b8 --- /dev/null +++ b/boards/default_src/micropython/python_generator.js @@ -0,0 +1,349 @@ +/* +Overrides for generic Python code generation. +*/ +import * as Blockly from 'blockly/core'; +import { Names } from '@mixly/python'; + +/** + * Python code generator. + * @type {!Blockly.Generator} + */ +export const Python = new Blockly.Generator('Python'); +Python.INDENT = " "; + +/** + * List of illegal variable names. + * This is not intended to be a security feature. Blockly is 100% client-side, + * so bypassing this list is trivial. This is intended to prevent users from + * accidentally clobbering a built-in object or function. + * @private + */ +Python.addReservedWords( + // import keyword + // print(','.join(sorted(keyword.kwlist))) + // https://docs.python.org/3/reference/lexical_analysis.html#keywords + // https://docs.python.org/2/reference/lexical_analysis.html#keywords + 'False,None,True,and,as,assert,break,class,continue,def,del,elif,else,' + + 'except,exec,finally,for,from,global,if,import,in,is,lambda,nonlocal,not,' + + 'or,pass,print,raise,return,try,while,with,yield,' + + // https://docs.python.org/3/library/constants.html + // https://docs.python.org/2/library/constants.html + 'NotImplemented,Ellipsis,__debug__,quit,exit,copyright,license,credits,' + + // >>> print(','.join(sorted(dir(__builtins__)))) + // https://docs.python.org/3/library/functions.html + // https://docs.python.org/2/library/functions.html + 'ArithmeticError,AssertionError,AttributeError,BaseException,' + + 'BlockingIOError,BrokenPipeError,BufferError,BytesWarning,' + + 'ChildProcessError,ConnectionAbortedError,ConnectionError,' + + 'ConnectionRefusedError,ConnectionResetError,DeprecationWarning,EOFError,' + + 'Ellipsis,EnvironmentError,Exception,FileExistsError,FileNotFoundError,' + + 'FloatingPointError,FutureWarning,GeneratorExit,IOError,ImportError,' + + 'ImportWarning,IndentationError,IndexError,InterruptedError,' + + 'IsADirectoryError,KeyError,KeyboardInterrupt,LookupError,MemoryError,' + + 'ModuleNotFoundError,NameError,NotADirectoryError,NotImplemented,' + + 'NotImplementedError,OSError,OverflowError,PendingDeprecationWarning,' + + 'PermissionError,ProcessLookupError,RecursionError,ReferenceError,' + + 'ResourceWarning,RuntimeError,RuntimeWarning,StandardError,' + + 'StopAsyncIteration,StopIteration,SyntaxError,SyntaxWarning,SystemError,' + + 'SystemExit,TabError,TimeoutError,TypeError,UnboundLocalError,' + + 'UnicodeDecodeError,UnicodeEncodeError,UnicodeError,' + + 'UnicodeTranslateError,UnicodeWarning,UserWarning,ValueError,Warning,' + + 'ZeroDivisionError,_,__build_class__,__debug__,__doc__,__import__,' + + '__loader__,__name__,__package__,__spec__,abs,all,any,apply,ascii,' + + 'basestring,bin,bool,buffer,bytearray,bytes,callable,chr,classmethod,cmp,' + + 'coerce,compile,complex,copyright,credits,delattr,dict,dir,divmod,' + + 'enumerate,eval,exec,execfile,exit,file,filter,float,format,frozenset,' + + 'getattr,globals,hasattr,hash,help,hex,id,input,int,intern,isinstance,' + + 'issubclass,iter,len,license,list,locals,long,map,max,memoryview,min,' + + 'next,object,oct,open,ord,pow,print,property,quit,range,raw_input,reduce,' + + 'reload,repr,reversed,round,set,setattr,slice,sorted,staticmethod,str,' + + 'sum,super,tuple,type,unichr,unicode,vars,xrange,zip' +); + +/** + * Order of operation ENUMs. + * http://docs.python.org/reference/expressions.html#summary + */ +Python.ORDER_ATOMIC = 0; // 0 "" ... +Python.ORDER_COLLECTION = 1; // tuples, lists, dictionaries +Python.ORDER_STRING_CONVERSION = 1; // `expression...` +Python.ORDER_UNARY_POSTFIX = 1; // expr++ expr-- () [] . +Python.ORDER_UNARY_PREFIX = 2; // -expr !expr ~expr ++expr --expr +Python.ORDER_MEMBER = 2.1; // . [] +Python.ORDER_FUNCTION_CALL = 2.2; // () +Python.ORDER_EXPONENTIATION = 3; // ** +Python.ORDER_UNARY_SIGN = 4; // + - +Python.ORDER_BITWISE_NOT = 4; // ~ +Python.ORDER_MULTIPLICATIVE = 5; // * / // % +Python.ORDER_ADDITIVE = 6; // + - +Python.ORDER_BITWISE_SHIFT = 7; // << >> +Python.ORDER_BITWISE_AND = 8; // & +Python.ORDER_BITWISE_XOR = 9; // ^ +Python.ORDER_BITWISE_OR = 10; // | +Python.ORDER_RELATIONAL = 11; // in, not in, is, is not, +// <, <=, >, >=, <>, !=, == +Python.ORDER_EQUALITY = 11; // == != === !== +Python.ORDER_LOGICAL_NOT = 12; // not +Python.ORDER_LOGICAL_AND = 13; // and +Python.ORDER_LOGICAL_OR = 14; // or +Python.ORDER_ASSIGNMENT = 14; // = *= /= ~/= %= += -= <<= >>= &= ^= |= +Python.ORDER_CONDITIONAL = 15; // if else +Python.ORDER_LAMBDA = 16; // lambda +Python.ORDER_NONE = 99; // (...) + +/** + * List of outer-inner pairings that do NOT require parentheses. + * @type {!Array.>} + */ +Python.ORDER_OVERRIDES = [ + // (foo()).bar -> foo().bar + // (foo())[0] -> foo()[0] + [Python.ORDER_FUNCTION_CALL, Python.ORDER_MEMBER], + // (foo())() -> foo()() + [Python.ORDER_FUNCTION_CALL, Python.ORDER_FUNCTION_CALL], + // (foo.bar).baz -> foo.bar.baz + // (foo.bar)[0] -> foo.bar[0] + // (foo[0]).bar -> foo[0].bar + // (foo[0])[1] -> foo[0][1] + [Python.ORDER_MEMBER, Python.ORDER_MEMBER], + // (foo.bar)() -> foo.bar() + // (foo[0])() -> foo[0]() + [Python.ORDER_MEMBER, Python.ORDER_FUNCTION_CALL], + + // not (not foo) -> not not foo + // [Python.ORDER_LOGICAL_NOT, Python.ORDER_LOGICAL_NOT], + // a and (b and c) -> a and b and c + // [Python.ORDER_LOGICAL_AND, Python.ORDER_LOGICAL_AND], + // a or (b or c) -> a or b or c + // [Python.ORDER_LOGICAL_OR, Python.ORDER_LOGICAL_OR] +]; + +Python.init = function () { + /** + * Empty loops or conditionals are not allowed in Python. + */ + Python.PASS = this.INDENT + 'pass\n'; + // Create a dictionary of definitions to be printed before the code. + Python.definitions_ = Object.create(null); + // Create a dictionary mapping desired function names in definitions_ + // to actual function names (to avoid collisions with user functions). + Python.functionNames_ = Object.create(null); + Python.setups_ = Object.create(null); + Python.loops_ = Object.create(null); + Python.codeEnd_ = Object.create(null); + + if (!Python.variableDB_) { + Python.variableDB_ = new Names(Python.RESERVED_WORDS_); + } else { + Python.variableDB_.reset(); + } +} + +function optimizeShowCalls(code) { + // 正则说明： + // - 使用 /s 修饰符让 . 可以匹配换行符 + // - 匹配所有 show() 调用（包括后面的换行符） + // - 但需要确保后续代码中还有 pixel 操作（说明不是最后一个 show()） + const regex = /onboard_tft\.show\(\)\s*\n(?=.*?onboard_tft\.pixel)/gs; + + // 替换所有中间 show() 调用为空字符串 + return code.replace(regex, ''); +} + + +Python.finish = function (code) { + // Convert the definitions dictionary into a list. + if (code !== "") { + code = code.replace(/\n/g, '\n'); + code = code.replace(/\n\s+$/, '\n'); + } + var imports = []; + var definitions_var = []; //变量定义 + var definitions_fun = []; //函数定义 + for (var name in this.definitions_) { + var def = this.definitions_[name]; + if (name.indexOf('import') === 0) { + imports.push(def); + } else if (name.indexOf('var_declare') === 0) { + definitions_var.push(def); + } else { + definitions_fun.push(def); + } + } + if (imports.length) { + imports.push('\n\n'); + } + if (definitions_var.length) { + definitions_var.push('\n\n'); + } + if (definitions_fun.length) { + definitions_fun.push('\n\n'); + } + var functions = []; + for (var name in Python.functions_) { + functions.push(Python.functions_[name]); + } + if (functions.length) { + functions.push('\n\n'); + } + var setups = []; + for (var name in Python.setups_) { + setups.push(Python.setups_[name]); + } + if (setups.length) { + setups.push('\n\n'); + } + var loops = []; + for (var name in Python.loops_) { + loops.push(Python.loops_[name]); + } + var codeEnd = []; + for (var name in Python.codeEnd_) { + codeEnd.push(Python.codeEnd_[name]); + } + if (codeEnd.length !== 0) { + codeEnd.push('\n'); + } + let text = ''; + if (loops.length > 0) { + text = imports.join('\n') + definitions_var.join('\n') + definitions_fun.join('\n') + + functions.join('\n') + setups.join('') + code + 'while True:\n' + loops.join('') + codeEnd.join('\n'); + } else { + text = imports.join('\n') + definitions_var.join('\n') + definitions_fun.join('\n') + + functions.join('\n') + setups.join('') + code + codeEnd.join('\n'); + } + try { + text = optimizeShowCalls(text); + } catch (error) { + console.log(error); + } + return text; +} + + +/** + * Naked values are top-level blocks with outputs that aren't plugged into + * anything. + * @param {string} line Line of generated code. + * @return {string} Legal line of code. + */ +Python.scrubNakedValue = function (line) { + return line + '\n'; +} + +/** + * Encode a string as a properly escaped Python string, complete with quotes. + * @param {string} string Text to encode. + * @return {string} Python string. + * @private + */ +Python.quote_ = function (string) { + // Can't use goog.string.quote since % must also be escaped. + string = string.replace(/\\/g, '\\\\') + .replace(/\n/g, '\\\n'); + + // Follow the CPython behaviour of repr() for a non-byte string. + var quote = '\''; + if (string.indexOf('\'') !== -1) { + if (string.indexOf('"') === -1) { + quote = '"'; + } else { + string = string.replace(/'/g, '\\\''); + } + } + return quote + string + quote; +} + +/** + * Encode a string as a properly escaped multiline Python string, complete + * with quotes. + * @param {string} string Text to encode. + * @return {string} Python string. + * @private + */ +Python.multiline_quote_ = function (string) { + // Can't use goog.string.quote since % must also be escaped. + string = string.replace(/'''/g, '\\\'\\\'\\\''); + return '\'\'\'' + string + '\'\'\''; +} + +/** + * Common tasks for generating Python from blocks. + * Handles comments for the specified block and any connected value blocks. + * Calls any statements following this block. + * @param {!Blockly.Block} block The current block. + * @param {string} code The Python code created for this block. + * @param {boolean=} opt_thisOnly True to generate code for only this statement. + * @return {string} Python code with comments and subsequent blocks added. + * @private + */ +Python.scrub_ = function (block, code, opt_thisOnly) { + var commentCode = ''; + // Only collect comments for blocks that aren't inline. + if (!block.outputConnection || !block.outputConnection.targetConnection) { + // Collect comment for this block. + var comment = block.getCommentText(); + if (comment) { + comment = Blockly.utils.string.wrap(comment, + Python.COMMENT_WRAP - 3); + commentCode += Python.prefixLines(comment + '\n', '# '); + } + // Collect comments for all value arguments. + // Don't collect comments for nested statements. + for (var i = 0; i < block.inputList.length; i++) { + if (block.inputList[i].type == Blockly.INPUT_VALUE) { + var childBlock = block.inputList[i].connection.targetBlock(); + if (childBlock) { + var comment = Python.allNestedComments(childBlock); + if (comment) { + commentCode += Python.prefixLines(comment, '# '); + } + } + } + } + } + var nextBlock = block.nextConnection && block.nextConnection.targetBlock(); + var nextCode = opt_thisOnly ? '' : Python.blockToCode(nextBlock); + return commentCode + code + nextCode; +} + +/** + * Gets a property and adjusts the value, taking into account indexing, and + * casts to an integer. + * @param {!Blockly.Block} block The block. + * @param {string} atId The property ID of the element to get. + * @param {number=} opt_delta Value to add. + * @param {boolean=} opt_negate Whether to negate the value. + * @return {string|number} + */ +Python.getAdjustedInt = function (block, atId, opt_delta, opt_negate) { + var delta = opt_delta || 0; + if (block.workspace.options.oneBasedIndex) { + delta--; + } + var defaultAtIndex = block.workspace.options.oneBasedIndex ? '1' : '0'; + var atOrder = delta ? Python.ORDER_ADDITIVE : + Python.ORDER_NONE; + var at = Python.valueToCode(block, atId, atOrder) || defaultAtIndex; + + if (Blockly.isNumber(at)) { + // If the index is a naked number, adjust it right now. + at = parseInt(at, 10) + delta; + if (opt_negate) { + at = -at; + } + } else { + // If the index is dynamic, adjust it in code. + if (delta > 0) { + at = 'int(' + at + ' + ' + delta + ')'; + } else if (delta < 0) { + at = 'int(' + at + ' - ' + -delta + ')'; + } else { + at = 'int(' + at + ')'; + } + if (opt_negate) { + at = '-' + at; + } + } + return at; +} \ No newline at end of file diff --git a/boards/default_src/micropython_esp32s3/index.js b/boards/default_src/micropython_esp32s3/index.js index 6e0f4125..d6eb38e0 100644 --- a/boards/default_src/micropython_esp32s3/index.js +++ b/boards/default_src/micropython_esp32s3/index.js @@ -29,8 +29,7 @@ import { PythonHtmlGenerators, PythonUtilityGenerators, Procedures, - Variables, - Python + Variables } from '@mixly/python'; import { @@ -73,7 +72,8 @@ import { MicroPythonSensorOnBoardGenerators, MicroPythonSerialGenerators, MicroPythonSystemGenerators, - MicroPythonWeatherGenerators + MicroPythonWeatherGenerators, + Python } from '@mixly/micropython'; import {