Selenium+Pytest 自動テスト フレームワークの実践 (パート 2)

序文

この記事は前回の記事からの続きです。

1. シンプルな学習要素の配置

私は日々の業務の中で、「Xpath のコピー」を右クリックして要素をブラウザーに直接コピーしている学生を多く見てきました。この方法で取得された要素式は、多くの場合、Webdriver で実行できるほど安定していないため、フロントエンドでのいくつかの小さな変更により、要素が見つからない場合に NoSuchElementException エラーが発生します。

したがって、実際の作業や学習では、要素の配置機能を強化し、xpath や CSS セレクターなどの比較的安定した配置構文をできる限り使用する必要があります。CSS セレクターの構文は単刀直入で理解しにくいため、初心者には不向きであり、xpath と比較して位置決め構文がいくつか欠けています。したがって、要素の配置構文として xpath を選択します。

1.1xパス

1.1.1 文法規則

xpath は、XML ドキュメント内の情報を検索するための言語です。

 

1.1.2 位置決めツール

  • chromath の利点: これは、firepath に似た Chrome ブラウザ用のテスト位置決めプラグインです。試してみましたが、全体的な感触は非常に良好です。初心者に対するフレンドリーさは非常に良いです。欠点: このプラグインをインストールするには FQ が必要です。
  • Katalon 記録ツールによって記録されたスクリプトには、要素の配置に関する情報も含まれます。
  • 自分で作成する - この利点をお勧めします: これは私が推奨する方法です。一定のレベルまで習熟すると、作成する内容がより直観的かつ簡潔になり、自動テストの実行時に問題をすぐに見つけることができるからです。欠点: xpath と CSS セレクター構文をある程度蓄積する必要があり、始めるのは簡単ではありません。

2. ページ要素を管理する

この記事で選択したテスト アドレスは Baidu のホームページであるため、対応する要素も Baidu のホームページからのものです。

プロジェクト フレームワーク設計には、要素を配置するためのファイルを保存するために特別に使用されるディレクトリ page_element があります。

さまざまな構成ファイルを比較した結果、ここでは YAML ファイル形式を選択しました。読みやすくてインタラクティブです。

page_element に新しい search.yaml ファイルを作成します。

搜索框: "id==kw"
候选: "css==.bdsug-overflow"
搜索候选: "css==#form div li"
搜索按钮: "id==su"

要素配置ファイルが作成されたので、このファイルを読み取る必要があります。

共通ディレクトリに readelement.py ファイルを作成します。

#!/usr/bin/env python3
# -*- coding:utf-8 -*-
import os
import yaml
from config.conf import cm


class Element(object):
    """获取元素"""

    def __init__(self, name):
        self.file_name = '%s.yaml' % name
        self.element_path = os.path.join(cm.ELEMENT_PATH, self.file_name)
        if not os.path.exists(self.element_path):
            raise FileNotFoundError("%s 文件不存在!" % self.element_path)
        with open(self.element_path, encoding='utf-8') as f:
            self.data = yaml.safe_load(f)

    def __getitem__(self, item):
        """获取属性"""
        data = self.data.get(item)
        if data:
            name, value = data.split('==')
            return name, value
        raise ArithmeticError("{}中不存在关键字:{}".format(self.file_name, item))


if __name__ == '__main__':
    search = Element('search')
    print(search['搜索框'])

特別なメソッド __getitem__ を使用して、任意の属性を呼び出し、yaml 内の値を読み取ります。

このようにして、配置された要素の保存と呼び出しを実現します。

しかし、まだ疑問はあります、作成したすべての要素が間違っていないことをどのように確認できるでしょうか? 人的エラーは避けられませんが、コードを通じてファイルのレビューを実行できます。現時点ではすべての問題を発見できるわけではありません。

そこで、ファイルを作成し、スクリプト ファイル ディレクトリに Inspection.py ファイルを作成し、すべての要素の yaml ファイルを検査します。

#!/usr/bin/env python3
# -*- coding:utf-8 -*-
import os
import yaml
from config.conf import cm
from utils.times import running_time


@running_time
def inspect_element():
    """检查所有的元素是否正确
    只能做一个简单的检查
    """
    for files in os.listdir(cm.ELEMENT_PATH):
        _path = os.path.join(cm.ELEMENT_PATH, files)
        with open(_path, encoding='utf-8') as f:
            data = yaml.safe_load(f)
        for k in data.values():
            try:
                pattern, value = k.split('==')
            except ValueError:
                raise Exception("元素表达式中没有`==`")
            if pattern not in cm.LOCATE_MODE:
                raise Exception('%s中元素【%s】没有指定类型' % (_path, k))
            elif pattern == 'xpath':
                assert '//' in value,\
                    '%s中元素【%s】xpath类型与值不配' % (_path, k)
            elif pattern == 'css':
                assert '//' not in value, \
                    '%s中元素【%s]css类型与值不配' % (_path, k)
            else:
                assert value, '%s中元素【%s】类型与值不匹配' % (_path, k)


if __name__ == '__main__':
    inspect_element()

このファイルを実行します。

校验元素done!用时0.002秒!

ご覧のとおり、短期間のうちに、入力された YAML ファイルを確認しました。

これで、必要な基本コンポーネントが大まかに完成しました。

次に、最も重要なステップであるセレンのカプセル化を実行します。

3. Selenium 基本クラスをカプセル化する

ファクトリーモードでは次のように記述します。

#!/usr/bin/env python3
# -*- coding:utf-8 -*-
import time
from selenium import webdriver


driver = webdriver.Chrome()
driver.get('https://www.baidu.com')
driver.find_element_by_xpath("//input[@id='kw']").send_keys('selenium')
driver.find_element_by_xpath("//input[@id='su']").click()
time.sleep(5)
driver.quit()

非常に単純で、シンプルで、明確です。

ドライバー オブジェクトを作成し、Baidu Web ページを開き、Selenium を検索して [検索] をクリックし、5 秒間待って結果を表示し、最後にブラウザーを閉じます。

では、なぜ Selenium のメソッドをカプセル化するのでしょうか? まず第一に、上記の比較的原始的な方法は、UI インターフェイスの実際の操作がはるかに複雑であるため、基本的に毎日の UI 自動テストには適していません。要素がテストされていないのは、ネットワーク上の理由または制御上の理由による可能性があります。まだ表示されています。クリックまたは入力してください。したがって、Selenium メソッドをカプセル化し、組み込みの明示的な待機または特定の条件ステートメントを通じて安定したメソッドを構築する必要があります。さらに、Selenium メソッドをカプセル化すると、日々のコードのメンテナンスに役立ちます。

ページ ディレクトリに webpage.py ファイルを作成します。

#!/usr/bin/env python3
# -*- coding:utf-8 -*-
"""
selenium基类
本文件存放了selenium基类的封装方法
"""
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.ui import WebDriverWait
from selenium.common.exceptions import TimeoutException

from config.conf import cm
from utils.times import sleep
from utils.logger import log


class WebPage(object):
    """selenium基类"""

    def __init__(self, driver):
        # self.driver = webdriver.Chrome()
        self.driver = driver
        self.timeout = 20
        self.wait = WebDriverWait(self.driver, self.timeout)

    def get_url(self, url):
        """打开网址并验证"""
        self.driver.maximize_window()
        self.driver.set_page_load_timeout(60)
        try:
            self.driver.get(url)
            self.driver.implicitly_wait(10)
            log.info("打开网页:%s" % url)
        except TimeoutException:
            raise TimeoutException("打开%s超时请检查网络或网址服务器" % url)

    @staticmethod
    def element_locator(func, locator):
        """元素定位器"""
        name, value = locator
        return func(cm.LOCATE_MODE[name], value)

    def find_element(self, locator):
        """寻找单个元素"""
        return WebPage.element_locator(lambda *args: self.wait.until(
            EC.presence_of_element_located(args)), locator)

    def find_elements(self, locator):
        """查找多个相同的元素"""
        return WebPage.element_locator(lambda *args: self.wait.until(
            EC.presence_of_all_elements_located(args)), locator)

    def elements_num(self, locator):
        """获取相同元素的个数"""
        number = len(self.find_elements(locator))
        log.info("相同元素:{}".format((locator, number)))
        return number

    def input_text(self, locator, txt):
        """输入(输入前先清空)"""
        sleep(0.5)
        ele = self.find_element(locator)
        ele.clear()
        ele.send_keys(txt)
        log.info("输入文本:{}".format(txt))

    def is_click(self, locator):
        """点击"""
        self.find_element(locator).click()
        sleep()
        log.info("点击元素:{}".format(locator))

    def element_text(self, locator):
        """获取当前的text"""
        _text = self.find_element(locator).text
        log.info("获取文本:{}".format(_text))
        return _text

    @property
    def get_source(self):
        """获取页面源代码"""
        return self.driver.page_source

    def refresh(self):
        """刷新页面F5"""
        self.driver.refresh()
        self.driver.implicitly_wait(30)

このファイルでは、Selenium のクリックを明示的に待機する、send_keys などのメソッドの二次カプセル化を作成しました。操作の成功率が向上しました。

さて、POM モデルの約半分が完成しました。次にページオブジェクトを入力します。

4. ページオブジェクトの作成

page_object ディレクトリに searchpage.py ファイルを作成します。

#!/usr/bin/env python3
# -*- coding:utf-8 -*-
from page.webpage import WebPage, sleep
from common.readelement import Element

search = Element('search')


class SearchPage(WebPage):
    """搜索类"""

    def input_search(self, content):
        """输入搜索"""
        self.input_text(search['搜索框'], txt=content)
        sleep()

    @property
    def imagine(self):
        """搜索联想"""
        return [x.text for x in self.find_elements(search['候选'])]

    def click_search(self):
        """点击搜索"""
        self.is_click(search['搜索按钮'])

このファイルには、検索キーワードを入力し、「検索」をクリックし、Lenovo を検索する手順がカプセル化されています。

そして設定された注釈。

コメントがないとしばらくするとコードが読みにくくなってしまうため、日常生活でコメントを書く習慣を身につけるべきです。

これで、ページ オブジェクトが完成しました。次にテストケースの作成を開始します。テストを開始する前に、pytest テスト フレームワークについて理解しましょう。

5. Pytest を簡単に理解する

pytest フレームワークの公式 Web サイトを開きます。

# content of test_sample.py
def inc(x):
    return x + 1


def test_answer():
    assert inc(3) == 5

公式チュートリアルは入門書には向かないと思いますし、中国語版もありません。チュートリアルが必要な場合は、自分で見つけることができます。

5.1pytest.ini

pytest プロジェクトの構成ファイルは、pytest の実行中の操作に対するグローバルな制御を提供できます。

プロジェクトのルート ディレクトリに新しい pytest.ini ファイルを作成します。

[pytest]
addopts = --html=report.html --self-contained-html

addopts は、実行中に他のパラメータを指定します。 --html=report/report.html --self-contained-html pytest-html スタイルのレポートを生成します。 -s ユースケースでのデバッグ情報を出力します。 -q 静かにテストします。 -v より詳細な情報を出力できます。ユースケースが配置されているファイルやユースケースの名前など、ユースケースの実行情報。

6. テストケースを書く

pytest を使用してテスト ケースを作成します。

TestCase ディレクトリに test_search.py​​ ファイルを作成します。

#!/usr/bin/env python3
# -*- coding:utf-8 -*-
import re
import pytest
from utils.logger import log
from common.readconfig import ini
from page_object.searchpage import SearchPage


class TestSearch:
    @pytest.fixture(scope='function', autouse=True)
    def open_baidu(self, drivers):
        """打开百度"""
        search = SearchPage(drivers)
        search.get_url(ini.url)

    def test_001(self, drivers):
        """搜索"""
        search = SearchPage(drivers)
        search.input_search("selenium")
        search.click_search()
        result = re.search(r'selenium', search.get_source)
        log.info(result)
        assert result

    def test_002(self, drivers):
        """测试搜索候选"""
        search = SearchPage(drivers)
        search.input_search("selenium")
        log.info(list(search.imagine))
        assert all(["selenium" in i for i in search.imagine])


if __name__ == '__main__':
    pytest.main(['TestCase/test_search.py'])

テスト用に書きました。

  • pytest.fixture は、単体テストのセットアップおよびティアダウンと同じ開始前およびクリーンアップ後のデコレーターを実装します。
  • 最初のテストケース:
    • Baidu に Selenium キーワードを実装し、検索ボタンをクリックし、正規表現を使用して検索結果の結果ページのソース コードを検索し、返された数値が 10 より大きい場合は合格とみなされます。
  • 2 番目のテスト ケース:
    • 実装して Selenium を検索し、検索候補のすべての結果に Selenium キーワードが含まれるかどうかをアサートします。

最後に、以下に実行開始ステートメントを記述します。

この時点で実行に入るべきですが、まだ問題があり、ドライバーをまだ渡していません。

7.conftest.py

プロジェクトのルート ディレクトリに新しい conftest.py ファイルを作成します。

#!/usr/bin/env python3
# -*- coding:utf-8 -*-
import pytest
from py.xml import html
from selenium import webdriver


driver = None


@pytest.fixture(scope='session', autouse=True)
def drivers(request):
    global driver
    if driver is None:
        driver = webdriver.Chrome()
        driver.maximize_window()

    def fn():
        driver.quit()

    request.addfinalizer(fn)
    return driver


@pytest.hookimpl(hookwrapper=True)
def pytest_runtest_makereport(item):
    """
    当测试失败的时候,自动截图,展示到html报告中
    :param item:
    """
    pytest_html = item.config.pluginmanager.getplugin('html')
    outcome = yield
    report = outcome.get_result()
    report.description = str(item.function.__doc__)
    extra = getattr(report, 'extra', [])

    if report.when == 'call' or report.when == "setup":
        xfail = hasattr(report, 'wasxfail')
        if (report.skipped and xfail) or (report.failed and not xfail):
            file_name = report.nodeid.replace("::", "_") + ".png"
            screen_img = _capture_screenshot()
            if file_name:
                html = '<div><img src="data:image/png;base64,%s" alt="screenshot" style="width:1024px;height:768px;" ' \
                       'onclick="window.open(this.src)" align="right"/></div>' % screen_img
                extra.append(pytest_html.extras.html(html))
        report.extra = extra


def pytest_html_results_table_header(cells):
    cells.insert(1, html.th('用例名称'))
    cells.insert(2, html.th('Test_nodeid'))
    cells.pop(2)


def pytest_html_results_table_row(report, cells):
    cells.insert(1, html.td(report.description))
    cells.insert(2, html.td(report.nodeid))
    cells.pop(2)


def pytest_html_results_table_html(report, data):
    if report.passed:
        del data[:]
        data.append(html.div('通过的用例未捕获日志输出.', class_='empty log'))


def _capture_screenshot():
    '''
    截图保存为base64
    :return:
    '''
    return driver.get_screenshot_as_base64()

conftest.py は、フィクスチャ メソッドを使用してドライバをカプセル化して渡すテスト フレームワーク pytest のグルー ファイルです。

8. 実行のユースケース

上記でフレームワーク全体とテスト ケースを書きました。

現在のプロジェクトのホーム ディレクトリに入り、次のコマンドを実行します。

pytest

コマンドライン出力:

Test session starts (platform: win32, Python 3.7.7, pytest 5.3.2, pytest-sugar 0.9.2)
cachedir: .pytest_cache
metadata: {'Python': '3.7.7', 'Platform': 'Windows-10-10.0.18362-SP0', 'Packages': {'pytest': '5.3.2', 'py': '1.8.0', 'pluggy': '0.13.1'}, 'Plugins': {'forked': '1.1.3', 'html': '2.0.1', 'metadata': '1.8.0', 'ordering': '0.6', 'rerunfailures': '8.0', 'sugar': '0.9.2', 'xdist': '1.31.0'}, 'JAVA_HOME': 'D:\\Program Files\\Java\\jdk1.8.0_131'}
rootdir: C:\Users\hoou\PycharmProjects\web-demotest, inifile: pytest.ini
plugins: forked-1.1.3, html-2.0.1, metadata-1.8.0, ordering-0.6, rerunfailures-8.0, sugar-0.9.2, xdist-1.31.0
collecting ... 
DevTools listening on ws://127.0.0.1:10351/devtools/browser/78bef34d-b94c-4087-b724-34fb6b2ef6d1

 TestCase\test_search.py::TestSearch.test_001 ✓                                                                                              50% █████     

 TestCase\test_search.py::TestSearch.test_002 ✓                                                                                             100% ██████████
------------------------------- generated html file: file://C:\Users\hoou\PycharmProjects\web-demotest\report\report.html -------------------------------- 

Results (12.90s):
       2 passed

2 つのユースケースが正常に実行されたことがわかります。

report.html ファイルがプロジェクトのレポート ディレクトリに生成されます。

これは生成されたテスト レポート ファイルです。

9.メールを送信する

プロジェクトが完了したら、結果を表示するには自分または他の人のメールボックスにプロジェクトを送信する必要があります。

電子メールを送信するためのモジュールを作成します。

utils ディレクトリに新しい send_mail.py ファイルを作成します。

#!/usr/bin/env python3
# -*- coding:utf-8 -*-
import zmail
from config.conf import cm


def send_report():
    """发送报告"""
    with open(cm.REPORT_FILE, encoding='utf-8') as f:
        content_html = f.read()
    try:
        mail = {
            'from': '[email protected]',
            'subject': '最新的测试报告邮件',
            'content_html': content_html,
            'attachments': [cm.REPORT_FILE, ]
        }
        server = zmail.server(*cm.EMAIL_INFO.values())
        server.send_mail(cm.ADDRESSEE, mail)
        print("测试邮件发送成功!")
    except Exception as e:
        print("Error: 无法发送邮件,{}!", format(e))


if __name__ == "__main__":
    '''请先在config/conf.py文件设置QQ邮箱的账号和密码'''
    send_report()

このファイルを実行します。

测试邮件发送成功!

テストレポートメールが正常に送信されたことが確認できます。メールボックスを開きます。

 

メールは正常に受信されました。

このデモプロジェクトが無事に完成しました、とてもやりがいを感じませんか?メールを送った瞬間に達成感を感じます。

要約する

この記事を通じて、pytest+selenium フレームワークを全体的に理解する必要があり、自動テストへの道で新たなレベルに到達することになります。気に入ったら、「いいね」、「収集」、「コメント」、「フォロー」をして、毎日違う驚きを与えてください。

最後に: 以下はサポート学習資料です。[ソフトウェア テスト] を行っている人にとって、これは最も包括的で完全な準備倉庫となるはずです。この倉庫は、最も困難な旅にも同行してくれました。また、お役に立てれば幸いです。

ソフトウェアテストインタビューアプレット

何百万人もの人々が使用しているソフトウェア テストの質問バンクです。誰が知っているのか!インターネット上で最も包括的な面接テスト ミニ プログラムです。携帯電話を使用して質問に答えたり、地下鉄やバスに乗ったり、試験に参加したりすることができます。

次のインタビューの質問セクションをカバーします。

1. ソフトウェアテストの基礎理論、2. Web、アプリ、インターフェース機能テスト、3. ネットワーク、4. データベース、5. Linux

6. Web、アプリ、インターフェイスの自動化、7. パフォーマンス テスト、8. プログラミングの基本、9. 人事面接の質問、10. 公開テストの質問、11. セキュリティ テスト、12. コンピューターの基本

  完全な情報を入手する方法: 下の小さなカードをクリックしてご自身で入手してください

おすすめ

転載: blog.csdn.net/weixin_57794111/article/details/132918100