diff -r eaf2cf171f3a -r 5cf645f6daab eric6/Documentation/Source/eric6.Helpviewer.AdBlock.AdBlockSubscription.html --- a/eric6/Documentation/Source/eric6.Helpviewer.AdBlock.AdBlockSubscription.html Sat Sep 07 14:45:27 2019 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,540 +0,0 @@ -<!DOCTYPE html> -<html><head> -<title>eric6.Helpviewer.AdBlock.AdBlockSubscription</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>eric6.Helpviewer.AdBlock.AdBlockSubscription</h1> -<p> -Module implementing the AdBlock subscription class. -</p> -<h3>Global Attributes</h3> -<table> -<tr><td>None</td></tr> -</table> -<h3>Classes</h3> -<table> -<tr> -<td><a href="#AdBlockSubscription">AdBlockSubscription</a></td> -<td>Class implementing the AdBlock subscription.</td> -</tr> -</table> -<h3>Functions</h3> -<table> -<tr><td>None</td></tr> -</table> -<hr /><hr /> -<a NAME="AdBlockSubscription" ID="AdBlockSubscription"></a> -<h2>AdBlockSubscription</h2> -<p> - Class implementing the AdBlock subscription. -</p><h3>Signals</h3> -<dl> -<dt>changed()</dt> -<dd> -emitted after the subscription has changed -</dd><dt>enabledChanged(bool)</dt> -<dd> -emitted after the enabled state was changed -</dd><dt>rulesChanged()</dt> -<dd> -emitted after the subscription's rules have changed -</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="#AdBlockSubscription.__init__">AdBlockSubscription</a></td> -<td>Constructor</td> -</tr><tr> -<td><a href="#AdBlockSubscription.__loadRules">__loadRules</a></td> -<td>Private method to load the rules of the subscription.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.__parseUrl">__parseUrl</a></td> -<td>Private method to parse the AdBlock URL for the subscription.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.__populateCache">__populateCache</a></td> -<td>Private method to populate the various rule caches.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.__rulesDownloaded">__rulesDownloaded</a></td> -<td>Private slot to deal with the downloaded rules.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.__validateCheckSum">__validateCheckSum</a></td> -<td>Private method to check the subscription file's checksum.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.adBlockDisabledForUrl">adBlockDisabledForUrl</a></td> -<td>Public method to check, if AdBlock is disabled for the given URL.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.addRule">addRule</a></td> -<td>Public method to add a rule.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.allRules">allRules</a></td> -<td>Public method to get the list of rules.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.canBeRemoved">canBeRemoved</a></td> -<td>Public method to check, if the subscription can be removed.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.canEditRules">canEditRules</a></td> -<td>Public method to check, if rules can be edited.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.checkForUpdate">checkForUpdate</a></td> -<td>Public method to check for an update.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.elemHideDisabledForUrl">elemHideDisabledForUrl</a></td> -<td>Public method to check, if element hiding is disabled for the given URL.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.elementHidingRules">elementHidingRules</a></td> -<td>Public method to get the element hiding rules.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.elementHidingRulesForDomain">elementHidingRulesForDomain</a></td> -<td>Public method to get the element hiding rules for the given domain.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.isEnabled">isEnabled</a></td> -<td>Public method to check, if the subscription is enabled.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.lastUpdate">lastUpdate</a></td> -<td>Public method to get the date and time of the last update.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.location">location</a></td> -<td>Public method to get the subscription location.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.match">match</a></td> -<td>Public method to check the subscription for a matching rule.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.removeRule">removeRule</a></td> -<td>Public method to remove a rule given the offset.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.replaceRule">replaceRule</a></td> -<td>Public method to replace a rule given the offset.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.requiresLocation">requiresLocation</a></td> -<td>Public method to get the location of a required subscription.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.rule">rule</a></td> -<td>Public method to get a specific rule.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.rulesFileName">rulesFileName</a></td> -<td>Public method to get the name of the rules file.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.saveRules">saveRules</a></td> -<td>Public method to save the subscription rules.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.setEnabled">setEnabled</a></td> -<td>Public method to set the enabled status.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.setLocation">setLocation</a></td> -<td>Public method to set the subscription location.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.setRuleEnabled">setRuleEnabled</a></td> -<td>Public method to enable a specific rule.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.setTitle">setTitle</a></td> -<td>Public method to set the subscription title.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.title">title</a></td> -<td>Public method to get the subscription title.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.updateNow">updateNow</a></td> -<td>Public method to update the subscription immediately.</td> -</tr><tr> -<td><a href="#AdBlockSubscription.url">url</a></td> -<td>Public method to generate the URL for this subscription.</td> -</tr> -</table> -<h3>Static Methods</h3> -<table> -<tr><td>None</td></tr> -</table> -<a NAME="AdBlockSubscription.__init__" ID="AdBlockSubscription.__init__"></a> -<h4>AdBlockSubscription (Constructor)</h4> -<b>AdBlockSubscription</b>(<i>url, custom, parent=None, default=False</i>) -<p> - Constructor -</p><dl> -<dt><i>url</i></dt> -<dd> -AdBlock URL for the subscription (QUrl) -</dd><dt><i>custom</i></dt> -<dd> -flag indicating a custom subscription (boolean) -</dd><dt><i>parent</i></dt> -<dd> -reference to the parent object (QObject) -</dd><dt><i>default</i></dt> -<dd> -flag indicating a default subscription (boolean) -</dd> -</dl><a NAME="AdBlockSubscription.__loadRules" ID="AdBlockSubscription.__loadRules"></a> -<h4>AdBlockSubscription.__loadRules</h4> -<b>__loadRules</b>(<i></i>) -<p> - Private method to load the rules of the subscription. -</p><a NAME="AdBlockSubscription.__parseUrl" ID="AdBlockSubscription.__parseUrl"></a> -<h4>AdBlockSubscription.__parseUrl</h4> -<b>__parseUrl</b>(<i>url</i>) -<p> - Private method to parse the AdBlock URL for the subscription. -</p><dl> -<dt><i>url</i></dt> -<dd> -AdBlock URL for the subscription (QUrl) -</dd> -</dl><a NAME="AdBlockSubscription.__populateCache" ID="AdBlockSubscription.__populateCache"></a> -<h4>AdBlockSubscription.__populateCache</h4> -<b>__populateCache</b>(<i></i>) -<p> - Private method to populate the various rule caches. -</p><a NAME="AdBlockSubscription.__rulesDownloaded" ID="AdBlockSubscription.__rulesDownloaded"></a> -<h4>AdBlockSubscription.__rulesDownloaded</h4> -<b>__rulesDownloaded</b>(<i>reply</i>) -<p> - Private slot to deal with the downloaded rules. -</p><dl> -<dt><i>reply</i> (QNetworkReply)</dt> -<dd> -reference to the network reply -</dd> -</dl><a NAME="AdBlockSubscription.__validateCheckSum" ID="AdBlockSubscription.__validateCheckSum"></a> -<h4>AdBlockSubscription.__validateCheckSum</h4> -<b>__validateCheckSum</b>(<i>fileName</i>) -<p> - Private method to check the subscription file's checksum. -</p><dl> -<dt><i>fileName</i></dt> -<dd> -name of the file containing the subscription (string) -</dd> -</dl><dl> -<dt>Returns:</dt> -<dd> -flag indicating a valid file (boolean). A file is considered - valid, if the checksum is OK or the file does not contain a - checksum (i.e. cannot be checked). -</dd> -</dl><a NAME="AdBlockSubscription.adBlockDisabledForUrl" ID="AdBlockSubscription.adBlockDisabledForUrl"></a> -<h4>AdBlockSubscription.adBlockDisabledForUrl</h4> -<b>adBlockDisabledForUrl</b>(<i>url</i>) -<p> - Public method to check, if AdBlock is disabled for the given URL. -</p><dl> -<dt><i>url</i></dt> -<dd> -URL to check (QUrl) -</dd> -</dl><dl> -<dt>Returns:</dt> -<dd> -flag indicating disabled state (boolean) -</dd> -</dl><a NAME="AdBlockSubscription.addRule" ID="AdBlockSubscription.addRule"></a> -<h4>AdBlockSubscription.addRule</h4> -<b>addRule</b>(<i>rule</i>) -<p> - Public method to add a rule. -</p><dl> -<dt><i>rule</i></dt> -<dd> -reference to the rule to add (AdBlockRule) -</dd> -</dl><dl> -<dt>Returns:</dt> -<dd> -offset of the rule (integer) -</dd> -</dl><a NAME="AdBlockSubscription.allRules" ID="AdBlockSubscription.allRules"></a> -<h4>AdBlockSubscription.allRules</h4> -<b>allRules</b>(<i></i>) -<p> - Public method to get the list of rules. -</p><dl> -<dt>Returns:</dt> -<dd> -list of rules (list of AdBlockRule) -</dd> -</dl><a NAME="AdBlockSubscription.canBeRemoved" ID="AdBlockSubscription.canBeRemoved"></a> -<h4>AdBlockSubscription.canBeRemoved</h4> -<b>canBeRemoved</b>(<i></i>) -<p> - Public method to check, if the subscription can be removed. -</p><dl> -<dt>Returns:</dt> -<dd> -flag indicating removal is allowed (boolean) -</dd> -</dl><a NAME="AdBlockSubscription.canEditRules" ID="AdBlockSubscription.canEditRules"></a> -<h4>AdBlockSubscription.canEditRules</h4> -<b>canEditRules</b>(<i></i>) -<p> - Public method to check, if rules can be edited. -</p><dl> -<dt>Returns:</dt> -<dd> -flag indicating rules may be edited (boolean) -</dd> -</dl><a NAME="AdBlockSubscription.checkForUpdate" ID="AdBlockSubscription.checkForUpdate"></a> -<h4>AdBlockSubscription.checkForUpdate</h4> -<b>checkForUpdate</b>(<i></i>) -<p> - Public method to check for an update. -</p><a NAME="AdBlockSubscription.elemHideDisabledForUrl" ID="AdBlockSubscription.elemHideDisabledForUrl"></a> -<h4>AdBlockSubscription.elemHideDisabledForUrl</h4> -<b>elemHideDisabledForUrl</b>(<i>url</i>) -<p> - Public method to check, if element hiding is disabled for the given - URL. -</p><dl> -<dt><i>url</i></dt> -<dd> -URL to check (QUrl) -</dd> -</dl><dl> -<dt>Returns:</dt> -<dd> -flag indicating disabled state (boolean) -</dd> -</dl><a NAME="AdBlockSubscription.elementHidingRules" ID="AdBlockSubscription.elementHidingRules"></a> -<h4>AdBlockSubscription.elementHidingRules</h4> -<b>elementHidingRules</b>(<i></i>) -<p> - Public method to get the element hiding rules. -</p><dl> -<dt>Returns:</dt> -<dd> -element hiding rules (string) -</dd> -</dl><a NAME="AdBlockSubscription.elementHidingRulesForDomain" ID="AdBlockSubscription.elementHidingRulesForDomain"></a> -<h4>AdBlockSubscription.elementHidingRulesForDomain</h4> -<b>elementHidingRulesForDomain</b>(<i>domain</i>) -<p> - Public method to get the element hiding rules for the given domain. -</p><dl> -<dt><i>domain</i></dt> -<dd> -domain name (string) -</dd> -</dl><dl> -<dt>Returns:</dt> -<dd> -element hiding rules (string) -</dd> -</dl><a NAME="AdBlockSubscription.isEnabled" ID="AdBlockSubscription.isEnabled"></a> -<h4>AdBlockSubscription.isEnabled</h4> -<b>isEnabled</b>(<i></i>) -<p> - Public method to check, if the subscription is enabled. -</p><dl> -<dt>Returns:</dt> -<dd> -flag indicating the enabled status (boolean) -</dd> -</dl><a NAME="AdBlockSubscription.lastUpdate" ID="AdBlockSubscription.lastUpdate"></a> -<h4>AdBlockSubscription.lastUpdate</h4> -<b>lastUpdate</b>(<i></i>) -<p> - Public method to get the date and time of the last update. -</p><dl> -<dt>Returns:</dt> -<dd> -date and time of the last update (QDateTime) -</dd> -</dl><a NAME="AdBlockSubscription.location" ID="AdBlockSubscription.location"></a> -<h4>AdBlockSubscription.location</h4> -<b>location</b>(<i></i>) -<p> - Public method to get the subscription location. -</p><dl> -<dt>Returns:</dt> -<dd> -URL of the subscription location (QUrl) -</dd> -</dl><a NAME="AdBlockSubscription.match" ID="AdBlockSubscription.match"></a> -<h4>AdBlockSubscription.match</h4> -<b>match</b>(<i>req, urlDomain, urlString</i>) -<p> - Public method to check the subscription for a matching rule. -</p><dl> -<dt><i>req</i></dt> -<dd> -reference to the network request (QNetworkRequest) -</dd><dt><i>urlDomain</i></dt> -<dd> -domain of the URL (string) -</dd><dt><i>urlString</i></dt> -<dd> -URL (string) -</dd> -</dl><dl> -<dt>Returns:</dt> -<dd> -reference to the rule object or None (AdBlockRule) -</dd> -</dl><a NAME="AdBlockSubscription.removeRule" ID="AdBlockSubscription.removeRule"></a> -<h4>AdBlockSubscription.removeRule</h4> -<b>removeRule</b>(<i>offset</i>) -<p> - Public method to remove a rule given the offset. -</p><dl> -<dt><i>offset</i></dt> -<dd> -offset of the rule to remove (integer) -</dd> -</dl><a NAME="AdBlockSubscription.replaceRule" ID="AdBlockSubscription.replaceRule"></a> -<h4>AdBlockSubscription.replaceRule</h4> -<b>replaceRule</b>(<i>rule, offset</i>) -<p> - Public method to replace a rule given the offset. -</p><dl> -<dt><i>rule</i></dt> -<dd> -reference to the rule to set (AdBlockRule) -</dd><dt><i>offset</i></dt> -<dd> -offset of the rule to remove (integer) -</dd> -</dl><dl> -<dt>Returns:</dt> -<dd> -requested rule (AdBlockRule) -</dd> -</dl><a NAME="AdBlockSubscription.requiresLocation" ID="AdBlockSubscription.requiresLocation"></a> -<h4>AdBlockSubscription.requiresLocation</h4> -<b>requiresLocation</b>(<i></i>) -<p> - Public method to get the location of a required subscription. -</p><dl> -<dt>Returns:</dt> -<dd> -location of a required subscription (string) -</dd> -</dl><a NAME="AdBlockSubscription.rule" ID="AdBlockSubscription.rule"></a> -<h4>AdBlockSubscription.rule</h4> -<b>rule</b>(<i>offset</i>) -<p> - Public method to get a specific rule. -</p><dl> -<dt><i>offset</i></dt> -<dd> -offset of the rule (integer) -</dd> -</dl><dl> -<dt>Returns:</dt> -<dd> -requested rule (AdBlockRule) -</dd> -</dl><a NAME="AdBlockSubscription.rulesFileName" ID="AdBlockSubscription.rulesFileName"></a> -<h4>AdBlockSubscription.rulesFileName</h4> -<b>rulesFileName</b>(<i></i>) -<p> - Public method to get the name of the rules file. -</p><dl> -<dt>Returns:</dt> -<dd> -name of the rules file (string) -</dd> -</dl><a NAME="AdBlockSubscription.saveRules" ID="AdBlockSubscription.saveRules"></a> -<h4>AdBlockSubscription.saveRules</h4> -<b>saveRules</b>(<i></i>) -<p> - Public method to save the subscription rules. -</p><a NAME="AdBlockSubscription.setEnabled" ID="AdBlockSubscription.setEnabled"></a> -<h4>AdBlockSubscription.setEnabled</h4> -<b>setEnabled</b>(<i>enabled</i>) -<p> - Public method to set the enabled status. -</p><dl> -<dt><i>enabled</i></dt> -<dd> -flag indicating the enabled status (boolean) -</dd> -</dl><a NAME="AdBlockSubscription.setLocation" ID="AdBlockSubscription.setLocation"></a> -<h4>AdBlockSubscription.setLocation</h4> -<b>setLocation</b>(<i>url</i>) -<p> - Public method to set the subscription location. -</p><dl> -<dt><i>url</i></dt> -<dd> -URL of the subscription location (QUrl) -</dd> -</dl><a NAME="AdBlockSubscription.setRuleEnabled" ID="AdBlockSubscription.setRuleEnabled"></a> -<h4>AdBlockSubscription.setRuleEnabled</h4> -<b>setRuleEnabled</b>(<i>offset, enabled</i>) -<p> - Public method to enable a specific rule. -</p><dl> -<dt><i>offset</i></dt> -<dd> -offset of the rule (integer) -</dd><dt><i>enabled</i></dt> -<dd> -new enabled state (boolean) -</dd> -</dl><dl> -<dt>Returns:</dt> -<dd> -reference to the changed rule (AdBlockRule) -</dd> -</dl><a NAME="AdBlockSubscription.setTitle" ID="AdBlockSubscription.setTitle"></a> -<h4>AdBlockSubscription.setTitle</h4> -<b>setTitle</b>(<i>title</i>) -<p> - Public method to set the subscription title. -</p><dl> -<dt><i>title</i></dt> -<dd> -subscription title (string) -</dd> -</dl><a NAME="AdBlockSubscription.title" ID="AdBlockSubscription.title"></a> -<h4>AdBlockSubscription.title</h4> -<b>title</b>(<i></i>) -<p> - Public method to get the subscription title. -</p><dl> -<dt>Returns:</dt> -<dd> -subscription title (string) -</dd> -</dl><a NAME="AdBlockSubscription.updateNow" ID="AdBlockSubscription.updateNow"></a> -<h4>AdBlockSubscription.updateNow</h4> -<b>updateNow</b>(<i></i>) -<p> - Public method to update the subscription immediately. -</p><a NAME="AdBlockSubscription.url" ID="AdBlockSubscription.url"></a> -<h4>AdBlockSubscription.url</h4> -<b>url</b>(<i></i>) -<p> - Public method to generate the URL for this subscription. -</p><dl> -<dt>Returns:</dt> -<dd> -AdBlock URL for the subscription (QUrl) -</dd> -</dl> -<div align="right"><a href="#top">Up</a></div> -<hr /> -</body></html> \ No newline at end of file