--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/eric7/Documentation/Source/eric7.WebBrowser.Sync.SyncHandler.html Thu Jul 07 11:23:56 2022 +0200 @@ -0,0 +1,328 @@ +<!DOCTYPE html> +<html><head> +<title>eric7.WebBrowser.Sync.SyncHandler</title> +<meta charset="UTF-8"> +<link rel="stylesheet" href="styles.css"> +</head> +<body> +<a NAME="top" ID="top"></a> +<h1>eric7.WebBrowser.Sync.SyncHandler</h1> + +<p> +Module containing a base class for synchronization handlers. +</p> +<h3>Global Attributes</h3> + +<table> +<tr><td>None</td></tr> +</table> +<h3>Classes</h3> + +<table> + +<tr> +<td><a href="#SyncHandler">SyncHandler</a></td> +<td>Base class for synchronization handlers.</td> +</tr> +</table> +<h3>Functions</h3> + +<table> +<tr><td>None</td></tr> +</table> +<hr /> +<hr /> +<a NAME="SyncHandler" ID="SyncHandler"></a> +<h2>SyncHandler</h2> + +<p> + Base class for synchronization handlers. +</p> +<h3>Signals</h3> +<dl> + +<dt>syncError(message)</dt> +<dd> +emitted for a general error with the error + message (string) +</dd> +<dt>syncFinished(type_, done, download)</dt> +<dd> +emitted after a + synchronization has finished (string one of "bookmarks", "history", + "passwords", "useragents" or "speeddial", boolean, boolean) +</dd> +<dt>syncMessage(message)</dt> +<dd> +emitted to send a message about + synchronization (string) +</dd> +<dt>syncStatus(type_, message)</dt> +<dd> +emitted to indicate the synchronization + status (string one of "bookmarks", "history", "passwords", + "useragents" or "speeddial", string) +</dd> +</dl> +<h3>Derived from</h3> +QObject +<h3>Class Attributes</h3> + +<table> +<tr><td>None</td></tr> +</table> +<h3>Class Methods</h3> + +<table> +<tr><td>None</td></tr> +</table> +<h3>Methods</h3> + +<table> + +<tr> +<td><a href="#SyncHandler.__init__">SyncHandler</a></td> +<td>Constructor</td> +</tr> +<tr> +<td><a href="#SyncHandler.initialLoadAndCheck">initialLoadAndCheck</a></td> +<td>Public method to do the initial check.</td> +</tr> +<tr> +<td><a href="#SyncHandler.readFile">readFile</a></td> +<td>Public method to read a file.</td> +</tr> +<tr> +<td><a href="#SyncHandler.shutdown">shutdown</a></td> +<td>Public method to shut down the handler.</td> +</tr> +<tr> +<td><a href="#SyncHandler.syncBookmarks">syncBookmarks</a></td> +<td>Public method to synchronize the bookmarks.</td> +</tr> +<tr> +<td><a href="#SyncHandler.syncHistory">syncHistory</a></td> +<td>Public method to synchronize the history.</td> +</tr> +<tr> +<td><a href="#SyncHandler.syncPasswords">syncPasswords</a></td> +<td>Public method to synchronize the passwords.</td> +</tr> +<tr> +<td><a href="#SyncHandler.syncSpeedDial">syncSpeedDial</a></td> +<td>Public method to synchronize the speed dial data.</td> +</tr> +<tr> +<td><a href="#SyncHandler.syncUserAgents">syncUserAgents</a></td> +<td>Public method to synchronize the user agents.</td> +</tr> +<tr> +<td><a href="#SyncHandler.writeFile">writeFile</a></td> +<td>Public method to write the data to a file.</td> +</tr> +</table> +<h3>Static Methods</h3> + +<table> +<tr><td>None</td></tr> +</table> + +<a NAME="SyncHandler.__init__" ID="SyncHandler.__init__"></a> +<h4>SyncHandler (Constructor)</h4> +<b>SyncHandler</b>(<i>parent=None</i>) + +<p> + Constructor +</p> +<dl> + +<dt><i>parent</i></dt> +<dd> +reference to the parent object (QObject) +</dd> +</dl> +<a NAME="SyncHandler.initialLoadAndCheck" ID="SyncHandler.initialLoadAndCheck"></a> +<h4>SyncHandler.initialLoadAndCheck</h4> +<b>initialLoadAndCheck</b>(<i>forceUpload</i>) + +<p> + Public method to do the initial check. +</p> +<dl> + +<dt><i>forceUpload</i></dt> +<dd> +flag indicating a forced upload of the files + (boolean) +</dd> +</dl> +<dl> + +<dt>Raises <b>NotImplementedError</b>:</dt> +<dd> +raised to indicate that this method + must be implemented by subclasses +</dd> +</dl> +<a NAME="SyncHandler.readFile" ID="SyncHandler.readFile"></a> +<h4>SyncHandler.readFile</h4> +<b>readFile</b>(<i>fileName, type_</i>) + +<p> + Public method to read a file. +</p> +<p> + If encrypted synchronization is enabled, the data will be encrypted + using the relevant encryption key. +</p> +<dl> + +<dt><i>fileName</i></dt> +<dd> +name of the file to be read (string) +</dd> +<dt><i>type_</i></dt> +<dd> +type of the synchronization event (string one + of "bookmarks", "history", "passwords", "useragents" or + "speeddial") +</dd> +</dl> +<dl> +<dt>Return:</dt> +<dd> +data of the file, optionally encrypted (QByteArray) +</dd> +</dl> +<a NAME="SyncHandler.shutdown" ID="SyncHandler.shutdown"></a> +<h4>SyncHandler.shutdown</h4> +<b>shutdown</b>(<i></i>) + +<p> + Public method to shut down the handler. +</p> +<dl> + +<dt>Raises <b>NotImplementedError</b>:</dt> +<dd> +raised to indicate that this method + must be implemented by subclasses +</dd> +</dl> +<a NAME="SyncHandler.syncBookmarks" ID="SyncHandler.syncBookmarks"></a> +<h4>SyncHandler.syncBookmarks</h4> +<b>syncBookmarks</b>(<i></i>) + +<p> + Public method to synchronize the bookmarks. +</p> +<dl> + +<dt>Raises <b>NotImplementedError</b>:</dt> +<dd> +raised to indicate that this method + must be implemented by subclasses +</dd> +</dl> +<a NAME="SyncHandler.syncHistory" ID="SyncHandler.syncHistory"></a> +<h4>SyncHandler.syncHistory</h4> +<b>syncHistory</b>(<i></i>) + +<p> + Public method to synchronize the history. +</p> +<dl> + +<dt>Raises <b>NotImplementedError</b>:</dt> +<dd> +raised to indicate that this method + must be implemented by subclasses +</dd> +</dl> +<a NAME="SyncHandler.syncPasswords" ID="SyncHandler.syncPasswords"></a> +<h4>SyncHandler.syncPasswords</h4> +<b>syncPasswords</b>(<i></i>) + +<p> + Public method to synchronize the passwords. +</p> +<dl> + +<dt>Raises <b>NotImplementedError</b>:</dt> +<dd> +raised to indicate that this method + must be implemented by subclasses +</dd> +</dl> +<a NAME="SyncHandler.syncSpeedDial" ID="SyncHandler.syncSpeedDial"></a> +<h4>SyncHandler.syncSpeedDial</h4> +<b>syncSpeedDial</b>(<i></i>) + +<p> + Public method to synchronize the speed dial data. +</p> +<dl> + +<dt>Raises <b>NotImplementedError</b>:</dt> +<dd> +raised to indicate that this method + must be implemented by subclasses +</dd> +</dl> +<a NAME="SyncHandler.syncUserAgents" ID="SyncHandler.syncUserAgents"></a> +<h4>SyncHandler.syncUserAgents</h4> +<b>syncUserAgents</b>(<i></i>) + +<p> + Public method to synchronize the user agents. +</p> +<dl> + +<dt>Raises <b>NotImplementedError</b>:</dt> +<dd> +raised to indicate that this method + must be implemented by subclasses +</dd> +</dl> +<a NAME="SyncHandler.writeFile" ID="SyncHandler.writeFile"></a> +<h4>SyncHandler.writeFile</h4> +<b>writeFile</b>(<i>data, fileName, type_, timestamp=0</i>) + +<p> + Public method to write the data to a file. +</p> +<p> + If encrypted synchronization is enabled, the data will be decrypted + using the relevant encryption key. +</p> +<dl> + +<dt><i>data</i></dt> +<dd> +data to be written and optionally decrypted (QByteArray) +</dd> +<dt><i>fileName</i></dt> +<dd> +name of the file the data is to be written to (string) +</dd> +<dt><i>type_</i></dt> +<dd> +type of the synchronization event (string one + of "bookmarks", "history", "passwords", "useragents" or + "speeddial") +</dd> +<dt><i>timestamp</i></dt> +<dd> +timestamp to be given to the file (int) +</dd> +</dl> +<dl> +<dt>Return:</dt> +<dd> +tuple giving a success flag and an error string (boolean, + string) +</dd> +</dl> +<div align="right"><a href="#top">Up</a></div> +<hr /> +</body></html> \ No newline at end of file