selene下載 - selene源代碼下載

selene

網站數據

2.0.0rc9

下載

Selene：Python中的面向用戶的Web UI瀏覽器測試

Selene的概述

Selene是在Python編寫瀏覽器UI測試的簡潔庫。它是在Java World的流行硒化項目中建造的。 Selene幫助開發人員編寫可讀和可維護的測試，這些測試以通用英語“說話”，使它們更易於理解和跨團隊共享。

Selene的核心強度是其面向用戶的API，它抽象了與Selenium Webdriver合作的複雜性。可以使用簡單的，表達的語法和支持功能（例如懶惰的元素）編寫測試，自動重試機制，用於智能隱式等待ajax樣負載。借助內置的PageObject支持，它可以通過小部件可以重複使用Web元素。

主要功能

以用戶為導向的API ：用自然語言編寫測試腳本，簡單的語法讀寫為常見英語。
類似AJAX的加載支持：內置的智能隱式等待和重試機制，以處理動態加載的Web元素。
PageObjects支持：懶惰的元素允許構建PageObjects在選擇器或By.*類似元組的定位器上構成元素，還允許為不同組件創建可重複使用的元素。
預期條件的擴展列表：與RAW Selenium中的條件列表要大得多，可以在測試中實施更可讀和簡潔的斷言。
元素上預定義命令的擴展列表：減少用ActionChains編寫自定義命令的需求。
開箱即用的框架和陰影根的支撐。
集合的靈活過濾：允許構建可組合定位器，以減少複雜的XPath選擇器的需求，並導致更詳細的錯誤消息，從而有助於進行測試維護。
非常詳細的錯誤消息：針對元素的動作和斷言。
自動驅動程序管理：自動處理瀏覽器驅動程序設置和拆卸，以快速，本地執行。
高度可定制的：高級用戶可以為特定要求配置或擴展SELENE。例如，您可以自定義自己的選擇模板。您還可以在所有級別上通過相同的API自定義相同的選項（例如超時）：1）在全球範圍內； 2）在特定的瀏覽器實例上； 3）在變量中存儲的特定元素或收集元素4）用於對元素的特定動作或主張。
對本地和遠程驅動程序的支持：Selene支持各種環境，包括本地瀏覽器，無頭設置以及諸如硒網格（Selenium Grid）的雲服務（以類似的方式）通過提供相應的驅動程序選項來支持硒。
多平台支持：與Web和Appium的手機或桌面驅動程序一起使用。但是，配置中的某些選項是平台特定的。

版本

Selene目前支持兩個主要版本：

最新推薦的預發行版本（v2.0.0rc9） ：
- Python版本： 3.8+
- 硒支持： >=4.12.0
- 此版本引入了改進的API，更好的性能，並建議用於新項目。
- 雖然處於Alpha/Beta階段，精煉API，改善“遷移性”並進行測試
- 大多數活躍的Selene用戶已經升級為2.0 alpha/beta，並且在過去2年中一直在生產中使用它
- 唯一的風險是API變化，有些命令正在貶值和重命名中
穩定版本（v1.0.2） ：
- Python版本： 2.7, 3.5, 3.6, 3.7
- 硒支持： <4.0.0
- 如果您的項目需要與較舊的Python版本兼容，請使用此版本。

對於從v1.x到v2.x的遷移，請遵循遷移指南。

遷移指南

從1.0.2到2.0.0rc<LATEST> ：

升級到Python 3.8+
將Selene更新為2.0.0rc<LATEST>
- 從.first collection.first() .first()方法到.first
- 確保諸如text('foo')之類的所有條件使用be.*或have.*文法
- 根據需要更新其他棄用方法

遷移過程中潛在重構的例子：

查找並替換全部
- (text('foo'))至(have.text('foo'))
- (visible)到(be.visible)
更聰明的查找和替換（通過一些手動重構）
- .should(x, timeout=y) .with_(timeout=y).should(x)
- .should_not(be.*) .should(be.not_.*) ）to .should(be.*.not_)
- .should_not .should(have.*.not_) .should_not(have.*) .should(have.no.*)
- .should_each(condition)至.should(condition.each)
並添加相應的導入： from selene import be, have

先決條件

需要Python 3.8+。

給定Pyenv安裝了，安裝所需版本的Python很簡單：

$ pyenv install 3.8.13
$ pyenv global 3.8.13
$ python -V
Python 3.8.13

安裝

通過詩歌 + pyenv（推薦）

然後確保安裝詩歌和Pyenv，然後：

poetry new my-tests-with-selene
cd my-tests-with-selene
pyenv local 3.8.13
poetry add selene --allow-prereleases  # for pre-release version
poetry install

通過PIP

對於預發行版本（推薦用於新項目）：

pip install selene --pre

對於最新穩定版本：

pip install selene

來自來源

如果您希望直接從源代碼安裝Selene：

git clone https://github.com/yashaka/selene.git
cd selene
python setup.py install

或使用詩歌：

poetry add git+https://github.com/yashaka/selene.git

或使用PIP：

pip install git+https://github.com/yashaka/selene.git

用法

快速開始

使用Selene自動化一個簡單的Google搜索：

 from selene import browser , be , have

browser . open ( 'https://google.com/ncr' )
browser . element ( '[name=q]' ). should ( be . blank )
    . type ( 'selenium' ). press_enter ()
browser . all ( '#rso>div' ). should ( have . size_greater_than ( 5 ))
    . first . should ( have . text ( 'Selenium automates browsers' ))

# not mandatory, because will be closed automatically:
# browser.quit()

核心API

Selene提供了一種直觀的API，用於使用be ， have或by模塊與Web元素進行交互。
懶惰而動態的元素：Selene元素是懶惰而動態的，這意味著每次執行動作時它們都位於它們。這樣可以確保與最新元素的互動。
這是一個基本元素交互：

 from selene import browser , by , be

# because elements are "lazy",
# you can store them in variable:
search_box = browser . element ( by . name ( 'q' ))

# – even before the actual page will be loaded:
browser . open ( 'https://google.com/ncr' )
search_box . should ( be . blank ). type ( 'Selenium' ). press_enter ()

選擇元素定位器

選擇正確的元素定位器對於可靠的測試至關重要。這裡有一些提示：

檢查元素：右鍵單擊Web元素，然後選擇“檢查”以在瀏覽器的開發人員工具中查看其HTML。
使用唯一的屬性：查找在選擇器中使用的唯一屬性，例如ID，名稱或自定義屬性。最佳實踐是與開發人員談判使用獨特的data-*屬性專門用於測試需求，例如data-test-id 。
構造CSS或XPATH選擇器：構建獨特識別元素的選擇器。例如，使用Conciser css-selector #elementId ， .className或[name="q"] ，或使用XPath用於CSS無法處理的內容： //*[text()="Submit"]/.. Selene將自動檢測您是提供CSS還是XPath選擇器。
利用Selene的選擇器幫助器（可選）：如果您需要大多數人類可讀代碼，則可以使用by.name('q') ， by.text('Submit')和其他by.* helpers。請注意，出於親吻原則的目的，某人會喜歡[name=q]而不是[name = by.name('q') 。
Break down long selectors into smaller parts for better readability and maintainability: If to find an element you have a complex selector like in: browser.element('//*[@role="row" and contains(.,"Jon")]//*[@data-field="select-row"]') , decomposing it utilizing Selene's filtering collections API to browser.all('[role=row]').element_by(have.text('Jon')).element('[data-field=select-row]')以下需要仔細檢查每個潛在的故障原因。
創建自定義選擇器策略（可選）：想像一下您的前端開發人員遵循最佳實踐，並對所有需要在測試中覆蓋的元素使用data-test-id屬性，並且有一個命名約定，以使此類元素成為Snake_case_case_or-kebab-case-case-words。借助Selene的browser.config.selector_to_by_strategy選項，您可以定義自定義選擇器策略，以自動檢測所有此類"snake_kebab-words"作為選擇器傳遞的所有[data-test-id="snake_kebab-words"]然後像browser.all('[data-testid=result]').first.element('[data-testid=result-title-a]').click()可以簡化為browser.all('result').first.element('result-title-a').click()查看如何通過測試ID簡化搜索？指南以獲取更多詳細信息。
this功能將在Selene的下一個版本中提供。 ️

自動驅動程序和瀏覽器管理

Selene可以自動為您管理瀏覽器驅動程序，但是您可以在需要時自定義。

自動駕駛員管理

使用預定義的瀏覽器實例而無需手動創建驅動程序：

 from selene import browser

browser . config . base_url = 'https://google.com'
browser . config . timeout = 2

browser . open ( '/ncr' )

自定義驅動程序設置

如果需要自定義驅動程序設置，例如使用遠程驅動程序或添加選項，請相應地配置驅動程序：

 from selenium import webdriver
from selene import browser

options = webdriver . ChromeOptions ()
options . add_argument ( '--headless' )
# Add other options as needed

# Selene will automatically detect the browser type (Chrome, Firefox, etc.)
# based on the options passed
browser . config . driver_options = options
browser . config . driver_remote_url = 'http://localhost:4444/wd/hub'
browser . config . base_url = 'https://google.com'
browser . config . timeout = 2

browser . open ( '/ncr' )

或者，創建並分配您自己的驅動程序實例：

 from selenium import webdriver
from selene import browser

options = webdriver . ChromeOptions ()
options . add_argument ( '--headless' )
# Add other options as needed

browser . config . driver = webdriver . Remote (
    command_executor = 'http://localhost:4444/wd/hub' ,
    options = options
)

browser . config . base_url = 'https://google.com'
browser . config . timeout = 2

browser . open ( '/ncr' )