Script converting AdBlock Plus rules into privoxy format.

The script privoxy-blocklist.sh downloads AdBlock Plus filter files and generates privoxy compatible filter and action files based on these. After the generation is done it modifies the privoxy configuration files /etc/privoxy/config to import the generated files.

Due to this behaviour the script must run as root user to be able to modify the privoxy configuration file.

Either run privoxy-blocklist.sh manually with root privileges (e.g., sudo privoxy-blocklist.sh) or via root cronjob.

1. Ssh into OpenWrt
2. Go to /etc/privoxy
3. Download privoxy-blocklist.sh
4. chmod +x privoxy-blocklist.sh
5. Run it once in order to create blocklist.conf
6. remove # from privoxy_user, privoxy_group and privoxy_conf
7. Run it again

The release process is automated via github action Release and triggered by pushing a tag to the main branch.

The following tags are recognized:

Code changes must be tested to ensure that all functionality is working as intended. For that a pytest based test suite is maintained and runs on every pull request within Gitlab Actions.

The test suite is designed to run within a docker container based on the definition of this repository. It is currently only tested on Ubuntu Linux but should work on every system with a POSIX compliant shell and docker.

To start all tests of the test suite just run:

./tests/run.sh

To start a single test file you can run:

./tests/run.sh tests/test_….py

To start all tests on ubuntu:

./tests/run.sh -o ubuntu

The whole process simplified by ./tests/run.sh runs the following:

1. build docker image based on project Dockerfile
2. start container based on created image with git repository mounted to /app and persistent volume for pytest-cache mounted to /pytest_cache

Within the container all pytest magic happens and all scripts matching test_*.py within tests/ are executed.

• Badge Generator for providing easy method to generate badges/shields