Metadata-Version: 2.4
Name: meyicloud-pw-ui-utils
Version: 1.0.1
Summary: Meyicloud private Playwright UI automation utilities
Author-email: Meyicloud Solutions <support@meyicloud.com>
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: playwright>=1.41.0
Requires-Dist: pytest>=7.4.0
Requires-Dist: pytest-playwright>=0.3.0

# Meyicloud Playwright UI Utils

**Meyicloud Playwright UI Utils** is a centralized automation utility package built on **Playwright**, created to standardize and simplify UI test automation across Meyicloud projects.

It provides reusable actions, assertions, locators, navigation flows, and helper utilities, helping teams write clean, consistent, and maintainable UI automation tests.

---

## Key Benefits

- Reusable utilities shared across projects  
- Standardized automation patterns and best practices  
- Modular and easy to extend  
- Faster test development with less boilerplate  
- Improved maintainability through centralized updates  

---

## Intended Usage

This package is intended to be used across multiple Playwright-based UI test suites within Meyicloud to:

- Reduce code duplication  
- Improve test reliability  
- Promote scalable and reusable automation architecture  

---

## Example Code Snippets

### Importing Utilities

```python
from playwright.sync_api import Page
from meyicloud_pw_ui_utils.actions import click_action, fill_action
from meyicloud_pw_ui_utils.assertions import assert_text_visible
from meyicloud_pw_ui_utils.navigation import go_to_login
from meyicloud_pw_ui_utils.locators import LoginLocators

from playwright.sync_api import sync_playwright
from meyicloud_pw_ui_utils.navigation import go_to_login
from meyicloud_pw_ui_utils.assertions import assert_text_visible

def test_google():
    with sync_playwright() as p:
        page = p.chromium.launch(headless=False).new_page()
        utils = PlaywrightUtils(page)

        go_to_login("https://www.google.com")
        utils.expect_url("https://www.google.com")
