"""Macintosh-specific module for conversion between pathnames and URLs.
Do not import directly; use urllib instead."""
__all__ = ["url2pathname","pathname2url"]
def url2pathname(pathname):
"""OS-specific conversion from a relative URL of the 'file' scheme
to a file system path; not recommended for general use."""
# XXXX The .. handling should be fixed...
tp = urllib.parse.splittype(pathname)[0]
raise RuntimeError('Cannot convert non-local URL to pathname')
# Turn starting /// into /, an empty hostname means current host
if pathname[:3] == '///':
elif pathname[:2] == '//':
raise RuntimeError('Cannot convert non-local URL to pathname')
components = pathname.split('/')
# Remove . and embedded ..
while i < len(components):
elif components[i] == '..' and i > 0 and \
components[i-1] not in ('', '..'):
elif components[i] == '' and i > 0 and components[i-1] != '':
# Absolute unix path, don't start with colon
rv = ':'.join(components[1:])
# relative unix path, start with colon. First replace
# leading .. by empty strings (giving ::file)
while i < len(components) and components[i] == '..':
rv = ':' + ':'.join(components)
# and finally unquote slashes and other funny characters
return urllib.parse.unquote(rv)
def pathname2url(pathname):
"""OS-specific conversion from a file system path to a relative URL
of the 'file' scheme; not recommended for general use."""
raise RuntimeError("Cannot convert pathname containing slashes")
components = pathname.split(':')
# Remove empty first and/or last component
# Replace empty string ('::') by .. (will result in '/../' later)
for i in range(len(components)):
# Truncate names longer than 31 bytes
components = map(_pncomp2url, components)
if os.path.isabs(pathname):
return '/' + '/'.join(components)
return '/'.join(components)
def _pncomp2url(component):
# We want to quote slashes
return urllib.parse.quote(component[:31], safe='')