Troubleshooting
Troubleshooting
ImportError when importing the library
Cause: The package is not installed in the active Python environment.
Fix: Install with pip install aspose-page-foss>=0.1.0 in the correct
virtual environment. Verify with pip show aspose-page-foss.
FileNotFoundError when calling from_file()
Cause: The file path passed to from_file() does not exist.
Fix: Use pathlib.Path("input.ps").exists() to verify the path before
calling from_file().
Output PDF is empty
Cause: The PS file may contain no renderable content or use unsupported operators.
Fix: Verify the PS file renders correctly with another viewer, then report the specific file as an issue in the GitHub repository.
Low-resolution raster output
Cause: Default DPI is 96, which produces low-resolution images.
Fix: Pass ImageSaveOptions(dpi=150) or ImageSaveOptions(dpi=300) to to_image().
FastMCP not found when using the MCP server
Cause: fastmcp is an optional dependency not installed by default.
Fix: pip install fastmcp separately.