Documentation/Source/eric5.Helpviewer.Sync.SyncHandler.html

<!DOCTYPE html>
<html><head>
<title>eric5.Helpviewer.Sync.SyncHandler</title>
<meta charset="UTF-8">
<style>
body {
    background: #EDECE6;
    margin: 0em 1em 10em 1em;
    color: black;
}

h1 { color: white; background: #85774A; }
h2 { color: white; background: #85774A; }
h3 { color: white; background: #9D936E; }
h4 { color: white; background: #9D936E; }
    
a { color: #BA6D36; }

</style>
</head>
<body><a NAME="top" ID="top"></a>
<h1>eric5.Helpviewer.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>Returns:</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>Returns:</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>