當前位置:首頁 > 公眾號精選 > 21ic電子網
[導讀]在開發(fā)過程中,我們常常會用到一些固定參數(shù)或者是常量。對于這些較為固定且常用到的部分,往往會將其寫到一個固定文件中,避免在不同的模塊代碼中重復出現(xiàn)從而保持核心代碼整潔。

5分鐘掌握Python中常見的配置文件

為什么要寫配置文件

在開發(fā)過程中,我們常常會用到一些固定參數(shù)或者是常量。對于這些較為固定且常用到的部分,往往會將其寫到一個固定文件中,避免在不同的模塊代碼中重復出現(xiàn)從而保持核心代碼整潔。
這個固定文件我們可以直接寫成一個? .py ?文件,例如? settings.py ?或? config.py ,這樣的好處就是能夠在同一工程下直接通過? import ?來導入當中的部分;但如果我們需要在其他非 Python 的平臺進行配置文件共享時,寫成單個? .py ?就不是一個很好的選擇。這時我們就應該選擇通用的配置文件類型來作為存儲這些固定的部分。目前常用且流行的配置文件格式類型主要有? ini 、 json toml 、 yaml 、 xml ?等,這些類型的配置文件我們都可以通過標準庫或第三方庫來進行解析。

ini

ini ?即 Initialize 初始化之意,早期是在 Windows 上配置文件的存儲格式。 ini ?文件的寫法通俗易懂,往往比較簡單,通常由節(jié)(Section)、鍵(key)和值(value)組成,就像以下形式:
[localdb]
host = 127.0.0.1
user = root
password = 123456
port = 3306
database = mysql
Python 本身內置的? configparser ?標準庫,我們直接就可以用來對? ini ?文件進行解析。如我們將上述內容保存在一個名為? db.ini ?的文件中,然后使用? read() ?方法來進行解析和讀取,最后通過? items() ?方法來獲取指定節(jié)點下的所有鍵值對。
>>>?from?configparser?import?ConfigParser
>>>?cfg?=?ConfigParser()
>>>?cfg.read("/Users/Bobot/db.ini")
['/Users/Bobot/db.ini']
>>>?cfg.items("localdb")
[('host',?'127.0.0.1'),?('user',?'root'),?('password',?'123456'),?('port',?'3306'),?('database',?'mysql')]
需要注意的是, configparser ?默認將值以字符串的形式呈現(xiàn),所以這也就是為什么我們在? db.ini ?文件中沒有加引號而是直接將字面量寫在上面的原因。
獲取到鍵值對后,我其實直接就將其轉換成字典,然后通過解包的方式進行穿參,保持代碼簡潔:
#!pip?install?pymysql
import?pymysql
from?configparser?import?ConfigParser

cfg?=?ConfigParser()
cfg.read("/Users/Bobot/db.ini")
db_cfg?=?dict(cfg.items("localdb"))

con?=?pymysql.connect(**db_cfg)

json

json ?格式可以說是我們常見的一種文件形式了,也是目前在互聯(lián)網較為流行的一種數(shù)據(jù)交換格式。除此之外, json ?有時也是配置文件的一種。
比如? npm (JavaScript 包管理工具類似 Python 的? pip )、以及微軟出品的目前被廣泛使用的 VSCode 編輯器,都使用? json ?編寫配置參數(shù)。
和? configparser ?一樣,Python 也內置了? json ?標準庫,可以通過? load() ?和? loads() ?方法來導入文件式和字符串的? json ?內容。
{
????"localdb":{
????????"host":?"127.0.0.1",
????????"user":?"root",
????????"password":?"123456",
????????"port":?3306,
????????"database":?"mysql"
????}
}

我們將上述內容保存為? db.json ?后進行讀取和解析, json ?庫讀取 json 文件相對簡單容易,而且很容易解析成 Python 的字典對象。
>>>?import?json
>>>?from?pprint?import?pprint
>>>?
>>>?with?open('/Users/Bobot/db.json')?as?j:
...?????cfg?=?json.load(j)['localdb']
...?
>>>?pprint(cfg)
{'database':?'mysql',
?'host':?'127.0.0.1',
?'password':?'123456',
?'port':?3306,
?'user':?'root'}
使用? json ?文件配置的缺點就是語法標準嚴格限制,為人所詬病之一的就是無法在當中寫注釋,除非采取? json ?類型的其他超集作為替代方案(VSCode 中能寫注釋的? json ?參數(shù)配置文件便是代替方案的一種);同時存在嵌套過深的問題,容易導致出錯,不宜用來寫過長或復雜的參數(shù)配置信息。

toml

toml ?格式(或? tml ?格式)是 Github 聯(lián)合創(chuàng)始人 Tom Preston-Werner 所提出的一種配置文件格式。根據(jù)維基百科的資料, toml ?最開始提出時是在 2013年7月份,距今已有七年時間;它在某些方面也與后面要談到的? yaml ?文件有些類似,但如果當你知道 yaml 的規(guī)范有幾十頁(沒有錯,真的就是幾十頁……)的時候,可能你真的就不太愿意去寫那么復雜的配置文件, toml ?格式則倒是個不錯的選擇。
toml ?格式大致如下:

5分鐘掌握Python中常見的配置文件

01-toml樣式

從這里可以看出?toml?有點類似于前面所講的?ini?文件。但是它比?ini?擴展了更多的內容。

在樣例圖片中我們可以看到,除了基本的字符串以外,例如時間戳、布爾值、數(shù)組等都進一步支持,而且樣式和 Python 的原生寫法十分類似。

當然這里不會過多介紹?toml?格式的一些規(guī)范說明,有人已經對官方的規(guī)范文檔進行了翻譯,有興趣的朋友可以直接查閱。

這么契合 Python 方式的配置文件類型已經有開發(fā)者造出了相應的「輪子」,目前在 Github 上 Stars 數(shù)最多的是則?uiri/toml?的版本,不過該版本僅通過了 v0.5 版本?toml?規(guī)范,但在使用上還是蠻簡潔的,我們可以通過?pip?命令進行安裝

pip?install?toml
該庫的解析方式很簡單,也有點類似于? json ?庫的解析用法,即通過 load() ?或? loads() ?來進行解析;同理轉換并導出也是同樣類似的用法。
比如我們現(xiàn)在將以下內容寫入到? config.toml ?中:
[mysql]
host = "127.0.0.1"
user = "root"
port = 3306
database = "test"

[mysql.parameters]
pool_size = 5
charset = "utf8"

[mysql.fields]
pandas_cols = [ "id", "name", "age", "date"]

緊接著我們就可以通過?toml?庫中的?load()?方法來進行讀?。?/span>

>>>?import?toml
>>>?import?os
>>>?from?pprint?import?pprint
>>>?cfg?=?toml.load(os.path.expanduser("~/Desktop/config.toml"))
>>>?pprint(cfg)
{'mysql':?{'database':?'test',
???????????'fields':?{'pandas_cols':?['id',?'name',?'age',?'date']},
???????????'host':?'127.0.0.1',
???????????'parameters':?{'charset':?'utf8',?'pool_size':?5},
???????????'port':?3306,
???????????'user':?'root'}}
可以看到? toml ?文件被間接地轉化成了字典類型,當然這也就是? json ?版的寫法(將單引號替換成雙引號即可),方便我們后續(xù)調用或者傳參。

yaml

yaml ?格式(或? yml ?格式)是目前較為流行的一種配置文件,它早在 2001 由一個名為 Clark Evans 的人提出;同時它也是目前被廣泛使用的配置文件類型,典型的就是 Docker 容器里的 docker-compose.yml ?配置文件,如果經常使用 Docker 進行部署的人對此不會陌生。
yaml ?文件的設計從 Python、XML 等地方獲取靈感,所以在使用時能很清楚地看到這些部分的影子。
在上一節(jié)? toml ?內容里我曾提到, yaml ?的規(guī)范內容可以說是冗長和復雜,足足有80頁之多(斗尊強者,恐怖如斯……)。

5分鐘掌握Python中常見的配置文件

02-yaml規(guī)范頁數(shù)

所以感興趣的朋友可以再自行了解相關用法。

YAML 官方早已經提供了相應的 Python 庫進行支持,即?PyYAML;當然也同樣需要我們事先進行安裝:

pip?install?pyyaml
同? json ?庫和? toml ?庫一樣,通過? load() ?方法來進行加載。
需要注意的是,使用? load() ?方法會存在一定的安全隱患,從思科 Talos 的這份報告中我們可以看到,如果加載了未知或不信任的? yaml ?文件,那么有可能會存在被攻擊的風險和網絡安全隱患,因為它能夠直接調用相應的 Python 函數(shù)來執(zhí)行為攻擊者所需要的命令,比如說在? yaml ?文件中寫入這么一段:
#?使用Linux和macOS的朋友不要輕易嘗試
!!python/object/apply:os.system?["rm?-rf?/"]

因此最好是使用?safe_load()?來代替?load()?方法。

這和 Python 內置的?string?標準庫中?Template?類的?substitute()?模板方法一樣存在著同樣的安全隱患,所以使用?safe_substitute()?來替代是一樣的道理。

如我們現(xiàn)在將之前的一些配置信息寫入?config.yaml?文件中:


mysql:
??host:?"127.0.0.1"
??port:?3306
??user:?"root"
??password:?"123456"
??database:?"test"

??parameter:
????pool_size:?5
????charset:?"utf8"

??fields:
????pandas_cols:?
??????-?id
??????-?name
??????-?age
??????-?date

然后我們通過?safe_load()?方法進行解析:


>>>?import?os
>>>?from?pprint?import?pprint
>>>?
>>>?with?open(os.path.expanduser("~/config.yaml"),?"r")?as?config:
...?????cfg?=?yaml.safe_load(config)
...?
>>>?pprint(cfg)
{'mysql':?{'database':?'test',
???????????'fields':?{'pandas_cols':?['id',?'name',?'age',?'date']},
???????????'host':?'127.0.0.1',
???????????'parameter':?{'charset':?'utf8',?'pool_size':?5},
???????????'password':?'123456',
???????????'port':?3306,
???????????'user':?'root'}}

可以看到最后結果和前面的?toml?庫的解析結果基本一致。

結尾

本文列舉了一些主流且常見的配置文件類型及其 Python 的讀取方法,可能有的讀者會發(fā)現(xiàn)當中沒有? xml ?格式類型的內容。對于? xml ?配置文件可能與 Java 系語言打交道的朋友遇見得會多一些,但? xml ?文件的可讀性實在是讓人望而生畏;對? xml ?文件不了解的朋友可以使用 Chrome 瀏覽器隨便進入一個網站然后按下 F12 進入開發(fā)者后查看那密密麻麻的 html 元素便是? .xml ?的縮影。
除了這些主流的配置文件類型之外,像一些? .cfg .properties ?等都可以作為配置文件,甚至和開頭提到的那樣,你單獨用一個? .py ?文件來書寫各類配置信息作為配置文件進行導入都是沒問題,只是在跨語言共享時可能會有些障礙。因此本文就不過多介紹,感興趣的朋友可以進一步自行了解。
在本文里列舉的配置文件類型其復雜性由上到下依次增加: ini < json ≈ toml < yaml ,它們之間各有優(yōu)劣,可以根據(jù)自己實際的需求和團隊協(xié)作要求來具體選擇。


來源:Python中文社區(qū)

免責聲明:本文內容由21ic獲得授權后發(fā)布,版權歸原作者所有,本平臺僅提供信息存儲服務。文章僅代表作者個人觀點,不代表本平臺立場,如有問題,請聯(lián)系我們,謝謝!

21ic電子網

掃描二維碼,關注更多精彩內容

本站聲明: 本文章由作者或相關機構授權發(fā)布,目的在于傳遞更多信息,并不代表本站贊同其觀點,本站亦不保證或承諾內容真實性等。需要轉載請聯(lián)系該專欄作者,如若文章內容侵犯您的權益,請及時聯(lián)系本站刪除。
換一批
延伸閱讀

9月2日消息,不造車的華為或將催生出更大的獨角獸公司,隨著阿維塔和賽力斯的入局,華為引望愈發(fā)顯得引人矚目。

關鍵字: 阿維塔 塞力斯 華為

加利福尼亞州圣克拉拉縣2024年8月30日 /美通社/ -- 數(shù)字化轉型技術解決方案公司Trianz今天宣布,該公司與Amazon Web Services (AWS)簽訂了...

關鍵字: AWS AN BSP 數(shù)字化

倫敦2024年8月29日 /美通社/ -- 英國汽車技術公司SODA.Auto推出其旗艦產品SODA V,這是全球首款涵蓋汽車工程師從創(chuàng)意到認證的所有需求的工具,可用于創(chuàng)建軟件定義汽車。 SODA V工具的開發(fā)耗時1.5...

關鍵字: 汽車 人工智能 智能驅動 BSP

北京2024年8月28日 /美通社/ -- 越來越多用戶希望企業(yè)業(yè)務能7×24不間斷運行,同時企業(yè)卻面臨越來越多業(yè)務中斷的風險,如企業(yè)系統(tǒng)復雜性的增加,頻繁的功能更新和發(fā)布等。如何確保業(yè)務連續(xù)性,提升韌性,成...

關鍵字: 亞馬遜 解密 控制平面 BSP

8月30日消息,據(jù)媒體報道,騰訊和網易近期正在縮減他們對日本游戲市場的投資。

關鍵字: 騰訊 編碼器 CPU

8月28日消息,今天上午,2024中國國際大數(shù)據(jù)產業(yè)博覽會開幕式在貴陽舉行,華為董事、質量流程IT總裁陶景文發(fā)表了演講。

關鍵字: 華為 12nm EDA 半導體

8月28日消息,在2024中國國際大數(shù)據(jù)產業(yè)博覽會上,華為常務董事、華為云CEO張平安發(fā)表演講稱,數(shù)字世界的話語權最終是由生態(tài)的繁榮決定的。

關鍵字: 華為 12nm 手機 衛(wèi)星通信

要點: 有效應對環(huán)境變化,經營業(yè)績穩(wěn)中有升 落實提質增效舉措,毛利潤率延續(xù)升勢 戰(zhàn)略布局成效顯著,戰(zhàn)新業(yè)務引領增長 以科技創(chuàng)新為引領,提升企業(yè)核心競爭力 堅持高質量發(fā)展策略,塑強核心競爭優(yōu)勢...

關鍵字: 通信 BSP 電信運營商 數(shù)字經濟

北京2024年8月27日 /美通社/ -- 8月21日,由中央廣播電視總臺與中國電影電視技術學會聯(lián)合牽頭組建的NVI技術創(chuàng)新聯(lián)盟在BIRTV2024超高清全產業(yè)鏈發(fā)展研討會上宣布正式成立。 活動現(xiàn)場 NVI技術創(chuàng)新聯(lián)...

關鍵字: VI 傳輸協(xié)議 音頻 BSP

北京2024年8月27日 /美通社/ -- 在8月23日舉辦的2024年長三角生態(tài)綠色一體化發(fā)展示范區(qū)聯(lián)合招商會上,軟通動力信息技術(集團)股份有限公司(以下簡稱"軟通動力")與長三角投資(上海)有限...

關鍵字: BSP 信息技術
關閉
關閉