Analyze Tools For Pro (Data Management)

Summary

Analyzes Python scripts and custom geoprocessing tools and toolboxes for functionality that is not supported in AllSource.

There are differences between AllSource and ArcGIS 10.x that may mean changes to some custom tools and scripts so they run successfully in AllSource. These changes include geoprocessing tools and environments that are not supported in AllSource, the replacement of the arcpy.mapping module with the arcpy.mp module, unsupported data formats (such as a personal geodatabase), and an upgrade to Python 3 from Python 2.

Usage

  • Any issues identified will be included in the tool messages as warnings.

  • AllSource uses Python 3. While many scripts may continue to work as is, others will not.

    For tips in updating Python scripts to work in AllSource, see Python migration from 10.x to ArcGIS Pro.

  • For Python 2 to Python 3 issues, Analyze Tools For Pro uses the Python 2to3 utility to review Python code. The Python 2to3 utility can be used to review Python 2.x code against a series of fixers that show how the code can be transformed to valid Python 3.x code.

  • The Python 2to3 utility can be used directly from the command prompt and has a rich set of options for analyzing Python code that are not available through Analyze Tools For Pro, such as applying only specific fixers or updating the code in place. For more information, see https://docs.python.org/3/library/2to3.html.

Parameters

LabelExplanationData Type
Input

The input can be a geoprocessing toolbox or Python file.

Toolbox; String; File
Output File
(Optional)

An output text file that includes all issues.

File

arcpy.management.AnalyzeToolsForPro(input, {report})
NameExplanationData Type
input

The input can be a geoprocessing toolbox, Python file, or a tool name.

Note:

If a tool name is specified, the tool will need to be loaded first using the arcpy.ImportToolbox function to be recognized. Tool names should include the toolbox alias.

Toolbox; String; File
report
(Optional)

An output text file that includes all issues.

File

Code sample

AnalyzeToolsForPro example 1

Analyze a Python script for AllSource.

import arcpy
arcpy.AnalyzeToolsForPro_management('c:/tools/scripts/myutils.py', 'c:/temp/analyze_report.txt')

print(arcpy.GetMessages(1))
AnalyzeToolsForPro example 2

Analyze a geoprocessing toolbox for AllSource.

import arcpy
arcpy.AnalyzeToolsForPro_management('c:/tools/scripts/mytools.tbx', 'c:/temp/analyze_report.txt')

print(arcpy.GetMessages(1))
AnalyzeToolsForPro example 3

Analyze a geoprocessing tool for AllSource. To analyze a tool, first import the toolbox using ImportToolbox, and then pass in the tool name with an alias to AnalyzeToolsForPro.

import arcpy

arcpy.ImportToolbox('c:/tools/scripts/mytools.tbx')
arcpy.AnalyzeToolsForPro_management('mytool_tools', 'c:/temp/analyze_report.txt')

print(arcpy.GetMessages(1))

Environments