Class: QgsNetworkContentFetcherRegistry

Registry for temporary fetched files.

This provides a simple way of downloading and accessing remote files during QGIS application running.

See also

QgsFetchedContent

Added in version 3.2.

Class Hierarchy

Base classes

QObject

Enums

FetchingMode

alias of ActionStart

Methods

fetch	Initialize a download for the given URL
localPath	Returns the path to a local file or to a temporary file previously fetched by the registry

class qgis.core.QgsNetworkContentFetcherRegistry

Bases: QObject

__init__()

Create the registry for temporary downloaded files

FetchingMode

alias of ActionStart

fetch(self, url: str | None, fetchingMode: Qgis.ActionStart = Qgis.ActionStart.Deferred, authConfig: str | None = '') → QgsFetchedContent | None

Initialize a download for the given URL

Parameters:

• url (Optional[str]) – the URL to be fetched

• fetchingMode (Qgis.ActionStart = Qgis.ActionStart.Deferred) – defines if the download will start immediately or shall be manually triggered

• authConfig (Optional[str] = '') – authentication configuration id to be used while fetching

Note

If the download starts immediately, it will not redownload any already fetched or currently fetching file.

Return type:

Optional[QgsFetchedContent]

localPath(self, filePathOrUrl: str | None) → str

Returns the path to a local file or to a temporary file previously fetched by the registry

Parameters:

filePathOrUrl (Optional[str]) – can either be a local file path or a remote content which has previously been fetched

Return type:

str