Add support for IRIs and RFC 3987 (#50)

Author: sethmlarson

.coveragerc

@@ -2,4 +2,5 @@
 exclude_lines =
     .* # Python \d.*
     .* # nocov: Python \d.*
+    .* # pragma: no cover.*
 fail_under = 100

docs/source/api-ref/index.rst

@@ -13,4 +13,5 @@ can be utilized, please see :ref:`narrative` instead.
     builder
     uri
     validators
+    iri
     miscellaneous

docs/source/api-ref/iri.rst

@@ -0,0 +1,19 @@
+===============
+ IRI Submodule
+===============
+
+.. autoclass:: rfc3986.iri.IRIReference
+
+.. automethod:: rfc3986.iri.IRIReference.encode
+
+.. automethod:: rfc3986.iri.IRIReference.from_string
+
+.. automethod:: rfc3986.iri.IRIReference.unsplit
+
+.. automethod:: rfc3986.iri.IRIReference.resolve_with
+
+.. automethod:: rfc3986.iri.IRIReference.copy_with
+
+.. automethod:: rfc3986.iri.IRIReference.is_absolute
+
+.. automethod:: rfc3986.iri.IRIReference.authority_info

docs/source/release-notes/1.3.0.rst

@@ -0,0 +1,12 @@
+1.3.0 -- 2019-04-20
+-------------------
+
+- Add the ``IRIReference`` class which parses data according
+  to RFC 3987 and encodes into an ``URIReference``.
+
+  See also `GitHub #50`_
+
+.. links
+
+.. _GitHub #50:
+    https://github.com/python-hyper/rfc3986/pull/50

docs/source/release-notes/index.rst

@@ -10,6 +10,7 @@ here with the newest releases first.
 
 .. toctree::
 
+    1.3.0
     1.2.0
     1.1.0
     1.0.0

setup.py

@@ -42,4 +42,7 @@
         'Programming Language :: Python :: 3.6',
         'Programming Language :: Python :: 3.7',
     ),
+    extras_require={
+        'idna2008':  ['idna']
+    }
 )

src/rfc3986/__init__.py

@@ -22,6 +22,8 @@
 :license: Apache v2.0, see LICENSE for details
 """
 
+from .api import iri_reference
+from .api import IRIReference
 from .api import is_valid_uri
 from .api import normalize_uri
 from .api import uri_reference
@@ -39,9 +41,11 @@
 __all__ = (
     'ParseResult',
     'URIReference',
+    'IRIReference',
     'is_valid_uri',
     'normalize_uri',
     'uri_reference',
+    'iri_reference',
     'urlparse',
     '__title__',
     '__author__',