tip/src/eric7/Documentation/Source/eric7.WebBrowser.Sync.SyncHandler.html

<!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
</dd>
<dt>syncFinished(type_, done, download)</dt>
<dd>
emitted after a synchronization
        has finished
</dd>
<dt>syncMessage(message)</dt>
<dd>
emitted to send a message about synchronization
</dd>
<dt>syncStatus(type_, message)</dt>
<dd>
emitted to indicate the synchronization status
</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> (QObject)</dt>
<dd>
reference to the parent object
</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> (bool)</dt>
<dd>
flag indicating a forced upload of the files
</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> (str)</dt>
<dd>
name of the file to be read
</dd>
<dt><i>type_</i> (str)</dt>
<dd>
type of the synchronization event (one of "bookmarks",
            "history", "passwords", "useragents" or "speeddial")
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
data of the file, optionally encrypted
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
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> (QByteArray)</dt>
<dd>
data to be written and optionally decrypted
</dd>
<dt><i>fileName</i> (str)</dt>
<dd>
name of the file the data is to be written to
</dd>
<dt><i>type_</i> (str)</dt>
<dd>
type of the synchronization event (one of "bookmarks",
            "history", "passwords", "useragents" or "speeddial")
</dd>
<dt><i>timestamp</i> (int)</dt>
<dd>
timestamp to be given to the file
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
tuple giving a success flag and an error string
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
tuple of (bool, str)
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>