给Python初学者的最好练手项目

摘要：我们将会创建两个一个是当比特币价格下滑到一定阈值后的紧急提醒另一个是常规的比特币价格的更新两个程序都将被我们的触发，从获取数据。

作者：xiaoyu
微信公众号：Python数据科学
知乎：python数据分析师

有很多朋友问我学习了Python后，有没有什么好的项目可以练手。

其实，做项目主要还是根据需求来的。但是对于一个初学者来说，很多复杂的项目没办法独立完成，因此博主挑选了一个非常适合初学者的项目，内容不是很复杂，但是非常有趣，我相信对于初学者小白来说是再好不过的项目了。

这个项目中，我们将要建立一个比特币价格的提醒服务。

你将主要会学习到HTTP的请求，以及如何使用requests包来发送这些请求。

同时，你会了解webhooks和如何使用它将Python app与外部设备连接，例如移动端手机提醒或者 Telegram 服务。

仅仅不到50行的代码就能完成一个比特币价格提醒服务的功能，并且可以轻松的扩展到其它加密数字货币和服务中。

下面我们马上来看看。

我们都知道，比特币是一个变动的东西。你无法真正的知道它的去向。因此，为了避免我们反复的刷新查看最新动态，我们可以做一个Python app来为你工作。

为此，我们将会使用一个很流行的自动化网站IFTTT。IFTTT("if this, then that")是一个可以在不同app设备与web服务之间建立连接桥梁的工具。

我们将会创建两个IFTTT applets：

一个是当比特币价格下滑到一定阈值后的紧急提醒

另一个是常规的比特币价格的更新

两个程序都将被我们的Python app触发，Python app从Coinmakercap API (https://coinmarketcap.com/api/) 获取数据。

一个IFTTT程序有两个部分组成：触发部分和动作部分。

在我们的情况下，触发是一个IFTTT提供的webhook服务。你可以将webhook想象为"user-defined HTTP callbacks"，更多请参考：http://timothyfitz.com/2009/0...

我们的Python app将会发出一个HTTP请求到webhook URL，然后webhook URL触发动作。有意思的部分来了，这个动作可以是你想要的任何东西。IFTTT提供了众多的动作像发送一个email，更新一个Google电子数据表，甚至可以给你打电话。

如果你安装了python3，那么只要再安装一个requests包就可以了。

$ pip install requests==2.18.4  # We only need the requests package

选一个编辑器，比如Pycharm进行代码编辑。

代码很简单，可以在console中进行。导入requests包，然后定义bitcoin_api_url变量，这个变量是Coinmarketcap API的URL。

接着，使用requests.get()函数发送一个 HTTP GET请求，然后保存响应response。由于API返回一个JSON响应，我们可以通过.json()将它转换为python对象。

>>> import requests
>>> bitcoin_api_url = "https://api.coinmarketcap.com/v1/ticker/bitcoin/"
>>> response = requests.get(bitcoin_api_url)
>>> response_json = response.json()
>>> type(response_json) # The API returns a list

>>> # Bitcoin data is the first element of the list
>>> response_json[0]
{"id": "bitcoin", "name": "Bitcoin", "symbol": "BTC", "rank": "1", 
 "price_usd": "10226.7", "price_btc": "1.0", "24h_volume_usd": "7585280000.0",
 "market_cap_usd": "172661078165", "available_supply": "16883362.0", 
 "total_supply": "16883362.0", "max_supply": "21000000.0", 
 "percent_change_1h": "0.67", "percent_change_24h": "0.78", 
 "percent_change_7d": "-4.79", "last_updated": "1519465767"}

上面我们感兴趣的是price_usd。

现在我们可以转到IFTTT上面来了。使用IFTTT之前，我们需要创建一个新账户(https://ifttt.com/join)，然后安装移动端app（如果你想在手机上接到通知）
设置成功后就开始创建一个新的IFTTT applet用于测试。

创建一个新的测试applet，可以按一下步骤进行：

点击大的 "this" 按钮；

搜索 "webhooks" 服务，然后选择 "Receive a web request"触发;

重命名event为test_event;

然后选择大的 "that" 按钮；

搜索 "notifications" 服务，然后选择 "send a notification from the IFTTT app"

改变短信息为 I just triggered my first IFTTT action!，然后点击 "Create action";

点击 "Finish" 按钮，完成；

要看如何使用IFTTT webhooks，请点击 "Documentation" 按钮documentation页有webhooks的URL。

https://maker.ifttt.com/trigger/{event}/with/key/{your-IFTTT-key}

接着，你需要将{event}替换为你在步骤3中自己起的名字。{your-IFTTT-key}是已经有了的IFTTT key。

现在你可以复制webhook URL，然后开启另一个console。同样导入requests然后发送post请求。

>>> import requests
>>> # Make sure that your key is in the URL
>>> ifttt_webhook_url = "https://maker.ifttt.com/trigger/test_event/with/key/{your-IFTTT-key}"
>>> requests.post(ifttt_webhook_url)

运行完之后，你可以看到：

前面只是测试，现在我们到了最主要的部分了。再开始代码之前，我们需要创建两个新的IFTTT applets：一个是比特币价格的紧急通知，另一个是常规的更新。

比特币价格紧急通知的applet：

选择 "webhooks" 服务，并且选择 "Receive a web request" 的触发;

命名一个事件 event 为 bitcoin_price_emergency;

对于响应的动作部分，选择 "Notifications"服务，然后继续选择 "send a rich notification from the IFTTT app" 动作；

提供一个标题，像 "Bitcoin price emergency!"

设置短信息 为 Bitcoin price is at ${{Value1}}. Buy or sell now!(我们一会儿将返回到{{Value1}}部分)

可选的，你可以加入一个URL link 到 Coinmarketcap Bitcoin page：https://coinmarketcap.com/currencies/bitcoin/;

创建动作，然后完成applet的设置；

常规价格更新的applet：

一样的选择 "webhooks" 服务，并且选择 "Receive a web request" 的触发;

命名一个事件 event 为 bitcoin_price_update;

对于响应的动作部分，选择 "Telegram" 服务，然后继续选择 "Send message" 动作；

设置短信信息文本为：Latest bitcoin prices:
{{Value1}}；

创建动作，然后完成applet的设置；

现在，我们有了IFTTT，下面就是代码了。你将通过创建像下面一样标准的Python命令行app骨架来开始。 代码码上去，然后保存为 bitcoin_notifications.py:

import requests
import time
from datetime import datetime

def main():
    pass

if __name__ == "__main__":
    main()

接着，我们还要将前面两个Python console部分的代码转换为两个函数，函数将返回最近比特币的价格，然后将它们分别post到IFTTT的webhook上去。将下面的代码加入到main()函数之上。

BITCOIN_API_URL = "https://api.coinmarketcap.com/v1/ticker/bitcoin/"
IFTTT_WEBHOOKS_URL = "https://maker.ifttt.com/trigger/{}/with/key/{your-IFTTT-key}"

def get_latest_bitcoin_price():
    response = requests.get(BITCOIN_API_URL)
    response_json = response.json()
    # Convert the price to a floating point number
    return float(response_json[0]["price_usd"])


def post_ifttt_webhook(event, value):
    # The payload that will be sent to IFTTT service
    data = {"value1": value}
    # inserts our desired event
    ifttt_event_url = IFTTT_WEBHOOKS_URL.format(event)
    # Sends a HTTP POST request to the webhook URL
    requests.post(ifttt_event_url, json=data)

除了将价格从一个字符串变成浮点数之外，get_latest_bitcoin_price基本没太变。psot_ifttt_webhook需要两个参数：event和value。

event参数与我们之前命名的触发名字对应。同时，IFTTT的webhooks允许我们通过requests发送额外的数据，数据作为JSON格式。

这就是为什么我们需要value参数：当设置我们的applet的时候，我们在信息文本中有{{Value1}}标签。这个标签会被 JSON payload 中的values1文本替换。requests.post()函数允许我们通过设置json关键字发送额外的JSON数据。

现在我们可以继续到我们app的核心main函数码代码了。它包括一个while True的循环，由于我们想要app永远的运行下去。在循环中，我们调用Coinmarkertcap API来得到最近比特币的价格，并且记录当时的日期和时间。

根据目前的价格，我们将决定我们是否想要发送一个紧急通知。对于我们的常规更新我们将把目前的价格和日期放入到一个bitcoin_history的列表里。一旦列表达到一定的数量(比如说5个)，我们将包装一下，将更新发送出去，然后重置历史，以为后续的更新。

一个需要注意的地方是避免发送信息太频繁，有两个原因：

Coinmarketcap API 声明他们只有每隔5分钟更新一次，因此更新太频也没有用

如果你的app发送太多的请求道 Coinmarketcap API，你的IP可能会被ban

因此，我们最后加入了 "go to sleep" 睡眠，设置至少5分钟才能得到新数据。下面的代码实现了我们的需要的特征：

BITCOIN_PRICE_THRESHOLD = 10000  # Set this to whatever you like

def main():
    bitcoin_history = []
    while True:
        price = get_latest_bitcoin_price()
        date = datetime.now()
        bitcoin_history.append({"date": date, "price": price})

        # Send an emergency notification
        if price < BITCOIN_PRICE_THRESHOLD:
            post_ifttt_webhook("bitcoin_price_emergency", price)

        # Send a Telegram notification
        # Once we have 5 items in our bitcoin_history send an update
        if len(bitcoin_history) == 5:
            post_ifttt_webhook("bitcoin_price_update", 
                               format_bitcoin_history(bitcoin_history))
            # Reset the history
            bitcoin_history = []

        # Sleep for 5 minutes 
        # (For testing purposes you can set it to a lower number)
        time.sleep(5 * 60)

我们几乎快成功了。但是还缺一个format_bitcoin_history函数。它将bitcoin_history作为参数，然后使用被Telegram允许的基本HTML标签（像
, , 等等）变换格式。将这个函数复制到main()之上。

def format_bitcoin_history(bitcoin_history):
    rows = []
    for bitcoin_price in bitcoin_history:
        # Formats the date into a string: "24.02.2018 15:09"
        date = bitcoin_price["date"].strftime("%d.%m.%Y %H:%M")
        price = bitcoin_price["price"]
        #  (bold) tag creates bolded text
        # 24.02.2018 15:09: $10123.4
        row = "{}: ${}".format(date, price)
        rows.append(row)

    # Use a 
 (break) tag to create a new line
    # Join the rows delimited by 
 tag: row1
row2
row3
    return "
".join(rows)

参考：https://realpython.com/python...