socketserver 是 Python 1 個內建模組，主要用來簡化撰寫 Socket Server 的工作，因此在官網中也宣稱它是一個方便的 Socket Server Framework 。
The socketserver module simplifies the task of writing network servers.
Last updated on May 15, 2024 in Python 程式設計 - 中階 by Amo Chen ‐ 5 min read
不管是何種程式語言都有註解的需求，而好的程式開發人員都必須具備勤寫註解的美德。
寫註解不僅是為了幫助自己了解程式的相關細節，也是為了能夠讓他人方便於一起參與開發、維護的重要步驟。
正因為現今的系統架構越來越繁雜，而開發人員的大腦記憶能力有限，當他們持續在開發新功能的同時，其實就已經在慢慢淡忘舊功能的實作細節。
特別是每當發現舊功能需要進行維護與除錯時，往往已經過一段時日，開發人員所存的印象早就所剩無幾，更遑論能夠迅速達成維護與除錯的目標。這些現象在程式開發過程屢見不鮮，因此養成撰寫註解的習慣格外重要。
而每個組織對於註解的規定有所不同，但若是對於初學 Python 程式的新進入者而言，可以參考 Google Python Style Guide 對於註解的規範的章節(連結)。
此外，除了註解，通常文件(documentation)也是必備的產出之一，這些細節都可在 GitHub 上的知名專案可見一斑(如 Django , D3 等)。 但基於 DRY(Don’t Repeat Yourself) 原則，我們希望可以在撰寫註解的同時，也一併完成文件的撰寫(相信有許多程式設計師厭惡撰寫文件)，因此本文將介紹如何利用 Sphinx 將 Python 中的註解自動萃取出來，並且自動地產生一份文件供人參考。
Last updated on Jan 11, 2021 in Python 模組/套件推薦 , Python 程式設計 - 高階 by Amo Chen ‐ 4 min read
如果說最方便且偷懶的對程式進行除錯訊息的記錄是 print() 的話，那麼我的建議是－「如果你正在使用最方便且偷懶的方法，而且知道這種方式不好的話，那麼請花費一點點時間看完這篇文章；如果你早已經像喝水一樣自然地使用 logging 模組的話，可以不需要在閱讀此篇文章」
Posted on Sep 9, 2016 in Python 程式設計 - 初階 by Amo Chen ‐ 2 min read
Python 內建有不少時間相關的操作函數，本篇將如何取得日期區間記錄成 Python recipes ，以供方便使用。
這些方法主要使用 timedelta 進行時間加減、 calendar 取得月份天數以及其他 datetime 模組所提供之函數組合而成。
Posted on Sep 8, 2016 in Python 程式設計 - 初階 by Amo Chen ‐ 1 min read
在我們談到 with 語句時，就不得不先提到所謂的 Context Manager ，有人翻譯成上下文管理器，但我覺得稱為情境管理即可，簡單來講就是希望規範一個物件在進入與離開 with 語句所創造的情境範圍內時能夠自動進行一些動作，打個比方就是進入浴室洗澡要脫衣服，洗完澡離開浴室要穿衣服，在這個比喻中浴室洗澡就是情境(Context)，脫穿衣服就是進入與離開這個情境下會需要進行的動作。
又或者程式設計師經常開完檔之後忘記關檔，所以我們會希望在 with 語句中進行讀檔的處理，並且讓程式執行離開 with 語句的範圍時，自動進行關檔，以免除一些繁瑣的動作，避免類似忘記關檔的事情發生。
Posted on Sep 6, 2016 in Python 程式設計 - 初階 by Amo Chen ‐ 2 min read
很多時候為撰寫速度與方便的結果，我們經常會把檔案開啟之後，就忘記關閉它。小小程式也許並不會讓人在意，但是當我們正在開發大型應用程式時，這樣的壞習慣經常會帶來無法預期的結果。
例如以下的 Python 片段就是一個不好的例子，因為它並沒有進行關檔的善後處理：
for line in open("file.txt"):
print line
Posted on Sep 5, 2016 in Python 程式設計 - 初階 by Amo Chen ‐ 2 min read
最近有朋友也開始寫起 Python，不過特別的是，他們是在不同的作業系統進行開發，有些人用 Windows，有些人用 Linux，這通常第一個地雷就是 “Tab 的間距在 Windows 與 Linux 是不一致的” ，這將可能導致 Python 執行時會產生 IndentationError: unindent does not match any outer indentation level 的錯誤訊息。也因此讓編者想寫下這篇文章，介紹 Python 的 Coding Style 與記錄編者常用的 Python 設定。
Posted on Sep 3, 2016 in Python 程式設計 - 初階 by Amo Chen ‐ 3 min read
Python 的 CSVDictWriter 是很方便的模組，可以直接使用 dict 資料寫入到 CSV 檔案，其用法大致如下：
import csv
with open('my.csv', 'w') as csvf:
writer = csv.DictWriter(csvf, fieldnames=[
'field_1',
'field_2',
'field_3'
])
writer.writeheader()
writer.writerow({'field_1': '', 'field_2': 'b', 'field_3': ''})
writer.writerow({'field_1': '', 'field_2': 'b', 'field_3': ''})
CSVDictWriter 雖然方便，但是如果 row 裡有缺少任何一個 field 都會停止執行，所以遇到欄位很多，而且又不見得每一個欄位都有值的情況就糟糕了，真的要手動打完所有欄位的值嗎？
其實只要搭配 defaultdict 就解決這個問題了。
Posted on Sep 2, 2016 in Python 程式設計 - 中階 by Amo Chen ‐ 1 min read