GroupDocs.Conversion for Python via .NET 26.5 Release Notes

This release introduces the groupdocs-conversion command-line interface and a new get_possible_conversions_by_extension class method for discovering conversion targets by file extension. The bundled conversion engine is unchanged from 26.3 — no document-conversion behavior or output fidelity is affected.

Full List of Changes in This Release

Key	Category	Summary
CONVERSIONPYTHON‑69	Feature	Command-line interface — `groupdocs-conversion` console script
CONVERSIONPYTHON‑80	Feature	Discover conversion targets by file extension via `Converter.get_possible_conversions_by_extension(extension)`

Major Features

Command-Line Interface — `groupdocs-conversion`

Installing the groupdocs-conversion-net package now also puts a groupdocs-conversion console script on your PATH. It is a thin wrapper over the Python API, built for shell pipelines, Make rules, CI steps, and one-off conversions where writing a Python script is overkill.

# Convert — the target format is inferred from the output extension
groupdocs-conversion convert business-plan.docx business-plan.pdf
groupdocs-conversion convert annual-review.pdf page1.png --page 1 --count 1
groupdocs-conversion convert protected.docx out.pdf --password "secret"

# Inspect
groupdocs-conversion info report.pdf
groupdocs-conversion list-formats report.docx       # valid targets for this input
groupdocs-conversion list-all-formats               # full source -> target matrix

# Apply a license up front
groupdocs-conversion --license license.lic convert in.docx out.pdf

The same commands are available through the module form python -m groupdocs.conversion. Exit codes follow shell conventions: 0 for success, 2 for a user error (unknown format token or missing input file), and 1 for a runtime error.

See the Command Line Interface documentation page for the full command reference, the format-token table, and guidance on when to drop into the Python API instead.

API Changes

New Method — `get_possible_conversions_by_extension`

Converter.get_possible_conversions_by_extension(extension) is a new class method that returns the set of conversion targets available for a given file extension — without opening a document. It complements the existing instance method Converter.get_possible_conversions(), which reports the targets available for the document currently loaded.

from groupdocs.conversion import Converter

conversions = Converter.get_possible_conversions_by_extension("docx")
for c in conversions.all:
    if c.is_primary:
        print(f"{c.format.extension}: {c.format.file_format}")
        # pdf: Portable Document Format
        # docx: Microsoft Word Open XML Document

The previously generated get_possible_conversions_string and get_possible_conversions_file names — which were non-functional and raised an error when called — have been removed in favor of get_possible_conversions_by_extension.

No other public API has been removed or changed in a breaking way. Existing applications continue to work unchanged.

Requirements

Python: 3.5 through 3.14
Platforms: Windows (x64), Linux (x64 glibc), macOS (Intel and Apple Silicon)
Optional system dependencies (Linux/macOS): libgdiplus, libfontconfig1, libicu-dev. See System Requirements.

Additional Resources

Feedback

If you have any questions, issues, or suggestions, please reach out through the Free Support Forum.