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 (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>