Fix order errors in text generators (#4329)

* Fix dart text generator logic * Fix Javascript text generator logic. * Fix Lua text generator logic * Fix php text generator logic * Fix python text generator logic * Fix error in substring logic * Fix unit test block generators * Update from ORDER_COMMA to ORDER_NONE * Update golden files
2026-01-08 17:40:09 +01:00 · 2020-09-30 14:08:45 -07:00
parent 64fe425944
commit 81d355f5fa
17 changed files with 139 additions and 118 deletions
--- a/generators/dart.js
+++ b/generators/dart.js
@@ -50,7 +50,7 @@ Blockly.Dart.addReservedWords(

 /**
 * Order of operation ENUMs.
- * https://www.dartlang.org/docs/dart-up-and-running/ch02.html#operator_table
+ * https://dart.dev/guides/language/language-tour#operators
 */
 Blockly.Dart.ORDER_ATOMIC = 0;         // 0 "" ...
 Blockly.Dart.ORDER_UNARY_POSTFIX = 1;  // expr++ expr-- () [] . ?.
@@ -158,7 +158,7 @@ Blockly.Dart.scrubNakedValue = function(line) {
 * Encode a string as a properly escaped Dart string, complete with quotes.
 * @param {string} string Text to encode.
 * @return {string} Dart string.
- * @private
+ * @protected
 */
 Blockly.Dart.quote_ = function(string) {
  // Can't use goog.string.quote since $ must also be escaped.
@@ -174,7 +174,7 @@ Blockly.Dart.quote_ = function(string) {
 * quotes.
 * @param {string} string Text to encode.
 * @return {string} Dart string.
- * @private
+ * @protected
 */
 Blockly.Dart.multiline_quote_ = function (string) {
  var lines = string.split(/\n/g).map(Blockly.Dart.quote_);
@@ -183,7 +183,6 @@ Blockly.Dart.multiline_quote_ = function (string) {
  return lines.join(' + \'\\n\' + \n');
 };

-
 /**
 * Common tasks for generating Dart from blocks.
 * Handles comments for the specified block and any connected value blocks.
@@ -192,7 +191,7 @@ Blockly.Dart.multiline_quote_ = function (string) {
 * @param {string} code The Dart code created for this block.
 * @param {boolean=} opt_thisOnly True to generate code for only this statement.
 * @return {string} Dart code with comments and subsequent blocks added.
- * @private
+ * @protected
 */
 Blockly.Dart.scrub_ = function(block, code, opt_thisOnly) {
  var commentCode = '';
--- a/generators/dart/text.js
+++ b/generators/dart/text.js
@@ -26,7 +26,9 @@ Blockly.Dart['text'] = function(block) {
 Blockly.Dart['text_multiline'] = function(block) {
  // Text value.
  var code = Blockly.Dart.multiline_quote_(block.getFieldValue('TEXT'));
-  return [code, Blockly.Dart.ORDER_ATOMIC];
+  var order = code.indexOf('+') != -1 ? Blockly.Dart.ORDER_ADDITIVE :
+      Blockly.Dart.ORDER_ATOMIC;
+  return [code, order];
 };

 Blockly.Dart['text_join'] = function(block) {
@@ -92,8 +94,9 @@ Blockly.Dart['text_charAt'] = function(block) {
  // Get letter at index.
  // Note: Until January 2013 this block did not have the WHERE input.
  var where = block.getFieldValue('WHERE') || 'FROM_START';
-  var text = Blockly.Dart.valueToCode(block, 'VALUE',
-      Blockly.Dart.ORDER_UNARY_POSTFIX) || '\'\'';
+  var textOrder = (where == 'FIRST' || where == 'FROM_START') ?
+      Blockly.Dart.ORDER_UNARY_POSTFIX : Blockly.Dart.ORDER_NONE;
+  var text = Blockly.Dart.valueToCode(block, 'VALUE', textOrder) || '\'\'';
  switch (where) {
    case 'FIRST':
      var code = text + '[0]';
@@ -133,14 +136,16 @@ Blockly.Dart['text_charAt'] = function(block) {

 Blockly.Dart['text_getSubstring'] = function(block) {
  // Get substring.
-  var text = Blockly.Dart.valueToCode(block, 'STRING',
-      Blockly.Dart.ORDER_UNARY_POSTFIX) || '\'\'';
  var where1 = block.getFieldValue('WHERE1');
  var where2 = block.getFieldValue('WHERE2');
+  var requiresLengthCall = (where1 != 'FROM_END' && where2 == 'FROM_START');
+  var textOrder = requiresLengthCall ? Blockly.Dart.ORDER_UNARY_POSTFIX :
+      Blockly.Dart.ORDER_NONE;
+  var text = Blockly.Dart.valueToCode(block, 'STRING', textOrder) || '\'\'';
  if (where1 == 'FIRST' && where2 == 'LAST') {
    var code = text;
-  } else if (text.match(/^'?\w+'?$/) ||
-      (where1 != 'FROM_END' && where2 == 'FROM_START')) {
+    return [code, Blockly.Dart.ORDER_NONE];
+  } else if (text.match(/^'?\w+'?$/) || requiresLengthCall) {
    // If the text is a variable or literal or doesn't require a call for
    // length, don't generate a helper function.
    switch (where1) {
@@ -290,7 +295,7 @@ Blockly.Dart['text_prompt'] = Blockly.Dart['text_prompt_ext'];

 Blockly.Dart['text_count'] = function(block) {
  var text = Blockly.Dart.valueToCode(block, 'TEXT',
-      Blockly.Dart.ORDER_UNARY_POSTFIX) || '\'\'';
+      Blockly.Dart.ORDER_NONE) || '\'\'';
  var sub = Blockly.Dart.valueToCode(block, 'SUB',
      Blockly.Dart.ORDER_NONE) || '\'\'';
  // Substring count is not a native Dart function.  Define one.
@@ -334,6 +339,5 @@ Blockly.Dart['text_reverse'] = function(block) {
  var text = Blockly.Dart.valueToCode(block, 'TEXT',
      Blockly.Dart.ORDER_UNARY_POSTFIX) || '\'\'';
  var code = 'new String.fromCharCodes(' + text + '.runes.toList().reversed)';
-  // XXX What should the operator precedence be for a `new`?
-  return [code, Blockly.Dart.ORDER_UNARY_POSTFIX];
+  return [code, Blockly.Dart.ORDER_UNARY_PREFIX];
 };
--- a/generators/javascript.js
+++ b/generators/javascript.js
@@ -188,7 +188,7 @@ Blockly.JavaScript.scrubNakedValue = function(line) {
 * quotes.
 * @param {string} string Text to encode.
 * @return {string} JavaScript string.
- * @private
+ * @protected
 */
 Blockly.JavaScript.quote_ = function(string) {
  // Can't use goog.string.quote since Google's style guide recommends
@@ -204,7 +204,7 @@ Blockly.JavaScript.quote_ = function(string) {
 * with quotes.
 * @param {string} string Text to encode.
 * @return {string} JavaScript string.
- * @private
+ * @protected
 */
 Blockly.JavaScript.multiline_quote_ = function(string) {
  // Can't use goog.string.quote since Google's style guide recommends
@@ -221,7 +221,7 @@ Blockly.JavaScript.multiline_quote_ = function(string) {
 * @param {string} code The JavaScript code created for this block.
 * @param {boolean=} opt_thisOnly True to generate code for only this statement.
 * @return {string} JavaScript code with comments and subsequent blocks added.
- * @private
+ * @protected
 */
 Blockly.JavaScript.scrub_ = function(block, code, opt_thisOnly) {
  var commentCode = '';
--- a/generators/javascript/text.js
+++ b/generators/javascript/text.js
@@ -24,24 +24,24 @@ Blockly.JavaScript['text'] = function(block) {
 Blockly.JavaScript['text_multiline'] = function(block) {
  // Text value.
  var code = Blockly.JavaScript.multiline_quote_(block.getFieldValue('TEXT'));
-  if (code.indexOf('\n') != -1) {
-      code = '(' + code + ')'
-  }
-  return [code, Blockly.JavaScript.ORDER_ATOMIC];
+  var order = code.indexOf('+') != -1 ? Blockly.JavaScript.ORDER_ADDITION :
+      Blockly.JavaScript.ORDER_ATOMIC;
+  return [code, order];
 };

 /**
 * Enclose the provided value in 'String(...)' function.
 * Leave string literals alone.
 * @param {string} value Code evaluating to a value.
- * @return {string} Code evaluating to a string.
+ * @return {[string, number]} Array containing code evaluating to a string and
+ *    the order of the returned code.
 * @private
 */
 Blockly.JavaScript.text.forceString_ = function(value) {
  if (Blockly.JavaScript.text.forceString_.strRegExp.test(value)) {
-    return value;
+    return [value, Blockly.JavaScript.ORDER_ATOMIC];
  }
-  return 'String(' + value + ')';
+  return ['String(' + value + ')', Blockly.JavaScript.ORDER_FUNCTION_CALL];
 };

 /**
@@ -57,21 +57,21 @@ Blockly.JavaScript['text_join'] = function(block) {
    case 1:
      var element = Blockly.JavaScript.valueToCode(block, 'ADD0',
          Blockly.JavaScript.ORDER_NONE) || '\'\'';
-      var code = Blockly.JavaScript.text.forceString_(element);
-      return [code, Blockly.JavaScript.ORDER_FUNCTION_CALL];
+      var codeAndOrder = Blockly.JavaScript.text.forceString_(element);
+      return codeAndOrder;
    case 2:
      var element0 = Blockly.JavaScript.valueToCode(block, 'ADD0',
          Blockly.JavaScript.ORDER_NONE) || '\'\'';
      var element1 = Blockly.JavaScript.valueToCode(block, 'ADD1',
          Blockly.JavaScript.ORDER_NONE) || '\'\'';
-      var code = Blockly.JavaScript.text.forceString_(element0) + ' + ' +
-          Blockly.JavaScript.text.forceString_(element1);
+      var code = Blockly.JavaScript.text.forceString_(element0)[0] +
+          ' + ' + Blockly.JavaScript.text.forceString_(element1)[0];
      return [code, Blockly.JavaScript.ORDER_ADDITION];
    default:
      var elements = new Array(block.itemCount_);
      for (var i = 0; i < block.itemCount_; i++) {
        elements[i] = Blockly.JavaScript.valueToCode(block, 'ADD' + i,
-            Blockly.JavaScript.ORDER_COMMA) || '\'\'';
+            Blockly.JavaScript.ORDER_NONE) || '\'\'';
      }
      var code = '[' + elements.join(',') + '].join(\'\')';
      return [code, Blockly.JavaScript.ORDER_FUNCTION_CALL];
@@ -84,13 +84,15 @@ Blockly.JavaScript['text_append'] = function(block) {
      block.getFieldValue('VAR'), Blockly.VARIABLE_CATEGORY_NAME);
  var value = Blockly.JavaScript.valueToCode(block, 'TEXT',
      Blockly.JavaScript.ORDER_NONE) || '\'\'';
-  return varName + ' += ' + Blockly.JavaScript.text.forceString_(value) + ';\n';
+  var code = varName + ' += ' +
+      Blockly.JavaScript.text.forceString_(value)[0] + ';\n';
+  return code;
 };

 Blockly.JavaScript['text_length'] = function(block) {
  // String or array length.
  var text = Blockly.JavaScript.valueToCode(block, 'VALUE',
-      Blockly.JavaScript.ORDER_FUNCTION_CALL) || '\'\'';
+      Blockly.JavaScript.ORDER_MEMBER) || '\'\'';
  return [text + '.length', Blockly.JavaScript.ORDER_MEMBER];
 };

@@ -177,15 +179,20 @@ Blockly.JavaScript.text.getIndex_ = function(stringName, where, opt_at) {

 Blockly.JavaScript['text_getSubstring'] = function(block) {
  // Get substring.
-  var text = Blockly.JavaScript.valueToCode(block, 'STRING',
-      Blockly.JavaScript.ORDER_FUNCTION_CALL) || '\'\'';
  var where1 = block.getFieldValue('WHERE1');
  var where2 = block.getFieldValue('WHERE2');
+  var requiresLengthCall = (where1 != 'FROM_END' && where1 != 'LAST' &&
+      where2 != 'FROM_END' && where2 != 'LAST');
+  var textOrder = requiresLengthCall ? Blockly.JavaScript.ORDER_MEMBER :
+      Blockly.JavaScript.ORDER_NONE;
+  var text = Blockly.JavaScript.valueToCode(block, 'STRING',
+      textOrder) || '\'\'';
  if (where1 == 'FIRST' && where2 == 'LAST') {
+    var text = Blockly.JavaScript.valueToCode(block, 'STRING',
+        Blockly.JavaScript.ORDER_NONE) || '\'\'';
    var code = text;
-  } else if (text.match(/^'?\w+'?$/) ||
-      (where1 != 'FROM_END' && where1 != 'LAST' &&
-      where2 != 'FROM_END' && where2 != 'LAST')) {
+    return [code, Blockly.JavaScript.ORDER_NONE];
+  } else if (text.match(/^'?\w+'?$/) || requiresLengthCall) {
    // If the text is a variable or literal or doesn't require a call for
    // length, don't generate a helper function.
    switch (where1) {
@@ -320,7 +327,7 @@ Blockly.JavaScript['text_prompt'] = Blockly.JavaScript['text_prompt_ext'];

 Blockly.JavaScript['text_count'] = function(block) {
  var text = Blockly.JavaScript.valueToCode(block, 'TEXT',
-      Blockly.JavaScript.ORDER_MEMBER) || '\'\'';
+      Blockly.JavaScript.ORDER_NONE) || '\'\'';
  var sub = Blockly.JavaScript.valueToCode(block, 'SUB',
      Blockly.JavaScript.ORDER_NONE) || '\'\'';
  var functionName = Blockly.JavaScript.provideFunction_(
@@ -334,12 +341,12 @@ Blockly.JavaScript['text_count'] = function(block) {
       '  }',
       '}']);
  var code = functionName + '(' + text + ', ' + sub + ')';
-  return [code, Blockly.JavaScript.ORDER_SUBTRACTION];
+  return [code, Blockly.JavaScript.ORDER_FUNCTION_CALL];
 };

 Blockly.JavaScript['text_replace'] = function(block) {
  var text = Blockly.JavaScript.valueToCode(block, 'TEXT',
-      Blockly.JavaScript.ORDER_MEMBER) || '\'\'';
+      Blockly.JavaScript.ORDER_NONE) || '\'\'';
  var from = Blockly.JavaScript.valueToCode(block, 'FROM',
      Blockly.JavaScript.ORDER_NONE) || '\'\'';
  var to = Blockly.JavaScript.valueToCode(block, 'TO',
@@ -356,12 +363,12 @@ Blockly.JavaScript['text_replace'] = function(block) {
       '  return haystack.replace(new RegExp(needle, \'g\'), replacement);',
       '}']);
  var code = functionName + '(' + text + ', ' + from + ', ' + to + ')';
-  return [code, Blockly.JavaScript.ORDER_MEMBER];
+  return [code, Blockly.JavaScript.ORDER_FUNCTION_CALL];
 };

 Blockly.JavaScript['text_reverse'] = function(block) {
  var text = Blockly.JavaScript.valueToCode(block, 'TEXT',
      Blockly.JavaScript.ORDER_MEMBER) || '\'\'';
  var code = text + '.split(\'\').reverse().join(\'\')';
-  return [code, Blockly.JavaScript.ORDER_MEMBER];
+  return [code, Blockly.JavaScript.ORDER_FUNCTION_CALL];
 };
--- a/generators/lua.js
+++ b/generators/lua.js
@@ -134,7 +134,7 @@ Blockly.Lua.scrubNakedValue = function(line) {
 * quotes.
 * @param {string} string Text to encode.
 * @return {string} Lua string.
- * @private
+ * @protected
 */
 Blockly.Lua.quote_ = function(string) {
  string = string.replace(/\\/g, '\\\\')
@@ -148,7 +148,7 @@ Blockly.Lua.quote_ = function(string) {
 * quotes.
 * @param {string} string Text to encode.
 * @return {string} Lua string.
- * @private
+ * @protected
 */
 Blockly.Lua.multiline_quote_ = function(string) {
  var lines = string.split(/\n/g).map(Blockly.Lua.quote_);
@@ -165,7 +165,7 @@ Blockly.Lua.multiline_quote_ = function(string) {
 * @param {string} code The Lua code created for this block.
 * @param {boolean=} opt_thisOnly True to generate code for only this statement.
 * @return {string} Lua code with comments and subsequent blocks added.
- * @private
+ * @protected
 */
 Blockly.Lua.scrub_ = function(block, code, opt_thisOnly) {
  var commentCode = '';
--- a/generators/lua/text.js
+++ b/generators/lua/text.js
@@ -24,7 +24,9 @@ Blockly.Lua['text'] = function(block) {
 Blockly.Lua['text_multiline'] = function(block) {
  // Text value.
  var code = Blockly.Lua.multiline_quote_(block.getFieldValue('TEXT'));
-  return [code, Blockly.Lua.ORDER_ATOMIC];
+  var order = code.indexOf('..') != -1 ? Blockly.Lua.ORDER_CONCATENATION :
+      Blockly.Lua.ORDER_ATOMIC;
+  return [code, order];
 };

 Blockly.Lua['text_join'] = function(block) {
@@ -347,7 +349,7 @@ Blockly.Lua['text_replace'] = function(block) {

 Blockly.Lua['text_reverse'] = function(block) {
  var text = Blockly.Lua.valueToCode(block, 'TEXT',
-      Blockly.Lua.ORDER_HIGH) || '\'\'';
+      Blockly.Lua.ORDER_NONE) || '\'\'';
  var code = 'string.reverse(' + text + ')';
  return [code, Blockly.Lua.ORDER_HIGH];
 };
--- a/generators/php.js
+++ b/generators/php.js
@@ -190,7 +190,7 @@ Blockly.PHP.scrubNakedValue = function(line) {
 * quotes.
 * @param {string} string Text to encode.
 * @return {string} PHP string.
- * @private
+ * @protected
 */
 Blockly.PHP.quote_ = function(string) {
  string = string.replace(/\\/g, '\\\\')
@@ -204,7 +204,7 @@ Blockly.PHP.quote_ = function(string) {
 * quotes.
 * @param {string} string Text to encode.
 * @return {string} PHP string.
- * @private
+ * @protected
 */
 Blockly.PHP.multiline_quote_ = function (string) {
  var lines = string.split(/\n/g).map(Blockly.PHP.quote_);
@@ -222,7 +222,7 @@ Blockly.PHP.multiline_quote_ = function (string) {
 * @param {string} code The PHP code created for this block.
 * @param {boolean=} opt_thisOnly True to generate code for only this statement.
 * @return {string} PHP code with comments and subsequent blocks added.
- * @private
+ * @protected
 */
 Blockly.PHP.scrub_ = function(block, code, opt_thisOnly) {
  var commentCode = '';
--- a/generators/php/text.js
+++ b/generators/php/text.js
@@ -24,7 +24,9 @@ Blockly.PHP['text'] = function(block) {
 Blockly.PHP['text_multiline'] = function(block) {
  // Text value.
  var code = Blockly.PHP.multiline_quote_(block.getFieldValue('TEXT'));
-  return [code, Blockly.PHP.ORDER_ATOMIC];
+  var order = code.indexOf('.') != -1 ? Blockly.PHP.ORDER_STRING_CONCAT :
+      Blockly.PHP.ORDER_ATOMIC;
+  return [code, order];
 };

 Blockly.PHP['text_join'] = function(block) {
@@ -35,19 +37,19 @@ Blockly.PHP['text_join'] = function(block) {
    var element = Blockly.PHP.valueToCode(block, 'ADD0',
        Blockly.PHP.ORDER_NONE) || '\'\'';
    var code = element;
-    return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+    return [code, Blockly.PHP.ORDER_NONE];
  } else if (block.itemCount_ == 2) {
    var element0 = Blockly.PHP.valueToCode(block, 'ADD0',
-        Blockly.PHP.ORDER_ATOMIC) || '\'\'';
+        Blockly.PHP.ORDER_STRING_CONCAT) || '\'\'';
    var element1 = Blockly.PHP.valueToCode(block, 'ADD1',
-        Blockly.PHP.ORDER_ATOMIC) || '\'\'';
+        Blockly.PHP.ORDER_STRING_CONCAT) || '\'\'';
    var code = element0 + ' . ' + element1;
    return [code, Blockly.PHP.ORDER_STRING_CONCAT];
  } else {
    var elements = new Array(block.itemCount_);
    for (var i = 0; i < block.itemCount_; i++) {
      elements[i] = Blockly.PHP.valueToCode(block, 'ADD' + i,
-          Blockly.PHP.ORDER_COMMA) || '\'\'';
+          Blockly.PHP.ORDER_NONE) || '\'\'';
    }
    var code = 'implode(\'\', array(' + elements.join(',') + '))';
    return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
@@ -118,7 +120,7 @@ Blockly.PHP['text_charAt'] = function(block) {
  // Get letter at index.
  var where = block.getFieldValue('WHERE') || 'FROM_START';
  var textOrder = (where == 'RANDOM') ? Blockly.PHP.ORDER_NONE :
-      Blockly.PHP.ORDER_COMMA;
+      Blockly.PHP.ORDER_NONE;
  var text = Blockly.PHP.valueToCode(block, 'VALUE', textOrder) || '\'\'';
  switch (where) {
    case 'FIRST':
@@ -149,13 +151,16 @@ Blockly.PHP['text_charAt'] = function(block) {

 Blockly.PHP['text_getSubstring'] = function(block) {
  // Get substring.
-  var text = Blockly.PHP.valueToCode(block, 'STRING',
-      Blockly.PHP.ORDER_FUNCTION_CALL) || '\'\'';
  var where1 = block.getFieldValue('WHERE1');
  var where2 = block.getFieldValue('WHERE2');
  if (where1 == 'FIRST' && where2 == 'LAST') {
+    var text = Blockly.PHP.valueToCode(block, 'STRING',
+        Blockly.PHP.ORDER_NONE) || '\'\'';
    var code = text;
+    return [code, Blockly.PHP.ORDER_NONE];
  } else {
+    var text = Blockly.PHP.valueToCode(block, 'STRING',
+        Blockly.PHP.ORDER_NONE) || '\'\'';
    var at1 = Blockly.PHP.getAdjusted(block, 'AT1');
    var at2 = Blockly.PHP.getAdjusted(block, 'AT2');
    var functionName = Blockly.PHP.provideFunction_(
@@ -183,8 +188,8 @@ Blockly.PHP['text_getSubstring'] = function(block) {
         '}']);
    var code = functionName + '(' + text + ', \'' +
        where1 + '\', ' + at1 + ', \'' + where2 + '\', ' + at2 + ')';
+    return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
  }
-  return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
 };

 Blockly.PHP['text_changeCase'] = function(block) {
@@ -243,7 +248,7 @@ Blockly.PHP['text_prompt'] = Blockly.PHP['text_prompt_ext'];

 Blockly.PHP['text_count'] = function(block) {
  var text = Blockly.PHP.valueToCode(block, 'TEXT',
-      Blockly.PHP.ORDER_MEMBER) || '\'\'';
+      Blockly.PHP.ORDER_NONE) || '\'\'';
  var sub = Blockly.PHP.valueToCode(block, 'SUB',
      Blockly.PHP.ORDER_NONE) || '\'\'';
  var code = 'strlen(' + sub + ') === 0'
@@ -254,7 +259,7 @@ Blockly.PHP['text_count'] = function(block) {

 Blockly.PHP['text_replace'] = function(block) {
  var text = Blockly.PHP.valueToCode(block, 'TEXT',
-      Blockly.PHP.ORDER_MEMBER) || '\'\'';
+      Blockly.PHP.ORDER_NONE) || '\'\'';
  var from = Blockly.PHP.valueToCode(block, 'FROM',
      Blockly.PHP.ORDER_NONE) || '\'\'';
  var to = Blockly.PHP.valueToCode(block, 'TO',
@@ -265,7 +270,7 @@ Blockly.PHP['text_replace'] = function(block) {

 Blockly.PHP['text_reverse'] = function(block) {
  var text = Blockly.PHP.valueToCode(block, 'TEXT',
-      Blockly.PHP.ORDER_MEMBER) || '\'\'';
+      Blockly.PHP.ORDER_NONE) || '\'\'';
  var code = 'strrev(' + text + ')';
  return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
 };
--- a/generators/python.js
+++ b/generators/python.js
@@ -207,7 +207,7 @@ Blockly.Python.scrubNakedValue = function(line) {
 * Encode a string as a properly escaped Python string, complete with quotes.
 * @param {string} string Text to encode.
 * @return {string} Python string.
- * @private
+ * @protected
 */
 Blockly.Python.quote_ = function(string) {
  // Can't use goog.string.quote since % must also be escaped.
@@ -222,7 +222,7 @@ Blockly.Python.quote_ = function(string) {
    } else {
      string = string.replace(/'/g, '\\\'');
    }
-  };
+  }
  return quote + string + quote;
 };

@@ -231,7 +231,7 @@ Blockly.Python.quote_ = function(string) {
 * with quotes.
 * @param {string} string Text to encode.
 * @return {string} Python string.
- * @private
+ * @protected
 */
 Blockly.Python.multiline_quote_ = function(string) {
  var lines = string.split(/\n/g).map(Blockly.Python.quote_);
@@ -248,7 +248,7 @@ Blockly.Python.multiline_quote_ = function(string) {
 * @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
+ * @protected
 */
 Blockly.Python.scrub_ = function(block, code, opt_thisOnly) {
  var commentCode = '';
--- a/generators/python/text.js
+++ b/generators/python/text.js
@@ -24,21 +24,24 @@ Blockly.Python['text'] = function(block) {
 Blockly.Python['text_multiline'] = function(block) {
  // Text value.
  var code = Blockly.Python.multiline_quote_(block.getFieldValue('TEXT'));
-  return [code, Blockly.Python.ORDER_ATOMIC];
+  var order = code.indexOf('+') != -1 ? Blockly.Python.ORDER_ADDITIVE :
+      Blockly.Python.ORDER_ATOMIC;
+  return [code, order];
 };

 /**
 * Enclose the provided value in 'str(...)' function.
 * Leave string literals alone.
 * @param {string} value Code evaluating to a value.
- * @return {string} Code evaluating to a string.
+ * @return {[string, number]} Array containing code evaluating to a string and
+ *    the order of the returned code.
 * @private
 */
 Blockly.Python.text.forceString_ = function(value) {
  if (Blockly.Python.text.forceString_.strRegExp.test(value)) {
-    return value;
+    return [value, Blockly.Python.ORDER_ATOMIC];
  }
-  return 'str(' + value + ')';
+  return ['str(' + value + ')', Blockly.Python.ORDER_FUNCTION_CALL];
 };

 /**
@@ -56,16 +59,16 @@ Blockly.Python['text_join'] = function(block) {
    case 1:
      var element = Blockly.Python.valueToCode(block, 'ADD0',
              Blockly.Python.ORDER_NONE) || '\'\'';
-      var code = Blockly.Python.text.forceString_(element);
-      return [code, Blockly.Python.ORDER_FUNCTION_CALL];
+      var codeAndOrder = Blockly.Python.text.forceString_(element);
+      return codeAndOrder;
      break;
    case 2:
      var element0 = Blockly.Python.valueToCode(block, 'ADD0',
          Blockly.Python.ORDER_NONE) || '\'\'';
      var element1 = Blockly.Python.valueToCode(block, 'ADD1',
          Blockly.Python.ORDER_NONE) || '\'\'';
-      var code = Blockly.Python.text.forceString_(element0) + ' + ' +
-          Blockly.Python.text.forceString_(element1);
+      var code = Blockly.Python.text.forceString_(element0)[0] + ' + ' +
+          Blockly.Python.text.forceString_(element1)[0];
      return [code, Blockly.Python.ORDER_ADDITIVE];
      break;
    default:
@@ -89,7 +92,7 @@ Blockly.Python['text_append'] = function(block) {
  var value = Blockly.Python.valueToCode(block, 'TEXT',
      Blockly.Python.ORDER_NONE) || '\'\'';
  return varName + ' = str(' + varName + ') + ' +
-      Blockly.Python.text.forceString_(value) + '\n';
+      Blockly.Python.text.forceString_(value)[0] + '\n';
 };

 Blockly.Python['text_length'] = function(block) {
@@ -126,8 +129,9 @@ Blockly.Python['text_charAt'] = function(block) {
  // Get letter at index.
  // Note: Until January 2013 this block did not have the WHERE input.
  var where = block.getFieldValue('WHERE') || 'FROM_START';
-  var text = Blockly.Python.valueToCode(block, 'VALUE',
-      Blockly.Python.ORDER_MEMBER) || '\'\'';
+  var textOrder = (where == 'RANDOM') ? Blockly.Python.ORDER_NONE :
+      Blockly.Python.ORDER_MEMBER;
+  var text = Blockly.Python.valueToCode(block, 'VALUE', textOrder) || '\'\'';
  switch (where) {
    case 'FIRST':
      var code = text + '[0]';
@@ -271,7 +275,7 @@ Blockly.Python['text_count'] = function(block) {
  var sub = Blockly.Python.valueToCode(block, 'SUB',
      Blockly.Python.ORDER_NONE) || '\'\'';
  var code = text + '.count(' + sub + ')';
-  return [code, Blockly.Python.ORDER_MEMBER];
+  return [code, Blockly.Python.ORDER_FUNCTION_CALL];
 };

 Blockly.Python['text_replace'] = function(block) {