This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

JSON like structure data lookup library. A fast alternative to XPath and JsonPath. Python3 only.

Project Description

XJPATH simplifies access to the python data structures using relatively simple path syntax. It doesn’t not only lookup value, it also can validate found data type as well as create value if a target structure is a dictionary.

The typical scenarios are:

  • you need to lookup an element from nested dicts.
  • you need to lookup and element from array that is a value of nested dictionary
  • you need to get a list of X values from multiple nested dictionaries.
  • you just want to operate with a complex data structure in the way you operate with the dictionary.
  • you want to make sure that found data has an expected type.

The expression syntax is trivial it looks like:


Each key name is a nested data index/key. Key may refer to a dictionary, an array index or iterator.

To refer a dictionary key, just use its name as in the example above.

An array index is prepended with ‘@’ symbol:

@2 - Means seconds element. @-2 - Means second element from the end. @last - Means last element. @first - Means first element of the array.

In case if dictionary key contains any reserved symbols, just escape them.

‘2.@2’ - will lookup key 2 and then key ‘@2’.

You also can specify a type of expected value as a postfix for expected value:

‘keyname[]’, ‘@last[], ‘@first{}’, ‘data$’, ‘data#’

[] - Expected value is a list. () - Expected value is a tuple. {} - Expected value is a dictionary. # - Expected value is an integer. % - Expected value is a float. $ - Expected value is a string.

Here is a bunch of examples:

>>> d = {'data': {
  'a_array': [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
  'b_dict': {'a': 'xxx', 'b': 'yyy', 'c': 'zzz'},
  'c_array': [{'v': 'vdata1'}, {'v': 'vdata2'}]}}
>>> xj = xjpath.XJPath(d)

To get ‘a_array’ array:

>>> xj['data.a_array']
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
>>> xj['data.a_array{}']
IndexError: ('Path error: data.a_array{}', 'Key a_array expects type "dict", but found value type is "list"')

To get a last element of ‘a_array’ array:

>>> xj['data.a_array.@last']

To get the first element of ‘a_array’ array:

>>> xj['data.a_array.@first']

To get 9th element from ‘a_array’:

>>> xj['data.a_array.@9']

To get third element from the back from ‘a_array’:

>>> xj['data.a_array.@-3']

To get all values that are stored in dictionaries with key ‘v1’ of array c_array:

>>> xj['data.c_array.*.v']
('vdata1', 'vdata2')

To return a frozen copy of a_array:

>>> xj['data.a_array.*']
(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10)

To get all values of b_dict dictionary:

>>> xj['data.b_dict.*']
('zzz', 'yyy', 'xxx')

If you don’t like a dictionary like interface. Feel free to use path_lookup function instead that returns a found value as well as a boolean value telling you if result is found or not.

Release History

Release History

This version
History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
xjpath-0.1.5.tar.gz (6.4 kB) Copy SHA256 Checksum SHA256 Source Mar 31, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting