https://github.com/eagleeggs/ehx
Realtime Browser Element Verification Tool [Stable]
https://github.com/eagleeggs/ehx
python python3 selenium test-automation
Last synced: 4 months ago
JSON representation
Realtime Browser Element Verification Tool [Stable]
- Host: GitHub
- URL: https://github.com/eagleeggs/ehx
- Owner: eagleEggs
- License: gpl-3.0
- Created: 2018-11-03T23:14:00.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-03-26T15:26:41.000Z (over 6 years ago)
- Last Synced: 2025-04-29T09:43:20.399Z (7 months ago)
- Topics: python, python3, selenium, test-automation
- Language: Python
- Homepage:
- Size: 8.66 MB
- Stars: 29
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EHX
  
### Notice
Use Release 1.0 until an XPATH bug is resolved in 1.1.
Source and/or EXE are [in Releases](https://github.com/eagleEggs/EHX/releases/tag/1.0)
### What is it?
Element Hunter X (EHX) is an application which allows you to maintain a single browser session while testing elements for web automation testing. It's main purpose is to save time from recompiling and/or relaunching test from your code and waiting over and over for the browser to open and close.
### Releases
[Version 1.0](https://github.com/eagleEggs/EHX/releases/tag/1.0) (Base)
[Version 1.1](https://github.com/eagleEggs/EHX/releases/tag/1.1) (Multiple elements, threading, performance)
### Documentation
You can view the PDF on Github here: https://github.com/eagleEggs/EHX/blob/master/EHX_1.0_Documentation.pdf
Within the main window there are two sections:
1. Browser Configuration
2. Element Configuration
Within Browser Configuration there are three actionable interactions:
1. URL: A text input box where you can paste the URL you will be testing.
2. Browser: A drop down list of browsers. Choose the one you'd like to open the URL with.
3. Launch Button: Once the previous inputs have been completed, click the rocket ship to launch the browser to the URL chosen.
Within Element Configuration there are four actionable interactions:
1. Element String: Text input box where you can paste or type your element tag string (i.e. CSS, XPATH, ID, etc...).
2. Element Type: A drop down where you will choose the type of element that you have pasted or typed above.
3. Color: A color drop down where you can choose a color of which will be highlighted within the browser.
4. Highlight Button: Once the previous inputs have been completed, click the highlight button to render highlight within the browser.
If there are multiple elements with the same tag string you're querying, a pop up will notify you of how many it has found. You can choose to continue, or cancel the highlight before it starts.
While highlighting, a brief pop up will flash while scanning and highlighting. A longer pop up will stay while it's highlighting, and disappear when complete.
If you have highlighted many elements at once (Over 25), it may take a few moments for it to unhighlight when you search for the next element. Simply wait for the pop up to disappear and you're good to go.
Note:
- If there is an error in highlighting the element within the browser, an error pop up will notify you. Try changing the element tag string to one that works.
- Once you see that the element is highlighted, you know that element will work within your scripts.
### Requirements
When running Python modules:
- PySimpleGUI (TKinter alternative)
- Selenium and Python Web Browser Drivers
When running release binary:
- Selenium and Python Web Browser Drivers
You can download the Web Drivers here: https://www.seleniumhq.org/projects/webdriver/
### Thanks
Great code from https://gist.github.com/dariodiaz/3104601 and https://gist.github.com/marciomazza/3086536 was referenced
to build the style highlighting functionality.
### License
EHX is GPL v3
Octicons (Rocket Ship and Pen icons) are MIT licensed: https://github.com/primer/octicons/blob/master/LICENSE