windows.py
496 lines
| 14.7 KiB
| text/x-python
|
PythonLexer
/ mercurial / windows.py
|
r8226 | # windows.py - Windows utility function implementations for Mercurial | ||
# | ||||
# Copyright 2005-2009 Matt Mackall <mpm@selenic.com> and others | ||||
# | ||||
# This software may be used and distributed according to the terms of the | ||||
|
r10263 | # GNU General Public License version 2 or any later version. | ||
|
r7890 | |||
|
r27360 | from __future__ import absolute_import | ||
|
r8421 | |||
|
r27360 | import errno | ||
import msvcrt | ||||
import os | ||||
import re | ||||
import stat | ||||
import sys | ||||
from .i18n import _ | ||||
from . import ( | ||||
encoding, | ||||
|
r33724 | error, | ||
|
r32367 | policy, | ||
|
r30612 | pycompat, | ||
|
r27436 | win32, | ||
|
r27360 | ) | ||
|
r29760 | try: | ||
import _winreg as winreg | ||||
winreg.CloseKey | ||||
except ImportError: | ||||
import winreg | ||||
|
r32367 | osutil = policy.importmod(r'osutil') | ||
|
r15016 | executablepath = win32.executablepath | ||
|
r35531 | getfsmountpoint = win32.getvolumename | ||
|
r35528 | getfstype = win32.getfstype | ||
|
r15016 | getuser = win32.getuser | ||
hidewindow = win32.hidewindow | ||||
makedir = win32.makedir | ||||
nlinks = win32.nlinks | ||||
oslink = win32.oslink | ||||
samedevice = win32.samedevice | ||||
samefile = win32.samefile | ||||
setsignalhandler = win32.setsignalhandler | ||||
spawndetached = win32.spawndetached | ||||
|
r17560 | split = os.path.split | ||
|
r15016 | testpid = win32.testpid | ||
unlink = win32.unlink | ||||
|
r14985 | |||
|
r25658 | umask = 0o022 | ||
|
r7890 | |||
|
r26375 | class mixedfilemodewrapper(object): | ||
"""Wraps a file handle when it is opened in read/write mode. | ||||
fopen() and fdopen() on Windows have a specific-to-Windows requirement | ||||
that files opened with mode r+, w+, or a+ make a call to a file positioning | ||||
function when switching between reads and writes. Without this extra call, | ||||
Python will raise a not very intuitive "IOError: [Errno 0] Error." | ||||
This class wraps posixfile instances when the file is opened in read/write | ||||
mode and automatically adds checks or inserts appropriate file positioning | ||||
calls when necessary. | ||||
""" | ||||
OPNONE = 0 | ||||
OPREAD = 1 | ||||
OPWRITE = 2 | ||||
def __init__(self, fp): | ||||
|
r31644 | object.__setattr__(self, r'_fp', fp) | ||
object.__setattr__(self, r'_lastop', 0) | ||||
|
r26375 | |||
|
r31891 | def __enter__(self): | ||
return self._fp.__enter__() | ||||
def __exit__(self, exc_type, exc_val, exc_tb): | ||||
self._fp.__exit__(exc_type, exc_val, exc_tb) | ||||
|
r26375 | def __getattr__(self, name): | ||
return getattr(self._fp, name) | ||||
def __setattr__(self, name, value): | ||||
return self._fp.__setattr__(name, value) | ||||
def _noopseek(self): | ||||
self._fp.seek(0, os.SEEK_CUR) | ||||
def seek(self, *args, **kwargs): | ||||
|
r31644 | object.__setattr__(self, r'_lastop', self.OPNONE) | ||
|
r26375 | return self._fp.seek(*args, **kwargs) | ||
def write(self, d): | ||||
if self._lastop == self.OPREAD: | ||||
self._noopseek() | ||||
|
r31644 | object.__setattr__(self, r'_lastop', self.OPWRITE) | ||
|
r26375 | return self._fp.write(d) | ||
def writelines(self, *args, **kwargs): | ||||
if self._lastop == self.OPREAD: | ||||
self._noopeseek() | ||||
|
r31644 | object.__setattr__(self, r'_lastop', self.OPWRITE) | ||
|
r26375 | return self._fp.writelines(*args, **kwargs) | ||
def read(self, *args, **kwargs): | ||||
if self._lastop == self.OPWRITE: | ||||
self._noopseek() | ||||
|
r31644 | object.__setattr__(self, r'_lastop', self.OPREAD) | ||
|
r26375 | return self._fp.read(*args, **kwargs) | ||
def readline(self, *args, **kwargs): | ||||
if self._lastop == self.OPWRITE: | ||||
self._noopseek() | ||||
|
r31644 | object.__setattr__(self, r'_lastop', self.OPREAD) | ||
|
r26375 | return self._fp.readline(*args, **kwargs) | ||
def readlines(self, *args, **kwargs): | ||||
if self._lastop == self.OPWRITE: | ||||
self._noopseek() | ||||
|
r31644 | object.__setattr__(self, r'_lastop', self.OPREAD) | ||
|
r26375 | return self._fp.readlines(*args, **kwargs) | ||
|
r8421 | def posixfile(name, mode='r', buffering=-1): | ||
|
r24069 | '''Open a file with even more POSIX-like semantics''' | ||
|
r8421 | try: | ||
|
r24069 | fp = osutil.posixfile(name, mode, buffering) # may raise WindowsError | ||
|
r24051 | |||
# The position when opening in append mode is implementation defined, so | ||||
# make it consistent with other platforms, which position at EOF. | ||||
if 'a' in mode: | ||||
|
r25462 | fp.seek(0, os.SEEK_END) | ||
|
r24051 | |||
|
r26375 | if '+' in mode: | ||
return mixedfilemodewrapper(fp) | ||||
|
r24051 | return fp | ||
|
r25660 | except WindowsError as err: | ||
|
r24069 | # convert to a friendlier exception | ||
|
r34024 | raise IOError(err.errno, '%s: %s' % ( | ||
name, encoding.strtolocal(err.strerror))) | ||||
|
r7890 | |||
|
r32203 | # may be wrapped by win32mbcs extension | ||
listdir = osutil.listdir | ||||
|
r8778 | class winstdout(object): | ||
|
r7890 | '''stdout on windows misbehaves if sent through a pipe''' | ||
def __init__(self, fp): | ||||
self.fp = fp | ||||
def __getattr__(self, key): | ||||
return getattr(self.fp, key) | ||||
def close(self): | ||||
try: | ||||
self.fp.close() | ||||
|
r14004 | except IOError: | ||
pass | ||||
|
r7890 | |||
def write(self, s): | ||||
try: | ||||
# This is workaround for "Not enough space" error on | ||||
# writing large size of data to console. | ||||
limit = 16000 | ||||
l = len(s) | ||||
start = 0 | ||||
|
r10394 | self.softspace = 0 | ||
|
r7890 | while start < l: | ||
end = start + limit | ||||
self.fp.write(s[start:end]) | ||||
start = end | ||||
|
r25660 | except IOError as inst: | ||
|
r10282 | if inst.errno != 0: | ||
raise | ||||
|
r7890 | self.close() | ||
raise IOError(errno.EPIPE, 'Broken pipe') | ||||
def flush(self): | ||||
try: | ||||
return self.fp.flush() | ||||
|
r25660 | except IOError as inst: | ||
|
r10282 | if inst.errno != errno.EINVAL: | ||
raise | ||||
|
r7890 | raise IOError(errno.EPIPE, 'Broken pipe') | ||
def _is_win_9x(): | ||||
'''return true if run on windows 95, 98 or me.''' | ||||
try: | ||||
return sys.getwindowsversion()[3] == 1 | ||||
except AttributeError: | ||||
|
r30636 | return 'command' in encoding.environ.get('comspec', '') | ||
|
r7890 | |||
def openhardlinks(): | ||||
|
r13375 | return not _is_win_9x() | ||
|
r7890 | |||
|
r14231 | def parsepatchoutput(output_line): | ||
|
r8761 | """parses the output produced by patch and returns the filename""" | ||
|
r7890 | pf = output_line[14:] | ||
if pf[0] == '`': | ||||
pf = pf[1:-1] # Remove the quotes | ||||
return pf | ||||
def sshargs(sshcmd, host, user, port): | ||||
'''Build argument list for ssh or Plink''' | ||||
pflag = 'plink' in sshcmd.lower() and '-P' or '-p' | ||||
args = user and ("%s@%s" % (user, host)) or host | ||||
|
r33724 | if args.startswith('-') or args.startswith('/'): | ||
raise error.Abort( | ||||
_('illegal ssh hostname or username starting with - or /: %s') % | ||||
args) | ||||
|
r33732 | args = shellquote(args) | ||
if port: | ||||
args = '%s %s %s' % (pflag, shellquote(port), args) | ||||
return args | ||||
|
r7890 | |||
|
r14232 | def setflags(f, l, x): | ||
|
r7890 | pass | ||
|
r15011 | def copymode(src, dst, mode=None): | ||
pass | ||||
|
r13879 | def checkexec(path): | ||
return False | ||||
|
r13890 | def checklink(path): | ||
return False | ||||
|
r14233 | def setbinary(fd): | ||
|
r7890 | # When run without console, pipes may expose invalid | ||
# fileno(), usually set to -1. | ||||
|
r14969 | fno = getattr(fd, 'fileno', None) | ||
if fno is not None and fno() >= 0: | ||||
msvcrt.setmode(fno(), os.O_BINARY) | ||||
|
r7890 | |||
def pconvert(path): | ||||
|
r30615 | return path.replace(pycompat.ossep, '/') | ||
|
r7890 | |||
def localpath(path): | ||||
return path.replace('/', '\\') | ||||
def normpath(path): | ||||
return pconvert(os.path.normpath(path)) | ||||
|
r15671 | def normcase(path): | ||
|
r25071 | return encoding.upper(path) # NTFS compares via upper() | ||
|
r15488 | |||
|
r24598 | # see posix.py for definitions | ||
normcasespec = encoding.normcasespecs.upper | ||||
normcasefallback = encoding.upperfallback | ||||
|
r7890 | def samestat(s1, s2): | ||
return False | ||||
# A sequence of backslashes is special iff it precedes a double quote: | ||||
# - if there's an even number of backslashes, the double quote is not | ||||
# quoted (i.e. it ends the quoted region) | ||||
# - if there's an odd number of backslashes, the double quote is quoted | ||||
# - in both cases, every pair of backslashes is unquoted into a single | ||||
# backslash | ||||
# (See http://msdn2.microsoft.com/en-us/library/a1y7w461.aspx ) | ||||
# So, to quote a string, we must surround it in double quotes, double | ||||
|
r17505 | # the number of backslashes that precede double quotes and add another | ||
|
r7890 | # backslash before every double quote (being careful with the double | ||
# quote we've appended to the end) | ||||
_quotere = None | ||||
|
r23682 | _needsshellquote = None | ||
|
r7890 | def shellquote(s): | ||
|
r24908 | r""" | ||
|
r34133 | >>> shellquote(br'C:\Users\xyz') | ||
|
r24908 | '"C:\\Users\\xyz"' | ||
|
r34133 | >>> shellquote(br'C:\Users\xyz/mixed') | ||
|
r24908 | '"C:\\Users\\xyz/mixed"' | ||
>>> # Would be safe not to quote too, since it is all double backslashes | ||||
|
r34133 | >>> shellquote(br'C:\\Users\\xyz') | ||
|
r24908 | '"C:\\\\Users\\\\xyz"' | ||
>>> # But this must be quoted | ||||
|
r34133 | >>> shellquote(br'C:\\Users\\xyz/abc') | ||
|
r24908 | '"C:\\\\Users\\\\xyz/abc"' | ||
""" | ||||
|
r7890 | global _quotere | ||
if _quotere is None: | ||||
_quotere = re.compile(r'(\\*)("|\\$)') | ||||
|
r23682 | global _needsshellquote | ||
if _needsshellquote is None: | ||||
|
r24885 | # ":" is also treated as "safe character", because it is used as a part | ||
# of path name on Windows. "\" is also part of a path name, but isn't | ||||
# safe because shlex.split() (kind of) treats it as an escape char and | ||||
# drops it. It will leave the next character, even if it is another | ||||
# "\". | ||||
_needsshellquote = re.compile(r'[^a-zA-Z0-9._:/-]').search | ||||
|
r24108 | if s and not _needsshellquote(s) and not _quotere.search(s): | ||
|
r23682 | # "s" shouldn't have to be quoted | ||
return s | ||||
|
r7890 | return '"%s"' % _quotere.sub(r'\1\1\\\2', s) | ||
|
r36433 | def _unquote(s): | ||
if s.startswith(b'"') and s.endswith(b'"'): | ||||
return s[1:-1] | ||||
return s | ||||
def shellsplit(s): | ||||
"""Parse a command string in cmd.exe way (best-effort)""" | ||||
return pycompat.maplist(_unquote, pycompat.shlexsplit(s, posix=False)) | ||||
|
r7890 | def quotecommand(cmd): | ||
"""Build a command string suitable for os.popen* calls.""" | ||||
|
r13188 | if sys.version_info < (2, 7, 1): | ||
# Python versions since 2.7.1 do this extra quoting themselves | ||||
return '"' + cmd + '"' | ||||
return cmd | ||||
|
r7890 | |||
def popen(command, mode='r'): | ||||
# Work around "popen spawned process may not write to stdout | ||||
# under windows" | ||||
# http://bugs.python.org/issue1366 | ||||
|
r36475 | command += " 2> %s" % pycompat.bytestr(os.devnull) | ||
|
r7890 | return os.popen(quotecommand(command), mode) | ||
|
r14234 | def explainexit(code): | ||
|
r7890 | return _("exited with status %d") % code, code | ||
# if you change this stub into a real check, please try to implement the | ||||
# username and groupname functions above, too. | ||||
|
r8657 | def isowner(st): | ||
|
r7890 | return True | ||
|
r14271 | def findexe(command): | ||
|
r7890 | '''Find executable for command searching like cmd.exe does. | ||
If command is a basename then PATH is searched for command. | ||||
PATH isn't searched if command is an absolute or relative path. | ||||
An extension from PATHEXT is found and added if not present. | ||||
If command isn't found None is returned.''' | ||||
|
r30636 | pathext = encoding.environ.get('PATHEXT', '.COM;.EXE;.BAT;.CMD') | ||
|
r30612 | pathexts = [ext for ext in pathext.lower().split(pycompat.ospathsep)] | ||
|
r7890 | if os.path.splitext(command)[1].lower() in pathexts: | ||
pathexts = [''] | ||||
def findexisting(pathcommand): | ||||
'Will append extension (if needed) and return existing file' | ||||
for ext in pathexts: | ||||
executable = pathcommand + ext | ||||
if os.path.exists(executable): | ||||
return executable | ||||
return None | ||||
|
r30615 | if pycompat.ossep in command: | ||
|
r7890 | return findexisting(command) | ||
|
r30636 | for path in encoding.environ.get('PATH', '').split(pycompat.ospathsep): | ||
|
r7890 | executable = findexisting(os.path.join(path, command)) | ||
if executable is not None: | ||||
return executable | ||||
|
r10156 | return findexisting(os.path.expanduser(os.path.expandvars(command))) | ||
|
r7890 | |||
|
r32291 | _wantedkinds = {stat.S_IFREG, stat.S_IFLNK} | ||
|
r18017 | |||
|
r7890 | def statfiles(files): | ||
|
r18017 | '''Stat each file in files. Yield each stat, or None if a file | ||
does not exist or has a type we don't care about. | ||||
|
r7890 | Cluster and cache stat per directory to minimize number of OS stat calls.''' | ||
dircache = {} # dirname -> filename -> status | None if file does not exist | ||||
|
r18017 | getkind = stat.S_IFMT | ||
|
r7890 | for nf in files: | ||
|
r15637 | nf = normcase(nf) | ||
|
r9099 | dir, base = os.path.split(nf) | ||
if not dir: | ||||
dir = '.' | ||||
|
r7890 | cache = dircache.get(dir, None) | ||
if cache is None: | ||||
try: | ||||
|
r15637 | dmap = dict([(normcase(n), s) | ||
|
r32203 | for n, k, s in listdir(dir, True) | ||
|
r18041 | if getkind(s.st_mode) in _wantedkinds]) | ||
|
r25660 | except OSError as err: | ||
|
r7890 | # Python >= 2.5 returns ENOENT and adds winerror field | ||
# EINVAL is raised if dir is not a directory. | ||||
|
r25204 | if err.errno not in (errno.ENOENT, errno.EINVAL, | ||
|
r7890 | errno.ENOTDIR): | ||
raise | ||||
dmap = {} | ||||
cache = dircache.setdefault(dir, dmap) | ||||
yield cache.get(base, None) | ||||
def username(uid=None): | ||||
"""Return the name of the user with the given uid. | ||||
If uid is None, return the name of the current user.""" | ||||
return None | ||||
def groupname(gid=None): | ||||
"""Return the name of the group with the given gid. | ||||
If gid is None, return the name of the current group.""" | ||||
return None | ||||
|
r24692 | def removedirs(name): | ||
|
r8364 | """special version of os.removedirs that does not remove symlinked | ||
directories or junction points if they actually contain files""" | ||||
|
r32203 | if listdir(name): | ||
|
r8364 | return | ||
os.rmdir(name) | ||||
head, tail = os.path.split(name) | ||||
if not tail: | ||||
head, tail = os.path.split(head) | ||||
while head and tail: | ||||
try: | ||||
|
r32203 | if listdir(head): | ||
|
r8364 | return | ||
os.rmdir(head) | ||||
|
r14004 | except (ValueError, OSError): | ||
|
r8364 | break | ||
head, tail = os.path.split(head) | ||||
|
r9549 | def rename(src, dst): | ||
'''atomically rename file src to dst, replacing dst if it exists''' | ||||
try: | ||||
os.rename(src, dst) | ||||
|
r25660 | except OSError as e: | ||
|
r13278 | if e.errno != errno.EEXIST: | ||
raise | ||||
|
r13280 | unlink(dst) | ||
|
r9549 | os.rename(src, dst) | ||
|
r10239 | def gethgcmd(): | ||
return [sys.executable] + sys.argv[:1] | ||||
|
r11138 | def groupmembers(name): | ||
# Don't support groups on Windows for now | ||||
|
r16687 | raise KeyError | ||
|
r11138 | |||
|
r14926 | def isexec(f): | ||
return False | ||||
|
r14927 | class cachestat(object): | ||
def __init__(self, path): | ||||
pass | ||||
def cacheable(self): | ||||
return False | ||||
|
r16807 | def lookupreg(key, valname=None, scope=None): | ||
''' Look up a key/value name in the Windows registry. | ||||
valname: value name. If unspecified, the default value for the key | ||||
is used. | ||||
scope: optionally specify scope for registry lookup, this can be | ||||
a sequence of scopes to look up in order. Default (CURRENT_USER, | ||||
LOCAL_MACHINE). | ||||
''' | ||||
if scope is None: | ||||
|
r29760 | scope = (winreg.HKEY_CURRENT_USER, winreg.HKEY_LOCAL_MACHINE) | ||
|
r16807 | elif not isinstance(scope, (list, tuple)): | ||
scope = (scope,) | ||||
for s in scope: | ||||
try: | ||||
|
r29760 | val = winreg.QueryValueEx(winreg.OpenKey(s, key), valname)[0] | ||
|
r16807 | # never let a Unicode string escape into the wild | ||
|
r31447 | return encoding.unitolocal(val) | ||
|
r16807 | except EnvironmentError: | ||
pass | ||||
|
r8614 | expandglobs = True | ||
|
r18868 | |||
def statislink(st): | ||||
'''check whether a stat result is a symlink''' | ||||
return False | ||||
def statisexec(st): | ||||
'''check whether a stat result is an executable file''' | ||||
return False | ||||
|
r22245 | |||
|
r25420 | def poll(fds): | ||
# see posix.py for description | ||||
raise NotImplementedError() | ||||
|
r22245 | def readpipe(pipe): | ||
"""Read all available data from a pipe.""" | ||||
chunks = [] | ||||
while True: | ||||
|
r24653 | size = win32.peekpipe(pipe) | ||
|
r22245 | if not size: | ||
break | ||||
s = pipe.read(size) | ||||
if not s: | ||||
break | ||||
chunks.append(s) | ||||
return ''.join(chunks) | ||||
|
r29530 | |||
def bindunixsocket(sock, path): | ||||
raise NotImplementedError('unsupported platform') | ||||