前言
在過往很多開源專案大家都會使用 Travis (也真的好用)，但隨著 GitHub Actions 推出之後也許多人轉移上去，畢竟讓資源都在同一個平台上也比較好管理。而最近看到許多專案(LINE SDK)都開始改到 Actions 上，且因緣際會下看到 GitHub 的文件上敘述如何使用，而在個人專案上也能很清楚明瞭的點選到相關的 Actions flow，所以本次就用這篇來介紹一下啦～
範例專案請參考我的 GitHub
介紹
GitHub Actions 到底是什麼？或許你聽過也用過 Travis CI、Circle CI、Jenkins …，大多人用途可能是 自動測試、持續部署…自動化ＯＯＯ，簡而言之就是透過這些工具讓我們日常重覆性極高的工作可以讓機器去自動處理，而只要收最後的結果即可(成功/失敗)。那 GitHub Actions 就是如前面幾樣工具一樣的功能，定義好 yaml 檔後就會自動觸發工作開始執行，最大的優點就是：若寫的套件、side project 剛好放在 GitHub 上，就可以達到 single source of truth 的效果，不用到處設定相關參數而導致搞混 🙂
處理相依套件資訊
首先一般專案設計都會依照環境去切割相依套件的檔案，例如 (production vs develop)，(Production vs CI 環境)，在此次的範例中我建立的 requirements.txt 與 requirements-ci.txt 來安裝相關套件，主要是為了切割環境避免造成多餘的安裝，後者則是在 CI 環境中會用到的工具。
檢查 tox.ini
這個檔案目的是為了讓你在跑 tox 這個指令時可以參考相關設定檔，讓個人開發者可以在當中彈性的設定相依需求。
- 第 2 行：在參考其他專案時複製過來，當中是
py37-flake8-src，但因為會測試多版本，因此這邊輸入py3-flake8-src就好。(少個 7) - 第 11 行：執行環境中會相依套件(如：pytest、pytest-flake8、pytest-pep8、pytest-cov)，雖然在建立時已經有安裝
requirement-ci.txt，但這邊還是要修改避免其他人在本地端測試時無法啟動。
加入部署的 Actions
進入專案後，點選到上面頁籤中的 Actions，選取當中的 Python Package，
猶記得去年剛出時因為資源還不多，但現在有許多貢獻者已經幫我們寫好了許多內容，可以讓我們在當中直接點選引進 專案中，但要在 submit 前要注意當中跑的內容是甚麼才行喔！
設定 Secret 至單一專案中
- 先到 https://pypi.org/
- 右上角 Your project
- 點選 Account Setting
因為我們還沒將專案上傳至 Pypi，因此在這裡設定權限時會先設定所有專案(Scope)，若在此之後會擔心權限問題，可在上傳完之後再回來更改喔！
最後會給你帳號 __token__ 與密碼 pypi-xxxoooo，並有敘述說你在本地端如何操作，不過這邊因為要放在 GitHub Actions 上，因此就不討論這部分。
接著開啟剛剛 Fork 的專案，並於 Setting 中設定剛剛建立的帳號密碼，並按第三步的建立，將 PYPI_USERNAME 以及 PYPI_PASSWORD 填入剛剛設定得對應值。
在加入部署 Actions 環節中的圖片，會有 Publish Python Package 的按鈕，但若你不小心把網頁關掉了也沒關係，以下提供一份 gist，在 .github/workflows 裡建立一個 publish.yml 並貼上即可。
小技巧：用 Mac 開網頁我都會 Command + 左鍵 開新頁面，避免舊的頁面也需要但被刷掉。
稍微解釋一下這份 yaml 檔在這部分最重要部分
- 6~8 行: 當在 GitHub 中 Release 新版本建立時(不清楚 Release 可參考)，自動觸發該腳本跑相對應功能。
- 27, 28 行: 讀取專案中的環境變數，也就是剛剛在 Secret 輸入的 PYPI_USERNAME 以及 PYPI_PASSWORD，這兩行會自動去抓這兩個參數並放入。
- 30, 31 行: 讀取專案套件中的 setup.py，透過設定值並編譯出一個
dist/的資料夾，透過 twine 把dist/上傳至 Pypi 上。
Testing
首先我們先任意改個 README 內容後，直接推送至 GitHub 上，應該會先看到 ✅ 的地方是個黃色圈圈 🟡，此時就是正在跑一開始設定的單元測試，可以點圖示進去看跑的過程。
修改 GitHub_Action_Python_Example/__version__.py 裡的版本號(例如: 1.0.2)演進版好，接著我們在點選 Release 後，會看到畫面上有 Draft a new release 的按鈕：
進入後輸入相關的資訊：
- 版號
- 標題
- 細節描述
輸入完之後點選 Actions，就會看到相關觸發的流程開始執行了
想看更多執行細節就點入，會看到相關的執行 Actions Task， 若有錯誤則在當中查看。(感覺可以在設定讓整個 Task 串在一起)
如上圖完成之後，至 Pypi 上查看你的套件，以下圖來說我就釋出了 0.2.0 的版本囉！
結論
若讀者在看這邊時也在嘗試做 Python 套件的話不妨參考看看，而透過 GitHub Actions 也能讓你只要下 Release 時即可自動推到 Pypi 上，整體體驗就超省時的，是不是很方便呀！
接下來則預計寫一篇如何讓 GitHub Actions 串相關通知型服務，近請期待！