cpython/Lib/macurl2path.py

78 lines
2.7 KiB
Python
Raw Normal View History

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