iT邦幫忙

2024 iThome 鐵人賽

DAY 4
0

前兩天介紹完了開發環境,今天要來介紹存放 Python 套件的地方 PyPI,以及我們存放自己程式碼的地方 Github,認識他們我們就能開發自己的 Python 棒球套件並且讓大家能夠一起使用了。

模組(Module)

在介紹 PyPI 前,想先跟大家介紹 Python 的模組,簡單來說如果我們自己定義一個函式(function),然後想讓他使用在其他 .py 的檔案的話,我們就會需要從函式所在的檔案 import 進我們想使用的檔案裡。
下面是一個使用例子:

  • 建立一個 lib.py 的檔案,在裡面定義一個 function
// lib.py

// 定義一個兩個數相加的 function 在 lib.py 這個檔案裡
def add_two(a, b):
    return a + b
  • 在另一個 main.py 的檔案匯入 lib.py 的 function 並使用
// main.py

import lib

print(lib.add_two(1, 2))
  • 也可以寫成
// main.py

from lib import add_two

print(add_two(1, 2))

最後都會顯示結果 3。
而除了我們自己寫的 function,我們也可以用 import 來取得 Python 內建的 function,像是處理數學運算的 math,或是操作日期或時間的 datetime,更多可以參考以下連結:
10. Python 標準函式庫概覽
當然只使用內建的是不夠的,這時候我們就要去尋找別人提供的公開套件,並且用 pip installPyPI 把他們載下來後,就能一樣用 import 使用,接下來就會來介紹 PyPI

PyPI

PyPI 全名是**(Python Package Index)**,是在 2000 年就推出的 Python 官方軟體套件儲存庫,上面已經有將近 57 萬個套件在上面供所有 Python 開發者使用,而我們也可以透過 pip 這個軟體包管理系統來安裝在 PyPI 上的套件來使用,目前從 Python 3.4 版之後已經有綁定內建 pip 了(詳情可以看這裡),所以可以不用特別安裝。另外,像是 NodeJSpackage.json 來管理套件,Python 也會用一個叫 虛擬環境(Virtual Environment) 來管理 Python 套件,在之後的文章也會再重新介紹這邊要如何操作。
去年介紹的 pybaseball 也是放在 PyPI,我們這次的目標就是希望把我們開發出來的套件也放到 PyPI 給有興趣的人使用。
延伸閱讀:

Github

Github 是一個我們放開放原始碼的平台,當然現下可以使用的平台不只有他,但他應該是最有名的,目前我的 Side Project 也都放在上面,pybaseball 也是在上面進行維護。這次的主題我們需要把我們開發的原始碼放到 Github 上面,並且使用 Github 提供的 CI/CD 功能 Github Action 來幫助我們上傳我們的套件到 PyPI 上,官方也有提供一個流程介紹,未來幾天我應該會一邊參考這個流程一邊解釋裡面有的內容與實作我們這次的功能。
另外,在維護我們自己的 Github Repository 的時候,也會需要知道如何操作 git 指令,在鐵人賽的途中滿有可能會頻繁使用到的,大家有興趣可以先去查查常使用到的 git 指令先預習,我應該是有使用到哪個就會稍微提到一下。
延伸閱讀:

本日小結

今天介紹完了我們程式碼會存在的平台,明天我們就可以開始在 Github 建立我們的專案(Project)開始開發了!會先從創 PyPI 帳號與在 Github 建立新的 Repo (Repository) 後拉到本地端(Local)開始介紹,篇幅夠的話可能會先上傳一版到 PyPI 試試。
總之,一樣感謝大家耐心地看完這篇文章,有任何問題與建議歡迎留言給我知道,明天見 掰掰


上一篇
Day 03 - VSCode 程式編輯器
下一篇
Day 05 - 在 Github 上面建立專案
系列文
上次介紹的棒球套件很少更新了,那就只好自己寫一個!?12
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言