Simple Resource Address Parser

Python module to parse simple network resource addresses, like the ones used in many database systems to represent a database URI.

Used by Mongotail to parse the address passed through the command line, but can be used by any other Python application that needs to parse a MongoDB database address, or any other network resource like [SCHEMA://][[HOST OR IP][:PORT]/]RESOURCE.

Usage:

>>> from res_address import get_res_address
>>> scheme, host, port, resource, query, username, password = get_res_address("localhost:27017/test?timeout=5")
>>> print(scheme, host, port, resource, query, username, password)
None localhost 27017 test timeout=5 None None
>>> print(get_res_address("my_db"))
(None, None, None, 'my_db', None, None, None)
>>> scheme, ipv6, port, resource, query, username, password = get_res_address("https://[::1]:9999/foo")
>>> print(scheme, ipv6, port, resource)
https [::1] 9999 foo

The address can be:

The only required component in the URI is the resource. Some validations are performed over the host, port and resource strings, and an exception is launched if some of the checks fail, but take into account that invalid range of IP addresses or incompatible resource names may pass:

>>> address = get_res_address("localhost:INVALIDport/test")
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "res_address/__init__.py", line 74, in get_res_address
    raise InvalidPortError('Invalid port number "%s"' % port, address, port)
res_address.InvalidPortError: Invalid port number "INVALIDport"

All the validation exceptions inherit from AddressError:

• InvalidHostError

• InvalidPortError

• InvalidResourceError

• NotResourceProvidedError

>>> from res_address import get_res_address
>>> from urllib.parse import parse_qs
>>> scheme, host, port, resource, query, username, password = get_res_address("localhost/db?timeout=500")
>>> parse_qs(query).get('timeout', None)
['500']

$ python setup.py test

$ python -m unittest -v tests