Ad Block engine in Rust

Native Rust module for Adblock Plus syntax (e.g. EasyList, EasyPrivacy) filter parsing and matching.

It uses a tokenisation approach for qucikly reducing the potentially matching rule search space against a URL.

The algorithm is inspired by, and closely follows the algorithm of uBlock Origin and Cliqz.

Somewhat graphical explanation of the algorithm:

Ad Block Algorithm

Demo

Demo use in Rust:

```rust extern crate adblock;

use adblock::engine::Engine;

fn main() { let rules = vec![ String::from("-advertisement-icon."), String::from("-advertisement-management/"), String::from("-advertisement."), String::from("-advertisement/script."), ];

let blocker = Engine::from_rules_debug(&rules);
let blocker_result = blocker.check_network_urls("http://example.com/-advertisement-icon.", "http://example.com/helloworld", "image");

println!("Blocker result: {:?}", blocker_result);

}

```

Node.js module demo

Note the Node.js module has overheads inherent to boundary crossing between JS and native code.

```js const AdBlockClient = require('adblock-rs'); let rules = fs.readFileSync('./data/easylist.to/easylist/easylist.txt', { encoding: 'utf-8' }).split('\n');

// create client with debug = true const client = new AdBlockClient.Engine(rules, true);

const serializedArrayBuffer = client.serialize(); // Serialize the engine to an ArrayBuffer

console.log(Engine size: ${(serializedArrayBuffer.byteLength / 1024 / 1024).toFixed(2)} MB);

console.log("Matching:", client.check("http://example.com/-advertisement-icon.", "http://example.com/helloworld", "image")) // Match with full debuging info console.log("Matching:", client.check("http://example.com/-advertisement-icon.", "http://example.com/helloworld", "image", true)) // No, but still with debugging info console.log("Matching:", client.check("https://github.githubassets.com/assets/frameworks-64831a3d.js", "https://github.com/AndriusA", "script", true)) ```

TODO