Loading Documents Leave feedback
GroupDocs.Viewer for Python via .NET can load a source document from three kinds of sources: a local file path, a Python stream (file handle or BytesIO), or an HTTP URL. Pass any of them to the Viewer class — the engine auto-detects the format and keeps the source open only as long as necessary.
The Viewer constructor accepts the source as its first positional argument. The remaining arguments are all optional and can be passed positionally or as keyword arguments:
Viewer(source, load_options=None, settings=None, leave_open=None)
source— a file path (str), raw bytes, or any file-like stream (open("file", "rb"),io.BytesIO(data)).load_options— aLoadOptionsinstance. Use it to pass a password, override the detected file type, or tune resource-loading behaviour.settings— aViewerSettingsinstance. Holds theloggerand cache, applied to the whole rendering pipeline. See Logging and Diagnostics.leave_open— whenTrue, theViewerwill not close the underlying stream after rendering. Handy when you want to keep reading from the same handle afterwards.
Always construct the Viewer inside a with block. The context manager releases the native handle and any cached render state as soon as the block exits.
LoadOptions is a single class whose properties cover every format the Viewer supports. Only set the properties that apply to your source — the rest default sensibly.
| Property | Type | Purpose |
|---|---|---|
file_type | FileType | Override the detected format. Useful when a file has no extension or an ambiguous MIME type. |
password | str | Password for an encrypted document (DOCX, XLSX, PDF, archive, Outlook, …). |
encoding | str | Force an encoding for plain-text and CSV sources. |
detect_encoding | bool | Enable automatic encoding detection for text. |
try_repair | bool | Attempt to recover data from a corrupted source. |
resource_loading_timeout | timedelta | Upper bound on external-resource fetches (HTML / MHTML / EPUB / SVG). |
skip_external_resources | bool | Render without fetching any external resources. |
whitelisted_resources | list[str] | When skip_external_resources is True, allow this specific list through. |
NoteThe three pages in this section each cover one source type — local disk, stream, and URL. For the full runnable examples, see the companion GroupDocs.Viewer for Python via .NET examples repository.
- Load from local disk — pass a filesystem path to the
Viewerconstructor. - Load from stream — pass an open file handle or a
BytesIObuffer. - Load from URL — fetch with
requests, wrap inBytesIO, render from memory.
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.
