Field Detail

• TRANSLATOR_NAME

  public static final String TRANSLATOR_NAME

  The variable name used to reference the current translator instance.

  See Also:

  Constant Field Values

Method Detail

• concatPyExprs

  public static PyExpr concatPyExprs(List<? extends PyExpr> pyExprs)

  Builds one Python expression that computes the concatenation of the given Python expressions.

  Python doesn't allow arbitrary concatentation between types, so to ensure type safety and consistent behavior, coerce all expressions to Strings before joining them. Python's array joining mechanism is used in place of traditional concatenation to improve performance.

  Parameters:

  pyExprs - The Python expressions to concatenate.

  Returns:

  One Python expression that computes the concatenation of the given Python expressions.

• genPyNotNullCheck

  public static PyExpr genPyNotNullCheck(PyExpr pyExpr)

  Generates a Python not null (None) check expression for the given PyExpr.

• genPyNullCheck

  public static PyExpr genPyNullCheck(PyExpr expr)

  Generates a Python null (None) check expression for the given PyExpr.

• maybeProtect

  public static PyExpr maybeProtect(PyExpr expr,
                    int minSafePrecedence)

  Wraps an expression with parenthesis if it's not above the minimum safe precedence.

  NOTE: For the sake of brevity, this implementation loses typing information in the expressions.

  Parameters:

  expr - The expression to wrap.

  minSafePrecedence - The minimum safe precedence (not inclusive).

  Returns:

  The PyExpr potentially wrapped in parenthesis.

• wrapAsSanitizedContent

  public static PyExpr wrapAsSanitizedContent(SanitizedContent.ContentKind contentKind,
                              PyExpr pyExpr)

  Wraps an expression with the proper SanitizedContent constructor.

  NOTE: The pyExpr provided must be properly escaped for the given ContentKind. Please talk to ISE (ise@) for any questions or concerns.

  Parameters:

  contentKind - The kind of sanitized content.

  pyExpr - The expression to wrap.

• pyPrecedenceForOperator

  public static int pyPrecedenceForOperator(Operator op)

  Provide the Python operator precedence for a given operator.

  Parameters:

  op - The operator.

  Returns:

  THe python precedence as an integer.

• convertIterableToPyListExpr

  public static PyExpr convertIterableToPyListExpr(Iterable<?> iterable)

  Convert a java Iterable object to valid PyExpr as array.

  Parameters:

  iterable - Iterable of Objects to be converted to PyExpr, it must be Number, PyExpr or String.

• convertIterableToPyTupleExpr

  public static PyExpr convertIterableToPyTupleExpr(Iterable<?> iterable)

  Convert a java Iterable object to valid PyExpr as tuple.

  Parameters:

  iterable - Iterable of Objects to be converted to PyExpr, it must be Number, PyExpr or String.

• convertMapToOrderedDict

  public static PyExpr convertMapToOrderedDict(Map<PyExpr,PyExpr> dict)

  Convert a java Map to valid PyExpr as dict.

  Parameters:

  dict - A Map to be converted to PyExpr as a dictionary, both key and value should be PyExpr.

• convertMapToPyExpr

  public static PyExpr convertMapToPyExpr(Map<PyExpr,PyExpr> dict)

  Convert a java Map to valid PyExpr as dict.

  Parameters:

  dict - A Map to be converted to PyExpr as a dictionary, both key and value should be PyExpr.