Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jinmoo21/pwdriver
To simplify web browser automation settings for python.
https://github.com/jinmoo21/pwdriver
appium appium-webdriver automation python selenium selenium-webdriver test-automation testing webdriver
Last synced: 2 months ago
JSON representation
To simplify web browser automation settings for python.
- Host: GitHub
- URL: https://github.com/jinmoo21/pwdriver
- Owner: jinmoo21
- License: mit
- Created: 2020-10-14T14:49:40.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-09-24T14:22:35.000Z (over 1 year ago)
- Last Synced: 2024-10-11T23:20:13.970Z (3 months ago)
- Topics: appium, appium-webdriver, automation, python, selenium, selenium-webdriver, test-automation, testing, webdriver
- Language: Python
- Homepage: https://pypi.org/project/pwdriver/
- Size: 119 KB
- Stars: 1
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PWDriver (PyWebDriver)
[](https://github.com/jinmoo21/pwdriver/actions/workflows/python_test.yml)
[](https://codecov.io/gh/jinmoo21/pwdriver)
[](https://github.com/jinmoo21/pwdriver/actions/workflows/python_release.yml)
[](https://badge.fury.io/py/pwdriver)
[](https://github.com/jinmoo21/PWDriver/blob/master/LICENSE)
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fjinmoo21%2FPWDriver?ref=badge_shield)
## Motivation
To simplify automation settings of each different platform, version, browser.
##### Support:
- ChromeDriver
- GeckoDriver
- EdgeDriver (Chromium)
- ~~IEDriver~~
- ...and Android, iOS (See [With Appium](https://github.com/jinmoo21/PWDriver#with-appium) section)
## Usage
### 1. Install:
```bash
pip install pwdriver
```
### 2. Make 'config.ini' file and locate in your project directory.
`config.ini` look like this.
```ini
[automation]
;if using remote webdriver, then local be false and url required.
local=true
url=http://localhost:4444
;target: chrome, gecko, edge, safari
target=chrome
```
### 3. Import WebDriverFactory.
Now, we can launch webdriver.
```python
from pwdriver.core import WebDriverFactory
driver = WebDriverFactory.launch()
```
## Alternative Usage
This way doesn't make and doesn't use configuration file, but calls setup method of the driver in your test code.
### with Chrome:
```python
from selenium import webdriver
from pwdriver import core
core.setup_chromedriver()
driver = webdriver.Chrome()
```
### with FireFox:
```python
from selenium import webdriver
from pwdriver import core
core.setup_geckodriver()
driver = webdriver.Firefox()
```
### with Edge:
```python
from selenium import webdriver
from pwdriver import core
core.setup_edgedriver()
driver = webdriver.Edge()
```
## Page object models
Page object models pattern makes our test cases more concise and readable.
The good news is, we can use Page Objects with this.
There is an example that searching for keyword on `www.bing.com` and verifying url, title.
For using this, we are going to create modules that page object classes and test cases.
Modules that page elements and locators already implemented, so nevermind.
### Page Object Class
```python
from selenium.webdriver.common.by import By
from pwdriver.page import BasePage
class BingPage(BasePage):
def __init__(self, driver):
super().__init__(driver)
self._url = 'https://www.bing.com'
self._locator = {
'input': (By.CSS_SELECTOR, 'input#sb_form_q'),
'search': (By.CSS_SELECTOR, 'label#search_icon')
}
def type_keyword(self, text) -> None:
self._by('input').send_keys(text)
def click_search(self) -> BasePage:
self._by('search').click()
return BingPage(BasePage)
```
### Test case
```python
from pwdriver.core import WebDriverFactory
from tests.pages.bing_page import BingPage
import unittest
class BrowserTest(unittest.TestCase):
def setUp(self):
self.driver = WebDriverFactory.launch()
def tearDown(self):
self.driver.quit()
def test_something(self):
page = BingPage(self.driver)
page.get()
keyword = 'chicken'
page.type_keyword(keyword)
page.submit_keyword()
self.assertIn(f'https://www.bing.com/search?q={keyword}', self.driver.current_url)
self.assertEqual(f'{keyword} - Search', self.driver.title)
if __name__ == '__main__':
unittest.main()
```
## Logging and Event listener
If we want to use logging or want to see what events occured in webdriver,
we can use `get_logger()` or `EventListener()`.
See below example code.
### Test
```python
from selenium.webdriver.support.events import EventFiringWebDriver
from pwdriver.core import WebDriverFactory
from pwdriver.listener import EventListener
from pwdriver.util import get_logger
logger = get_logger('test')
core = WebDriverFactory.launch()
driver = EventFiringWebDriver(core, EventListener())
logger.info('WebDriver created.')
```
* Log level: `debug`, `info`, `warning`, `error`, `critical`
* WebDriver event: `navigate`, `execute script`
* WebElement event: `find`, `click`, `change value`
## With Appium
This package also includes wrapped appium's remote webdriver.
We could launch an appium driver using `config.ini` file that contains capabilities.
See below configuration and example code.
### Configuration
```ini
[automation]
;if using appium, then local be false and url required.
local=false
url=http://localhost:4723
;target: android, ios
target=ios
[mobile]
;add capabilities for mobile testing.
platformVersion=15.5
deviceName=iPhone 13 mini
browserName=Safari
```
### Test
```python
from pwdriver.core import WebDriverFactory
driver = WebDriverFactory.launch()
```
## License
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fjinmoo21%2FPWDriver?ref=badge_large)