为解决反人类设计的一款票根助手,适用于票根网(pss.txffp.com)。
可执行发票下载、自动合并、查看发票信息等。
欢迎大家加入本项目交流群:863896565,你可以提供宝贵的意见或参与新功能的测试等。
本项目基于python3开发,需要安装python3.4及以上版本。
使用pip安装:
$ pip install --upgrade txffpAssistant
虚拟环境下安装(virtualenvwrapper):
$ mkvirtualenv txffp_assistant
$ workon txffp_assistant
$ pip install --upgrade txffpAssistant
卸载:
$ pip uninstall txffpAssistant
查看ETC卡信息:
$ txffp etc --auth user:password
查看2018年5月份,etcid为xxx的开票记录信息:
$ txffp record --month 201805 --etcid xxx --auth user:password
下载2018年5月份的全部发票并合并:
$ txffp inv-dl --merge --month 201805 --auth user:password --all true -o ./
通用可选参数:
$ txffp -h
optional arguments:
-h, --help show this help message and exit
-d, --debug debug模式
-s, --simple 精简模式
-v, --version 查看当前版本并退出
--sleep SLEEP_TIME 请求间隔睡眠时间(s),默认关闭。(推荐使用)
※ 强烈推荐使用--sleep
参数,这样不仅能减少触发反爬虫,还能减轻对服务器的压力。
※ 推荐--sleep
参数值:3-5。因为是取范围随机值,所以并不是每次都睡眠指定值。
经过实验发现,当以较高频率进行请求时会触发反爬虫,导致无法模拟登陆。因为这种情况并不常见,所以我目前也不打算对此做处理。
etc
命令参数:
$ txffp etc -h
optional arguments:
-h, --help show this help message and exit
--type {personal,company,all}
etc卡类型,默认:all
--auth AUTH 用户名和密码,格式:user:password
record
命令参数:
$ txffp record -h
optional arguments:
-h, --help show this help message and exit
--etcid ETC_ID ETC卡ID
--month MONTH 开票年月,例如: 201805
--type {personal,company}
etc卡类型,默认:company
--auth AUTH 用户名和密码,格式:user:password
inv-dl
命令参数:
$ txffp inv-dl -h
optional arguments:
-h, --help show this help message and exit
--month MONTH 开票年月,例如: 201805
--type {personal,company,all}
etc卡类型,默认:company
--merge MERGE 自动合并
--auth AUTH 用户名和密码,格式:user:password
--all DL_ALL 下载全部发票
--etcid ETC_ID ETC卡ID
-o OUTPUT, --output OUTPUT
保存位置, 默认:当前目录的txffp目录下
apply
参数命令:
optional arguments:
-h, --help show this help message and exit
--auth AUTH 用户名和密码,格式:user:password
--month MONTH 开票年月,例: 201805
--email EMAIL 发票接收邮箱
--all APPLY_ALL 全部ETC卡开票(默认)
--etcid APPLY_ETC_ID 指定ETC卡(需要etcid)
开启合并功能后,自动将已下载完成的zip文件内的pdf文件进行合并,并存放于下载目录下的merge文件夹下的同名文件夹内。 发票文件将会合并到invoice.pdf,pdf发票记录将会合并到invoiceDetail.pdf。
目录示例:
download/
├── invoice-xxxxx-example.zip
└── merged
└── invoice-xxxxx-example
├── invoice.pdf
└── invoiceDetail.pdf
如果在使用过程中出现bug等,请到 https://github.com/Kairu-Madigan/txffpAssistant 发起Issue。
该项目根据GNU许可证授权,详细信息请查看LICENSE文件。