posix.py
706 lines
| 22.1 KiB
| text/x-python
|
PythonLexer
/ mercurial / posix.py
|
r8226 | # posix.py - Posix 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 | |||
|
r25967 | from __future__ import absolute_import | ||
import errno | ||||
import fcntl | ||||
import getpass | ||||
import grp | ||||
import os | ||||
import pwd | ||||
import re | ||||
|
r25420 | import select | ||
|
r25967 | import stat | ||
import sys | ||||
import tempfile | ||||
import unicodedata | ||||
from .i18n import _ | ||||
from . import ( | ||||
encoding, | ||||
|
r33724 | error, | ||
|
r35527 | policy, | ||
|
r30612 | pycompat, | ||
|
r25967 | ) | ||
|
r7890 | |||
|
r35527 | osutil = policy.importmod(r'osutil') | ||
|
r9031 | posixfile = open | ||
|
r7890 | normpath = os.path.normpath | ||
samestat = os.path.samestat | ||||
|
r27236 | try: | ||
oslink = os.link | ||||
except AttributeError: | ||||
# Some platforms build Python without os.link on systems that are | ||||
# vaguely unix-like but don't have hardlink support. For those | ||||
# poor souls, just say we tried and that it failed so we fall back | ||||
# to copies. | ||||
def oslink(src, dst): | ||||
raise OSError(errno.EINVAL, | ||||
'hardlinks not supported: %s to %s' % (src, dst)) | ||||
|
r39940 | readlink = os.readlink | ||
|
r13280 | unlink = os.unlink | ||
|
r9549 | rename = os.rename | ||
|
r24692 | removedirs = os.removedirs | ||
|
r8614 | expandglobs = False | ||
|
r7890 | |||
umask = os.umask(0) | ||||
os.umask(umask) | ||||
|
r17560 | def split(p): | ||
|
r18288 | '''Same as posixpath.split, but faster | ||
>>> import posixpath | ||||
|
r34133 | >>> for f in [b'/absolute/path/to/file', | ||
... b'relative/path/to/file', | ||||
... b'file_alone', | ||||
... b'path/to/directory/', | ||||
... b'/multiple/path//separators', | ||||
... b'/file_at_root', | ||||
... b'///multiple_leading_separators_at_root', | ||||
... b'']: | ||||
|
r18288 | ... assert split(f) == posixpath.split(f), f | ||
''' | ||||
|
r17560 | ht = p.rsplit('/', 1) | ||
if len(ht) == 1: | ||||
return '', p | ||||
nh = ht[0].rstrip('/') | ||||
if nh: | ||||
return nh, ht[1] | ||||
|
r18288 | return ht[0] + '/', ht[1] | ||
|
r17560 | |||
|
r7890 | def openhardlinks(): | ||
'''return true if it is safe to hold open file handles to hardlinks''' | ||||
return True | ||||
|
r13375 | def nlinks(name): | ||
'''return number of hardlinks for the given file''' | ||||
return os.lstat(name).st_nlink | ||||
|
r14231 | def parsepatchoutput(output_line): | ||
|
r8761 | """parses the output produced by patch and returns the filename""" | ||
|
r7890 | pf = output_line[14:] | ||
|
r30642 | if pycompat.sysplatform == 'OpenVMS': | ||
|
r7890 | if pf[0] == '`': | ||
pf = pf[1:-1] # Remove the quotes | ||||
else: | ||||
|
r8219 | if pf.startswith("'") and pf.endswith("'") and " " in pf: | ||
|
r7890 | pf = pf[1:-1] # Remove the quotes | ||
return pf | ||||
def sshargs(sshcmd, host, user, port): | ||||
'''Build argument list for ssh''' | ||||
args = user and ("%s@%s" % (user, host)) or host | ||||
|
r33732 | if '-' in args[:1]: | ||
|
r33724 | raise error.Abort( | ||
_('illegal ssh hostname or username starting with -: %s') % args) | ||||
|
r33732 | args = shellquote(args) | ||
if port: | ||||
args = '-p %s %s' % (shellquote(port), args) | ||||
return args | ||||
|
r7890 | |||
|
r14273 | def isexec(f): | ||
|
r7890 | """check whether a file is executable""" | ||
|
r25658 | return (os.lstat(f).st_mode & 0o100 != 0) | ||
|
r7890 | |||
|
r14232 | def setflags(f, l, x): | ||
|
r32721 | st = os.lstat(f) | ||
s = st.st_mode | ||||
|
r7890 | if l: | ||
if not stat.S_ISLNK(s): | ||||
# switch file to link | ||||
|
r36321 | fp = open(f, 'rb') | ||
|
r13400 | data = fp.read() | ||
fp.close() | ||||
|
r31537 | unlink(f) | ||
|
r7890 | try: | ||
os.symlink(data, f) | ||||
|
r14004 | except OSError: | ||
|
r7890 | # failed to make a link, rewrite file | ||
|
r36321 | fp = open(f, "wb") | ||
|
r13400 | fp.write(data) | ||
fp.close() | ||||
|
r7890 | # no chmod needed at this point | ||
return | ||||
if stat.S_ISLNK(s): | ||||
# switch link to file | ||||
data = os.readlink(f) | ||||
|
r31537 | unlink(f) | ||
|
r36321 | fp = open(f, "wb") | ||
|
r13400 | fp.write(data) | ||
fp.close() | ||||
|
r25658 | s = 0o666 & ~umask # avoid restatting for chmod | ||
|
r7890 | |||
|
r25658 | sx = s & 0o100 | ||
|
r32721 | if st.st_nlink > 1 and bool(x) != bool(sx): | ||
# the file is a hardlink, break it | ||||
with open(f, "rb") as fp: | ||||
data = fp.read() | ||||
unlink(f) | ||||
with open(f, "wb") as fp: | ||||
fp.write(data) | ||||
|
r7890 | if x and not sx: | ||
# Turn on +x for every +r bit when making a file executable | ||||
# and obey umask. | ||||
|
r25658 | os.chmod(f, s | (s & 0o444) >> 2 & ~umask) | ||
|
r7890 | elif not x and sx: | ||
# Turn off all +x bits | ||||
|
r25658 | os.chmod(f, s & 0o666) | ||
|
r7890 | |||
|
r41325 | def copymode(src, dst, mode=None, enforcewritable=False): | ||
|
r15011 | '''Copy the file mode from the file at path src to dst. | ||
If src doesn't exist, we're using mode instead. If mode is None, we're | ||||
using umask.''' | ||||
try: | ||||
|
r25658 | st_mode = os.lstat(src).st_mode & 0o777 | ||
|
r25660 | except OSError as inst: | ||
|
r15011 | if inst.errno != errno.ENOENT: | ||
raise | ||||
st_mode = mode | ||||
if st_mode is None: | ||||
st_mode = ~umask | ||||
|
r25658 | st_mode &= 0o666 | ||
|
r41325 | |||
new_mode = st_mode | ||||
if enforcewritable: | ||||
new_mode |= stat.S_IWUSR | ||||
os.chmod(dst, new_mode) | ||||
|
r15011 | |||
|
r13879 | def checkexec(path): | ||
""" | ||||
Check whether the given path is on a filesystem with UNIX-like exec flags | ||||
Requires a directory (like /foo/.hg) | ||||
""" | ||||
# VFAT on some Linux versions can flip mode but it doesn't persist | ||||
# a FS remount. Frequently we can detect it if files are created | ||||
# with exec bit on. | ||||
try: | ||||
EXECFLAGS = stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH | ||||
|
r40703 | basedir = os.path.join(path, '.hg') | ||
|
r40823 | cachedir = os.path.join(basedir, 'wcache') | ||
|
r40703 | storedir = os.path.join(basedir, 'store') | ||
if not os.path.exists(cachedir): | ||||
try: | ||||
# we want to create the 'cache' directory, not the '.hg' one. | ||||
# Automatically creating '.hg' directory could silently spawn | ||||
# invalid Mercurial repositories. That seems like a bad idea. | ||||
os.mkdir(cachedir) | ||||
if os.path.exists(storedir): | ||||
copymode(storedir, cachedir) | ||||
else: | ||||
copymode(basedir, cachedir) | ||||
except (IOError, OSError): | ||||
# we other fallback logic triggers | ||||
pass | ||||
|
r30446 | if os.path.isdir(cachedir): | ||
checkisexec = os.path.join(cachedir, 'checkisexec') | ||||
checknoexec = os.path.join(cachedir, 'checknoexec') | ||||
try: | ||||
m = os.stat(checkisexec).st_mode | ||||
except OSError as e: | ||||
if e.errno != errno.ENOENT: | ||||
raise | ||||
# checkisexec does not exist - fall through ... | ||||
else: | ||||
# checkisexec exists, check if it actually is exec | ||||
if m & EXECFLAGS != 0: | ||||
# ensure checkisexec exists, check it isn't exec | ||||
try: | ||||
m = os.stat(checknoexec).st_mode | ||||
except OSError as e: | ||||
if e.errno != errno.ENOENT: | ||||
raise | ||||
|
r31505 | open(checknoexec, 'w').close() # might fail | ||
|
r30446 | m = os.stat(checknoexec).st_mode | ||
if m & EXECFLAGS == 0: | ||||
# check-exec is exec and check-no-exec is not exec | ||||
return True | ||||
# checknoexec exists but is exec - delete it | ||||
|
r31537 | unlink(checknoexec) | ||
|
r30446 | # checkisexec exists but is not exec - delete it | ||
|
r31537 | unlink(checkisexec) | ||
|
r30446 | |||
# check using one file, leave it as checkisexec | ||||
checkdir = cachedir | ||||
else: | ||||
# check directly in path and don't leave checkisexec behind | ||||
checkdir = path | ||||
checkisexec = None | ||||
|
r38182 | fh, fn = pycompat.mkstemp(dir=checkdir, prefix='hg-checkexec-') | ||
|
r13879 | try: | ||
os.close(fh) | ||||
|
r30445 | m = os.stat(fn).st_mode | ||
|
r30446 | if m & EXECFLAGS == 0: | ||
os.chmod(fn, m & 0o777 | EXECFLAGS) | ||||
if os.stat(fn).st_mode & EXECFLAGS != 0: | ||||
if checkisexec is not None: | ||||
os.rename(fn, checkisexec) | ||||
fn = None | ||||
return True | ||||
|
r13879 | finally: | ||
|
r30446 | if fn is not None: | ||
|
r31537 | unlink(fn) | ||
|
r13879 | except (IOError, OSError): | ||
# we don't care, the user probably won't be able to commit anyway | ||||
return False | ||||
|
r13890 | def checklink(path): | ||
"""check whether the given path is on a symlink-capable filesystem""" | ||||
# mktemp is not racy because symlink creation will fail if the | ||||
# file already exists | ||||
|
r26883 | while True: | ||
|
r40823 | cachedir = os.path.join(path, '.hg', 'wcache') | ||
|
r30448 | checklink = os.path.join(cachedir, 'checklink') | ||
# try fast path, read only | ||||
if os.path.islink(checklink): | ||||
return True | ||||
|
r30447 | if os.path.isdir(cachedir): | ||
checkdir = cachedir | ||||
else: | ||||
checkdir = path | ||||
cachedir = None | ||||
|
r38184 | name = tempfile.mktemp(dir=pycompat.fsdecode(checkdir), | ||
|
r31506 | prefix=r'checklink-') | ||
name = pycompat.fsencode(name) | ||||
|
r22946 | try: | ||
|
r30555 | fd = None | ||
if cachedir is None: | ||||
|
r38184 | fd = pycompat.namedtempfile(dir=checkdir, | ||
prefix='hg-checklink-') | ||||
target = os.path.basename(fd.name) | ||||
|
r30555 | else: | ||
# create a fixed file to link to; doesn't matter if it | ||||
# already exists. | ||||
target = 'checklink-target' | ||||
|
r32393 | try: | ||
|
r36966 | fullpath = os.path.join(cachedir, target) | ||
open(fullpath, 'w').close() | ||||
|
r32393 | except IOError as inst: | ||
if inst[0] == errno.EACCES: | ||||
# If we can't write to cachedir, just pretend | ||||
# that the fs is readonly and by association | ||||
# that the fs won't support symlinks. This | ||||
# seems like the least dangerous way to avoid | ||||
# data loss. | ||||
return False | ||||
raise | ||||
|
r26883 | try: | ||
|
r30555 | os.symlink(target, name) | ||
|
r30448 | if cachedir is None: | ||
|
r31537 | unlink(name) | ||
|
r30448 | else: | ||
try: | ||||
os.rename(name, checklink) | ||||
except OSError: | ||||
|
r31537 | unlink(name) | ||
|
r26883 | return True | ||
except OSError as inst: | ||||
# link creation might race, try again | ||||
|
r37953 | if inst.errno == errno.EEXIST: | ||
|
r26883 | continue | ||
|
r26889 | raise | ||
|
r26883 | finally: | ||
|
r30555 | if fd is not None: | ||
fd.close() | ||||
|
r26883 | except AttributeError: | ||
return False | ||||
|
r26889 | except OSError as inst: | ||
# sshfs might report failure while successfully creating the link | ||||
|
r37953 | if inst.errno == errno.EIO and os.path.exists(name): | ||
|
r31537 | unlink(name) | ||
|
r26889 | return False | ||
|
r13890 | |||
|
r13916 | def checkosfilename(path): | ||
'''Check that the base-relative path is a valid filename on this platform. | ||||
Returns None if the path is ok, or a UI string describing the problem.''' | ||||
|
r34382 | return None # on posix platforms, every path is ok | ||
|
r13916 | |||
|
r35531 | def getfsmountpoint(dirpath): | ||
'''Get the filesystem mount point from a directory (best-effort) | ||||
Returns None if we are unsure. Raises OSError on ENOENT, EPERM, etc. | ||||
''' | ||||
return getattr(osutil, 'getfsmountpoint', lambda x: None)(dirpath) | ||||
|
r35527 | def getfstype(dirpath): | ||
'''Get the filesystem type name from a directory (best-effort) | ||||
Returns None if we are unsure. Raises OSError on ENOENT, EPERM, etc. | ||||
''' | ||||
return getattr(osutil, 'getfstype', lambda x: None)(dirpath) | ||||
|
r14233 | def setbinary(fd): | ||
|
r7890 | pass | ||
def pconvert(path): | ||||
return path | ||||
def localpath(path): | ||||
return path | ||||
|
r10218 | def samefile(fpath1, fpath2): | ||
"""Returns whether path1 and path2 refer to the same file. This is only | ||||
guaranteed to work for files, not directories.""" | ||||
return os.path.samefile(fpath1, fpath2) | ||||
def samedevice(fpath1, fpath2): | ||||
"""Returns whether fpath1 and fpath2 are on the same device. This is only | ||||
guaranteed to work for files, not directories.""" | ||||
st1 = os.lstat(fpath1) | ||||
st2 = os.lstat(fpath2) | ||||
return st1.st_dev == st2.st_dev | ||||
|
r15488 | # os.path.normcase is a no-op, which doesn't help us on non-native filesystems | ||
def normcase(path): | ||||
return path.lower() | ||||
|
r24594 | # what normcase does to ASCII strings | ||
normcasespec = encoding.normcasespecs.lower | ||||
# fallback normcase function for non-ASCII strings | ||||
normcasefallback = normcase | ||||
|
r34648 | if pycompat.isdarwin: | ||
|
r15551 | |||
def normcase(path): | ||||
|
r19131 | ''' | ||
Normalize a filename for OS X-compatible comparison: | ||||
- escape-encode invalid characters | ||||
- decompose to NFD | ||||
- lowercase | ||||
|
r23597 | - omit ignored characters [200c-200f, 202a-202e, 206a-206f,feff] | ||
|
r19131 | |||
|
r34133 | >>> normcase(b'UPPER') | ||
|
r19131 | 'upper' | ||
|
r34196 | >>> normcase(b'Caf\\xc3\\xa9') | ||
|
r19131 | 'cafe\\xcc\\x81' | ||
|
r34196 | >>> normcase(b'\\xc3\\x89') | ||
|
r19131 | 'e\\xcc\\x81' | ||
|
r34196 | >>> normcase(b'\\xb8\\xca\\xc3\\xca\\xbe\\xc8.JPG') # issue3918 | ||
|
r19131 | '%b8%ca%c3\\xca\\xbe%c8.jpg' | ||
''' | ||||
|
r15551 | try: | ||
|
r22781 | return encoding.asciilower(path) # exception for non-ASCII | ||
|
r18501 | except UnicodeDecodeError: | ||
|
r24595 | return normcasefallback(path) | ||
normcasespec = encoding.normcasespecs.lower | ||||
def normcasefallback(path): | ||||
|
r18501 | try: | ||
|
r15551 | u = path.decode('utf-8') | ||
except UnicodeDecodeError: | ||||
|
r19131 | # OS X percent-encodes any bytes that aren't valid utf-8 | ||
s = '' | ||||
|
r26876 | pos = 0 | ||
|
r27380 | l = len(path) | ||
|
r26876 | while pos < l: | ||
try: | ||||
c = encoding.getutf8char(path, pos) | ||||
pos += len(c) | ||||
except ValueError: | ||||
|
r34198 | c = '%%%02X' % ord(path[pos:pos + 1]) | ||
|
r26876 | pos += 1 | ||
s += c | ||||
|
r19131 | |||
|
r15551 | u = s.decode('utf-8') | ||
# Decompose then lowercase (HFS+ technote specifies lower) | ||||
|
r34199 | enc = unicodedata.normalize(r'NFD', u).lower().encode('utf-8') | ||
|
r23597 | # drop HFS+ ignored characters | ||
return encoding.hfsignoreclean(enc) | ||||
|
r15551 | |||
|
r30641 | if pycompat.sysplatform == 'cygwin': | ||
|
r15711 | # workaround for cygwin, in which mount point part of path is | ||
# treated as case sensitive, even though underlying NTFS is case | ||||
# insensitive. | ||||
# default mount points | ||||
cygwinmountpoints = sorted([ | ||||
"/usr/bin", | ||||
"/usr/lib", | ||||
"/cygdrive", | ||||
], reverse=True) | ||||
# use upper-ing as normcase as same as NTFS workaround | ||||
def normcase(path): | ||||
pathlen = len(path) | ||||
|
r30614 | if (pathlen == 0) or (path[0] != pycompat.ossep): | ||
|
r15711 | # treat as relative | ||
|
r17203 | return encoding.upper(path) | ||
|
r15711 | |||
# to preserve case of mountpoint part | ||||
for mp in cygwinmountpoints: | ||||
if not path.startswith(mp): | ||||
continue | ||||
mplen = len(mp) | ||||
if mplen == pathlen: # mount point itself | ||||
return mp | ||||
|
r30614 | if path[mplen] == pycompat.ossep: | ||
|
r17203 | return mp + encoding.upper(path[mplen:]) | ||
|
r15711 | |||
|
r17203 | return encoding.upper(path) | ||
|
r15711 | |||
|
r24596 | normcasespec = encoding.normcasespecs.other | ||
normcasefallback = normcase | ||||
|
r16240 | # Cygwin translates native ACLs to POSIX permissions, | ||
# but these translations are not supported by native | ||||
# tools, so the exec bit tends to be set erroneously. | ||||
# Therefore, disable executable bit access on Cygwin. | ||||
def checkexec(path): | ||||
return False | ||||
|
r16241 | # Similarly, Cygwin's symlink emulation is likely to create | ||
# problems when Mercurial is used from both Cygwin and native | ||||
# Windows, with other native tools, or on shared volumes | ||||
def checklink(path): | ||||
return False | ||||
|
r23683 | _needsshellquote = None | ||
|
r7890 | def shellquote(s): | ||
|
r30642 | if pycompat.sysplatform == 'OpenVMS': | ||
|
r7890 | return '"%s"' % s | ||
|
r23683 | global _needsshellquote | ||
if _needsshellquote is None: | ||||
|
r31491 | _needsshellquote = re.compile(br'[^a-zA-Z0-9._/+-]').search | ||
|
r24108 | if s and not _needsshellquote(s): | ||
|
r23683 | # "s" shouldn't have to be quoted | ||
return s | ||||
|
r7890 | else: | ||
return "'%s'" % s.replace("'", "'\\''") | ||||
|
r36433 | def shellsplit(s): | ||
"""Parse a command string in POSIX shell way (best-effort)""" | ||||
return pycompat.shlexsplit(s, posix=True) | ||||
|
r7890 | def quotecommand(cmd): | ||
return cmd | ||||
def testpid(pid): | ||||
'''return False if pid dead, True if running or not sure''' | ||||
|
r30642 | if pycompat.sysplatform == 'OpenVMS': | ||
|
r7890 | return True | ||
try: | ||||
os.kill(pid, 0) | ||||
return True | ||||
|
r25660 | except OSError as inst: | ||
|
r7890 | return inst.errno != errno.ESRCH | ||
|
r8657 | def isowner(st): | ||
"""Return True if the stat object st is from the current user.""" | ||||
|
r7890 | return st.st_uid == os.getuid() | ||
|
r14271 | def findexe(command): | ||
|
r7890 | '''Find executable for command searching like which does. | ||
If command is a basename then PATH is searched for command. | ||||
PATH isn't searched if command is an absolute or relative path. | ||||
If command isn't found None is returned.''' | ||||
|
r30641 | if pycompat.sysplatform == 'OpenVMS': | ||
|
r7890 | return command | ||
def findexisting(executable): | ||||
'Will return executable if existing file' | ||||
|
r15499 | if os.path.isfile(executable) and os.access(executable, os.X_OK): | ||
|
r7890 | return executable | ||
return None | ||||
|
r30614 | if pycompat.ossep in command: | ||
|
r7890 | return findexisting(command) | ||
|
r30641 | if pycompat.sysplatform == 'plan9': | ||
|
r16383 | return findexisting(os.path.join('/bin', command)) | ||
|
r30634 | for path in encoding.environ.get('PATH', '').split(pycompat.ospathsep): | ||
|
r7890 | executable = findexisting(os.path.join(path, command)) | ||
if executable is not None: | ||||
|
r15499 | return executable | ||
|
r7890 | return None | ||
|
r14237 | def setsignalhandler(): | ||
|
r7890 | pass | ||
|
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 | lstat = os.lstat | ||
|
r18017 | getkind = stat.S_IFMT | ||
|
r7890 | for nf in files: | ||
try: | ||||
st = lstat(nf) | ||||
|
r18017 | if getkind(st.st_mode) not in _wantedkinds: | ||
st = None | ||||
|
r25660 | except OSError as err: | ||
|
r7890 | if err.errno not in (errno.ENOENT, errno.ENOTDIR): | ||
raise | ||||
st = None | ||||
yield st | ||||
def getuser(): | ||||
'''return name of current user''' | ||||
|
r32129 | return pycompat.fsencode(getpass.getuser()) | ||
|
r7890 | |||
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.""" | ||||
if uid is None: | ||||
uid = os.getuid() | ||||
try: | ||||
|
r38271 | return pycompat.fsencode(pwd.getpwuid(uid)[0]) | ||
|
r7890 | except KeyError: | ||
|
r38271 | return b'%d' % uid | ||
|
r7890 | |||
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.""" | ||||
if gid is None: | ||||
gid = os.getgid() | ||||
try: | ||||
return grp.getgrgid(gid)[0] | ||||
except KeyError: | ||||
return str(gid) | ||||
|
r10237 | |||
|
r11138 | def groupmembers(name): | ||
"""Return the list of members of the group with the given | ||||
name, KeyError if the group does not exist. | ||||
""" | ||||
|
r41645 | name = pycompat.sysstr(name) | ||
|
r11138 | return list(grp.getgrnam(name).gr_mem) | ||
|
r10237 | def spawndetached(args): | ||
return os.spawnvp(os.P_NOWAIT | getattr(os, 'P_DETACH', 0), | ||||
args[0], args) | ||||
|
r10239 | def gethgcmd(): | ||
return sys.argv[:1] | ||||
|
r11010 | |||
|
r14908 | def makedir(path, notindexed): | ||
os.mkdir(path) | ||||
|
r14909 | |||
|
r14910 | def lookupreg(key, name=None, scope=None): | ||
return None | ||||
|
r14911 | |||
def hidewindow(): | ||||
"""Hide current shell window. | ||||
Used to hide the window opened when starting asynchronous | ||||
child process under Windows, unneeded on other systems. | ||||
""" | ||||
pass | ||||
|
r14926 | |||
|
r14927 | class cachestat(object): | ||
def __init__(self, path): | ||||
self.stat = os.stat(path) | ||||
def cacheable(self): | ||||
return bool(self.stat.st_ino) | ||||
|
r15791 | __hash__ = object.__hash__ | ||
|
r14927 | def __eq__(self, other): | ||
try: | ||||
|
r18442 | # Only dev, ino, size, mtime and atime are likely to change. Out | ||
# of these, we shouldn't compare atime but should compare the | ||||
# rest. However, one of the other fields changing indicates | ||||
# something fishy going on, so return False if anything but atime | ||||
# changes. | ||||
return (self.stat.st_mode == other.stat.st_mode and | ||||
self.stat.st_ino == other.stat.st_ino and | ||||
self.stat.st_dev == other.stat.st_dev and | ||||
self.stat.st_nlink == other.stat.st_nlink and | ||||
self.stat.st_uid == other.stat.st_uid and | ||||
self.stat.st_gid == other.stat.st_gid and | ||||
self.stat.st_size == other.stat.st_size and | ||||
|
r36799 | self.stat[stat.ST_MTIME] == other.stat[stat.ST_MTIME] and | ||
self.stat[stat.ST_CTIME] == other.stat[stat.ST_CTIME]) | ||||
|
r14927 | except AttributeError: | ||
return False | ||||
def __ne__(self, other): | ||||
return not self == other | ||||
|
r18868 | def statislink(st): | ||
'''check whether a stat result is a symlink''' | ||||
return st and stat.S_ISLNK(st.st_mode) | ||||
def statisexec(st): | ||||
'''check whether a stat result is an executable file''' | ||||
|
r25658 | return st and (st.st_mode & 0o100 != 0) | ||
|
r22245 | |||
|
r25420 | def poll(fds): | ||
"""block until something happens on any file descriptor | ||||
This is a generic helper that will check for any activity | ||||
(read, write. exception) and return the list of touched files. | ||||
In unsupported cases, it will raise a NotImplementedError""" | ||||
try: | ||||
|
r30654 | while True: | ||
try: | ||||
res = select.select(fds, fds, fds) | ||||
break | ||||
except select.error as inst: | ||||
if inst.args[0] == errno.EINTR: | ||||
continue | ||||
raise | ||||
|
r25420 | except ValueError: # out of range file descriptor | ||
raise NotImplementedError() | ||||
return sorted(list(set(sum(res, [])))) | ||||
|
r22245 | def readpipe(pipe): | ||
"""Read all available data from a pipe.""" | ||||
|
r22246 | # We can't fstat() a pipe because Linux will always report 0. | ||
# So, we set the pipe to non-blocking mode and read everything | ||||
# that's available. | ||||
flags = fcntl.fcntl(pipe, fcntl.F_GETFL) | ||||
flags |= os.O_NONBLOCK | ||||
oldflags = fcntl.fcntl(pipe, fcntl.F_SETFL, flags) | ||||
|
r22245 | |||
|
r22246 | try: | ||
chunks = [] | ||||
while True: | ||||
try: | ||||
s = pipe.read() | ||||
if not s: | ||||
break | ||||
chunks.append(s) | ||||
except IOError: | ||||
break | ||||
return ''.join(chunks) | ||||
finally: | ||||
fcntl.fcntl(pipe, fcntl.F_SETFL, oldflags) | ||||
|
r29530 | |||
def bindunixsocket(sock, path): | ||||
"""Bind the UNIX domain socket to the specified path""" | ||||
# use relative path instead of full path at bind() if possible, since | ||||
# AF_UNIX path has very small length limit (107 chars) on common | ||||
# platforms (see sys/un.h) | ||||
dirname, basename = os.path.split(path) | ||||
bakwdfd = None | ||||
if dirname: | ||||
bakwdfd = os.open('.', os.O_DIRECTORY) | ||||
os.chdir(dirname) | ||||
sock.bind(basename) | ||||
if bakwdfd: | ||||
os.fchdir(bakwdfd) | ||||
os.close(bakwdfd) | ||||