火车票查看脚本

Posted by dony on April 18, 2019

火车票查看脚本

快到假期了,相信大家又要面临预订火车票的问题,参考网络上的一些资料写了这个火车票查看脚本,还挺有意思的,记录如下。

接口设计

一个应用写出来最终是要给人使用的,哪怕只是给你自己使用。

所以,首先应该想想你希望怎么使用它?让我们先给这个小应用起个名字吧,既然涉及查询票务信息,那就叫它 tickets 好了。

我们希望用户只要输入出发站,到达站以及日期就能获得想要的信息,比如要查看4月23号上海-深圳的火车余票, 我们只需输入:

python3 tickets.py 深圳 北京 2019-04-23

注意:上面的日期(包括后面的)是笔者写文章时确定的日期,当你在做这个项目的时候可能要根据当前时间做适当调整。

转化为程序语言就是:

python tickets.py from to date

另外,火车有各种类型,高铁、动车、特快、快速和直达,我们希望可以提供选项只查询特定的一种或几种的火车,所以,我们应该有下面这些选项:

-g 高铁
-d 动车
-t 特快
-k 快速
-z 直达

这几个选项应该能被组合使用,所以,最终我们的接口应该是这个样子的:

python3 tickets.py [-gdtkz] from to date

接口已经确定好了,剩下的就是实现它了。

三、代码实现 首先安装一下实验需要用到的库:

(如果你装了anaconda,pip可能出现不对的情况,which pip 信息替换即可)

sudo pip3 install requests prettytable docopt 
sudo pip3 install --upgrade colorama #升级环境中的 colorama
requests,使用 Python 访问 HTTP 资源的必备库。
docoptPython3 命令行参数解析工具。
prettytable 格式化信息打印工具,能让你像 MySQL 那样打印数据。
colorama,命令行着色工具

解析参数

Python有很多写命令行参数解析工具,如 argparse, docopt, click,这里我们选用的是 docopt 这个简单易用的工具。docopt 可以按我们在文档字符串中定义的格式来解析参数.

我们在 /home/shiyanlou/ 目录下新建 tickets.py 文件,并向其中写入下面的内容(实验楼环境下,通过点击右下角的键盘小图标可以选择中文输入法):

##coding: utf-8

"""命令行火车票查看器

Usage:
    tickets [-gdtkz] <from> <to> <date>

Options:
    -h,--help   显示帮助菜单
    -g          高铁
    -d          动车
    -t          特快
    -k          快速
    -z          直达

Example:
    tickets 北京 上海 2016-10-10
    tickets -dg 成都 南京 2016-10-10
"""
from docopt import docopt

def cli():
    """command-line interface"""
    arguments = docopt(__doc__)
    print(arguments)

if __name__ == '__main__':
    cli()

上面的程序中, docopt 会根据我们在 docstring 中的定义的格式自动解析出参数并返回一个字典,也就是 arguments, 我们打印出了这个字典的内容。

获取数据

参数已经解析好了,下面就是如何获取数据了,这也是最主要的部分。首先我们用实验楼环境的Firefox浏览打开 12306,进入余票查询页面,按下 F12 打开开发者工具,选中 Network 一栏,在查询框中随便查询一次,我们在调试工具观察下请求和响应:

注意这个URL,它是由基URL:

https://kyfw.12306.cn/otn/leftTicket/query?

加上四个参数构成的,这个四个参数分别代表,日期,始发站,目的站,查询类型(成人&学生)

看下这个响应的数据

我们打开返回的json数据看下

可以对比一下列车图

我们可以发现,每一列火车的数据就是一列

接下来问题就简单了,我们只需要利用这个接口, 构建请求URL然后解析返回的JSON数据就可以了。

注意到源码中有一个map字符串,那么这个是建立代号和中文名映射的信息,那应该存在一个文件是包括了所有车站的中文名,拼音的映射信息的。

打开网页源码,发现,有一个station_name.js文件

果然是一个很长的字符串,其中有所有的车站的中文名,拼音,简写等信息。然后下一步就是使用正则表达式提取出需要的信息。

这里有一个问题,pprint这个包是用于格式化输出print的内容,但是python3貌似已经独立出来了

查阅资料后,修改代码如下:

结果如下

我们可以看到,查询的结果里和列车时刻相关的信息都在reslut数组里

result 中的每个元素都是包含了列车信息的字符串,并以 分隔。所以可以先用 split 将字符串分解成列表,然后再读取感兴趣的数据

结果如下:

着色

上面打印出的结果全是黑白的,怎么可以添加颜色呢,可以使用colorama这个命令行着色工具:

from colorama import init, Fore

init()

修改一下程序,将出发车站与出发时间显示为绿色,到达车站与到达时间显示为红色:

'\n'.join([Fore.LIGHTGREEN_EX + self.available_place[raw_train_list[6]] + Fore.RESET,
           Fore.LIGHTRED_EX +  self.available_place[raw_train_list[7]] + Fore.RESET]),
'\n'.join([Fore.LIGHTGREEN_EX + raw_train_list[8] + Fore.RESET,
           Fore.LIGHTRED_EX + raw_train_list[9] + Fore.RESET]),

效果如图:

Setup

上面的程序中我们运行程序的方式是这样的:

python3 tickets.py from to date

我们当然可以将脚本改成可执行的,然后这样执行:

./tickets.py from to date

但这也不是理想的方案,因为我们必须在脚本的目录下才能运行。我们想要的是在命令行的任何地方都可以这样运行:

ticktes from to date

这是可以实现的,我们需要借助 Python 的 SETUP 工具。写一个简单的 setup 脚本:

from setuptools import setup

setup(
    name='tickets',
    py_modules=['tickets', 'stations'],
    install_requires=['requests', 'docopt', 'prettytable', 'colorama'],
    entry_points={
        'console_scripts': ['tickets=tickets:cli']
    }
)

在命令行运行一下:

python3 setup.py install

然后我们就可以直接当一个包来使用了输入命令如下:

tickets -gdtzk 深圳 北京 2019-04-23