• 常用配置文件 参考


     

    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方法来获取指定节点下的所有键值对。

    >>> 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默认将值以字符串的形式呈现,所以这也就是为什么我们在db.ini文件中没有加引号而是直接将字面量写在上面的原因。

    获取到键值对后,我其实直接就将其转换成字典,然后通过解包的方式进行穿参,保持代码简洁:

    #!pip install pymysql
    import pymysqlfrom configparser import ConfigParser
    cfg = ConfigParsercfg.read("/Users/Bobot/db.ini")
    db_cfg = dict(cfg.items("localdb"))
    con = pymysql.connect(**db_cfg)

    json

    json格式可以说是我们常见的一种文件形式了,也是目前在互联网较为流行的一种数据交换格式。除此之外,json有时也是配置文件的一种。

    比如 npm(JavaScript 包管理工具类似 Python 的pip)、以及微软出品的目前被广泛使用的 VSCode 编辑器,都使用json编写配置参数。

    和 configparser一样,Python 也内置了json标准库,可以通过loadloads方法来导入文件式和字符串的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参数配置文件便是代替方案的一种);同时存在嵌套过深的问题,容易导致出错,不宜用来写过长或复杂的参数配置信息。

    toml

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

    toml格式大致如下:

    01-toml样式

    从这里可以看出 toml有点类似于前面所讲的ini文件。但是它比ini扩展了更多的内容。

    在样例图片中我们可以看到,除了基本的字符串以外,例如时间戳、布尔值、数组等都进一步支持,而且样式和 Python 的原生写法十分类似。

    当然这里不会过多介绍 toml格式的一些规范说明,有人已经对官方的规范文档进行了翻译,有兴趣的朋友可以直接查阅。

    这么契合 Python 方式的配置文件类型已经有开发者造出了相应的「轮子」,目前在 Github 上 Stars 数最多的是则是 uiri/toml的版本,不过该版本仅通过了 v0.5 版本toml规范,但在使用上还是蛮简洁的,我们可以通过pip命令进行安装

    pip install toml

    该库的解析方式很简单,也有点类似于 json库的解析用法,即通过loadloads来进行解析;同理转换并导出也是同样类似的用法。

    比如我们现在将以下内容写入到 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方法来进行读取:

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

    yaml

    yaml格式(或yml格式)是目前较为流行的一种配置文件,它早在 2001 由一个名为 Clark Evans 的人提出;同时它也是目前被广泛使用的配置文件类型,典型的就是 Docker 容器里的docker-compose.yml配置文件,如果经常使用 Docker 进行部署的人对此不会陌生。

    yaml文件的设计从 Python、XML 等地方获取灵感,所以在使用时能很清楚地看到这些部分的影子。

    在上一节 toml内容里我曾提到,yaml的规范内容可以说是冗长和复杂,足足有80页之多(斗尊强者,恐怖如斯……)。

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

    YAML 官方早已经提供了相应的 Python 库进行支持,即 PyYAML;当然也同样需要我们事先进行安装:

    pip install pyyaml

    同 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方法进行解析:


    >>> 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库的解析结果基本一致。

    说明

    在本文里列举的配置文件类型其复杂性由上到下依次增加:ini < json ≈ toml < yaml,它们之间各有优劣,可以根据自己实际的需求和团队协作要求来具体选择。

    转自:https://mp.weixin.qq.com/s/s8OpyNexL0R9Ay_TX7zA0Q

  • 相关阅读:
    debian10
    Containerd 学习
    Java8中list转map方法总结
    微服务难点:基础数据如何设计,为做到共享,我们这样做
    Linux 取两个文件的交集、差集、并集
    Nginx部署图片、视频服务
    python PIL/cv2/base64相互转换
    sql 查询昨日,今日数据
    GridView组件 以及动态GridView
    ListView 基础列表组件、水平 列表组件、图标组件
  • 原文地址:https://www.cnblogs.com/yanhuidj/p/16420923.html
Copyright © 2020-2023  润新知