Find Unique Xpath of any HTML/XML element
Project description
XPanther
Find Unique Xpath expressions of HTML/XML elements.
Mostly intended for Selenium and Appium automators.
This python module's objective is to find unique xpath selector for any element in a document, using unique attributes/combination of attributes/parent or child relationship methods to find and write such expression for correctly identifying that element.
How to install:
pip install xpanther
or search it by xpanther
if you have editor with package installer. If it doesn't show up (happens in pycharm sometimes), go to global site-packages (pip show xpanther
<--cmd command to find directory), find and copy xpanther package, and paste it to your project's venv.
This package contains 2 modules, XPanther
and XPantherIDE
, let's start with the powerhouse!
Import XPanther to your file like:
from xpanther import XPanther
How to use:
Insert inside XPanther() the whole HTML/XML text, which can be in the form of:
- string,
- the path to any local text file you might have or
- a page url (check below for optional-parameter page_url).
Insert inside .capture() the outerHTML/whole text of element to be found:
- as a string
- or alternatively an integer, which represents the index of that element in the DOM, starting from 1 as the first (check below for interesting usage of index input).
XPanther(dom).capture(element)
After writing this , run the code and the xpath of that element should be returned as value and printed in the console.
Code execution illustrations:
The class has a few optional-parameters that you can change to modify it in the way you want:
-
xml
(default:False
): Set this toTrue
if document is not HTML, this is because the xml document can contain uppercase characters in attributes, unlike html, so a different parser needs to be used. -
pre_formatted
(default:False
): Set this toTrue
if you have already formatted document and don't want formatter of XPanther to change anything. -
url_input
(default:False
): Set this toTrue
if you intend to insert page url intead of text or file as the dom parameter of this class. -
child_method
(default:True
): Set this toFalse
if you don't want the Xpath to be found using its children, reason for this can depend on context. -
show_all
(default:False
): Set this toTrue
if you want all possible working xpaths found and not resort to only the one chosen by program. -
no_digits
(default:False
): Set this toTrue
if you don't want element attributes that contain numbers. -
print_output
(default:True
): Set this toFalse
if you don't want the program to print anything in console but just return the xpath as a value in any variable or function. -
speed
(default:'normal'
): other valid options are'fast'
-- (less detailed, faster execution),'slow'
-- (more detailed, slower execution), or an integer (maximum is 50, which represent the number of attributes of element program can take and proccess to find combinations of). if you have a slow computer, better set it to 'fast', cause it takes lesser number of combination and lowers memory and performance consumption, thus increasing speed of execution.
For most optimal usage, keep this values as default, you have to only change to xml=True if you are not dealing with HTML, and url_input=True if you like to fetch the HTML directly from link.
Interesting way which you can utilize putting an integer as parameter to capture(), is this function like here:
for x in range(100):
XPanther('xpath_test.txt').capture(x+1)
Literally, create and write an unique xpath for every element in the document if you want (change the number in range() accordingly).
If you are into web automation, that's where XPantherIDE
comes into play.
XPantherIDE
is a simple Selenium script, that tries to mimic an IDE for finding xpaths instantly on any web page with just 1 click.
Import:
from xpanther import XPantherIDE
Use:
XPantherIDE('page_url').start()
After you run the program, the browser will open, and you can start finding xpaths by right-clicking
over elements. A pop up alert will appear showing the xpath, you must accept/close the pop up before trying again.
Both programs are open to improvements or new ideas!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file xpanther-1.0.8.tar.gz
.
File metadata
- Download URL: xpanther-1.0.8.tar.gz
- Upload date:
- Size: 11.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2f85a3eb36e2ad8da1aaa46c025082c446f514466c0f33ecdcd67cc7e9b31b69 |
|
MD5 | 94a40b69e8463553d205e0afd3ca0886 |
|
BLAKE2b-256 | 1f018b7c6b3551f6f773126d9cabe2e59a5883c597fb17274ce3be3180e97832 |
File details
Details for the file xpanther-1.0.8-py3-none-any.whl
.
File metadata
- Download URL: xpanther-1.0.8-py3-none-any.whl
- Upload date:
- Size: 9.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a2eeb7e9139f6ec1bad3974ddede9463a75077216347ecef56c53f8a1f09452f |
|
MD5 | 8c2ea9a5ef4c86ee830d42378c512639 |
|
BLAKE2b-256 | 154fe023c3cee21b7c2b57771e04eebb96e2ddcb8160d8113a9f229bf799d0ed |