Skip to main content

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 to True 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 to True if you have already formatted document and don't want formatter of XPanther to change anything.

  • url_input (default: False): Set this to True 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 to False 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 to True if you want all possible working xpaths found and not resort to only the one chosen by program.

  • no_digits (default: False): Set this to True if you don't want element attributes that contain numbers.

  • print_output (default: True): Set this to False 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xpanther-1.0.8.tar.gz (11.5 kB view details)

Uploaded Source

Built Distribution

xpanther-1.0.8-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

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

Hashes for xpanther-1.0.8.tar.gz
Algorithm Hash digest
SHA256 2f85a3eb36e2ad8da1aaa46c025082c446f514466c0f33ecdcd67cc7e9b31b69
MD5 94a40b69e8463553d205e0afd3ca0886
BLAKE2b-256 1f018b7c6b3551f6f773126d9cabe2e59a5883c597fb17274ce3be3180e97832

See more details on using hashes here.

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

Hashes for xpanther-1.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 a2eeb7e9139f6ec1bad3974ddede9463a75077216347ecef56c53f8a1f09452f
MD5 8c2ea9a5ef4c86ee830d42378c512639
BLAKE2b-256 154fe023c3cee21b7c2b57771e04eebb96e2ddcb8160d8113a9f229bf799d0ed

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page