Metadata-Version: 2.1
Name: servicenow-selenium
Version: 0.2
Summary: A simple selenium wrapper for ServiceNow
Home-page: https://github.com/connorwquick/servicenow-selenium
Author: Seamless Migration
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: selenium

# ServiceNow Selenium Wrapper

A simple selenium wrapper designed for interaction with ServiceNow. This package simplifies logging in, managing alerts, and interacting with shadow elements within the ServiceNow environment.

## Installation

To install the package, use pip:

```bash
pip install servicenow-selenium
```

## Usage

Initialize the ServiceNowSelenium class by providing the URL, username, and password:

```python
from servicenow_selenium import ServiceNowSelenium

selenium_wrapper = ServiceNowSelenium(url="YOUR_SERVICENOW_URL", username="YOUR_USERNAME", password="YOUR_PASSWORD")
```

### Key Features:

1. **Login**:
   Easily log into ServiceNow:

   ```python
   selenium_wrapper.login()
   ```
2. **Logout**:
   Log out and quit the driver:

   ```python
   selenium_wrapper.logout(user_menu_path="JS_PATH_HERE", logout_path="JS_PATH_HERE")
   ```
3. **Interact with Shadow DOM Elements**:
   Click shadow elements using JS path:

   ```python
   selenium_wrapper.click_shadow_element(errorName="element name for error reference", js_path="JS_PATH_HERE")
   ```
   Note: The provided JS path must contain "return" to correctly fetch the element. For instance, `return document.querySelector(...)`
4. **Check for Element Presence**:
   Determine if an element is present using its JS path:

   ```python
   is_present = selenium_wrapper.is_element_present(js_path="JS_PATH_HERE")
   ```
