Metadata-Version: 2.1
Name: poium
Version: 1.2.0
Summary: Selenium/appium-based Page Objects test library.
Home-page: https://github.com/SeldomQA/poium
Author: fnngj
Author-email: fnngj@126.com
License: BSD
Description: 
        ![](logo.png)
        
        基于 selenium/appium 的 Page Objects 设计模式测试库。
        
        * 简化了Page层的元素定义
        * 对原生 API 无损
        
        
        __支持库：__
        
          - [x] selenium ✔️
          - [x] appium ✔️
          - [ ] playwright ⌛
          - [ ] uiautomator2 
          - [ ] ...
        
        ## Installation
        
        pip install:
        
        ```shell
        > pip install poium
        ```
        
        If you want to keep up with the latest version, you can install with github repository url:
        
        ```shell
        > pip install -U git+https://github.com/SeldomQA/poium.git@master
        ```
        
        ## Sample
        
        通过下面的例子，体会`Page Objects` 设计模式如此简单。
        
        ```python
        from poium import Page, Element
        from selenium import webdriver
        
        
        class BaiduIndexPage(Page):
            search_input = Element(name='wd')
            search_button = Element(id_='su')
        
        
        driver = webdriver.Chrome()
        page = BaiduIndexPage(driver)
        page.open("https://www.baidu.com")
        
        page.search_input.send_keys("poium") 
        page.search_button.click()
        
        driver.quit()
        ```
        
        
        更多例子，请点击[这里](/sample) 。
        
        ## Documentation
        
        在开使用poium前，请快速阅读下面的文档。
        
        * [Page和Element类](/docs/page_element.md)
        * [Eelment类元素操作](docs/element_operation.md)
        * [CSSElement类](/docs/csselement.md)
        * [在Selenium中使用poium](docs/selenium_sample.md)
        * [在appium中使用poium](docs/poium_sample.md)
        * [在seldom框架中使用poium](docs/seldom_sample.md)
        
        ## Project usage
        
        * 在基于pytest的自动化项目中的应用，请点击[这里](https://github.com/defnngj/pyautoTest) 。
        
        * 在基于seldom自动化测试框架的应用，请点击[这里](https://github.com/SeldomQA/seldom) 。
        
        ## Old version
        
        > `poium < 0.6.0`版本，主要提供了`Page`、`PageElement`、`PageElement`、`PageSelect`、`PageWait`等类。
        
        [参考文档](./docs/base_old.md)
        
        > `poium>=0.6.0, <1.0.0` 版本，新增了`NewPageElement`类，用新的方式重新实现了`PageElement`类的大部分功能。 推荐使用`NewPageElement` 类。
        
        [参考文档](./docs/base_0.6.0.md)
        
        ## Project History
        
        参考项目：https://github.com/eeaston/page-objects
        
        参考项目已经不再维护，我阅读了原项目代码，虽然只有100多行，但设计非常精妙。本项目在此基础上进行开发。
        
        原项目名：https://pypi.org/project/selenium-page-objects/
        
        本项目的核心是 Page Objects设计模式, 于是取了 __PO__，同时支持selenium/appium，于是取了 __ium__，那么新的项目命名为：__poium__。
        
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.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Description-Content-Type: text/markdown
