Metadata-Version: 1.1
Name: genpac
Version: 1.3.1
Summary: convert gfwlist to pac, custom rules supported.
Home-page: https://github.com/JinnLynn/genpac
Author: JinnLynn
Author-email: eatfishlin@gmail.com
License: MIT
Description: GenPAC
        ===========
        
        |pypi version| |pypi license|
        
        基于gfwlist的代理自动配置(Proxy Auto-config)文件生成工具，支持自定义规则。
        
        Generate PAC file from gfwlist, custom rules supported. 
        
        Installation
        ~~~~~~~~~~~~
        
        ::
        
            pip install genpac
            pip install --upgrade genpac
            pip uninstall genpac
        
        or
        
        ::
        
            pip install -e git+https://github.com/JinnLynn/genpac.git#egg=genpac
            pip install --upgrade -e git+https://github.com/JinnLynn/genpac.git#egg=genpac
        
        Usage
        ~~~~~
        
        ::
        
            genpac [-h|--help] [-v|version]
                   [-p PROXY|--proxy=PROXY]
                   [--gfwlist-url=URL] [--gfwlist-proxy=PROXY]
                   [--gfwlist-local=FILE] [--update-gfwlist-local]
                   [--user-rule=RULE] [--user-rule-from=FILE]
                   [-c FILE|--config-from=FILE] [-o FILE|--output=FILE]
                   [-z|--compress]
                   [--base64]
                   [--init[=PATH]]
        
            可选参数:
              -h, --help                帮助
              -v, --version             版本信息
              -p PROXY, --proxy=PROXY   PAC文件中使用的代理信息, 如:
                                          SOCKS 127.0.0.1:8080
                                          SOCKS5 127.0.0.1:8080; SOCKS 127.0.0.1:8080
                                          PROXY 127.0.0.1:8080
              --gfwlist-proxy=PROXY     获取gfwlist时的代理设置, 如果你可以正常访问gfwlist, 则无必要使用该选项
                                        格式为 "代理类型 [用户名:密码]@地址:端口" 其中用户名和密码可选, 如:
                                          SOCKS5 127.0.0.1:8080
                                          SOCKS5 username:password@127.0.0.1:8080
              --gfwlist-url=URL         gfwlist网址，无此参数或URL为空则使用默认地址, URL为-则不在线获取
                                          https://raw.githubusercontent.com/gfwlist/gfwlist/master/gfwlist.txt
              --gfwlist-local=FILE      本地gfwlist文件地址, 当在线地址获取失败时使用
              --update-gfwlist-local    当在线gfwlist成功获取且gfwlist-local存在时, 更新gfwlist-local内容
              --user-rule=RULE          自定义规则, 该参数允许重复使用或在单个参数中使用`,`分割多个规则，如:
                                          --user-rule="@@sina.com" --user-rule="||youtube.com"
                                          --user-rule="@@sina.com,||youtube.com"
              --user-rule-from=FILE     从文件中读取自定义规则, 该参数使用规则与--user-rule相同
              -c FILE, --config-from=FILE
                                        从文件中读取配置信息
              -o FILE, --output=FILE    输出到文件, 无此参数或FILE为-, 意味着输出到stdout
              -z, --compress            压缩输出
              --base64                  base64加密输出, 注意: 部分浏览器并不支持经过base64加密的pac文件
              --init[=PATH]             初始化配置和用户规则文件
        
        Config
        ~~~~~~
        
        支持通过 `--config-from` 参数读入配置信息，配置文件书写方法可参考 config-sample.ini_
        
        Custom Rules
        ~~~~~~~~~~~~
        
        支持通过 `--user-rule` 自定义单个规则或 `--user-rule-from` 读入自定义规则文件，这两个参数均可重复使用。
        
        自定义规则文件可参考 user-rules-sample.txt_
        
        自定义规则的语法与gfwlist相同，使用AdBlock Plus过滤规则( http://adblockplus.org/en/filters )，简述如下:
          
        1. 通配符支持，如 `*.example.com/*` 实际书写时可省略 `*` 为 `.example.com/`
        2. 正则表达式支持，以 `\` 开始和结束，如 `\[\w]+:\/\/example.com\\`
        3. 例外规则 `@@` ，如 `@@*.example.com/*` 满足 `@@` 后规则的地址不使用代理
        4. 匹配地址开始和结尾 `|` ，如 `|http://example.com` 、 `example.com|` 分别表示以 `http://example.com` 开始和以 `example.com` 结束的地址
        5. `||` 标记，如 `||example.com` 则 `http://example.com https://example.com ftp://example.com` 等地址均满足条件
        6. 注释 `!` 如 `! Comment`
        
        配置自定义规则时需谨慎，尽量避免与gfwlist产生冲突，或将一些本不需要代理的网址添加到代理列表
        
        规则优先级从高到底为: user-rule > user-rule-from > gfwlist
        
        .. |pypi version| image:: https://img.shields.io/pypi/v/genpac.svg?style=flat
           :target: https://pypi.python.org/pypi/genpac
        .. |pypi license| image:: https://img.shields.io/pypi/l/genpac.svg?style=flat
           :target: https://pypi.python.org/pypi/genpac
        .. _config-sample.ini: https://github.com/JinnLynn/genpac/blob/master/genpac/res/config-sample.ini
        .. _user-rules-sample.txt: https://github.com/JinnLynn/genpac/blob/master/genpac/res/user-rules-sample.txt
        
Keywords: proxy pac gfwlist gfw
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
