pypom-form 0.3.1

它是如何工作的？

使用 pypom_form，您只需要

• 实例化一个继承自 pypom_form 提供的 BaseFormPage 类的页面对象实例

• 声明模式模型

然后您就可以通过仅使用表单与您的页面交互，驱动浏览器，只需输入

page.title = 'the title'
page.title

假设您的表单中有一个 标题 字段。

page.getWidgetRegion('state').filter('virg').select('Virginia')

代码示例

以下代码示例假设存在一个提供使用Splinter驱动程序构建的页面实例的导航固定装置，但你也可以根据PyPOM文档自己构建页面实例

• http://pypom.readthedocs.io/en/latest/

Schema定义

import colander

from pypom_form.form import BaseFormPage


class BaseEditSchema(colander.MappingSchema):
    """ This is the base edit mapping common for all pages """

    name = colander.SchemaNode(
        colander.String(),
        selector=('id', 'name-widget'),
    )


class BaseEditPage(BaseFormPage):
    """ This is the base edit class """

    schema_factory = BaseEditSchema

假设你有一个可以与之交互的页面实例，你可以通过设置一个属性来操作上述页面

@pytest_bdd.when(pytest_bdd.parsers.parse(
    'I set {name} as name field'))
def fill_name(navigation, name):
    page = navigation.page
    page.name = name

你也可以定义具有扩展schema的其他页面，例如整数类型

class AnotherPageEditSchema(BaseEditSchema):

    duration = colander.SchemaNode(
        colander.Int(),
        missing=0,
        selector=('id',
                  'duration-widget'),
        validator=colander.Range(0, 9999))

但你也可以创建类似于colander.Bool或任何其他colander支持的类型。

并且测试

@pytest_bdd.when(pytest_bdd.parsers.cfparse(
    'I set {duration:Number} as Alarm duration',
    extra_types=dict(Number=int)))
def fill_alarm_duration(navigation, duration):
    page = navigation.page
    page.duration = duration

你可能会注意到在上面的例子中，你设置了一个整数持续时间而不是字符串。例如，你可以执行page.duration += 10。

如果默认实现不符合你的应用程序上的实现（例如，非标准的复选框用于布尔小部件），你还可以在字段上定义自定义小部件，例如一个pretend MyBooleanWidget

mybool = colander.SchemaNode(
    colander.Bool(),
    missing=False,
    selector=(
        'id',
        'mybool-widget'
    ),
    pypom_widget=MyBoolWidget()
)

也支持链式调用（例如：设置标题，执行pretend提交方法，然后设置布尔值）

page.set('title', 'the title'). \
    .submit(). \
    .set('mybool', False)

或批量更新。所有更改都遵循schema级别的字段顺序

page.update(**{'title': 'the title', 'mybool': True})

可以使用update或raw_update在测试预条件创建中使用。假设你有一个具有复杂配置的通用给定步骤，你可以传递原始json数据，raw_update将负责将数据从浏览器模型（例如：字符串）转换为页面模型（字符串、整数、日期时间等）

@pytest_bdd.given(pytest_bdd.parsers.cfparse(
    'I have a CAN bus protocol configured with:\n{raw_conf:json}',
    extra_types=dict(json=json.loads)))
def create_can_protocol(navigation, base_url, raw_conf):
    """ create a can protocol
    """

    navigation. \
        visit_page('CANBusProtocolsPage'). \
        wait_for_full_spinner(). \
        click_add(). \
        raw_update(**raw_conf). \
        save(). \
        wait_for_success_pop_up_appears(). \
        click_on_ok_pop_up()

假设在.feature文件中指定了raw_conf的json格式，例如

@UI @edit @CANBusParameter
Scenario: Add a CAN bus parameter
  Given I am logged in as Administrator
  And I have a CAN bus protocol configured with:
      {"name": "The name",
       "baudrate": "250",
       ...
      }
  And ...

如上述代码示例所示，在页面加载时与表单交互之前不需要执行等待调用，因为每个小部件都能够等待其控制的输入元素就绪。等待逻辑已经在小部件级别上定义，并且你可以覆盖它们。

0.3.1 (2017-10-24)

• 添加了raw_dump方法来获取所有字段的序列化。

0.3.0 (2017-10-10)

• 添加了dump方法来获取所有字段的大批量。

0.2.3 (2017-09-14)

• 现在你可以覆盖自动生成的方法，并在其中调用super

0.2.2 (2017-07-03)

• 将test_fields.py移动到正确的位置。

• 如果已经存在，不要覆盖页面和区域上的update和raw_update方法。

0.2.1 (2017-06-01)

• 更新电子邮件项目

0.2.0 (2017-01-24)

功能

• 在组件基类实现中添加了 序列化 和 反序列化 方法，以便进行高级使用。这样，您只需覆盖上述方法即可轻松实现复杂/组合组件（例如：从页面模型数据到浏览器或组件内部表示数据的中间转换）。

• 为在需要实现复杂或组合组件时添加了 ObjectType 字段。

• 添加了对 readonly 字段的支持。如果字段被标记为只读，则不会执行浏览器交互。

0.1.0 (2017-01-03)

0.0.1 (2016-12-22)

• 初始版本