"""Convert a NT pathname to a file URL and vice versa.
This module only exists to provide OS-specific code
for urllib.requests, thus do not use directly.
# Testing is done through test_urllib.
"""OS-specific conversion from a relative URL of the 'file' scheme
to a file system path; not recommended for general use."""
import string, urllib.parse
# Windows itself uses ":" even in URLs.
url = url.replace(':', '|')
# No drive specifier, just convert slashes
# path is something like ////host/path/on/remote/host
# convert this to \\host\path\on\remote\host
# (notice halving of slashes at the start of the path)
components = url.split('/')
# make sure not to convert quoted slashes :-)
return urllib.parse.unquote('\\'.join(components))
if len(comp) != 2 or comp[0][-1] not in string.ascii_letters:
error = 'Bad URL: ' + url
drive = comp[0][-1].upper()
components = comp[1].split('/')
path = path + '\\' + urllib.parse.unquote(comp)
# Issue #11474 - handing url such as |c/|
if path.endswith(':') and url.endswith('/'):
"""OS-specific conversion from a file system path to a relative URL
of the 'file' scheme; not recommended for general use."""
# First, clean up some special forms. We are going to sacrifice
# the additional information anyway
if p[:4].upper() == 'UNC\\':
raise OSError('Bad path: ' + p)
# No drive specifier, just convert slashes and quote the name
# path is something like \\host\path\on\remote\host
# convert this to ////host/path/on/remote/host
# (notice doubling of slashes at the start of the path)
components = p.split('\\')
return urllib.parse.quote('/'.join(components))
comp = p.split(':', maxsplit=2)
if len(comp) != 2 or len(comp[0]) > 1:
drive = urllib.parse.quote(comp[0].upper())
components = comp[1].split('\\')
path = '///' + drive + ':'
path = path + '/' + urllib.parse.quote(comp)