A C++ library offering the core functionality of Adblock Plus.
libadblockplus is still work in progress, at an early stage.
All you need is Python 2.6 and Make:
make
The default target architecture is x64. On a 32 bit system, run:
make ARCH=ia32
To build and run the tests:
make test
Likewise, use the following on a 32 bit system:
make test ARCH=ia32
To run specific tests, you can specify a filter:
make test FILTER=*.Matches
You need Microsoft Visual C++ (Express is sufficient) 2012
and Python 2.6. Make sure that python.exe is on your PATH.
- Execute
createsolution.batto generate project files, this will createbuild\ia32\libadblockplus.sln(solution for the 32 bit build) andbuild\x64\libadblockplus.sln(solution for the 64 bit build). Unfortunately, V8 doesn't support creating both from the same project files. - Open
build\ia32\libadblockplus.slnorbuild\x64\libadblockplus.slnin Visual Studio and build the solution there. Alternatively you can use themsbuildcommand line tool, e.g. runmsbuild /m build\ia32\libadblockplus.slnfrom the Visual Studio Developer Command Prompt to create a 32 bit debug build.
The shell subdirectory contains an example application using libadblockplus.
It's a simple shell that loads subscriptions into memory and checks whether a specified resource would be blocked or not.
To see the available commands, type help.
The shell is automatically built by make, you can run it as follows:
build/out/abpshell
Just run the project abpshell.
The msvs generator is broken; well not so much broken as twisted.
Its behavior induces some restrictions on the way we're able to use gyp.
For the full story, see the extended gyp documentation.
- All our own command line tools have to have arguments that either (a) begin with a hyphen or slash, or (b) are path names. Sounds bizarre? I'm with you.
- We can't support spaces in path or file names. Strictly speaking, that's only for some path names in certain situations. But please, make everyone's lives easier. Just don't do it.