0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

Python 中常见的配置文件写法有哪些

马哥Linux运维 ? 来源:Python中文社区 ? 作者:Python中文社区 ? 2021-10-20 16:11 ? 次阅读
加入交流群
微信小助手二维码

扫码添加小助手

加入工程师交流群

为什么要写配置文件

在开发过程中,我们常常会用到一些固定参数或者是常量。对于这些较为固定且常用到的部分,往往会将其写到一个固定文件中,避免在不同的模块代码中重复出现从而保持核心代码整洁。这个固定文件我们可以直接写成一个.py文件,例如settings.pyconfig.py,这样的好处就是能够在同一工程下直接通过import来导入当中的部分;但如果我们需要在其他Python 的平台进行配置文件共享时,写成单个.py就不是一个很好的选择。这时我们就应该选择通用的配置文件类型来作为存储这些固定的部分。目前常用且流行的配置文件格式类型主要有inijsontomlyamlxml等,这些类型的配置文件我们都可以通过标准库或第三方库来进行解析。

ini

ini即 Initialize 初始化之意,早期是在 Windows 上配置文件的存储格式。ini文件的写法通俗易懂,往往比较简单,通常由节(Section)、键(key)和值(value)组成,就像以下形式:
[localdb]
host     = 127.0.0.1
user     = root
password = 123456
port     = 3306
database = mysql
Python 本身内置的configparser标准库,我们直接就可以用来对ini文件进行解析。如我们将上述内容保存在一个名为db.ini的文件中,然后使用read()方法来进行解析和读取,最后通过items()方法来获取指定节点下的所有键值对。
>>>fromconfigparserimportConfigParser
>>>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默认将值以字符串的形式呈现,所以这也就是为什么我们在db.ini文件中没有加引号而是直接将字面量写在上面的原因。获取到键值对后,我其实直接就将其转换成字典,然后通过解包的方式进行穿参,保持代码简洁:
#!pipinstallpymysql
importpymysql
fromconfigparserimportConfigParser

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

con=pymysql.connect(**db_cfg)

json

json格式可以说是我们常见的一种文件形式了,也是目前在互联网较为流行的一种数据交换格式。除此之外,json有时也是配置文件的一种。比如npmJavaScript 包管理工具类似 Python 的pip)、以及微软出品的目前被广泛使用的 VSCode 编辑器,都使用json编写配置参数。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 的字典对象。
>>>importjson
>>>frompprintimportpprint
>>>
>>>withopen('/Users/Bobot/db.json')asj:
...cfg=json.load(j)['localdb']
...
>>>pprint(cfg)
{'database':'mysql',
'host':'127.0.0.1',
'password':'123456',
'port':3306,
'user':'root'}
使用json文件配置的缺点就是语法标准严格限制,为人所诟病之一的就是无法在当中写注释,除非采取json类型的其他超集作为替代方案(VSCode 中能写注释的json参数配置文件便是代替方案的一种);同时存在嵌套过深的问题,容易导致出错,不宜用来写过长或复杂的参数配置信息。

toml

toml格式(或tml格式)是 Github 联合创始人 Tom Preston-Werner 所提出的一种配置文件格式。根据维基百科的资料,toml最开始提出时是在 2013年7月份,距今已有七年时间;它在某些方面也与后面要谈到的yaml文件有些类似,但如果当你知道 yaml 的规范有几十页(没有错,真的就是几十页……)的时候,可能你真的就不太愿意去写那么复杂的配置文件,toml格式则倒是个不错的选择。toml格式大致如下:

f05cbf0e-315c-11ec-82a8-dac502259ad0.png

01-toml样式从这里可以看出toml有点类似于前面所讲的ini文件。但是它比ini扩展了更多的内容。在样例图片中我们可以看到,除了基本的字符串以外,例如时间戳、布尔值、数组等都进一步支持,而且样式和 Python 的原生写法十分类似。当然这里不会过多介绍toml格式的一些规范说明,有人已经对官方的规范文档进行了翻译,有兴趣的朋友可以直接查阅。这么契合 Python 方式的配置文件类型已经有开发者造出了相应的「轮子」,目前在 Github 上 Stars 数最多的是则是uiri/toml的版本,不过该版本仅通过了 v0.5 版本toml规范,但在使用上还是蛮简洁的,我们可以通过pip命令进行安装
pipinstalltoml
该库的解析方式很简单,也有点类似于json库的解析用法,即通过load()loads()来进行解析;同理转换并导出也是同样类似的用法。比如我们现在将以下内容写入到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()方法来进行读取:

>>>importtoml
>>>importos
>>>frompprintimportpprint
>>>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版的写法(将单引号替换成双引号即可),方便我们后续调用或者传参。

yaml

yaml格式(或yml格式)是目前较为流行的一种配置文件,它早在 2001 由一个名为 Clark Evans 的人提出;同时它也是目前被广泛使用的配置文件类型,典型的就是 Docker 容器里的docker-compose.yml配置文件,如果经常使用 Docker 进行部署的人对此不会陌生。yaml文件的设计从 Python、XML 等地方获取灵感,所以在使用时能很清楚地看到这些部分的影子。在上一节toml内容里我曾提到,yaml的规范内容可以说是冗长和复杂,足足有80页之多(斗尊强者,恐怖如斯……)。

f0bc32e0-315c-11ec-82a8-dac502259ad0.png

02-yaml规范页数所以感兴趣的朋友可以再自行了解相关用法。YAML 官方早已经提供了相应的 Python 库进行支持,即PyYAML;当然也同样需要我们事先进行安装:
pipinstallpyyaml

json库和toml库一样,通过load()方法来进行加载。

需要注意的是,使用load()方法会存在一定的安全隐患,从思科 Talos 的这份报告中我们可以看到,如果加载了未知或不信任的yaml文件,那么有可能会存在被攻击的风险和网络安全隐患,因为它能够直接调用相应的 Python 函数来执行为攻击者所需要的命令,比如说在yaml文件中写入这么一段:

#使用Linux和macOS的朋友不要轻易尝试
!!python/object/apply:os.system["rm-rf/"]

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

这和 Python 内置的string标准库中Template类的substitute()模板方法一样存在着同样的安全隐患,所以使用safe_substitute()来替代是一样的道理。

如我们现在将之前的一些配置信息写入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()方法进行解析:

>>>importos
>>>frompprintimportpprint
>>>
>>>withopen(os.path.expanduser("~/config.yaml"),"r")asconfig:
...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 的读取方法,可能有的读者会发现当中没有xml格式类型的内容。对于xml配置文件可能与 Java 系语言打交道的朋友遇见得会多一些,但xml文件的可读性实在是让人望而生畏;对xml文件不了解的朋友可以使用 Chrome 浏览器随便进入一个网站然后按下 F12 进入开发者后查看那密密麻麻的 html 元素便是.xml的缩影。除了这些主流的配置文件类型之外,像一些.cfg.properties等都可以作为配置文件,甚至和开头提到的那样,你单独用一个.py文件来书写各类配置信息作为配置文件进行导入都是没问题,只是在跨语言共享时可能会有些障碍。因此本文就不过多介绍,感兴趣的朋友可以进一步自行了解。在本文里列举的配置文件类型其复杂性由上到下依次增加:ini < json ≈ toml < yaml,它们之间各有优劣,可以根据自己实际的需求和团队协作要求来具体选择。
编辑:jq
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • XML
    XML
    +关注

    关注

    0

    文章

    188

    浏览量

    33901
  • python
    +关注

    关注

    56

    文章

    4838

    浏览量

    87939
  • Docker
    +关注

    关注

    0

    文章

    522

    浏览量

    13187

原文标题:Python 中常见的配置文件写法

文章出处:【微信号:magedu-Linux,微信公众号:马哥Linux运维】欢迎添加关注!文章转载请注明出处。

收藏 人收藏
加入交流群
微信小助手二维码

扫码添加小助手

加入工程师交流群

    评论

    相关推荐
    热点推荐

    是否可能使用CYSPP配置文件连接到外围设备?

    我们的现有系统使用中央和外围设备,使用基于 Microchip RN4020 的中央和外围设备。 由于供应限制的原因,我们希望将英飞凌 CYBT-483056 SoC 用于 BLE central。 我们想知道是否可能使用CYSPP配置文件连接到外围设备? 或任何其他请
    发表于 07-07 06:17

    CYW920820M2EVB-01开发套件可以与蓝牙的免提配置文件一起使用吗?

    英飞凌 CYW920820M2EVB-01 开发套件,我想将它与蓝牙的免提配置文件一起使用。 是否可以。 该套件是否支持该配置文件? 我无法在任何地方找到该套件支持的配置文件。 如
    发表于 06-30 06:15

    如何才能知道英飞凌Bluetooth?产品支持哪种Bluetooth?配置文件和版本?

    如何才能知道英飞凌Bluetooth?产品支持哪种Bluetooth?配置文件和版本? A2DP、AVRCP、HSP、HFP 等 是否一个网页或文档解释每个设备支持哪些配置文件和版本? 目前我想了解以下设备特别支持的
    发表于 06-27 06:04

    配置文件的差异介绍

    配置文件的差异 FA模型应用在config.json文件中描述应用的基本信息,一个应用工程中可以创建多个Module,每个Module中都有一份config.json文件。config.json由
    发表于 06-05 06:50

    Profibus DP主站转Modbus TCP网关配置文件制作

    Profibus DP主站转Modbus TCP网关配置文件制作
    的头像 发表于 04-02 13:06 ?377次阅读
    Profibus DP主站转Modbus TCP网关<b class='flag-5'>配置文件</b>制作

    是否有用于OpenVINO?工具套件的配置文件工具呢?

    是否有用于OpenVINO?工具套件的配置文件工具?
    发表于 03-06 07:29

    Web Bluetooth SPP(串行端口配置文件)示例

    电缆替代(Cable Replacement)通常指的是通过无线技术,如低功耗蓝牙(Bluetooth LE)替代传统的有线连接,例如串行端口配置文件(Serial Port Profile,简称SPP)。
    的头像 发表于 02-28 09:40 ?816次阅读

    DLPC3478怎么去做ini配置文件和firmware呢 ?

    你好我们现在是用其他厂商的芯片做的开发板加上dlpc3478 2005dmd3010,我们不是官网那个evm,我们要自己开发我们怎么去做ini配置文件 和firmware呢 ?之后我们是用特殊
    发表于 02-24 06:35

    如何导出交换机的配置文件

    在网络管理中,导出交换机的配置文件是一项关键任务,它有助于备份、审计、迁移或恢复网络配置。本文将详细介绍如何导出交换机配置文件,涵盖多种方法,适用于不同场景和需求。文章内容将围绕几种常见
    的头像 发表于 02-02 17:20 ?4545次阅读

    迅为RK3568开发板篇OpenHarmony配置HDF驱动控制LED-配置创建私有配置文件

    私有配置文件,用来填写一些驱动的默认配置信息。HDF 框架在加载驱动时,会获取相应的配置信息并将其保存在 HdfDeviceObject 的 property 中。这些配置信息通过 B
    发表于 01-10 11:13

    SSM开发中的常见问题及解决方案

    在SSM(Spring + Spring MVC + MyBatis)框架的开发过程中,开发者可能会遇到一些常见问题。以下是对这些问题的详细分析以及相应的解决方案: 一、配置文件问题 问题描述
    的头像 发表于 12-17 09:16 ?1521次阅读

    linux网卡配置文件

    网卡配置文件 ? ? 网卡目录[root@localhost opt]# ls /etc/sysconfig/network-scripts/网卡文件名字,和我们ifconfig看到的一样
    的头像 发表于 12-10 10:09 ?919次阅读

    springboot的项目如何既要用jar包启动,同时还可以为不同的机房设置不同的配置文件

    作者:京东科技 李意文 1、首先先把配置文件从jar中抽离 示例代码: ? org.apache.maven.plugins maven-jar-plugin 3.2.0
    的头像 发表于 10-19 16:48 ?927次阅读
    springboot的项目如何既要用jar包启动,同时还可以为不同的机房设置不同的<b class='flag-5'>配置文件</b>

    HID over GATT配置文件(HOGP)低功耗蓝牙

    电子发烧友网站提供《HID over GATT配置文件(HOGP)低功耗蓝牙.pdf》资料免费下载
    发表于 09-26 11:01 ?3次下载
    HID over GATT<b class='flag-5'>配置文件</b>(HOGP)低功耗蓝牙

    确定LDO的任务配置文件兼容性

    电子发烧友网站提供《确定LDO的任务配置文件兼容性.pdf》资料免费下载
    发表于 09-24 10:44 ?0次下载
    确定LDO的任务<b class='flag-5'>配置文件</b>兼容性