feat: lays foundation for URI validation

src/validators/uri.py

@@ -0,0 +1,91 @@
+"""URI."""
+
+# Read: https://stackoverflow.com/questions/176264
+# https://www.rfc-editor.org/rfc/rfc3986#section-3
+
+# local
+from .email import email
+from .url import url
+from .utils import validator
+
+
+def _file_url(value: str):
+    if not value.startswith("file:///"):
+        return False
+    return True
+
+
+def _ipfs_url(value: str):
+    if not value.startswith("ipfs://"):
+        return False
+    return True
+
+
+@validator
+def uri(value: str, /):
+    """Return whether or not given value is a valid URI.
+
+    Examples:
+        >>> uri('mailto:example@domain.com')
+        # Output: True
+        >>> uri('file:path.txt')
+        # Output: ValidationError(func=uri, ...)
+
+    Args:
+        value:
+            URI to validate.
+
+    Returns:
+        (Literal[True]): If `value` is a valid URI.
+        (ValidationError): If `value` is an invalid URI.
+    """
+    if not value:
+        return False
+
+    # TODO: work on various validations
+
+    # url
+    if any(
+        # fmt: off
+        value.startswith(item) for item in {
+            "ftp", "ftps", "git", "http", "https",
+            "irc", "rtmp", "rtmps", "rtsp", "sftp",
+            "ssh", "telnet",
+        }
+        # fmt: on
+    ):
+        return url(value)
+
+    # email
+    if value.startswith("mailto:"):
+        return email(value.lstrip("mailto:"))
+
+    # file
+    if value.startswith("file:"):
+        return _file_url(value)
+
+    # ipfs
+    if value.startswith("ipfs:"):
+        return _ipfs_url(value)
+
+    # magnet
+    if value.startswith("magnet:?"):
+        return True
+
+    # telephone
+    if value.startswith("tel:"):
+        return True
+
+    # data
+    if value.startswith("data:"):
+        return True
+
+    # urn
+    if value.startswith("urn:"):
+        return True
+
+    # urc
+    if value.startswith("urc:"):
+        return True
+
+    return False

src/validators/url.py

@@ -44,7 +44,7 @@ def _validate_scheme(value: str):
         # fmt: off
         in {
             "ftp", "ftps", "git", "http", "https",
-            "rtmp", "rtmps", "rtsp", "sftp",
+            "irc", "rtmp", "rtmps", "rtsp", "sftp",
             "ssh", "telnet",
         }
         # fmt: on