Documentation/Source/eric6.Helpviewer.AdBlock.AdBlockRule.html

Tue, 24 Oct 2017 19:09:09 +0200

author
Detlev Offenbach <detlev@die-offenbachs.de>
date
Tue, 24 Oct 2017 19:09:09 +0200
changeset 5928
a3809f75ca07
parent 5606
da305d172769
permissions
-rw-r--r--

Changed the logic of the two web browsers in order to put new downloads at the top of the list of downloads and add the download date and time to the shown info.

<!DOCTYPE html>
<html><head>
<title>eric6.Helpviewer.AdBlock.AdBlockRule</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.AdBlockRule</h1>
<p>
Module implementing the AdBlock rule class.
</p>
<h3>Global Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>
<h3>Classes</h3>
<table>
<tr>
<td><a href="#AdBlockRule">AdBlockRule</a></td>
<td>Class implementing the AdBlock rule.</td>
</tr>
</table>
<h3>Functions</h3>
<table>
<tr>
<td><a href="#toSecondLevelDomain">toSecondLevelDomain</a></td>
<td>Module function to get a second level domain from the given URL.</td>
</tr>
</table>
<hr /><hr />
<a NAME="AdBlockRule" ID="AdBlockRule"></a>
<h2>AdBlockRule</h2>
<p>
    Class implementing the AdBlock rule.
</p>
<h3>Derived from</h3>
object
<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="#AdBlockRule.__init__">AdBlockRule</a></td>
<td>Constructor</td>
</tr><tr>
<td><a href="#AdBlockRule.__convertPatternToRegExp">__convertPatternToRegExp</a></td>
<td>Private method to convert a wildcard pattern to a regular expression.</td>
</tr><tr>
<td><a href="#AdBlockRule.__parseDomains">__parseDomains</a></td>
<td>Private method to parse a string with a domain list.</td>
</tr><tr>
<td><a href="#AdBlockRule.__parseFilter">__parseFilter</a></td>
<td>Private method to parse the filter pattern.</td>
</tr><tr>
<td><a href="#AdBlockRule.cssSelector">cssSelector</a></td>
<td>Public method to get the CSS selector of the rule.</td>
</tr><tr>
<td><a href="#AdBlockRule.filter">filter</a></td>
<td>Public method to get the rule filter string.</td>
</tr><tr>
<td><a href="#AdBlockRule.isCSSRule">isCSSRule</a></td>
<td>Public method to check, if the rule is a CSS rule.</td>
</tr><tr>
<td><a href="#AdBlockRule.isComment">isComment</a></td>
<td>Public method to check, if this is a comment.</td>
</tr><tr>
<td><a href="#AdBlockRule.isDocument">isDocument</a></td>
<td>Public method to check, if this is a document rule.</td>
</tr><tr>
<td><a href="#AdBlockRule.isDomainRestricted">isDomainRestricted</a></td>
<td>Public method to check, if this rule is restricted by domain.</td>
</tr><tr>
<td><a href="#AdBlockRule.isElementHiding">isElementHiding</a></td>
<td>Public method to check, if this is an element hiding rule.</td>
</tr><tr>
<td><a href="#AdBlockRule.isEnabled">isEnabled</a></td>
<td>Public method to check, if the rule is enabled.</td>
</tr><tr>
<td><a href="#AdBlockRule.isException">isException</a></td>
<td>Public method to check, if the rule defines an exception.</td>
</tr><tr>
<td><a href="#AdBlockRule.isHeader">isHeader</a></td>
<td>Public method to check, if this is a header.</td>
</tr><tr>
<td><a href="#AdBlockRule.isInternalDisabled">isInternalDisabled</a></td>
<td>Public method to check, if this rule was disabled internally.</td>
</tr><tr>
<td><a href="#AdBlockRule.isSlow">isSlow</a></td>
<td>Public method to check, if this is a slow rule.</td>
</tr><tr>
<td><a href="#AdBlockRule.matchDomain">matchDomain</a></td>
<td>Public method to match a domain.</td>
</tr><tr>
<td><a href="#AdBlockRule.matchObject">matchObject</a></td>
<td>Public slot to match an object rule.</td>
</tr><tr>
<td><a href="#AdBlockRule.matchSubdocument">matchSubdocument</a></td>
<td>Public slot to match a sub-document rule.</td>
</tr><tr>
<td><a href="#AdBlockRule.matchThirdParty">matchThirdParty</a></td>
<td>Public slot to match a third-party rule.</td>
</tr><tr>
<td><a href="#AdBlockRule.matchXmlHttpRequest">matchXmlHttpRequest</a></td>
<td>Public slot to match a XmlHttpRequest rule.</td>
</tr><tr>
<td><a href="#AdBlockRule.networkMatch">networkMatch</a></td>
<td>Public method to check the rule for a match.</td>
</tr><tr>
<td><a href="#AdBlockRule.setEnabled">setEnabled</a></td>
<td>Public method to set the rule's enabled state.</td>
</tr><tr>
<td><a href="#AdBlockRule.setException">setException</a></td>
<td>Public method to set the rule's exception flag.</td>
</tr><tr>
<td><a href="#AdBlockRule.setFilter">setFilter</a></td>
<td>Public method to set the rule filter string.</td>
</tr><tr>
<td><a href="#AdBlockRule.subscription">subscription</a></td>
<td>Public method to get the subscription this rule belongs to.</td>
</tr><tr>
<td><a href="#AdBlockRule.urlMatch">urlMatch</a></td>
<td>Public method to check an URL against the rule.</td>
</tr>
</table>
<h3>Static Methods</h3>
<table>
<tr><td>None</td></tr>
</table>
<a NAME="AdBlockRule.__init__" ID="AdBlockRule.__init__"></a>
<h4>AdBlockRule (Constructor)</h4>
<b>AdBlockRule</b>(<i>filterRule="", subscription=None</i>)
<p>
        Constructor
</p><dl>
<dt><i>filterRule</i></dt>
<dd>
filter string of the rule (string)
</dd><dt><i>subscription</i></dt>
<dd>
reference to the subscription object
            (AdBlockSubscription)
</dd>
</dl><a NAME="AdBlockRule.__convertPatternToRegExp" ID="AdBlockRule.__convertPatternToRegExp"></a>
<h4>AdBlockRule.__convertPatternToRegExp</h4>
<b>__convertPatternToRegExp</b>(<i>wildcardPattern</i>)
<p>
        Private method to convert a wildcard pattern to a regular expression.
</p><dl>
<dt><i>wildcardPattern</i></dt>
<dd>
string containing the wildcard pattern (string)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
string containing a regular expression (string)
</dd>
</dl><a NAME="AdBlockRule.__parseDomains" ID="AdBlockRule.__parseDomains"></a>
<h4>AdBlockRule.__parseDomains</h4>
<b>__parseDomains</b>(<i>domains, separator</i>)
<p>
        Private method to parse a string with a domain list.
</p><dl>
<dt><i>domains</i></dt>
<dd>
list of domains (string)
</dd><dt><i>separator</i></dt>
<dd>
separator character used by the list (string)
</dd>
</dl><a NAME="AdBlockRule.__parseFilter" ID="AdBlockRule.__parseFilter"></a>
<h4>AdBlockRule.__parseFilter</h4>
<b>__parseFilter</b>(<i></i>)
<p>
        Private method to parse the filter pattern.
</p><a NAME="AdBlockRule.cssSelector" ID="AdBlockRule.cssSelector"></a>
<h4>AdBlockRule.cssSelector</h4>
<b>cssSelector</b>(<i></i>)
<p>
        Public method to get the CSS selector of the rule.
</p><dl>
<dt>Returns:</dt>
<dd>
CSS selector (string)
</dd>
</dl><a NAME="AdBlockRule.filter" ID="AdBlockRule.filter"></a>
<h4>AdBlockRule.filter</h4>
<b>filter</b>(<i></i>)
<p>
        Public method to get the rule filter string.
</p><dl>
<dt>Returns:</dt>
<dd>
rule filter string (string)
</dd>
</dl><a NAME="AdBlockRule.isCSSRule" ID="AdBlockRule.isCSSRule"></a>
<h4>AdBlockRule.isCSSRule</h4>
<b>isCSSRule</b>(<i></i>)
<p>
        Public method to check, if the rule is a CSS rule.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating a CSS rule (boolean)
</dd>
</dl><a NAME="AdBlockRule.isComment" ID="AdBlockRule.isComment"></a>
<h4>AdBlockRule.isComment</h4>
<b>isComment</b>(<i></i>)
<p>
        Public method to check, if this is a comment.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating a comment (boolean)
</dd>
</dl><a NAME="AdBlockRule.isDocument" ID="AdBlockRule.isDocument"></a>
<h4>AdBlockRule.isDocument</h4>
<b>isDocument</b>(<i></i>)
<p>
        Public method to check, if this is a document rule.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating a document rule (boolean)
</dd>
</dl><a NAME="AdBlockRule.isDomainRestricted" ID="AdBlockRule.isDomainRestricted"></a>
<h4>AdBlockRule.isDomainRestricted</h4>
<b>isDomainRestricted</b>(<i></i>)
<p>
        Public method to check, if this rule is restricted by domain.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating a domain restriction (boolean)
</dd>
</dl><a NAME="AdBlockRule.isElementHiding" ID="AdBlockRule.isElementHiding"></a>
<h4>AdBlockRule.isElementHiding</h4>
<b>isElementHiding</b>(<i></i>)
<p>
        Public method to check, if this is an element hiding rule.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating an element hiding rule (boolean)
</dd>
</dl><a NAME="AdBlockRule.isEnabled" ID="AdBlockRule.isEnabled"></a>
<h4>AdBlockRule.isEnabled</h4>
<b>isEnabled</b>(<i></i>)
<p>
        Public method to check, if the rule is enabled.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating enabled state (boolean)
</dd>
</dl><a NAME="AdBlockRule.isException" ID="AdBlockRule.isException"></a>
<h4>AdBlockRule.isException</h4>
<b>isException</b>(<i></i>)
<p>
        Public method to check, if the rule defines an exception.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating an exception (boolean)
</dd>
</dl><a NAME="AdBlockRule.isHeader" ID="AdBlockRule.isHeader"></a>
<h4>AdBlockRule.isHeader</h4>
<b>isHeader</b>(<i></i>)
<p>
        Public method to check, if this is a header.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating a header (boolean)
</dd>
</dl><a NAME="AdBlockRule.isInternalDisabled" ID="AdBlockRule.isInternalDisabled"></a>
<h4>AdBlockRule.isInternalDisabled</h4>
<b>isInternalDisabled</b>(<i></i>)
<p>
        Public method to check, if this rule was disabled internally.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating an internally disabled rule (boolean)
</dd>
</dl><a NAME="AdBlockRule.isSlow" ID="AdBlockRule.isSlow"></a>
<h4>AdBlockRule.isSlow</h4>
<b>isSlow</b>(<i></i>)
<p>
        Public method to check, if this is a slow rule.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating a slow rule (boolean)
</dd>
</dl><a NAME="AdBlockRule.matchDomain" ID="AdBlockRule.matchDomain"></a>
<h4>AdBlockRule.matchDomain</h4>
<b>matchDomain</b>(<i>domain</i>)
<p>
        Public method to match a domain.
</p><dl>
<dt><i>domain</i></dt>
<dd>
domain name to check (string)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
flag indicating a match (boolean)
</dd>
</dl><a NAME="AdBlockRule.matchObject" ID="AdBlockRule.matchObject"></a>
<h4>AdBlockRule.matchObject</h4>
<b>matchObject</b>(<i>req</i>)
<p>
        Public slot to match an object rule.
</p><dl>
<dt><i>req</i></dt>
<dd>
request object to check (QNetworkRequest)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
flag indicating a match (boolean)
</dd>
</dl><a NAME="AdBlockRule.matchSubdocument" ID="AdBlockRule.matchSubdocument"></a>
<h4>AdBlockRule.matchSubdocument</h4>
<b>matchSubdocument</b>(<i>req</i>)
<p>
        Public slot to match a sub-document rule.
</p><dl>
<dt><i>req</i></dt>
<dd>
request object to check (QNetworkRequest)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
flag indicating a match (boolean)
</dd>
</dl><a NAME="AdBlockRule.matchThirdParty" ID="AdBlockRule.matchThirdParty"></a>
<h4>AdBlockRule.matchThirdParty</h4>
<b>matchThirdParty</b>(<i>req</i>)
<p>
        Public slot to match a third-party rule.
</p><dl>
<dt><i>req</i></dt>
<dd>
request object to check (QNetworkRequest)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
flag indicating a match (boolean)
</dd>
</dl><a NAME="AdBlockRule.matchXmlHttpRequest" ID="AdBlockRule.matchXmlHttpRequest"></a>
<h4>AdBlockRule.matchXmlHttpRequest</h4>
<b>matchXmlHttpRequest</b>(<i>req</i>)
<p>
        Public slot to match a XmlHttpRequest rule.
</p><dl>
<dt><i>req</i></dt>
<dd>
request object to check (QNetworkRequest)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
flag indicating a match (boolean)
</dd>
</dl><a NAME="AdBlockRule.networkMatch" ID="AdBlockRule.networkMatch"></a>
<h4>AdBlockRule.networkMatch</h4>
<b>networkMatch</b>(<i>request, domain, encodedUrl</i>)
<p>
        Public method to check the rule for a match.
</p><dl>
<dt><i>request</i></dt>
<dd>
reference to the network request (QNetworkRequest)
</dd><dt><i>domain</i></dt>
<dd>
domain name (string)
</dd><dt><i>encodedUrl</i></dt>
<dd>
string encoded URL to be checked (string)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
flag indicating a match (boolean)
</dd>
</dl><a NAME="AdBlockRule.setEnabled" ID="AdBlockRule.setEnabled"></a>
<h4>AdBlockRule.setEnabled</h4>
<b>setEnabled</b>(<i>enabled</i>)
<p>
        Public method to set the rule's enabled state.
</p><dl>
<dt><i>enabled</i></dt>
<dd>
flag indicating the new enabled state (boolean)
</dd>
</dl><a NAME="AdBlockRule.setException" ID="AdBlockRule.setException"></a>
<h4>AdBlockRule.setException</h4>
<b>setException</b>(<i>exception</i>)
<p>
        Public method to set the rule's exception flag.
</p><dl>
<dt><i>exception</i></dt>
<dd>
flag indicating an exception rule (boolean)
</dd>
</dl><a NAME="AdBlockRule.setFilter" ID="AdBlockRule.setFilter"></a>
<h4>AdBlockRule.setFilter</h4>
<b>setFilter</b>(<i>filterRule</i>)
<p>
        Public method to set the rule filter string.
</p><dl>
<dt><i>filterRule</i></dt>
<dd>
rule filter string (string)
</dd>
</dl><a NAME="AdBlockRule.subscription" ID="AdBlockRule.subscription"></a>
<h4>AdBlockRule.subscription</h4>
<b>subscription</b>(<i></i>)
<p>
        Public method to get the subscription this rule belongs to.
</p><dl>
<dt>Returns:</dt>
<dd>
subscription of the rule (AdBlockSubscription)
</dd>
</dl><a NAME="AdBlockRule.urlMatch" ID="AdBlockRule.urlMatch"></a>
<h4>AdBlockRule.urlMatch</h4>
<b>urlMatch</b>(<i>url</i>)
<p>
        Public method to check an URL against the rule.
</p><dl>
<dt><i>url</i></dt>
<dd>
URL to check (QUrl)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
flag indicating a match (boolean)
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr /><hr />
<a NAME="toSecondLevelDomain" ID="toSecondLevelDomain"></a>
<h2>toSecondLevelDomain</h2>
<b>toSecondLevelDomain</b>(<i>url</i>)
<p>
    Module function to get a second level domain from the given URL.
</p><dl>
<dt><i>url</i></dt>
<dd>
URL to extract domain from (QUrl)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
name of second level domain (string)
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>

eric ide

mercurial