blob: b4d7cdf6bedc1194230caf59f8ca5f46baead799 [file] [log] [blame]
Guido van Rossum667d7041995-08-04 04:20:48 +00001/* Python interpreter main program */
2
3#include "Python.h"
Guido van Rossuma075ce11997-12-05 21:56:45 +00004#include "osdefs.h"
Guido van Rossum667d7041995-08-04 04:20:48 +00005
Guido van Rossum66a70131996-12-09 18:46:58 +00006#ifdef HAVE_UNISTD_H
7#include <unistd.h>
8#endif
Guido van Rossum667d7041995-08-04 04:20:48 +00009
Guido van Rossum3e7ae7a1997-01-17 22:05:38 +000010#ifdef MS_WINDOWS
11#include <fcntl.h>
12#endif
13
Guido van Rossuma075ce11997-12-05 21:56:45 +000014#if defined(PYOS_OS2) || defined(MS_WINDOWS)
15#define PYTHONHOMEHELP "<prefix>\\lib"
16#else
Fredrik Lundh620f3772000-07-09 20:42:34 +000017#define PYTHONHOMEHELP "<prefix>/python2.0"
Guido van Rossuma075ce11997-12-05 21:56:45 +000018#endif
19
Guido van Rossuma22865e2000-09-05 04:41:18 +000020#define COPYRIGHT \
21 "Type \"copyright\", \"credits\" or \"license\" for more information."
22
Guido van Rossum667d7041995-08-04 04:20:48 +000023/* Interface to getopt(): */
24extern int optind;
25extern char *optarg;
26extern int getopt(); /* PROTO((int, char **, char *)); -- not standardized */
27
28
Guido van Rossumac56b031996-07-21 02:33:38 +000029/* For Py_GetArgcArgv(); set by main() */
Guido van Rossum667d7041995-08-04 04:20:48 +000030static char **orig_argv;
31static int orig_argc;
32
Guido van Rossum667d7041995-08-04 04:20:48 +000033/* Short usage message (with %s for argv0) */
34static char *usage_line =
Guido van Rossum6b86a421999-01-28 15:07:47 +000035"usage: %s [option] ... [-c cmd | file | -] [arg] ...\n";
Guido van Rossum667d7041995-08-04 04:20:48 +000036
37/* Long usage message, split into parts < 512 bytes */
Guido van Rossuma075ce11997-12-05 21:56:45 +000038static char *usage_top = "\
Guido van Rossum667d7041995-08-04 04:20:48 +000039Options and arguments (and corresponding environment variables):\n\
40-d : debug output from parser (also PYTHONDEBUG=x)\n\
Guido van Rossum775af911997-02-14 19:50:32 +000041-i : inspect interactively after running script, (also PYTHONINSPECT=x)\n\
Guido van Rossumbba92ca1998-04-10 19:39:15 +000042 and force prompts, even if stdin does not appear to be a terminal\n\
Guido van Rossume7adf3e1998-10-07 14:50:06 +000043-O : optimize generated bytecode (a tad; also PYTHONOPTIMIZE=x)\n\
Guido van Rossum6b86a421999-01-28 15:07:47 +000044-OO : remove doc-strings in addition to the -O optimizations\n\
Guido van Rossum7922bd71997-08-29 22:34:47 +000045-S : don't imply 'import site' on initialization\n\
Guido van Rossumbba92ca1998-04-10 19:39:15 +000046-t : issue warnings about inconsistent tab usage (-tt: issue errors)\n\
Guido van Rossum667d7041995-08-04 04:20:48 +000047";
Guido van Rossum7922bd71997-08-29 22:34:47 +000048static char *usage_mid = "\
Guido van Rossumbba92ca1998-04-10 19:39:15 +000049-u : unbuffered binary stdout and stderr (also PYTHONUNBUFFERED=x)\n\
Guido van Rossumc15a9a12000-05-01 17:54:33 +000050-U : Unicode literals: treats '...' literals like u'...'\n\
Guido van Rossum7922bd71997-08-29 22:34:47 +000051-v : verbose (trace import statements) (also PYTHONVERBOSE=x)\n\
Guido van Rossuma075ce11997-12-05 21:56:45 +000052-x : skip first line of source, allowing use of non-Unix forms of #!cmd\n\
Barry Warsaw3b2aedb2000-09-15 18:40:42 +000053-h : print this help message and exit\n\
54-V : print the Python version number and exit\n\
Guido van Rossum775af911997-02-14 19:50:32 +000055-c cmd : program passed in as string (terminates option list)\n\
Guido van Rossum667d7041995-08-04 04:20:48 +000056file : program read from script file\n\
57- : program read from stdin (default; interactive mode if a tty)\n\
Guido van Rossum7922bd71997-08-29 22:34:47 +000058";
59static char *usage_bot = "\
Guido van Rossumbba92ca1998-04-10 19:39:15 +000060arg ...: arguments passed to program in sys.argv[1:]\n\
Guido van Rossum667d7041995-08-04 04:20:48 +000061Other environment variables:\n\
62PYTHONSTARTUP: file executed on interactive startup (no default)\n\
Guido van Rossuma075ce11997-12-05 21:56:45 +000063PYTHONPATH : '%c'-separated list of directories prefixed to the\n\
Guido van Rossum667d7041995-08-04 04:20:48 +000064 default module search path. The result is sys.path.\n\
Guido van Rossuma075ce11997-12-05 21:56:45 +000065PYTHONHOME : alternate <prefix> directory (or <prefix>%c<exec_prefix>).\n\
66 The default module search path uses %s.\n\
Guido van Rossum667d7041995-08-04 04:20:48 +000067";
68
69
Barry Warsaw3b2aedb2000-09-15 18:40:42 +000070static void
71usage(int exitcode, char* program)
72{
73 fprintf(stderr, usage_line, program);
74 fprintf(stderr, usage_top);
75 fprintf(stderr, usage_mid);
76 fprintf(stderr, usage_bot, DELIM, DELIM, PYTHONHOMEHELP);
77 exit(exitcode);
78 /*NOTREACHED*/
79}
80
81
Guido van Rossum667d7041995-08-04 04:20:48 +000082/* Main program */
83
Guido van Rossum9c1201f1998-12-07 14:28:47 +000084DL_EXPORT(int)
Fredrik Lundh620f3772000-07-09 20:42:34 +000085Py_Main(int argc, char **argv)
Guido van Rossum667d7041995-08-04 04:20:48 +000086{
87 int c;
88 int sts;
89 char *command = NULL;
90 char *filename = NULL;
91 FILE *fp = stdin;
92 char *p;
93 int inspect = 0;
94 int unbuffered = 0;
Guido van Rossuma075ce11997-12-05 21:56:45 +000095 int skipfirstline = 0;
Guido van Rossum775af911997-02-14 19:50:32 +000096 int stdin_is_interactive = 0;
Barry Warsaw3b2aedb2000-09-15 18:40:42 +000097 int help = 0;
98 int version = 0;
Guido van Rossum667d7041995-08-04 04:20:48 +000099
Guido van Rossumac56b031996-07-21 02:33:38 +0000100 orig_argc = argc; /* For Py_GetArgcArgv() */
Guido van Rossum667d7041995-08-04 04:20:48 +0000101 orig_argv = argv;
Guido van Rossum667d7041995-08-04 04:20:48 +0000102
Guido van Rossum667d7041995-08-04 04:20:48 +0000103 if ((p = getenv("PYTHONINSPECT")) && *p != '\0')
104 inspect = 1;
105 if ((p = getenv("PYTHONUNBUFFERED")) && *p != '\0')
106 unbuffered = 1;
107
Barry Warsaw3b2aedb2000-09-15 18:40:42 +0000108 while ((c = getopt(argc, argv, "c:diOStuUvxXhV")) != EOF) {
Guido van Rossum667d7041995-08-04 04:20:48 +0000109 if (c == 'c') {
110 /* -c is the last option; following arguments
111 that look like options are left for the
112 the command to interpret. */
113 command = malloc(strlen(optarg) + 2);
114 if (command == NULL)
115 Py_FatalError(
116 "not enough memory to copy -c argument");
117 strcpy(command, optarg);
118 strcat(command, "\n");
119 break;
120 }
121
122 switch (c) {
123
124 case 'd':
125 Py_DebugFlag++;
126 break;
127
128 case 'i':
129 inspect++;
Guido van Rossum775af911997-02-14 19:50:32 +0000130 Py_InteractiveFlag++;
Guido van Rossum667d7041995-08-04 04:20:48 +0000131 break;
132
Guido van Rossum7614da61997-03-03 19:14:45 +0000133 case 'O':
134 Py_OptimizeFlag++;
135 break;
136
Guido van Rossum7922bd71997-08-29 22:34:47 +0000137 case 'S':
138 Py_NoSiteFlag++;
139 break;
140
Guido van Rossumbba92ca1998-04-10 19:39:15 +0000141 case 't':
142 Py_TabcheckFlag++;
143 break;
144
Guido van Rossum667d7041995-08-04 04:20:48 +0000145 case 'u':
146 unbuffered++;
147 break;
148
149 case 'v':
150 Py_VerboseFlag++;
151 break;
152
Guido van Rossuma075ce11997-12-05 21:56:45 +0000153 case 'x':
154 skipfirstline = 1;
155 break;
156
Guido van Rossumc15a9a12000-05-01 17:54:33 +0000157 case 'U':
158 Py_UnicodeFlag++;
159 break;
Barry Warsaw3b2aedb2000-09-15 18:40:42 +0000160 case 'h':
161 help++;
162 break;
163 case 'V':
164 version++;
165 break;
Guido van Rossumc15a9a12000-05-01 17:54:33 +0000166
Guido van Rossum667d7041995-08-04 04:20:48 +0000167 /* This space reserved for other options */
168
169 default:
Barry Warsaw3b2aedb2000-09-15 18:40:42 +0000170 usage(2, argv[0]);
Guido van Rossum667d7041995-08-04 04:20:48 +0000171 /*NOTREACHED*/
172
173 }
174 }
175
Barry Warsaw3b2aedb2000-09-15 18:40:42 +0000176 if (help)
177 usage(0, argv[0]);
178
179 if (version) {
180 fprintf(stderr, "Python %s\n", PY_VERSION);
181 exit(0);
182 }
183
Guido van Rossum775af911997-02-14 19:50:32 +0000184 if (command == NULL && optind < argc &&
185 strcmp(argv[optind], "-") != 0)
186 {
187 filename = argv[optind];
188 if (filename != NULL) {
189 if ((fp = fopen(filename, "r")) == NULL) {
190 fprintf(stderr, "%s: can't open file '%s'\n",
191 argv[0], filename);
192 exit(2);
193 }
Guido van Rossuma075ce11997-12-05 21:56:45 +0000194 else if (skipfirstline) {
Guido van Rossumdc8b5691999-04-19 17:54:19 +0000195 int ch;
196 /* Push back first newline so line numbers
197 remain the same */
198 while ((ch = getc(fp)) != EOF) {
199 if (ch == '\n') {
200 (void)ungetc(ch, fp);
201 break;
202 }
203 }
Guido van Rossuma075ce11997-12-05 21:56:45 +0000204 }
Guido van Rossum775af911997-02-14 19:50:32 +0000205 }
206 }
207
208 stdin_is_interactive = Py_FdIsInteractive(stdin, (char *)0);
209
Guido van Rossum667d7041995-08-04 04:20:48 +0000210 if (unbuffered) {
Guido van Rossumf22d7e21997-01-11 19:28:55 +0000211#ifdef MS_WINDOWS
Guido van Rossum3e7ae7a1997-01-17 22:05:38 +0000212 _setmode(fileno(stdin), O_BINARY);
213 _setmode(fileno(stdout), O_BINARY);
Guido van Rossumf22d7e21997-01-11 19:28:55 +0000214#endif
Guido van Rossum667d7041995-08-04 04:20:48 +0000215#ifndef MPW
Guido van Rossum22ffac11998-03-06 15:30:39 +0000216#ifdef HAVE_SETVBUF
Guido van Rossum775af911997-02-14 19:50:32 +0000217 setvbuf(stdin, (char *)NULL, _IONBF, BUFSIZ);
218 setvbuf(stdout, (char *)NULL, _IONBF, BUFSIZ);
219 setvbuf(stderr, (char *)NULL, _IONBF, BUFSIZ);
Guido van Rossum22ffac11998-03-06 15:30:39 +0000220#else /* !HAVE_SETVBUF */
221 setbuf(stdin, (char *)NULL);
222 setbuf(stdout, (char *)NULL);
223 setbuf(stderr, (char *)NULL);
224#endif /* !HAVE_SETVBUF */
225#else /* MPW */
Guido van Rossum667d7041995-08-04 04:20:48 +0000226 /* On MPW (3.2) unbuffered seems to hang */
Guido van Rossum775af911997-02-14 19:50:32 +0000227 setvbuf(stdin, (char *)NULL, _IOLBF, BUFSIZ);
Guido van Rossum667d7041995-08-04 04:20:48 +0000228 setvbuf(stdout, (char *)NULL, _IOLBF, BUFSIZ);
229 setvbuf(stderr, (char *)NULL, _IOLBF, BUFSIZ);
Guido van Rossum22ffac11998-03-06 15:30:39 +0000230#endif /* MPW */
Guido van Rossum667d7041995-08-04 04:20:48 +0000231 }
Guido van Rossum2a212191997-04-11 21:57:53 +0000232 else if (Py_InteractiveFlag) {
Guido van Rossumb31c7dc1997-04-11 22:19:12 +0000233#ifdef MS_WINDOWS
234 /* Doesn't have to have line-buffered -- use unbuffered */
Guido van Rossum01b7ced1999-02-09 18:36:51 +0000235 /* Any set[v]buf(stdin, ...) screws up Tkinter :-( */
Guido van Rossumb31c7dc1997-04-11 22:19:12 +0000236 setvbuf(stdout, (char *)NULL, _IONBF, BUFSIZ);
Guido van Rossum22ffac11998-03-06 15:30:39 +0000237#else /* !MS_WINDOWS */
238#ifdef HAVE_SETVBUF
Guido van Rossumb31c7dc1997-04-11 22:19:12 +0000239 setvbuf(stdin, (char *)NULL, _IOLBF, BUFSIZ);
240 setvbuf(stdout, (char *)NULL, _IOLBF, BUFSIZ);
Guido van Rossum22ffac11998-03-06 15:30:39 +0000241#endif /* HAVE_SETVBUF */
242#endif /* !MS_WINDOWS */
Guido van Rossum775af911997-02-14 19:50:32 +0000243 /* Leave stderr alone - it should be unbuffered anyway. */
244 }
Guido van Rossum667d7041995-08-04 04:20:48 +0000245
Guido van Rossumed52aac1997-07-19 19:20:32 +0000246 Py_SetProgramName(argv[0]);
247 Py_Initialize();
248
Guido van Rossum667d7041995-08-04 04:20:48 +0000249 if (Py_VerboseFlag ||
Guido van Rossum129e91a1997-02-14 21:00:50 +0000250 (command == NULL && filename == NULL && stdin_is_interactive))
Guido van Rossumfe4dfc71997-05-19 18:33:01 +0000251 fprintf(stderr, "Python %s on %s\n%s\n",
Guido van Rossuma22865e2000-09-05 04:41:18 +0000252 Py_GetVersion(), Py_GetPlatform(), COPYRIGHT);
Guido van Rossum667d7041995-08-04 04:20:48 +0000253
Guido van Rossum667d7041995-08-04 04:20:48 +0000254
255 if (command != NULL) {
256 /* Backup optind and force sys.argv[0] = '-c' */
257 optind--;
258 argv[optind] = "-c";
259 }
260
261 PySys_SetArgv(argc-optind, argv+optind);
262
Guido van Rossum3d26cc91997-09-16 16:11:28 +0000263 if ((inspect || (command == NULL && filename == NULL)) &&
264 isatty(fileno(stdin))) {
265 PyObject *v;
266 v = PyImport_ImportModule("readline");
267 if (v == NULL)
268 PyErr_Clear();
269 else
270 Py_DECREF(v);
271 }
272
Guido van Rossum667d7041995-08-04 04:20:48 +0000273 if (command) {
274 sts = PyRun_SimpleString(command) != 0;
Guido van Rossum05f7c501997-08-02 03:00:42 +0000275 free(command);
Guido van Rossum667d7041995-08-04 04:20:48 +0000276 }
277 else {
Guido van Rossum775af911997-02-14 19:50:32 +0000278 if (filename == NULL && stdin_is_interactive) {
Guido van Rossum667d7041995-08-04 04:20:48 +0000279 char *startup = getenv("PYTHONSTARTUP");
280 if (startup != NULL && startup[0] != '\0') {
281 FILE *fp = fopen(startup, "r");
282 if (fp != NULL) {
283 (void) PyRun_SimpleFile(fp, startup);
284 PyErr_Clear();
285 fclose(fp);
286 }
287 }
288 }
Guido van Rossum0df002c2000-08-27 19:21:52 +0000289 sts = PyRun_AnyFileEx(
Guido van Rossum775af911997-02-14 19:50:32 +0000290 fp,
Guido van Rossum0df002c2000-08-27 19:21:52 +0000291 filename == NULL ? "<stdin>" : filename,
292 filename != NULL) != 0;
Guido van Rossum667d7041995-08-04 04:20:48 +0000293 }
294
Guido van Rossum775af911997-02-14 19:50:32 +0000295 if (inspect && stdin_is_interactive &&
Guido van Rossum667d7041995-08-04 04:20:48 +0000296 (filename != NULL || command != NULL))
297 sts = PyRun_AnyFile(stdin, "<stdin>") != 0;
298
Guido van Rossum5d1770e1997-08-05 02:23:48 +0000299 Py_Finalize();
Guido van Rossum05f7c501997-08-02 03:00:42 +0000300 return sts;
Guido van Rossum667d7041995-08-04 04:20:48 +0000301}
302
303
Guido van Rossum667d7041995-08-04 04:20:48 +0000304/* Make the *original* argc/argv available to other modules.
305 This is rare, but it is needed by the secureware extension. */
306
307void
Fredrik Lundh620f3772000-07-09 20:42:34 +0000308Py_GetArgcArgv(int *argc, char ***argv)
Guido van Rossum667d7041995-08-04 04:20:48 +0000309{
310 *argc = orig_argc;
311 *argv = orig_argv;
312}