RF《Quick Start Guide》操作总结

这篇文章之所以会给整理出来，是因为学了一个季度的RF后，再去看官网的这个文档，感触破多，最大的感触还是觉得自己走了不少弯路，还有些是学习方法上的弯路。在未查看这类官网文档之前，更多的是看其他各种人的博客，看齐涛的修炼宝典（无任何恶意，仅表明适合刚入门的测试人员）的方式来学习RF，学的很多知识点都零散且不同的博客对同一个问题还有不同的个人看法。于是后期便开始查看官网文档，学习了Quick Start Guide 文档后，对于一个已入门3个月的测试来说，还是有些收获（可能以前也是自己学的肤浅，呵呵）。下面就从Quick Start Guide中挑选出部分重要的知识点。

首先在官网下载Quick Start Guide的相关文档（官网：https://github.com/robotframework/QuickStartGuide/blob/master/QuickStart.rst），这个文档使用了一个经典的登录应用程序，实际上就一个用python语言写的基于命令的代码。分2个模块：一个模块是服务器端的代码login.py.里面主要有2个类构成UserDataBase和User，User类主要是针对User的属性username，password，status的校验管理。比如密码长度必须是6-12位且由大小写+数字组成。而UserDataBase主要是完成User与数据库（robotframework-quickstart-db.txt）的交互。比如把符合一定规则的用户注册信息保存在数据库中。部分代码如下所示，详细的代码参见：QuickStartGuide-master\sut\login.py

class User(object):
    @property
    def password(self):
        return self._password

    @password.setter
    def password(self, password):
        self._validate_password(password)
        self._password = password

    def _validate_password(self, password):
        if not (7 <= len(password) <= 12):
            raise ValueError('Password must be 7-12 characters long')
        if not self._validate_password_chars(password):
            raise ValueError('Password must be a combination of lowercase '
                             'and uppercase letters and numbers')

    def _validate_password_chars(self, password):
        has_lower = has_upper = has_number = False
        for char in password:
            if char.islower():
                has_lower = True
            elif char.isupper():
                has_upper = True
            elif char.isdigit():
                has_number = True
            else:
                return False
        return has_lower and has_upper and has_number

class UserDataBase(object):
    def create_user(self, username, password):
        try:
            user = User(username, password)
        except ValueError as err:
            return 'Creating user failed: %s' % err
        self.users[user.username] = user
        return 'SUCCESS'

    def login(self, username, password):
        if self._is_valid_user(username, password):
            self.users[username].status = 'Active'
            return 'Logged In'
        return 'Access Denied'

    def _is_valid_user(self, username, password):
        return (username in self.users and
                self.users[username].password == password)

    def change_password(self, username, old_pwd, new_pwd):
        try:
            if not self._is_valid_user(username, old_pwd):
                raise ValueError('Access Denied')
            self.users[username].password = new_pwd
        except ValueError as err:
            return 'Changing password failed: %s' % err
        else:
            return 'SUCCESS'

还有一个模块，是封装关键字给RF直接调用的，然后在文件里面又调用了服务器模块login.py来与服务进行交互。部分代码如下，详细代码见：QuickStartGuide-master\lib\LoginLibrary.py

class LoginLibrary(object):

    def create_user(self, username, password):
        self._run_command('create', username, password)

    def change_password(self, username, old_pwd, new_pwd):
        self._run_command('change-password', username, old_pwd, new_pwd)

    def attempt_to_login_with_credentials(self, username, password):
        self._run_command('login', username, password)

    def status_should_be(self, expected_status):
        if expected_status != self._status:
            raise AssertionError("Expected status to be '%s' but was '%s'."% (expected_status, self._status))

由此可见，这个demo提供以下四个功能：

使用有效的密码创建一个用户。create_user(username, password)
使用有效的用户名和密码登陆。attempt_to_login_with_credentials( username, password)
修改已存在账户的密码。change_password(username, old_pwd, new_pwd)
判断用户的当前状态. status_should_be(expected_status)

Demo在RF内，首先可以创建一个suit级别的文件，然后导入operatingSystem库(Remove File关键字使用到的库文件)和用户自定义LoginLibrary库（测试服务器模块login.py），拷贝sut到D:\python27下，再拷贝LoginLibrary.py到D:\python27\Lib文件夹下，搭建完后，架构如图所示：