現在、ArcGIS arcpy ライブラリを使用するスクリプトのスフィンクス ドキュメントを生成しようとしています。
arcpy スクリプトが arcgis GUI から入力パラメーターを取得するため、ドキュメントの生成中に sphinx がスクリプトを実行しようとすると、問題が発生します。sphinx は GUI なしでスクリプトを呼び出しているため、これらのパラメーターは空であり、次のようなトレースバックを引き起こしています。
C:\VersionControl\PythonScripts\Source\src\_build\script_export_pdf.rst:4: WARNING: autodoc: failed to import module u'gis.scripts.script_export_pdf'; the following exception was raised:
Traceback (most recent call last):
File "C:\VersionControl\PythonScripts\Source\src\lib\Python27\ArcGIS10.1\lib\site-packages\sphinx\ext\autodoc.py", line 335, in import_object
__import__(self.modname)
File "C:\VersionControl\PythonScripts\Source\src\gis\scripts\script_export_pdf.py", line 76, in <module>
mxd.ExportToPDF(in_mxds, out_folder, overwrite, current)
File "C:\VersionControl\PythonScripts\Source\src\gis\mapping\mxd.py", line 315, in ExportToPDF
_ExportToPDF(arcpy.mapping.MapDocument(m), out_folder, overwrite)
File "C:\Program Files (x86)\ArcGIS\Desktop10.1\arcpy\arcpy\arcobjects\mixins.py", line 609, in __init__
assert (os.path.isfile(mxd) or (mxd.lower() == "current")), gp.getIDMessage(89004, "Invalid MXD filename")
AssertionError: Invalid MXD filename.
ユニットテストでこの問題を回避するには、スクリプトがパラメーターでテスト値をチェックして設定するテストの開始時に変数を設定します。スフィンクスで同様の回避策があるかどうか疑問に思っていますか?