Skip to content

为解决某票根网反人类设计的一款助手工具。

License

Notifications You must be signed in to change notification settings

huimingz/txffpAssistant

Repository files navigation

txffpAssistant

PyPI - Python Version GitHub PyPI - Wheel

为解决反人类设计的一款票根助手,适用于票根网(pss.txffp.com)。

可执行发票下载、自动合并、查看发票信息等。

欢迎大家加入本项目交流群:863896565,你可以提供宝贵的意见或参与新功能的测试等。

依赖

本项目基于python3开发,需要安装python3.4及以上版本。

安装

使用pip安装:

$ pip install --upgrade txffpAssistant

虚拟环境下安装(virtualenvwrapper):

$ mkvirtualenv txffp_assistant
$ workon txffp_assistant
$ pip install --upgrade txffpAssistant

pip install 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)

help info

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文件。

About

为解决某票根网反人类设计的一款助手工具。

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages