import os import sys from pip._vendor.six.moves.urllib import parse as urllib_parse from pip._vendor.six.moves.urllib import request as urllib_request from pip._internal.utils.typing import MYPY_CHECK_RUNNING if MYPY_CHECK_RUNNING: from typing import Optional, Text, Union def get_url_scheme(url): # type: (Union[str, Text]) -> Optional[Text] if ":" not in url: return None return url.split(":", 1)[0].lower() def path_to_url(path): # type: (Union[str, Text]) -> str """ Convert a path to a file: URL. The path will be made absolute and have quoted path parts. """ path = os.path.normpath(os.path.abspath(path)) url = urllib_parse.urljoin("file:", urllib_request.pathname2url(path)) return url def url_to_path(url): # type: (str) -> str """ Convert a file: URL to a path. """ assert url.startswith( "file:" ), "You can only turn file: urls into filenames (not {url!r})".format(**locals()) _, netloc, path, _, _ = urllib_parse.urlsplit(url) if not netloc or netloc == "localhost": # According to RFC 8089, same as empty authority. netloc = "" elif sys.platform == "win32": # If we have a UNC path, prepend UNC share notation. netloc = "\\\\" + netloc else: raise ValueError( "non-local file URIs are not supported on this platform: {url!r}".format( **locals() ) ) path = urllib_request.url2pathname(netloc + path) return path