A Python wrapper to convert XML documentation into Python source code with its related Sphinx documentation.
The PyConverter-XML2Py project aims to automatically generate a Python library and a related Sphinx documentation from an XML documentation.
On the PyConverter-XML2Py Issues for this repository, you can create issues to submit questions, report bugs, and request new features. To reach the PyAnsys support team, email pyansys.core@ansys.com.
Install the pyconverter-xml2py package with:
python -m pip install pyconverter-xml2pyIt is recommended to organize the XML documentation as follow:
Once the XML_directory is correctly organized, the converter can be run.
pyconverter-xml2py package -x XML_directory_pathIf some functions need to be customized, the path containing the python files can be specified.
pyconverter-xml2py package -x XML_directory_path -f customized_function_directory_pathA new package is then automatically generated. Its default name is package. It is organized as follow:
Then, the Sphinx documentation can be generated from this package. The following code is to render the documentation as an HTML one from Windows:
cd package
pip install -e .[doc,tests] # Using a virtual environment is recommended.
.\doc\make.bat html