|
Server : LiteSpeed System : Linux srv104790275 5.15.0-161-generic #171-Ubuntu SMP Sat Oct 11 08:17:01 UTC 2025 x86_64 User : dewac4139 ( 1077) PHP Version : 8.0.30 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory : /usr/local/CyberPanel/lib64/python3.10/site-packages/validators/ |
Upload File : |
"""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