Skip to content

eagleEggs/EHX

Repository files navigation

EHX

anim1 anim1 anim1

Notice

Use Release 1.0 until an XPATH bug is resolved in 1.1.
Source and/or EXE are in Releases

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.

anim1

Releases

Version 1.0 (Base)
Version 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