給Python初學者的最好練手項目,進來看就對了!

  • 2019 年 12 月 2 日
  • 筆記

有很多朋友問我學習了Python後,有沒有什麼好的項目可以練手。

其實,做項目主要還是根據需求來的。但是對於一個初學者來說,很多複雜的項目沒辦法獨立完成,因此部落客挑選了一個非常適合初學者的項目,內容不是很複雜,但是非常有趣,我相信對於初學者小白來說是再好不過的項目了。

這個項目中,我們將要建立一個比特幣價格的提醒服務。

  • 你將主要會學習到HTTP的請求,以及如何使用requests包來發送這些請求。
  • 同時,你會了解webhooks和如何使用它將Python app與外部設備連接,例如移動端手機提醒或者 Telegram 服務。

僅僅不到50行的程式碼就能完成一個比特幣價格提醒服務的功能,並且可以輕鬆的擴展到其它加密數字貨幣和服務中。

下面我們馬上來看看。

1、用Python實現比特幣價格提醒

我們都知道,比特幣是一個變動的東西。你無法真正的知道它的去向。因此,為了避免我們反覆的刷新查看最新動態,我們可以做一個Python app來為你工作。

為此,我們將會使用一個很流行的自動化網站IFTTT。IFTTT ("if this, then that") 是一個可以在不同app設備與web服務之間建立連接橋樑的工具。

我們將會創建兩個IFTTT applets:

  • 一個是當比特幣價格下滑到一定閾值後的緊急提醒
  • 另一個是常規的比特幣價格的更新

兩個程式都將被我們的Python app觸發,Python app從Coinmakercap API獲取數據。

Coinmakercap API鏈接:https://coinmarketcap.com/api/

一個IFTTT程式有兩個部分組成:觸發部分動作部分

在我們的情況下,觸發是一個IFTTT提供的webhook服務。你可以將webhook想像為"user-defined HTTP callbacks"。

更多請參考:http://timothyfitz.com/2009/02/09/what-webhooks-are-and-why-you-should-care/

我們的Python app將會發出一個HTTP請求到webhook URL,然後webhook URL觸發動作。有意思的部分來了,這個動作可以是你想要的任何東西。IFTTT提供了眾多的動作,像發送一個email,更新一個Google電子數據表,甚至可以給你打電話。

2、配置項目

如果你安裝了python3,那麼只要再安裝一個requests包就可以了。

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

選一個編輯器,比如Pycharm進行程式碼編輯。

3、獲取比特幣價格

程式碼很簡單,可以在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  <class '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

4、發送一個測試的IFTTT提醒

現在我們可以轉到IFTTT上面來了。使用IFTTT之前,我們需要創建一個新賬戶,然後安裝移動端app(如果你想在手機上接到通知),設置成功後就開始創建一個新的IFTTT applet用於測試。

新賬戶鏈接:https://ifttt.com/join

創建一個新的測試applet,可以按以下步驟進行:

  1. 點擊大的 "this" 按鈕;
  2. 搜索 "webhooks" 服務,然後選擇 "Receive a web request"觸發;
  3. 重命名event為test_event;
  4. 然後選擇大的 "that" 按鈕;
  5. 搜索 "notifications" 服務,然後選擇 "send a notification from the IFTTT app"
  6. 改變簡訊息為 I just triggered my first IFTTT action!,然後點擊 "Create action";
  7. 點擊 "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)  <Response [200]>

運行完之後,你可以在手機端的app看到:

5、創建IFTTT Applets

前面只是測試,現在我們到了最主要的部分了。再開始程式碼之前,我們需要創建兩個新的IFTTT applets:一個是比特幣價格的緊急通知,另一個是常規的更新。

比特幣價格緊急通知的applet:

  1. 選擇 "webhooks" 服務,並且選擇 "Receive a web request" 的觸發;
  2. 命名一個事件 event 為 bitcoin_price_emergency;
  3. 對於響應的動作部分,選擇 "Notifications"服務,然後繼續選擇 "send a rich notification from the IFTTT app" 動作;
  4. 提供一個標題,像 "Bitcoin price emergency!"
  5. 設置簡訊息 為 Bitcoin price is at ${{Value1}}. Buy or sell now!(我們一會兒將返回到{{Value1}}部分)
  6. 可選的,你可以加入一個URL link 到 Coinmarketcap Bitcoin page:https://coinmarketcap.com/currencies/bitcoin/;
  7. 創建動作,然後完成applet的設置;

常規價格更新的applet:

  1. 一樣的選擇 "webhooks" 服務,並且選擇 "Receive a web request" 的觸發;
  2. 命名一個事件 event 為 bitcoin_price_update;
  3. 對於響應的動作部分,選擇 "Telegram" 服務,然後繼續選擇 "Send message" 動作;
  4. 設置簡訊資訊文本為:Latest bitcoin prices:<br>{{Value1}}
  5. 創建動作,然後完成applet的設置;

6、將所有連到一起

現在,我們有了IFTTT,下面就是程式碼了。你可以通過創建下面開始,然後保存為 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需要兩個參數:eventvalue

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標籤(像<br>, <b>, <i> 等等)變換格式。將這個函數複製到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']          # <b> (bold) tag creates bolded text          # 24.02.2018 15:09: $<b>10123.4</b>          row = '{}: $<b>{}</b>'.format(date, price)          rows.append(row)      # Use a <br> (break) tag to create a new line      # Join the rows delimited by <br> tag: row1<br>row2<br>row3      return '<br>'.join(rows)

最後在手機上顯示的結果是這樣的:

然後,我們的功能就完成了,只要比特幣的價格一更新,手機移動端就有提示。當然,如果你嫌煩也可以在app裡面off掉。