Issue 6945 - Add script to make filter list diffs

README.md

 # python-abp
 
 This repository contains a library for working with Adblock Plus filter lists
 and the script that is used for building Adblock Plus filter lists from the
 form in which they are authored into the format suitable for consumption by the
 adblocking software.
 
 ## Installation
 
 Prerequisites:
@@ skipping 90 matching lines @@
 
 This will produce a diff that shows how a client may get from `base.txt` to
 `latest.txt`, and write the output to `output.txt`. The output argument is
 optional. If ommitted, the data will be written to `stdout`.
 
 The script produces three types of lines, as specified in the [technical specification][5]:
 * Special comments of the form `! <name>:[ <value>]`
 * Added filters of the form `+ <filter-text>`
 * Removed filter of the form `- <filter-text>`
 
-The diff is generated such that the removed filters are listed before the added

[Sebastian Noack, 2018/09/25 17:00:39]

Maybe this is a bit too much detail, if we refer to the spec anyway. But I don't
care too much, so I leave it up to you (and Vasily), however, keep in mind if
the behavior should ever change this will be an additional resource that you
have to remember to update.

[rhowell, 2018/09/25 23:01:45]

Yeah, I see your point. Maybe it would be better to mention this where it's done
in the source code, in renderer.py. I moved it there.

-filters. This covers the case where a filter is both removed and added. The 
-client should process the diffs in order, so if this conflict happens, the rule
-will be added.
-
 ## Library API
 
 Python-abp can also be used as a library for parsing filter lists. For example
 to read a filter list (we use Python 3 syntax here but the API is the same):
 
     from abp.filters import parse_filterlist
 
     with open('filterlist.txt') as filterlist:
         for line in parse_filterlist(filterlist):
             print(line)
@@ skipping 77 matching lines @@
 
 Now you can use the functions with `abp$functionname`, e.g. 
 `abp.line2dict("@@||g.doubleclick.net/pagead/$subdocument,domain=hon30.org")`
 
 
  [1]: https://adblockplus.org/filters#special-comments
  [2]: http://pytest.org/
  [3]: https://tox.readthedocs.org/
  [4]: https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt
  [5]: https://docs.google.com/document/d/1SoEqaOBZRCfkh1s5Kds5A5RwUC_nqbYYlGH72sbsSgQ/