Issue 4970 - Document the library API of python-abp

abp/filters/render_script.py

 # This file is part of Adblock Plus <https://adblockplus.org/>,
 # Copyright (C) 2006-present eyeo GmbH
 #
 # Adblock Plus is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License version 3 as
 # published by the Free Software Foundation.
 #
 # Adblock Plus is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
 # along with Adblock Plus.  If not, see <http://www.gnu.org/licenses/>.
 
+"""Command line script for rendering Adblock Plus filter lists."""
+
 import argparse
 import io
 import logging
 import sys
 
 from .sources import FSSource, TopSource, WebSource, NotFound
 from .renderer import render_filterlist, IncludeError, MissingHeader
 
+__all__ = ['main']
+
 
 def parse_args():
     parser = argparse.ArgumentParser(description='Render a filter list.')
     parser.add_argument(
         'infile', help='top level filter list fragment from which the '
         'rendering starts')
     parser.add_argument('outfile', help='output filter list file')
     parser.add_argument(
         '-i', '--include', action='append', default=[], metavar='NAME=PATH',
         help='define include path (could be given multiple times)')
@@ skipping 19 matching lines @@
         name, path = include_path.split('=', 1)
         sources[name] = FSSource(path)
 
     try:
         lines = render_filterlist(args.infile, sources, TopSource())
         with io.open(args.outfile, 'w', encoding='utf-8') as out_fp:
             for line in lines:
                 out_fp.write(line.to_string() + '\n')
     except (MissingHeader, NotFound, IncludeError) as exc:
         sys.exit(exc)