Metadata-Version: 2.1
Name: xpath-string
Version: 0.2.3
Summary: Module which allows to make xpath operations over string which represent xpath
Home-page: https://github.com/yavorek/xpath_string
Author: Tomasz Jaworski
Author-email: jaworski.tomasz.91@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent

.. image:: https://travis-ci.com/yavorek/xpath-string.svg?branch=master
        :target: https://travis-ci.com/yavorek/xpath-string

.. image:: https://img.shields.io/badge/python-3.4%2C%203.5%2C%203.6%2C%203.7-blue.svg
        :target: https://pypi.python.org/pypi/xpath-string

.. image:: https://img.shields.io/pypi/v/xpath-string.svg
        :target: https://pypi.python.org/pypi/xpath-string

.. image:: https://codecov.io/gh/yavorek/xpath-string/branch/master/graph/badge.svg
        :target: https://codecov.io/gh/yavorek/xpath-string

xpath-string
============
Simple module providing operations on Xpath string

Currently only addition of xpath is supported


Xpath Object
------------
* Initialization
    .. code:: python

        from xpath_string.xpath import Xpath

        xpath_object = Xpath('//some[@xpath="string"]')

* Attributes:\
    ``xpath`` - xpath string (type: 'str')

Xpath Adding
---------------
* Xpath object + string\
    Result of addition string to Xpath object is Xpath object.
    Adding string to Xpath object is the same as adding two strings.

    .. code:: python

        xpath_object = Xpath('//some[@xpath="string"]')
        string = '//div[@class="name"]'
        result = xpath_object + string

        # result == '//some[@xpath="string"]//div[@class="name"]'
        # result.xpath == '//some[@xpath="string"]//div[@class="name"]'

    Same situation is when Xpath object represents xpath string with OR operator

    .. code:: python

        xpath_object = Xpath('//some[@xpath="string"]|\\span')
        string = '//div[@class="name"]'

        result = xpath_object + string
        # result == '//some[@xpath="string"]|//span//div[@class="name"]'
        # result.xpath == '//some[@xpath="string"]|//span//div[@class="name"]'

* Xpath object + Xpath object\
    Result of addition Xpath object to Xpath object is Xpath Object.

    .. code:: python

        xpath_object_1 = Xpath('//some[@xpath="string"]')
        xpath_object_2 = Xpath('//div[@class="name"]')

        result = xpath_object_1 + xpath_object_2
        # result == '//some[@xpath="string"]//div[@class="name"]'
        # result.xpath == '//some[@xpath="string"]//div[@class="name"]'

    When at least one Xpath object has or operator in main part of xpath (not inside square brackets):

    .. code:: python

        xpath_object_1 = Xpath('//some[@xpath="string"]|//span')
        xpath_object_2 = Xpath('//div[@class="name"]')

        result_1 = xpath_object_1 + xpath_object_2
        # result_1 == '//some[@xpath="string"]//div[@class="name"|//span//div[@class="name"]'
        # result_1.xpath == '//some[@xpath="string"]//div[@class="name"|//span//div[@class="name"]'

        result_2 = xpath_object_2 + xpath_object_1
        # result_2 == '//div[@class="name"]//some[@xpath="string"]|//div[@class="name"]//span'
        # result_2.xpath == '//div[@class="name"]//some[@xpath="string"]|//div[@class="name"]//span'


Xpath.format()
--------------
The string built-in is overwrote.
*Xpath.format('some string')* is formatting *xpath* string attribute of a Object.
It returns new Xpath object with 'formatted' *xpath* attribute.

Example:

.. code:: python

    xpath_object_1 = Xpath('//some[@xpath="{}"]')
    xpath_object_2 = xpath_object_1.format('new')
    # xpath_object_1 == Xpath('//some[@xpath="{}"]')
    # xpath_object_2 == Xpath('//some[@xpath="new"]')

    xpath_object_3 = Xpath('//some[@xpath="{sth}"]')
    xpath_object_4 = xpath_object_1.format(sth='one')
    # xpath_object_3 == Xpath('//some[@xpath="{sth}"]')
    # xpath_object_4 == Xpath('//some[@xpath="one"]')

Running tests
-------------
Install tox (pip install tox)
Then:

.. code:: bash

    tox

OR install nose (pip install nose)
Then:

.. code:: bash

    nosetests

