Get Possible Conversions Leave feedback
On this page
GroupDocs.Conversion offers several methods to retrieve possible conversions:
Converter.get_all_possible_conversions(): Retrieves all available primary and secondary conversions for every supported file type.Converter.get_possible_conversions_by_extension(extension: str): Retrieves possible conversions for a specific file extension, e.g.,"docx".converter.get_possible_conversions(): Retrieves possible conversions for the currently loaded file.
- Primary Conversion: A direct conversion from one format to another, providing higher quality and better performance.
- Secondary Conversion: An indirect conversion that requires the source file to be first converted to an intermediate format before reaching the final format.
The following example demonstrates how to retrieve and display all primary and secondary conversions for every supported file type.
from groupdocs.conversion import Converter
# GroupDocs.Conversion supports 150+ source formats; print the first N
# to keep the console output readable. Raise or remove the limit to see
# every source format.
SAMPLE_LIMIT = 3
def get_all_possible_conversions():
# Get all possible conversions for every supported source format
all_possible_conversions = list(Converter.get_all_possible_conversions())
print(f"Total supported source formats: {len(all_possible_conversions)}")
print(f"Showing the first {SAMPLE_LIMIT} as a sample.")
print()
for possible_conversion in all_possible_conversions[:SAMPLE_LIMIT]:
# Collect primary / secondary target extensions for this source
primary_conversions = [c.format.extension for c in possible_conversion.all if c.is_primary]
secondary_conversions = [c.format.extension for c in possible_conversion.all if not c.is_primary]
# Print the source format and its target extensions
print(f"Source format: {possible_conversion.source.description}")
print(f" Primary target formats ({len(primary_conversions)}): {primary_conversions}")
print(f" Secondary target formats ({len(secondary_conversions)}): {secondary_conversions}")
print()
if __name__ == "__main__":
get_all_possible_conversions()
Total supported source formats: 208
Showing the first 3 as a sample.
Source format: MP3 Audio File (mp3)
Primary target formats (9): ['mp3', 'aac', 'aiff', 'flac', 'm4a', 'wma', 'ac3', 'ogg', 'wav']
Secondary target formats (0): []
Source format: Advanced Audio Coding File (aac)
Primary target formats (9): ['mp3', 'aac', 'aiff', 'flac', 'm4a', 'wma', 'ac3', 'ogg', 'wav']
Secondary target formats (0): []
[TRUNCATED]
The following example demonstrates how to retrieve and display possible conversions for the “docx” extension, which corresponds to a Microsoft Word Open XML Document.
from groupdocs.conversion import Converter
def get_all_possible_conversions_by_file_extension():
# Get all possible conversions for a specific extension
possible_conversion = Converter.get_possible_conversions_by_extension("docx")
# Filter primary conversions (use .extension for a clean string)
primary_conversions = [conversion.format.extension for conversion in possible_conversion.all if conversion.is_primary]
# Filter secondary conversions
secondary_conversions = [conversion.format.extension for conversion in possible_conversion.all if not conversion.is_primary]
# Print out the source format and its conversions
print(f" **Source format**: {possible_conversion.source.description}")
print(f" - **Primary conversions**: {primary_conversions}")
print(f" - **Secondary conversions**: {secondary_conversions}")
print()
if __name__ == "__main__":
get_all_possible_conversions_by_file_extension()
**Source format**: Microsoft Word Open XML Document (docx)
- **Primary conversions**: ['epub', 'mobi', 'azw3', 'tiff', 'tif', 'jpg', 'jpeg', 'png', 'gif', 'bmp', 'ico', 'psd', 'wmf', 'emf', 'dcm', 'dicom', 'webp', 'jp2', 'j2k', 'emz', 'wmz', 'tga', 'psb', 'jfif', 'eps', 'xps', 'tex', 'ps', 'pcl', 'svg', 'svgz', 'pdf', 'ppt', 'pps', 'pptx', 'ppsx', 'odp', 'otp', 'potx', 'pot', 'potm', 'pptm', 'ppsm', 'fodp', 'htm', 'html', 'mhtml', 'mht', 'doc', 'docm', 'docx', 'dot', 'dotm', 'dotx', 'rtf', 'od
[TRUNCATED]
The following example demonstrates how to retrieve and display possible conversions for a file passed to the Converter class constructor.
from groupdocs.conversion import Converter
def get_all_possible_conversions_for_current_file():
with Converter("./cost-analysis.xlsx") as converter:
# Get possible conversions for the loaded document
possible_conversion = converter.get_possible_conversions()
# Filter primary conversions (use .extension for a clean string)
primary_conversions = [conversion.format.extension for conversion in possible_conversion.all if conversion.is_primary]
# Filter secondary conversions
secondary_conversions = [conversion.format.extension for conversion in possible_conversion.all if not conversion.is_primary]
# Print out the source format and its conversions
print(f" **Source format**: {possible_conversion.source.description}")
print(f" - **Primary conversions**: {primary_conversions}")
print(f" - **Secondary conversions**: {secondary_conversions}")
print()
if __name__ == "__main__":
get_all_possible_conversions_for_current_file()
**Source format**: Microsoft Excel Open XML Spreadsheet (xlsx)
- **Primary conversions**: ['epub', 'mobi', 'azw3', 'eps', 'xps', 'tex', 'ps', 'pcl', 'pdf', 'xls', 'xlsx', 'xlsm', 'xlsb', 'ods', 'xltx', 'xlt', 'xltm', 'tsv', 'xlam', 'csv', 'fods', 'dif', 'sxc', 'fopcs', 'htm', 'html', 'mhtml', 'mht', 'json', 'xml']
- **Secondary conversions**: ['tiff', 'tif', 'jpg', 'jpeg', 'png', 'gif', 'bmp', 'ico', 'psd', 'wmf', 'emf', 'dcm', 'dicom', 'webp', 'jp2', 'j2k', 'emz', 'wmz', 'tga', 'psb', 'jfif
[TRUNCATED]
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.
