U Cdi@s^dZddlmZddlmZddlmZddlmZddlmZGdd d ed ej eZ d S) z?Module containing the implementation of the URIReference class.) namedtuple)compat)misc) normalizers)URIMixincsJeZdZdZdZd fdd ZejZddZdd Z e d d d Z Z S) URIReferenceaImmutable object representing a parsed URI Reference. .. note:: This class is not intended to be directly instantiated by the user. This object exposes attributes for the following components of a URI: - scheme - authority - path - query - fragment .. attribute:: scheme The scheme that was parsed for the URI Reference. For example, ``http``, ``https``, ``smtp``, ``imap``, etc. .. attribute:: authority Component of the URI that contains the user information, host, and port sub-components. For example, ``google.com``, ``127.0.0.1:5000``, ``username@[::1]``, ``username:password@example.com:443``, etc. .. attribute:: path The path that was parsed for the given URI Reference. For example, ``/``, ``/index.php``, etc. .. attribute:: query The query component for a given URI Reference. For example, ``a=b``, ``a=b%20c``, ``a=b+c``, ``a=b,c=d,e=%20f``, etc. .. attribute:: fragment The fragment component of a URI. For example, ``section-3.1``. This class also provides extra attributes for easier access to information like the subcomponents of the authority component. .. attribute:: userinfo The user information parsed from the authority. .. attribute:: host The hostname, IPv4, or IPv6 address parsed from the authority. .. attribute:: port The port parsed from the authority. utf-8cs0tt|||pd|pd|pd||}||_|S)zCreate a new URIReference.N)superr__new__encoding)clsscheme authoritypathqueryfragmentr ref __class__r //tmp/pip-unpacked-wheel-79v45wuf/rfc3986/uri.pyr Us zURIReference.__new__cCsx|}t|trt|}nBt|tsZzt|}Wn(tk rXtdt|jYnXt|t|k}|pv||S)z"Compare this reference to another.z)Unable to compare URIReference() to {0}()) isinstancetupler from_string TypeErrorformattype__name__Znormalized_equality)selfotherZ other_refZnaive_equalityr r r__eq__fs    zURIReference.__eq__cCsNtt|jpdt|j|j|jft|j p0dt |j t |j |jS)aNormalize this reference as described in Section 6.2.2. This is not an in-place normalization. Instead this creates a new URIReference. :returns: A new reference object with normalized components. :rtype: URIReference )rrZnormalize_schemerZnormalize_authorityuserinfohostportnormalize_pathrZnormalize_queryrZnormalize_fragmentrr )rr r r normalizeys   zURIReference.normalizec CsZt||}tj|}||d|dt|d|t|d|t|d||S)a Parse a URI reference from the given unicode URI string. :param str uri_string: Unicode URI to be parsed into a reference. :param str encoding: The encoding of the string provided :returns: :class:`URIReference` or subclass thereof rrrrr)rZto_strrZ URI_MATCHERmatch groupdictrZencode_component)rZ uri_stringr Z split_urir r rrs zURIReference.from_string)r )r ) r __module__ __qualname____doc__slotsr r__hash__r!r' classmethodr __classcell__r r rrrs9rN) r, collectionsrr"rrrZ_mixinrZURI_COMPONENTSrr r r rs