1. Redis 作者關(guān)于寫代碼注釋的一點想法

http://antirez.com/news/124
Redis 的代碼注釋清晰簡潔，堪稱典范。
這篇文章作者分享自己寫注釋的一點心得，推薦一讀。

概括起來注釋包括：

• Function comments 放在函數(shù)里面，減少讀代碼者需要額外的思考負擔
• Design comments 通常放在一個文件的開頭，整個文件的概述、原理等
• Why comments 解釋一些實現(xiàn)方法的原因
• Teacher comments 解釋一些非編程領(lǐng)域的人可能不了解的信息，如數(shù)學、圖形學等
• Checklist comments 解決一些比如改了這里代碼，也要修改那里代碼的問題
• Guide comments 幫助引導讀者確認沒有誤解代碼
  ……

作者原話：

• Writing good comments is harder than writing good code
• 寫好注釋比寫好代碼更困難。

2. Python 中與和導入同等級目錄下的另一個模塊？

假設(shè)我有一個模塊my_module, 我為其寫了一些測試腳本放在tests目錄下。
一般情況下，我并不想把這些測試腳本放在源碼文件里面，所以會這樣存放：

.
├── README.md
├── my_module
│   └── my_class.py
└── tests
    └── my_test.py

但是由于測試腳本并不在模塊里面，當需要導入這個模塊的時候，就有點麻煩，只能通過路徑的方法導入：

# tests/my_test.py
import sys
from os import path
sys.path.append( path.dirname( path.dirname( path.abspath(__file__) ) ) )

from my_module import my_class

3. 使用 SQLAlchemy 直接執(zhí)行 SQL 語句

SQLAlchemy 雖然提供了方便的ORM，但有時候需要直接執(zhí)行一些語句，有不想用其他連接庫的時候，可以直接用engine.connect()來執(zhí)行。

from sqlalchemy.sql import text

connection = engine.connect()

# recommended
cmd = 'select * from Employees where EmployeeGroup == :group'
employeeGroup = 'Staff'
employees = connection.execute(text(cmd), group = employeeGroup)

參考鏈接
https://stackoverflow.com/questions/17972020/how-to-execute-raw-sql-in-sqlalchemy-flask-app
https://chartio.com/resources/tutorials/how-to-execute-raw-sql-in-sqlalchemy/

4. Git diff 直接輸出到當前頁面

有時候我們需要將 git diff 輸出到當前頁面或者文件，可以通過參數(shù)或者管道控制。

git --no-pager diff
git diff | cat # The latter also removes colour coding.

5. 一些有意思的句子

"Poor people spend their money and save what’s left. Rich people save their money and spend what’s left."

https://www.jimrohn.com/3-money-habits-separate-rich-poor/

其實作為運維，對于時間管理也是相同的道理：珍惜時間的人應(yīng)該能夠盡量按照自己的計劃來工作，而不是等待緊急時間，一直處于救火狀態(tài)。