annotate Lib/os.py @ 5817:48b94de85bf3 legacy-trunk

Extensive changes by AMK.
author Guido van Rossum <guido@python.org>
date Thu, 17 Jul 1997 16:29:42 +0000
parents 4f73962aaba6
children 24d668454cb0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1463
305748ebab43 Some minute changes.
Guido van Rossum <guido@python.org>
parents: 1403
diff changeset
1 # os.py -- either mac, dos or posix depending on what system we're on.
580
3169d38f6774 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
2
3169d38f6774 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
3 # This exports:
3169d38f6774 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
4 # - all functions from either posix or mac, e.g., os.unlink, os.stat, etc.
772
d945cf33a64f Added definition for pardir ('..')
Guido van Rossum <guido@python.org>
parents: 580
diff changeset
5 # - os.path is either module posixpath or macpath
580
3169d38f6774 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
6 # - os.name is either 'posix' or 'mac'
3169d38f6774 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
7 # - os.curdir is a string representing the current directory ('.' or ':')
772
d945cf33a64f Added definition for pardir ('..')
Guido van Rossum <guido@python.org>
parents: 580
diff changeset
8 # - os.pardir is a string representing the parent directory ('..' or '::')
806
259923e4d7b1 Add separator
Guido van Rossum <guido@python.org>
parents: 772
diff changeset
9 # - os.sep is the (or a most common) pathname separator ('/' or ':')
1745
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
10 # - os.pathsep is the component separator used in $PATH etc
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
11 # - os.defpath is the default search path for executables
580
3169d38f6774 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
12
3169d38f6774 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
13 # Programs that import and use 'os' stand a better chance of being
3169d38f6774 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
14 # portable between different platforms. Of course, they must then
3169d38f6774 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
15 # only use functions that are defined by all platforms (e.g., unlink
3169d38f6774 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
16 # and opendir), and leave all pathname manipulation to os.path
3169d38f6774 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
17 # (e.g., split and join).
3169d38f6774 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
18
1745
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
19 _osindex = {
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
20 'posix': ('.', '..', '/', ':', ':/bin:/usr/bin'),
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
21 'dos': ('.', '..', '\\', ';', '.;C:\\bin'),
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
22 'nt': ('.', '..', '\\', ';', '.;C:\\bin'),
2542
49df1576fb54 set mac path separator to newline
Guido van Rossum <guido@python.org>
parents: 2539
diff changeset
23 'mac': (':', '::', ':', '\n', ':'),
1745
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
24 }
772
d945cf33a64f Added definition for pardir ('..')
Guido van Rossum <guido@python.org>
parents: 580
diff changeset
25
1785
dd167bfd7a08 do fake "import posix" for freeze.py script
Guido van Rossum <guido@python.org>
parents: 1745
diff changeset
26 # For freeze.py script:
dd167bfd7a08 do fake "import posix" for freeze.py script
Guido van Rossum <guido@python.org>
parents: 1745
diff changeset
27 if 0:
dd167bfd7a08 do fake "import posix" for freeze.py script
Guido van Rossum <guido@python.org>
parents: 1745
diff changeset
28 import posix
1932
5bcaaed902f5 Import posixpath for freeze script
Guido van Rossum <guido@python.org>
parents: 1785
diff changeset
29 import posixpath
1785
dd167bfd7a08 do fake "import posix" for freeze.py script
Guido van Rossum <guido@python.org>
parents: 1745
diff changeset
30
1745
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
31 import sys
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
32 for name in _osindex.keys():
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
33 if name in sys.builtin_module_names:
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
34 curdir, pardir, sep, pathsep, defpath = _osindex[name]
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
35 exec 'from %s import *' % name
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
36 exec 'import %spath' % name
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
37 exec 'path = %spath' % name
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
38 exec 'del %spath' % name
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
39 try:
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
40 exec 'from %s import _exit' % name
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
41 except ImportError:
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
42 pass
2921
0c50ec8e8358 make sure os.environ exists (maybe empty)
Guido van Rossum <guido@python.org>
parents: 2542
diff changeset
43 try:
0c50ec8e8358 make sure os.environ exists (maybe empty)
Guido van Rossum <guido@python.org>
parents: 2542
diff changeset
44 environ
0c50ec8e8358 make sure os.environ exists (maybe empty)
Guido van Rossum <guido@python.org>
parents: 2542
diff changeset
45 except:
0c50ec8e8358 make sure os.environ exists (maybe empty)
Guido van Rossum <guido@python.org>
parents: 2542
diff changeset
46 environ = {} # Make sure os.environ exists, at least
1745
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
47 break
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
48 else:
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
49 del name
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
50 raise ImportError, 'no os specific module found'
1403
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
51
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
52 def execl(file, *args):
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
53 execv(file, args)
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
54
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
55 def execle(file, *args):
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
56 env = args[-1]
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
57 execve(file, args[:-1], env)
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
58
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
59 def execlp(file, *args):
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
60 execvp(file, args)
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
61
2539
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
62 def execlpe(file, *args):
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
63 env = args[-1]
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
64 execvpe(file, args[:-1], env)
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
65
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
66 def execvp(file, args):
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
67 _execvpe(file, args)
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
68
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
69 def execvpe(file, args, env):
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
70 _execvpe(file, args, env)
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
71
1745
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
72 _notfound = None
2539
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
73 def _execvpe(file, args, env = None):
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
74 if env:
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
75 func = execve
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
76 argrest = (args, env)
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
77 else:
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
78 func = execv
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
79 argrest = (args,)
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
80 env = environ
1745
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
81 global _notfound
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
82 head, tail = path.split(file)
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
83 if head:
2539
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
84 apply(func, (file,) + argrest)
1403
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
85 return
2539
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
86 if env.has_key('PATH'):
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
87 envpath = env['PATH']
1403
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
88 else:
1745
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
89 envpath = defpath
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
90 import string
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
91 PATH = string.splitfields(envpath, pathsep)
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
92 if not _notfound:
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
93 import tempfile
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
94 # Exec a file that is guaranteed not to exist
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
95 try: execv(tempfile.mktemp(), ())
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
96 except error, _notfound: pass
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
97 exc, arg = error, _notfound
1403
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
98 for dir in PATH:
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
99 fullname = path.join(dir, file)
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
100 try:
2539
534a97c400cc add execvpe -- mix of execvp and execve
Guido van Rossum <guido@python.org>
parents: 1932
diff changeset
101 apply(func, (fullname,) + argrest)
1403
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
102 except error, (errno, msg):
1745
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
103 if errno != arg[0]:
1403
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
104 exc, arg = error, (errno, msg)
6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret
Guido van Rossum <guido@python.org>
parents: 1197
diff changeset
105 raise exc, arg
1745
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
106
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
107 # Provide listdir for Windows NT that doesn't have it built in
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
108 if name == 'nt':
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
109 try:
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
110 _tmp = listdir
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
111 del _tmp
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
112 except NameError:
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
113 def listdir(name):
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
114 if path.ismount(name):
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
115 list = ['.']
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
116 else:
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
117 list = ['.', '..']
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
118 f = popen('dir/l/b ' + name, 'r')
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
119 line = f.readline()
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
120 while line:
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
121 list.append(line[:-1])
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
122 line = f.readline()
d5b67d2ec7ee Merge changes
Guido van Rossum <guido@python.org>
parents: 1463
diff changeset
123 return list
3805
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
124
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
125
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
126 # Change environ to automatically call putenv() if it exists
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
127 try:
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
128 _putenv = putenv
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
129 except NameError:
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
130 _putenv = None
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
131 if _putenv:
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
132 import UserDict
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
133
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
134 class _Environ(UserDict.UserDict):
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
135 def __init__(self, environ):
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
136 UserDict.UserDict.__init__(self)
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
137 self.data = environ
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
138 def __setitem__(self, key, item):
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
139 putenv(key, item)
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
140 self.data[key] = item
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
141
4f73962aaba6 Added hook to os.environ to call putenv(), if it exists.
Guido van Rossum <guido@python.org>
parents: 2921
diff changeset
142 environ = _Environ(environ)