紫式書摘003：讀《Publishing Python Package》，思考「什麼是套件(Package)?」
閱讀時間約 4 分鐘
https://www.midjourney.com/app/jobs/518224de-9d1c-4275-ac0b-df6311a0c94b/
你好，歡迎閱讀《紫式書摘》。
我是王啟樺，目前在加州大學洛杉磯分校(UCLA)擔任統計機器學習方向的博士後研究員。
這篇文章是《紫式書摘》的第003篇文章，紀錄了我閱讀《Publishing Python Packages》的Chapter 1後，產生對「套件(Package)」的一些想法隨筆。
之所以想讀《Publishing Python Package》，是因為
- Reason 1：學習自動化能力，是經營個人副業的基礎
- Reason 2：工作上的勞動成果，要能更容易為他人所用
- Reason 3：了解open source community的文化，取用大量優質免費資源
而閱讀完《Publishing Python Package》的Chapter 1，我學到了3個要點
- Lesson 1：Packaging = Software + Metadata 套件=軟體＋元數據.
- Lesson 2：套件管理系統(Package management systems)是用來解決各種版本衝突.
- Lesson 3：發布套件時，會放入4種檔案：Source code, makefile, Metadata, Instructions.
對「什麼是套件(Package)?」感興趣嗎？繼續往下閱讀吧：）
Lesson 1：套件=軟體＋元數據 (Packaging = Software + Metadata)
一直覺得「套件」這個概念很抽象。但在這本書中，我讀到套件的定義為：
Packaging is the act of archiving software along with metadata that describes those files. 套件化本身，就是將「軟體」與「描述軟體檔案的元數據」建檔的過程。
這個定義解答了我很多疑惑。當只有程式碼而沒有解說，我們很難知道程式碼有什麼用。當只有解說而沒有程式碼，我們又會覺得在畫大餅，不實際。
同時有程式碼(code)與解說(nocode)，讓東西真的能用起來，這就是套件(Packaging)的藝術。
的確，當使用他人的github儲存庫，如果解說不清楚就很難用。在我的學術工作中，常常需要搭配paper來讀懂作者寫的code的用法。好的paper相當於非常詳細的code使用手冊。因此，練習寫好軟體的解說，是重要的任務。
把軟體的解說寫好，有哪些習慣需要立即開始培養呢？
Lesson 2：套件管理系統(Package management systems)是用來解決各種版本衝突
我學到的第二件事，就是理解到套件管理系統(Package management systems)，就是用來解決各種版本衝突的。
在安裝軟體的時候，我也用過如 pip 安裝Python package, 用conda安裝Pytorch，用Homebrew安裝Mac軟體。這些「安裝方式」或多或少有經驗，但是讀了這本書後知道，他們提供了
- 安裝(install)
- 解安裝(uninstall)
- 更新(update)
套件，一個標準化的流程，讓大家的軟體使用更加順暢。
有了套件管理系統，開發者就可以指定好用戶的使用設定(Configuration)。
Lesson 3：發布套件時，會放入4種檔案：Source code, makefile, Metadata, Instructions.
我學到的第3件事，就是原來發布套件的時候，會需要放入4種檔案：
- 原始程式碼(Source code)
- 編譯程式碼的makefile
- 程式碼的元數據 (Metadata)
- 用戶指南 (Instructions for the consumer).
能夠設計套件真的是一個體力活。首先，能夠寫source code就已經很考驗硬技能。而寫用戶指南又很考驗軟技能。這些東西都不顯然，但是在現代卻很流行，就一定有它的用途。開始投資IT技能，就可以享用各種免費的資源。
不知道makefile與Metadata有什麼好用的寫作原則?
你是否也對「」開始感興趣了呢？謝謝你閱讀《紫式書摘》。如果覺得這個文章對你有幫助，歡迎
為什麼會看到廣告
留言0
查看全部
你可能也想看
重點摘要：
1.9 月降息 2 碼、進一步暗示年內還有 50 bp 降息
2.SEP 上修失業率預期，但快速的降息速率將有助失業率觸頂
3.未來幾個月經濟數據將繼續轉弱，經濟復甦的時點或是 1Q25 季底附近
近期的「貼文發佈流程 & 版型大更新」功能大家使用了嗎？
新版式整體視覺上「更加凸顯圖片」，為了搭配這次的更新，我們推出首次貼文策展 ❤️
使用貼文功能並完成這次的指定任務，還有機會獲得富士即可拍，讓你的美好回憶都可以用即可拍珍藏！
假日的傍晚來到不只是圖書館，樸質的木質窗框搭配較為現代感的玻璃，從松菸的走廊上就能看見它微微發光的樣貌。融入在松菸的老式建築下，它竟不突兀卻也成為年輕人的新聚所。當閱讀、老屋成為一種老派浪漫，身邊多了這樣充滿藝術氛圍的圖書館，它已不是圖書館，而是我們也可以浸潤其中的藝術。
本文刊於 AWESOME Magazine 2017 3-6月號
位於台北西區的《偵探書屋》，是臺灣第一間以推理、懸疑為主體的類型書店。走進書店，除了架上琳瑯滿目的書籍，隨處可見偵探識別的圖！
打開台北前傳｜松山文創園區｜松菸｜不只是圖書館｜2023/11/11~12是打開台北的活動日！Open House Taipei 是一年一度限時打開平日鮮為人知的都市秘境空間，讓大家能窺探台北的神秘空間！限時 48 小時串聯台北100+建築空間，不只是圖書館是其中之一，帶大家來看看這個空間有什麼！
如果用一本書來形容自己，你覺得自己是什麼樣類型的書？
經典文學？潮流漫畫？浪漫詩集？勵志雞湯？地方文史？學術論文？
這一集是我們錄製最長時間的一集，並不是忘記控制時間，而是有許多碰撞的火花，這一集我們欣賞那每個人精彩故事，七十歲大姐、科技業主管、青春大學生.....
我們每個人，多少都在社會中失語。面對誤會無法澄清、面對工作上司夾擊只能吞下去、面對感情難以解釋：在現代政經體系只在乎地位權勢金錢，但許多人們還是想要一個沒有利益衝突的所在，一個自己能夠好好做喜歡的事情、有人互相完成目標的地方。
說不是為了朝聖是假的XD，身為不知第幾刷的想見你小粉絲，偶然間看到電影版中場景，一定要親自來體驗一下囉！
就是這個背景！拍攝地位於松菸文創園區內的「不只是圖書館 Not just library」裡。這原是個女澡堂，經過改造變成現在這個樣子。
一進去，撲鼻而來是淡雅的木頭香。還有由書架指引的唯一通道
還記得某位政客諷某黨在南部隨便擺一顆西瓜也能選上?這是有名有姓的事實，但不列出名字和政黨，因為要敘述的只是現今民主的假象，或做事過去另一個政黨也一樣。探討解析是希望讓大多數迷信民主迷湯的人們可以正視，並且重新把人民的權力從這個假民主拿回來，回歸真正的民主，甚麼才是真民主?
想要一次讀懂，就什麼也不懂。如何破解書中深鎖黃金屋，《如何閱讀一本書》就是您的首選。
作品名稱：《結與書：《外科室》的一心一意》
作者：野村美月
出版社：尖端
售價：250元
重點摘要：
1.9 月降息 2 碼、進一步暗示年內還有 50 bp 降息
2.SEP 上修失業率預期，但快速的降息速率將有助失業率觸頂
3.未來幾個月經濟數據將繼續轉弱，經濟復甦的時點或是 1Q25 季底附近
近期的「貼文發佈流程 & 版型大更新」功能大家使用了嗎？
新版式整體視覺上「更加凸顯圖片」，為了搭配這次的更新，我們推出首次貼文策展 ❤️
使用貼文功能並完成這次的指定任務，還有機會獲得富士即可拍，讓你的美好回憶都可以用即可拍珍藏！
假日的傍晚來到不只是圖書館，樸質的木質窗框搭配較為現代感的玻璃，從松菸的走廊上就能看見它微微發光的樣貌。融入在松菸的老式建築下，它竟不突兀卻也成為年輕人的新聚所。當閱讀、老屋成為一種老派浪漫，身邊多了這樣充滿藝術氛圍的圖書館，它已不是圖書館，而是我們也可以浸潤其中的藝術。
本文刊於 AWESOME Magazine 2017 3-6月號
位於台北西區的《偵探書屋》，是臺灣第一間以推理、懸疑為主體的類型書店。走進書店，除了架上琳瑯滿目的書籍，隨處可見偵探識別的圖！
打開台北前傳｜松山文創園區｜松菸｜不只是圖書館｜2023/11/11~12是打開台北的活動日！Open House Taipei 是一年一度限時打開平日鮮為人知的都市秘境空間，讓大家能窺探台北的神秘空間！限時 48 小時串聯台北100+建築空間，不只是圖書館是其中之一，帶大家來看看這個空間有什麼！
如果用一本書來形容自己，你覺得自己是什麼樣類型的書？
經典文學？潮流漫畫？浪漫詩集？勵志雞湯？地方文史？學術論文？
這一集是我們錄製最長時間的一集，並不是忘記控制時間，而是有許多碰撞的火花，這一集我們欣賞那每個人精彩故事，七十歲大姐、科技業主管、青春大學生.....
我們每個人，多少都在社會中失語。面對誤會無法澄清、面對工作上司夾擊只能吞下去、面對感情難以解釋：在現代政經體系只在乎地位權勢金錢，但許多人們還是想要一個沒有利益衝突的所在，一個自己能夠好好做喜歡的事情、有人互相完成目標的地方。
說不是為了朝聖是假的XD，身為不知第幾刷的想見你小粉絲，偶然間看到電影版中場景，一定要親自來體驗一下囉！
就是這個背景！拍攝地位於松菸文創園區內的「不只是圖書館 Not just library」裡。這原是個女澡堂，經過改造變成現在這個樣子。
一進去，撲鼻而來是淡雅的木頭香。還有由書架指引的唯一通道
還記得某位政客諷某黨在南部隨便擺一顆西瓜也能選上?這是有名有姓的事實，但不列出名字和政黨，因為要敘述的只是現今民主的假象，或做事過去另一個政黨也一樣。探討解析是希望讓大多數迷信民主迷湯的人們可以正視，並且重新把人民的權力從這個假民主拿回來，回歸真正的民主，甚麼才是真民主?
想要一次讀懂，就什麼也不懂。如何破解書中深鎖黃金屋，《如何閱讀一本書》就是您的首選。
作品名稱：《結與書：《外科室》的一心一意》
作者：野村美月
出版社：尖端
售價：250元