fs方法目录 - KPTest框架开放资料

Skip to content

# fs方法目录

1. clear_file
> 描述：

    1
    2
    3

    方法功能：

    命令格式：

> 参数：

    1

    file_path       (str) : 需要操作的文件路径

> 返回值：

    1

    result          (bool): True if success else False

> 异常：

    1

    None

> 举例：

    1

    success = self.host.fs.clear_file(file_path)

2. get_checksum
> 描述：

    1
    2
    3

    方法功能：获取指定文件的checksum值, 比如常用的md5sum

    命令格式：md5sum /home/test.txt

> 参数：

    1
    2

    path        (str): 需要获取checksum的文件路径
    method      (str): 检查文件的方法，默认为md5，可用方法有['md5', 'sha1', 'sha256', 'sha384', 'sha512', 'ck']

> 返回值：

    1

    checksum    (str): 指定文件的checksum值

> 异常：

    1
    2

    FileNotFoundException(f"file path {path} does not exist.")
    InvalidParamException(f"{method} was not found in {check_methods.keys()}")

> 举例：

    1

    md5sum = self.host.fs.get_checksum("/etc/resolv.conf", "md5")

3. file
> 描述：

    1
    2
    3

    方法功能：

    命令格式：

> 参数：

    1

    path    (str): 需要获取类型的文件路径

> 返回值：

    1

    result  (str): 文件的类型属性字符串

> 异常：

    1
    2

    FileNotFoundException(f"file path {path} does not exist.")
    KPTestException(f'获取文件类型属性失败，错误信息如下：/r/n{outcome}')

> 举例：

    1

    md5sum = self.host.fs.get_checksum("/etc/resolv.conf", "md5")

4. does_content_exist
> 描述：

    1
    2
    3

    方法功能：

    命令格式：

> 参数：

    1
    2
    3
    4

    search_str   (str) : 查找字符串
    file_path    (str) : 文件路径，包含文件名， 若存在特殊字符需要加转义字符
    head         (bool): 是否锚定行首，默认为False
    tail         (bool): 是否锚定行尾，默认为False

> 返回值：

    1

    result       (bool): True if success else False

> 异常：

    1

    None

> 举例：

    1

    exist = self.host.fs.does_content_exist("ip", "/etc/resolv.conf")

5. eject_sr
> 描述：

    1
    2
    3

    方法功能：

    命令格式：

> 参数：

    1

    num      (int) : 被挂载的ISO文件或块设备号，默认为0

> 返回值：

    1

    result   (bool): True if success else False

> 异常：

    1

    None

> 举例：

    1

    mounted = self.host.fs.eject_sr(1)

6. mount_share
> 描述：

    1
    2
    3

    方法功能：将nfs共享目录挂载在本地路径

    命令格式：showmount -e

> 参数：

    1
    2
    3

    share_dir       (str) : nfs服务器共享目录
    create_dir      (str) : 需要在nfs服务器共享目录下创建的子目录
    local_path      (str) : 本地挂载路径

> 返回值：

    1

    None

> 异常：

    1
    2
    3
    4

    KPTestException("%s 在nfs服务器上不存在" % share_dir)
    KPTestException('%s 不是nfs共享目录' % share_dir)
    KPTestException("挂载共享目录到本地目录失败")
    KPTestException("路径%s挂载点信息为空" % local_path)

> 举例：

    1

    self.host.fs.mount_share('/home/kvm/dm', '/virt')

7. umount_share
> 描述：

    1
    2
    3

    方法功能：取消共享目录的挂载

    命令格式：fuser -kv <mount_path>

> 参数：

    1

    mount_path      (str)  : 被挂载的目录

> 返回值：

    1

    True or False   (bool) : 取消挂载是否成功

> 异常：

    1

    None

> 举例：

    1

    self.host.fs.umount_share(mount_path)