summaryrefslogtreecommitdiffstats
path: root/Lib
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1997-08-28 14:32:14 (GMT)
committerGuido van Rossum <guido@python.org>1997-08-28 14:32:14 (GMT)
commit02840fdf84dc2dbbe01fe6c0da7397aa9e8a9420 (patch)
tree2d79a5642c64626bb65fe41b42232f87b525ed5f /Lib
parent522578e90fa2bfda46d97d09ffa3156cd8f98704 (diff)
downloadcpython-02840fdf84dc2dbbe01fe6c0da7397aa9e8a9420.zip
cpython-02840fdf84dc2dbbe01fe6c0da7397aa9e8a9420.tar.gz
cpython-02840fdf84dc2dbbe01fe6c0da7397aa9e8a9420.tar.bz2
user.py -- when imported, execfile(~/.pythonrc.py).
Diffstat (limited to 'Lib')
-rw-r--r--Lib/user.py38
1 files changed, 38 insertions, 0 deletions
diff --git a/Lib/user.py b/Lib/user.py
new file mode 100644
index 0000000..06e9ead
--- /dev/null
+++ b/Lib/user.py
@@ -0,0 +1,38 @@
+"""Hook to allow user-specified customization code to run.
+
+As a policy, Python doesn't run user-specified code on startup of
+Python programs (interactive sessions execute the script specified in
+the PYTHONPATH environment variable if it exists).
+
+However, some programs or sites may find it convenient to allow users
+to have a standard customization file, which gets run when a program
+requests it. This module implements such a mechanism. A program
+that wishes to use the mechanism mist execute the statement
+
+ import user
+
+The user module looks for a file .pythonrc.py in the user's home
+directory and if it can be opened, execfile()s it in its own global
+namespace. Errors during this phase are not caught; that's up to the
+program that imports the user module, if it wishes.
+
+The user's .pythonrc.py could conceivably test for sys.version if it
+wishes to do different things depending on the Python version.
+
+"""
+
+import os
+
+try:
+ home = os.environ['HOME']
+except:
+ home = os.curdir
+
+pythonrc = os.path.join(home, ".pythonrc.py")
+try:
+ f = open(pythonrc)
+except IOError:
+ pass
+else:
+ f.close()
+ execfile(pythonrc)