eric7/Documentation/Source/eric7.WebBrowser.Tools.WebBrowserTools.html

<!DOCTYPE html>
<html><head>
<title>eric7.WebBrowser.Tools.WebBrowserTools</title>
<meta charset="UTF-8">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<a NAME="top" ID="top"></a>
<h1>eric7.WebBrowser.Tools.WebBrowserTools</h1>

<p>
Module implementing tool functions for the web browser.
</p>
<h3>Global Attributes</h3>

<table>
<tr><td>WebBrowserDataDirectory</td></tr>
</table>
<h3>Classes</h3>

<table>
<tr><td>None</td></tr>
</table>
<h3>Functions</h3>

<table>

<tr>
<td><a href="#containsSpace">containsSpace</a></td>
<td>Function to check, if a string contains whitespace characters.</td>
</tr>
<tr>
<td><a href="#ensureUniqueFilename">ensureUniqueFilename</a></td>
<td>Module function to generate an unique file name based on a pattern.</td>
</tr>
<tr>
<td><a href="#filterCharsFromFilename">filterCharsFromFilename</a></td>
<td>Module function to filter illegal characters.</td>
</tr>
<tr>
<td><a href="#getFileNameFromUrl">getFileNameFromUrl</a></td>
<td>Module function to generate a file name based on the given URL.</td>
</tr>
<tr>
<td><a href="#getHtmlPage">getHtmlPage</a></td>
<td>Module function to load a HTML page.</td>
</tr>
<tr>
<td><a href="#getJavascript">getJavascript</a></td>
<td>Module function to load a JavaScript source file.</td>
</tr>
<tr>
<td><a href="#getWebEngineVersions">getWebEngineVersions</a></td>
<td>Module function to extract the web engine related versions from the default user agent string.</td>
</tr>
<tr>
<td><a href="#pixmapFileToDataUrl">pixmapFileToDataUrl</a></td>
<td>Module function to load a pixmap file and convert the pixmap to a data: URL.</td>
</tr>
<tr>
<td><a href="#pixmapFromByteArray">pixmapFromByteArray</a></td>
<td>Module function to convert a byte array to a pixmap.</td>
</tr>
<tr>
<td><a href="#pixmapToByteArray">pixmapToByteArray</a></td>
<td>Module function to convert a pixmap to a byte array containing the pixmap as a PNG encoded as base64.</td>
</tr>
<tr>
<td><a href="#pixmapToDataUrl">pixmapToDataUrl</a></td>
<td>Module function to convert a pixmap to a data: URL.</td>
</tr>
<tr>
<td><a href="#readAllFileContents">readAllFileContents</a></td>
<td>Function to read the string contents of the given file.</td>
</tr>
</table>
<hr />
<hr />
<a NAME="containsSpace" ID="containsSpace"></a>
<h2>containsSpace</h2>
<b>containsSpace</b>(<i>string</i>)

<p>
    Function to check, if a string contains whitespace characters.
</p>
<dl>

<dt><i>string</i> (str)</dt>
<dd>
string to be checked
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flag indicating the presence of at least one whitespace character
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
bool
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="ensureUniqueFilename" ID="ensureUniqueFilename"></a>
<h2>ensureUniqueFilename</h2>
<b>ensureUniqueFilename</b>(<i>name, appendFormat="({0})"</i>)

<p>
    Module function to generate an unique file name based on a pattern.
</p>
<dl>

<dt><i>name</i></dt>
<dd>
desired file name (string)
</dd>
<dt><i>appendFormat</i></dt>
<dd>
format pattern to be used to make the unique name
        (string)
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
unique file name
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="filterCharsFromFilename" ID="filterCharsFromFilename"></a>
<h2>filterCharsFromFilename</h2>
<b>filterCharsFromFilename</b>(<i>name</i>)

<p>
    Module function to filter illegal characters.
</p>
<dl>

<dt><i>name</i></dt>
<dd>
name to be sanitized (string)
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
sanitized name (string)
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="getFileNameFromUrl" ID="getFileNameFromUrl"></a>
<h2>getFileNameFromUrl</h2>
<b>getFileNameFromUrl</b>(<i>url</i>)

<p>
    Module function to generate a file name based on the given URL.
</p>
<dl>

<dt><i>url</i></dt>
<dd>
URL (QUrl)
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
file name (string)
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="getHtmlPage" ID="getHtmlPage"></a>
<h2>getHtmlPage</h2>
<b>getHtmlPage</b>(<i>pageFileName</i>)

<p>
    Module function to load a HTML page.
</p>
<p>
    Note: If the given HTML file path is not absolute, it is assumed to
    denote a HTML file in the html data directory.
</p>
<dl>

<dt><i>pageFileName</i> (str)</dt>
<dd>
file name of the HTML file
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
HTML page
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
str
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="getJavascript" ID="getJavascript"></a>
<h2>getJavascript</h2>
<b>getJavascript</b>(<i>jsFileName</i>)

<p>
    Module function to load a JavaScript source file.
</p>
<p>
    Note: If the given JavaScript source file path is not absolute, it is
    assumed to denote a JavaScript source file in the javascript data
    directory.
</p>
<dl>

<dt><i>jsFileName</i> (str)</dt>
<dd>
file name of the JavaScript source file
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
JavaScript source
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
str
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="getWebEngineVersions" ID="getWebEngineVersions"></a>
<h2>getWebEngineVersions</h2>
<b>getWebEngineVersions</b>(<i></i>)

<p>
    Module function to extract the web engine related versions from the default
    user agent string.
</p>
<p>
    Note: For PyQt 6.3.1 or newer the data is extracted via some Qt functions.
</p>
<dl>
<dt>Return:</dt>
<dd>
tuple containing the Chromium version, the Chromium security patch
        version and the QtWebEngine version
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
tuple of (str, str, str)
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="pixmapFileToDataUrl" ID="pixmapFileToDataUrl"></a>
<h2>pixmapFileToDataUrl</h2>
<b>pixmapFileToDataUrl</b>(<i>pixmapFile, asString=False</i>)

<p>
    Module function to load a pixmap file and convert the pixmap to a
    data: URL.
</p>
<p>
    Note: If the given pixmap file path is not absolute, it is assumed to
    denote a pixmap file in the icons data directory.
</p>
<dl>

<dt><i>pixmapFile</i> (str)</dt>
<dd>
file name of the pixmap file
</dd>
<dt><i>asString</i> (bool)</dt>
<dd>
flag indicating a string representation is requested
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
data: URL
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
QUrl or str
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="pixmapFromByteArray" ID="pixmapFromByteArray"></a>
<h2>pixmapFromByteArray</h2>
<b>pixmapFromByteArray</b>(<i>data</i>)

<p>
    Module function to convert a byte array to a pixmap.
</p>
<dl>

<dt><i>data</i> (bytes or QByteArray)</dt>
<dd>
data for the pixmap
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
extracted pixmap
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
QPixmap
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="pixmapToByteArray" ID="pixmapToByteArray"></a>
<h2>pixmapToByteArray</h2>
<b>pixmapToByteArray</b>(<i>pixmap</i>)

<p>
    Module function to convert a pixmap to a byte array containing the pixmap
    as a PNG encoded as base64.
</p>
<dl>

<dt><i>pixmap</i> (QPixmap)</dt>
<dd>
pixmap to be converted
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
byte array containing the pixmap
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
QByteArray
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="pixmapToDataUrl" ID="pixmapToDataUrl"></a>
<h2>pixmapToDataUrl</h2>
<b>pixmapToDataUrl</b>(<i>pixmap, mimetype="image/png"</i>)

<p>
    Module function to convert a pixmap to a data: URL.
</p>
<dl>

<dt><i>pixmap</i> (QPixmap)</dt>
<dd>
pixmap to be converted
</dd>
<dt><i>mimetype</i> (str)</dt>
<dd>
MIME type to be used
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
data: URL
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
QUrl
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="readAllFileContents" ID="readAllFileContents"></a>
<h2>readAllFileContents</h2>
<b>readAllFileContents</b>(<i>filename</i>)

<p>
    Function to read the string contents of the given file.
</p>
<dl>

<dt><i>filename</i> (str)</dt>
<dd>
name of the file
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
contents of the file
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
str
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>