Python Compatibility

Workspace/Transformer Parameters > Scripting > Python Compatibility

This parameter specifies the level of compatibility your workspace or custom transformer has with different versions of the Python programming language, and determines the Python interpreter used by FME when running a workspace.

FME loads a Python interpreter that is either compatible or potentially compatible with this setting. On Windows and Mac OS X, this is a Python 3.9 interpreter bundled with FME, and on Linux, it is the Python interpreter installed on the system.

On Windows, a custom Python interpreter can be used instead of the interpreter bundled with FME by specifying a custom interpreter for the Preferred Python Interpreter setting in Translation. FME will use that interpreter as long as it is compatible or potentially compatible with the workspace's Python Compatibility setting.

Note: When an interpreter loads that is potentially compatible with this setting, a warning is logged.

Backward Compatibility

If a workspace was created in a previous version of Workbench with Python Compatibility set to Python 2.7 or Esri ArcGIS Python 2.7, one of the following occurs when the workspace is opened:

  • If the workspace does not contain user-defined Python, Python Compatibility automatically updates to the latest supported Python version.
  • If the workspace contains user-defined Python, a warning displays to inform you that Python Compatibility will automatically update to the latest supported Python version, which may cause unexpected behavior at workspace runtime.

Custom transformers with Python Compatibility set to Python 2.7 or Esri ArcGIS Python 2.7 must be manually updated to a supported setting before embedding or linking in a workspace.

Note: Python 3.0 introduced significant changes that are not backward compatible with Python 2.x. For more information, see https://wiki.python.org/moin/Python2orPython3.

Compatibility Levels

  • Compatible: Python version x.y is compatible with w.z if x == w and y >= z
  • Potentially compatible: Python version x.y is potentially compatible to version w.z if x == w and y < z
  • Incompatible: Python version x.y is incompatible with version w.z if x != w

Note: Esri ArcGIS Python interpreters are only compatible or potentially compatible with other Esri ArcGIS Python interpreters because they provide guaranteed access to the ArcPy package.

Specifying a Compatibility

  • Python 3.9+: The workspace or custom transformer is compatible with Python 3.9 and higher. This value is the default when Preferred Python Interpreter (Tools > FME Options > Translation) is FME Python 3.9+ or a custom interpreter based on Python 3.9 or higher.
  • Python 3.8+: The workspace or custom transformer is compatible with Python 3.8 and higher. This value is the default when Preferred Python Interpreter (Tools > FME Options > Translation) is FME Python 3.8+ or a custom interpreter based on Python 3.8 or higher.
  • Python 3.7+: The workspace or custom transformer is compatible with Python 3.7 and higher. This value is the default when Preferred Python Interpreter (Tools > FME Options > Translation) is FME Python 3.7+ or a custom interpreter based on Python 3.7 or higher.
  • Python 3.6+: The workspace or custom transformer is compatible with Python 3.6 and higher. This value is the default when Preferred Python Interpreter (Tools > FME Options > Translation) is FME Python 3.6+ or a custom interpreter based on Python 3.6 or higher.
  • Esri ArcGIS Python 3.9: The workspace or custom transformer is compatible with the Python 3.9 interpreter distributed with ArcGIS Pro 3.0 and ArcGIS Server 11. This value is the default when Preferred Python Interpreter (Tools > FME Options > Translation) is Esri ArcGIS Python 3.9.
  • Esri ArcGIS Python 3.7+: The workspace or custom transformer is compatible with the Python 3.7 interpreter distributed with ArcGIS Pro 2.7, ArcGIS Pro 2.8, ArcGIS Pro 2.9, and ArcGIS Server 10.9. This value is the default when Preferred Python Interpreter (Tools > FME Options > Translation) is Esri ArcGIS Python 3.7.
  • Esri ArcGIS Python 3.6+: The workspace or custom transformer is compatible with the Python 3.6 interpreter distributed with ArcGIS Pro 2.1- 2.6 and ArcGIS Server 10.6 - 10.8. This value is the default when Preferred Python Interpreter (Tools > FME Options > Translation) is Esri ArcGIS Python 3.6.

Scenarios

To run a Python-enabled workspace/custom transformer as optimally as possible on FME Desktop

Leave Python Compatibility at its default setting.

To use a specific Python interpreter, such as a system-specific interpreter with custom modules

Set Python Compatibility to match the Python version of the custom interpreter specified by the Use Custom Intepreter setting of the Preferred Python Interpreter option (Tools > FME Options > Translation).

To run Python code that uses features from a specific version of Python

Set Python Compatibility to the appropriate version of Python.

To ensure the greatest compatibility with other FME Desktop users and/or FME Server.

Leave Python Compatibility at its default setting.

To use an Esri ArcGIS Python interpreter to make use of the ArcPy package

Set Python Compatibility to one of the settings compatible with the Python 3.x interpreter distributed with ArcGIS Pro.