Metadata-Version: 2.1
Name: poium
Version: 0.2.3
Summary: Selenium/appium-based Page Objects test library.
Home-page: https://github.com/defnngj/poium
Author: fnngj
Author-email: fnngj@126.com
License: BSD
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Dist: selenium (>=3.14.1)
Requires-Dist: Appium-Python-Client (==0.30)

### poium

基于 selenium/appium 的 Page Objects 设计模式测试库。

* 支持大部分selenium/appium API。
* 封装元素定位操作，以及少量原生API，同时并不影响原生API的使用。

#### Installation
------------

download install:

```shell
$ python setup.py install
```

pip install:
```
$ pip install poium
```

#### 简单例子：


使用poium实现百度搜索。

```python

# baidu_page.py
from page_objects import PageObject, PageElement

class BaiduIndexPage(PageObject):
    search_input = PageElement(id_='kw', describe="搜索输入框")
    search_button = PageElement(id_='su', describe="搜索按钮")


# test_baidu.py
from selenium import webdriver
from baidu_page import BaiduIndexPage

driver = webdriver.Chrome()

page = BaiduIndexPage(driver)
page.get("https://www.baidu.com")

page.search_input.send_keys("poium")
page.search_button.click()

driver.quit()
```
使用poium将元素 __定位__ 与 __操作__ 分离，这将会非常有助于规模化自动化测试用例的编写与维护。

#### 使用文档：

请阅读 [wiki](https://github.com/defnngj/poium/wiki)

#### 项目历史：

参考项目：https://github.com/eeaston/page-objects

参考项目已经不再维护，我阅读了原项目代码，虽然只有100多行，但设计非常精妙。本项目在此基础上进行开发。

原项目名：https://pypi.org/project/selenium-page-objects/

有一天，我向群里的同学推荐selenium-page-objects，有同学问是否支持appium，appium也是从selenium继承而来，我想为什么不能支持appium呢？
于是，加入了appium支持，但是 selenium-page-objects 已经不能表达对appium的支持，而且他似乎有点长了。

本项目的核心是 Page Objects的设计模式, 于是取了 __PO__，同时支持selenium/appium，于是取了 __ium__，那么新的项目命名为：__poium__。


