深入解析 YAML 配置文件：从语法到最佳实践

迈不过友情╰ 2024-04-24 14:47 5阅读 0赞

## 一、认识YAML ##

*  YAML（YAML Ain't Markup Language）是一种人类可读的数据序列化语言。它的设计目标是使数据在不同编程语言之间交换和共享变得简单。YAML采用了一种简洁、直观的语法，以易于阅读和编写的方式表示数据结构。
 *  YAML广泛应用于配置文件、数据序列化、API设计和许多其他领域。它被许多编程语言和框架所支持，包括Python、Java、Ruby等。在Python中，可以使用PyYAML库来读取和写入YAML文件。
 *  YAML的优点包括易读性高、易于理解、与多种编程语言兼容以及支持丰富的数据结构。它的简洁语法使得配置文件变得更加直观和可维护。无论是作为配置文件格式还是数据交换格式，YAML都是一个强大而受欢迎的选择。

## 二、YAML语法规范 ##

YAML的语法特点包括：

1.  使用缩进表示层级关系，不使用大括号或者其他符号。
2.  使用冒号来表示键值对。
3.  支持列表和嵌套结构。
4.  使用注释以 "\#" 开头。
5.  支持引用和锚点，可以在文档中引用其他部分的数据。

YAML（YAML Ain't Markup Language）支持多种数据类型，包括字符串、数字、布尔值、列表、字典和空值。下面是每种数据类型的示例代码和相应的语法规范：

## 1. 字符串 ##

*  语法规范：使用单引号或双引号将字符串括起来。字符串的引号也可以省略

name: "John"
    addr: "长沙"

## 2. 数字 ##

*  语法规范：直接写入数字即可。

age: 30

## 3.布尔值 ##

*  语法规范：使用true表示真，使用false表示假。

isStudent: true
    isTeacher: false

## 4.列表 ##

*  语法规范：使用短横线（-）表示列表项，列表项之间使用换行进行分隔。

fruits:
        - apple
        - banana
        - orange

## 5.字典 ##

*  语法规范：使用冒号（:）表示键值对，键值对之间使用空格进行分隔。

person:
        name: "John"
        age: 30

## 6. 空值 ##

*  语法规范：使用null表示空值。

status: null

*  这些是YAML支持的常见数据类型和相应的示例代码。您可以根据需要使用这些数据类型来构建复杂的数据结构。
 *  **注意** : **YAML对于缩进非常敏感，使用空格进行缩进来表示层级关系。** **缩进的空格数目可以是2个或4个，但在整个文档中必须保持一致。**

## 三、python操作YAML ##

*  Python提供了pyyaml库来操作YAML文件，操作yaml文件之前，先安装好pyyaml库。
 *  在终端(Pycharm-Terminal)或命令提示符(cmd)中运行以下命令来安装pyyaml库：pip install pyyaml

## 1.python读取yaml文件 ##

*  第一步：提前准备好的yaml文件，yaml文件后缀为.yaml或者.yml

name: "John"
    addr: "长沙"
    age: 18
    status: null
    isStudent: true
    fruits:
        - apple
        - banana
        - orange
    teacher:
        name: "Alex"
        age: 30

*  第二步：使用python读取yaml中的数据

import yaml
    
    with open(file="d.yaml", mode="r",encoding='utf-8') as f:
        res = yaml.safe_load(f)
    print(res)

*  yaml.safe\_load()方法:读取YAML文件中的数据。yaml.safe\_load()方法参数是文件对象
 *  运行结果：**会自动将yaml中的数据转为python所支持的数据类型**

![7f4f553aa3b6483ea12b735cd0754001.png][]

## 2.python将数据写入yaml文件 ##

*  第一步：将python指定的变量值写入yaml文件中

import yaml
    
    data = {
        "Person": {
            "name": "John",
            "age": 30,
            "address": {
                "street": "123 Main St",
                "city": "Anytown",
                "state": "CA"
            }
        }
    }
    # 将data变量存储的数据写入YAML文件
    with open(file="example.yaml", mode="w") as f:
        yaml.dump(data, f)

*  yaml.dump()方法:将数据写入到yaml文件中。yaml.dump()方法的第一个参数是写入数据，第二个参数是文件对象。
 *  第二步：查看example.yaml中的显示

![019f0778e3c8490486f0f85596f7cb7b.jpeg][]

## 四、YAML结合UI自动化实现KDT ##

*  KDT（Keyword-Driven Testing）：关键字驱动测试的英文简称。

1.  yaml数据准备

# 访问页面
    - action: goto
      params:
        url: 'https://www.baidu.com'
    # 输入python
    - action: sendkeys
      params:
        locator: ['id','kw']
        value: 'python'
    # 点击搜索按钮
    - action: click
      params:
        locator: ['id','su']
    # 断言
    - action: assert_text_contains
      params:
        locator: ['id','content_left']
        excepted: 'python'

1.  basepage方法封装

from selenium.webdriver import Chrome,ActionChains
    
    class BasePage:
        def __init__(self,driver:Chrome):
            self.driver = driver
    
        def goto(self,url):
            '''打开网址'''
            self.driver.get(url)
    
        def click(self,locator):
            '''点击操作'''
            el = self.driver.find_element(*locator)
            try:
                el.click()
            except:
                ActionChains(self.driver).click(el).perform()
    
        def sendkeys(self,value,locator=None):
            '''发送文本操作'''
            if locator:
                # 相当于ActionChains中的send_keys_to_element(ele,value)，先做点击，再做文本输入
                el = self.driver.find_element(*locator)
                el.send_keys(value)
            else:
                ActionChains(self.driver).send_keys(value).perform()
    
        def assert_text_contains(self,locator,excepted):
            '''断言文本是否包含指定的内容'''
            el = self.driver.find_element(*locator)
            assert excepted in el.text

1.  测试用例编写---实现关键字驱动测试

import time
    import yaml
    from selenium import webdriver
    from basepage import BasePage
    
    # 1、读取yaml文件中的数据
    with open(file='test_keyword.yaml',mode='r',encoding='utf-8') as f:
        data = yaml.safe_load(f)
    
    # 2、测试用例编写
    def test_01():
        # 初始化浏览器操作
        driver = webdriver.Chrome()
        driver.implicitly_wait(10)
        driver.maximize_window()
        # 实例化BasePage的对象
        basepage = BasePage(driver)
        # 遍历读取到的data数据
        for step in data:
            # 获取动作名称
            method_name = step['action']
            # 获取参数
            params = step['params']
            # 获取类中方法名
            method = getattr(basepage, method_name)
            # 调用方法，输入参数
            method(**params)  # 字典解包
        time.sleep(2)
        driver.quit()

[7f4f553aa3b6483ea12b735cd0754001.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/24/ed9718f29117425097425ac1b7d7897d.png
[019f0778e3c8490486f0f85596f7cb7b.jpeg]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/24/c270ef0f5e16490a839689b3e4a75038.jpeg