Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

A set of tool for the decoding and conversion of AdBlock and Filter Lists.

Project description

A set of tools for the decoding and conversion of AdBlock and filter lists. The decoder itself is part of the PyFunceble project.

Installation

$ pip install --user adblock-decoder

Update

$ pip install --user --upgrade adblock-decoder

Python API

If you want to use the decoder in your own Python modules or infrastructure, you may use the PyFunceble project to access the decoder.

from PyFunceble.converter.adblock_input_line2subject import AdblockInputLine2Subject

to_decode = ["||example.com^", "||example.net^"]

decoder = AdblockInputLine2Subject()
decoder.aggressive = False

decoded = set()

for line in to_decode:
    # One shot method.
    decoded.update(decoder.set_data_to_convert(line).get_converted())

    # Step by step method
    decoder.set_data_to_convert(line)
    decoded.update(decoder.get_converted())

print("Decoded:", decoded)

Tools

adblock2hosts

A tool to convert adblock or filter lists to hosts format.

Usage

usage: adblock2hosts [-h] [--aggressive] [--ip IP] [-o OUTPUT] input_file

An AdBlock2hosts converter.

positional arguments:
    input_file            The input file to work with.

optional arguments:
    -h, --help            show this help message and exit
    --aggressive          [USE AT YOUR OWN RISK AS IT IS EXPERIMENTAL] Activates the extraction of everything regardless of the interpretation of AdBlock/UBlock.
    --ip IP               Sets the IP to use while generating the hosts file.
    -o OUTPUT, --output OUTPUT
                            The file to write to.

Crafted with ♥ by Nissar Chababy (Funilrys)!

adblock2plain

A tool to convert adblock or filter lists to plain text format.

Usage

usage: adblock2plain [-h] [--aggressive] [-o OUTPUT] input_file

An AdBlock2plain (text) converter.

positional arguments:
    input_file            The input file to work with.

optional arguments:
    -h, --help            show this help message and exit
    --aggressive          [USE AT YOUR OWN RISK AS IT IS EXPERIMENTAL] Activates the extraction of everything regardless of the interpretation of AdBlock/UBlock.
    -o OUTPUT, --output OUTPUT
                            The file to write to.

Crafted with ♥ by Nissar Chababy (Funilrys)!

License

Copyright 2017, 2018, 2019, 2020, 2021 Nissar Chababy

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for adblock-decoder, version 1.2.0
Filename, size File type Python version Upload date Hashes
Filename, size adblock_decoder-1.2.0-py3-none-any.whl (14.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size adblock-decoder-1.2.0.tar.gz (7.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page