# adblock-rust-server
Server wrapper for the [adblock crate](https://crates.io/crates/adblock) using Unix domain sockets.

Created for [blockit](https://github.com/dudik/blockit), but can be used in any program that supports Unix domain sockets.

## Usage
Add urls of filter lists (e.g. https://easylist.to/easylist/easylist.txt) to `~/.config/ars/urls`.  
Custom rules (e.g. ###customAd) should be added to `~/.config/ars/lists/custom`.

## API
After launching adblock-rust-server connect to `/tmp/ars` socket file to start communicating. 
Every request and response message have to end with a new line character `\n`. Two request types are supported:

### Network request
`n <request_url> <source_url> <request_type>`

For example:
`n https://duckduckgo.com/p103.js https://duckduckgo.com/ script`

Checks if the request should be blocked. Returns `1` if it should and `0` if not.

### Cosmetic request
`c <website_url> <ids> <classes>`

For example:
`c https://duckduckgo.com/ pg-index   wedonttrack content_homepage    logo_homepage_link`

Returns a CSS rule that hides unwanted elements. `<ids>` and `<classes>` are lists of id/class names separated by the tab character `\t`.

### Reload engine request
`r`
Restarts the adblock-rust engine applying any changes made to fiter lists or custom rules.

### Force update request
`u`
Updates every filter list and restarts the engine.