跳转到主要内容

用于集成axe和selenium进行网络无障碍性测试的Python库。

项目描述

axe-selenium-python集成了aXe和selenium,以实现自动化的网络无障碍性测试。

本版本的axe-selenium-python使用axe-core@3.1.1。

License PyPI Travis Issues Dependabot Coveralls

要求

要使用axe-selenium-python,您需要以下先决条件

  • selenium >= 3.0.0

  • Python 2.7或3.6

  • 您打算使用的浏览器的适当驱动程序,已下载并添加到您的路径中,例如Firefox的geckodriver

安装

要安装axe-selenium-python

$ pip install axe-selenium-python

使用方法

from selenium import webdriver
from axe_selenium_python import Axe

def test_google():
    driver = webdriver.Firefox()
    driver.get("http://www.google.com")
    axe = Axe(driver)
    # Inject axe-core javascript into page.
    axe.inject()
    # Run axe accessibility checks.
    results = axe.run()
    # Write results to file
    axe.write_results(results, 'a11y.json')
    driver.close()
    # Assert no violations are found
    assert len(results["violations"]) == 0, axe.report(results["violations"])

方法axe.run()接受两个参数:contextoptions

有关contextoptions的更多信息,请查看aXe文档

贡献

分支存储库并提交PR以修复错误和增强功能;欢迎贡献。

必须在axe-selenium-python目录内运行npm install来安装Node依赖项。

您可以使用tox运行测试

$ tox

资源

变更日志

版本 2.1.5

重大更改:

  • 将Axe类方法execute重命名为run,以与axe-core API中的方法保持一致。

版本2.1.0

  • 创建package.json文件以维护axe-core依赖

  • 将单元测试替换为更具意义的集成测试 - 包含一个用于集成测试的示例HTML文件

版本2.0.0

  • 所有不属于axe-core的功能都已移入一个单独的包pytest-axe。这包括

    • run_axe辅助方法

    • get_rules Axe类方法

    • run Axe类方法

    • impact_included Axe类方法

    • analyze Axe类方法。

此更改的目的是将特定于Mozilla Firefox测试工程团队的实施分离出来,并将基本axe-selenium-python包留给更广泛的使用场景。此包是基于Deque的Java包axe-selenium-java构建的,现在将更接近于它。

当使用axe-selenium-pythonpytest-axe结合使用时,所有功能仍然可以正常使用。

版本1.2.3

  • 将analyze方法添加到Axe类中。此方法运行可访问性检查,并将基于页面URL和时间戳的JSON结果写入文件。

  • 可以通过设置环境变量ACCESSIBILITY_REPORTING=true来启用将结果写入文件。文件将被写入results/目录,如果该目录不存在,则需要创建。

  • 可以通过设置环境变量ACCESSIBILITY_DISABLED=true来禁用可访问性检查。

版本1.2.1

  • 将axe更新到axe-core@2.6.1

  • 修改impact_included类方法以反映对aXe API的更改

  • 现在只有3个影响级别:“critical”(临界)、“serious”(严重)和“minor”(轻微”)

版本1.0.0

  • 更新README中的使用示例

  • 为缺少文档的方法添加了文档字符串

  • 删除了未使用的文件

版本0.0.3

  • 将run方法添加到Axe类中,以简化现有测试套件的使用

  • run方法包括设置要测试的影响级别的功能:“minor”(轻微)、“moderate”(中等)、“severe”(严重)、“critical”(临界”)

版本0.0.28

  • 将selenium实例添加为类属性

  • 更改文件路径以使用操作系统独立的结构

  • 修复了使用关键字进行文件读取操作的问题

版本0.0.21

  • 修复了包含aXe API文件及其引用的问题

  • 更新README

项目详情


下载文件

下载您平台的文件。如果您不确定选择哪个,请了解更多关于 安装软件包 的信息。

源分发

axe-selenium-python-2.1.6.tar.gz (88.6 kB 查看哈希值)

上传时间

构建分发

axe_selenium_python-2.1.6-py2.py3-none-any.whl (86.9 kB 查看哈希值)

上传时间 Python 2 Python 3

由...

AWSAWS云计算和安全赞助商DatadogDatadog监控FastlyFastlyCDNGoogleGoogle下载分析MicrosoftMicrosoftPSF赞助商PingdomPingdom监控SentrySentry错误日志StatusPageStatusPage状态页面