为解决某票根网反人类设计的一款助手工具
txffpAssistant的Python项目详细描述
txffpAssistant
为解决反人类设计的一款票根助手，适用于票根网(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 --id xxx --auth user:password
下载2018年5月份的全部发票并合并：
$ txffp inv-dl --merge --month 201805 --auth user:password --all -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）
pdf合并说明
开启合并功能后，自动将已下载完成的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文件。
赞助
如果您觉得 txffpAssistant 对你有帮助，欢迎给予我一定的捐助来维持项目的长期发展。
支付宝扫码捐赠
微信扫码捐赠
欢迎加入QQ群-->： 979659372
