blob: b4566c94af69ecb0dcdef086d1d0bb7bc77c9313 [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
Thomas Wouters2cffc7d2000-11-03 08:18:37 +000020#include "pygetopt.h"
21
Guido van Rossuma22865e2000-09-05 04:41:18 +000022#define COPYRIGHT \
23 "Type \"copyright\", \"credits\" or \"license\" for more information."
24
Guido van Rossumac56b031996-07-21 02:33:38 +000025/* For Py_GetArgcArgv(); set by main() */
Guido van Rossum667d7041995-08-04 04:20:48 +000026static char **orig_argv;
27static int orig_argc;
28
Guido van Rossum3ed4c152001-03-02 06:18:03 +000029/* For my_readline when running under RISCOS */
30#ifdef RISCOS
31extern int Py_RISCOSWimpFlag;
32#endif
33
Guido van Rossum667d7041995-08-04 04:20:48 +000034/* Short usage message (with %s for argv0) */
35static char *usage_line =
Guido van Rossum6b86a421999-01-28 15:07:47 +000036"usage: %s [option] ... [-c cmd | file | -] [arg] ...\n";
Guido van Rossum667d7041995-08-04 04:20:48 +000037
38/* Long usage message, split into parts < 512 bytes */
Guido van Rossuma075ce11997-12-05 21:56:45 +000039static char *usage_top = "\
Guido van Rossum667d7041995-08-04 04:20:48 +000040Options and arguments (and corresponding environment variables):\n\
41-d : debug output from parser (also PYTHONDEBUG=x)\n\
Guido van Rossum775af911997-02-14 19:50:32 +000042-i : inspect interactively after running script, (also PYTHONINSPECT=x)\n\
Guido van Rossumbba92ca1998-04-10 19:39:15 +000043 and force prompts, even if stdin does not appear to be a terminal\n\
Guido van Rossume7adf3e1998-10-07 14:50:06 +000044-O : optimize generated bytecode (a tad; also PYTHONOPTIMIZE=x)\n\
Guido van Rossum6b86a421999-01-28 15:07:47 +000045-OO : remove doc-strings in addition to the -O optimizations\n\
Guido van Rossum7922bd71997-08-29 22:34:47 +000046-S : don't imply 'import site' on initialization\n\
Guido van Rossumbba92ca1998-04-10 19:39:15 +000047-t : issue warnings about inconsistent tab usage (-tt: issue errors)\n\
Guido van Rossum667d7041995-08-04 04:20:48 +000048";
Guido van Rossum7922bd71997-08-29 22:34:47 +000049static char *usage_mid = "\
Guido van Rossumbba92ca1998-04-10 19:39:15 +000050-u : unbuffered binary stdout and stderr (also PYTHONUNBUFFERED=x)\n\
Guido van Rossumc15a9a12000-05-01 17:54:33 +000051-U : Unicode literals: treats '...' literals like u'...'\n\
Guido van Rossum7922bd71997-08-29 22:34:47 +000052-v : verbose (trace import statements) (also PYTHONVERBOSE=x)\n\
Guido van Rossuma075ce11997-12-05 21:56:45 +000053-x : skip first line of source, allowing use of non-Unix forms of #!cmd\n\
Barry Warsaw3b2aedb2000-09-15 18:40:42 +000054-h : print this help message and exit\n\
55-V : print the Python version number and exit\n\
Guido van Rossum47f5fdc2000-12-15 22:00:54 +000056-W arg : warning control (arg is action:message:category:module:lineno)\n\
Guido van Rossum775af911997-02-14 19:50:32 +000057-c cmd : program passed in as string (terminates option list)\n\
Guido van Rossum667d7041995-08-04 04:20:48 +000058file : program read from script file\n\
59- : program read from stdin (default; interactive mode if a tty)\n\
Guido van Rossum7922bd71997-08-29 22:34:47 +000060";
61static char *usage_bot = "\
Guido van Rossumbba92ca1998-04-10 19:39:15 +000062arg ...: arguments passed to program in sys.argv[1:]\n\
Guido van Rossum667d7041995-08-04 04:20:48 +000063Other environment variables:\n\
64PYTHONSTARTUP: file executed on interactive startup (no default)\n\
Guido van Rossuma075ce11997-12-05 21:56:45 +000065PYTHONPATH : '%c'-separated list of directories prefixed to the\n\
Guido van Rossum667d7041995-08-04 04:20:48 +000066 default module search path. The result is sys.path.\n\
Guido van Rossuma075ce11997-12-05 21:56:45 +000067PYTHONHOME : alternate <prefix> directory (or <prefix>%c<exec_prefix>).\n\
68 The default module search path uses %s.\n\
Tim Peters793de092001-02-22 00:39:47 +000069PYTHONCASEOK : ignore case in 'import' statements (Windows).\n\
Guido van Rossum667d7041995-08-04 04:20:48 +000070";
71
72
Barry Warsaw3b2aedb2000-09-15 18:40:42 +000073static void
74usage(int exitcode, char* program)
75{
76 fprintf(stderr, usage_line, program);
77 fprintf(stderr, usage_top);
78 fprintf(stderr, usage_mid);
79 fprintf(stderr, usage_bot, DELIM, DELIM, PYTHONHOMEHELP);
80 exit(exitcode);
81 /*NOTREACHED*/
82}
83
84
Guido van Rossum667d7041995-08-04 04:20:48 +000085/* Main program */
86
Guido van Rossum9c1201f1998-12-07 14:28:47 +000087DL_EXPORT(int)
Fredrik Lundh620f3772000-07-09 20:42:34 +000088Py_Main(int argc, char **argv)
Guido van Rossum667d7041995-08-04 04:20:48 +000089{
90 int c;
91 int sts;
92 char *command = NULL;
93 char *filename = NULL;
94 FILE *fp = stdin;
95 char *p;
96 int inspect = 0;
97 int unbuffered = 0;
Guido van Rossuma075ce11997-12-05 21:56:45 +000098 int skipfirstline = 0;
Guido van Rossum775af911997-02-14 19:50:32 +000099 int stdin_is_interactive = 0;
Barry Warsaw3b2aedb2000-09-15 18:40:42 +0000100 int help = 0;
101 int version = 0;
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000102 PyCompilerFlags cf;
Guido van Rossum667d7041995-08-04 04:20:48 +0000103
Guido van Rossumac56b031996-07-21 02:33:38 +0000104 orig_argc = argc; /* For Py_GetArgcArgv() */
Guido van Rossum667d7041995-08-04 04:20:48 +0000105 orig_argv = argv;
Guido van Rossum667d7041995-08-04 04:20:48 +0000106
Guido van Rossum3ed4c152001-03-02 06:18:03 +0000107#ifdef RISCOS
108 Py_RISCOSWimpFlag = 0;
109#endif
110
Guido van Rossum667d7041995-08-04 04:20:48 +0000111 if ((p = getenv("PYTHONINSPECT")) && *p != '\0')
112 inspect = 1;
113 if ((p = getenv("PYTHONUNBUFFERED")) && *p != '\0')
114 unbuffered = 1;
115
Guido van Rossum47f5fdc2000-12-15 22:00:54 +0000116 PySys_ResetWarnOptions();
117
Guido van Rossum3ed4c152001-03-02 06:18:03 +0000118#ifdef RISCOS
119 while ((c = getopt(argc, argv, "c:diOStuUvwxXhV")) != EOF) {
120#else
Guido van Rossum47f5fdc2000-12-15 22:00:54 +0000121 while ((c = _PyOS_GetOpt(argc, argv, "c:diOStuUvxXhVW:")) != EOF) {
Guido van Rossum3ed4c152001-03-02 06:18:03 +0000122#endif
Guido van Rossum667d7041995-08-04 04:20:48 +0000123 if (c == 'c') {
124 /* -c is the last option; following arguments
125 that look like options are left for the
126 the command to interpret. */
Thomas Wouters2cffc7d2000-11-03 08:18:37 +0000127 command = malloc(strlen(_PyOS_optarg) + 2);
Guido van Rossum667d7041995-08-04 04:20:48 +0000128 if (command == NULL)
129 Py_FatalError(
130 "not enough memory to copy -c argument");
Thomas Wouters2cffc7d2000-11-03 08:18:37 +0000131 strcpy(command, _PyOS_optarg);
Guido van Rossum667d7041995-08-04 04:20:48 +0000132 strcat(command, "\n");
133 break;
134 }
135
136 switch (c) {
137
138 case 'd':
139 Py_DebugFlag++;
140 break;
141
142 case 'i':
143 inspect++;
Guido van Rossum775af911997-02-14 19:50:32 +0000144 Py_InteractiveFlag++;
Guido van Rossum667d7041995-08-04 04:20:48 +0000145 break;
146
Guido van Rossum7614da61997-03-03 19:14:45 +0000147 case 'O':
148 Py_OptimizeFlag++;
149 break;
150
Guido van Rossum7922bd71997-08-29 22:34:47 +0000151 case 'S':
152 Py_NoSiteFlag++;
153 break;
154
Guido van Rossumbba92ca1998-04-10 19:39:15 +0000155 case 't':
156 Py_TabcheckFlag++;
157 break;
158
Guido van Rossum667d7041995-08-04 04:20:48 +0000159 case 'u':
160 unbuffered++;
161 break;
162
163 case 'v':
164 Py_VerboseFlag++;
165 break;
166
Guido van Rossum3ed4c152001-03-02 06:18:03 +0000167#ifdef RISCOS
168 case 'w':
169 Py_RISCOSWimpFlag = 1;
170 break;
171#endif
172
Guido van Rossuma075ce11997-12-05 21:56:45 +0000173 case 'x':
174 skipfirstline = 1;
175 break;
176
Guido van Rossumc15a9a12000-05-01 17:54:33 +0000177 case 'U':
178 Py_UnicodeFlag++;
179 break;
Barry Warsaw3b2aedb2000-09-15 18:40:42 +0000180 case 'h':
181 help++;
182 break;
183 case 'V':
184 version++;
185 break;
Guido van Rossumc15a9a12000-05-01 17:54:33 +0000186
Guido van Rossum47f5fdc2000-12-15 22:00:54 +0000187 case 'W':
188 PySys_AddWarnOption(_PyOS_optarg);
189 break;
190
Guido van Rossum667d7041995-08-04 04:20:48 +0000191 /* This space reserved for other options */
192
193 default:
Barry Warsaw3b2aedb2000-09-15 18:40:42 +0000194 usage(2, argv[0]);
Guido van Rossum667d7041995-08-04 04:20:48 +0000195 /*NOTREACHED*/
196
197 }
198 }
199
Barry Warsaw3b2aedb2000-09-15 18:40:42 +0000200 if (help)
201 usage(0, argv[0]);
202
203 if (version) {
204 fprintf(stderr, "Python %s\n", PY_VERSION);
205 exit(0);
206 }
207
Thomas Wouters2cffc7d2000-11-03 08:18:37 +0000208 if (command == NULL && _PyOS_optind < argc &&
209 strcmp(argv[_PyOS_optind], "-") != 0)
Guido van Rossum775af911997-02-14 19:50:32 +0000210 {
Thomas Wouters2cffc7d2000-11-03 08:18:37 +0000211 filename = argv[_PyOS_optind];
Guido van Rossum775af911997-02-14 19:50:32 +0000212 if (filename != NULL) {
213 if ((fp = fopen(filename, "r")) == NULL) {
214 fprintf(stderr, "%s: can't open file '%s'\n",
215 argv[0], filename);
216 exit(2);
217 }
Guido van Rossuma075ce11997-12-05 21:56:45 +0000218 else if (skipfirstline) {
Guido van Rossumdc8b5691999-04-19 17:54:19 +0000219 int ch;
220 /* Push back first newline so line numbers
221 remain the same */
222 while ((ch = getc(fp)) != EOF) {
223 if (ch == '\n') {
224 (void)ungetc(ch, fp);
225 break;
226 }
227 }
Guido van Rossuma075ce11997-12-05 21:56:45 +0000228 }
Guido van Rossum775af911997-02-14 19:50:32 +0000229 }
230 }
231
232 stdin_is_interactive = Py_FdIsInteractive(stdin, (char *)0);
233
Guido van Rossum667d7041995-08-04 04:20:48 +0000234 if (unbuffered) {
Guido van Rossumf22d7e21997-01-11 19:28:55 +0000235#ifdef MS_WINDOWS
Guido van Rossum3e7ae7a1997-01-17 22:05:38 +0000236 _setmode(fileno(stdin), O_BINARY);
237 _setmode(fileno(stdout), O_BINARY);
Guido van Rossumf22d7e21997-01-11 19:28:55 +0000238#endif
Guido van Rossum667d7041995-08-04 04:20:48 +0000239#ifndef MPW
Guido van Rossum22ffac11998-03-06 15:30:39 +0000240#ifdef HAVE_SETVBUF
Guido van Rossum775af911997-02-14 19:50:32 +0000241 setvbuf(stdin, (char *)NULL, _IONBF, BUFSIZ);
242 setvbuf(stdout, (char *)NULL, _IONBF, BUFSIZ);
243 setvbuf(stderr, (char *)NULL, _IONBF, BUFSIZ);
Guido van Rossum22ffac11998-03-06 15:30:39 +0000244#else /* !HAVE_SETVBUF */
245 setbuf(stdin, (char *)NULL);
246 setbuf(stdout, (char *)NULL);
247 setbuf(stderr, (char *)NULL);
248#endif /* !HAVE_SETVBUF */
249#else /* MPW */
Guido van Rossum667d7041995-08-04 04:20:48 +0000250 /* On MPW (3.2) unbuffered seems to hang */
Guido van Rossum775af911997-02-14 19:50:32 +0000251 setvbuf(stdin, (char *)NULL, _IOLBF, BUFSIZ);
Guido van Rossum667d7041995-08-04 04:20:48 +0000252 setvbuf(stdout, (char *)NULL, _IOLBF, BUFSIZ);
253 setvbuf(stderr, (char *)NULL, _IOLBF, BUFSIZ);
Guido van Rossum22ffac11998-03-06 15:30:39 +0000254#endif /* MPW */
Guido van Rossum667d7041995-08-04 04:20:48 +0000255 }
Guido van Rossum2a212191997-04-11 21:57:53 +0000256 else if (Py_InteractiveFlag) {
Guido van Rossumb31c7dc1997-04-11 22:19:12 +0000257#ifdef MS_WINDOWS
258 /* Doesn't have to have line-buffered -- use unbuffered */
Guido van Rossum01b7ced1999-02-09 18:36:51 +0000259 /* Any set[v]buf(stdin, ...) screws up Tkinter :-( */
Guido van Rossumb31c7dc1997-04-11 22:19:12 +0000260 setvbuf(stdout, (char *)NULL, _IONBF, BUFSIZ);
Guido van Rossum22ffac11998-03-06 15:30:39 +0000261#else /* !MS_WINDOWS */
262#ifdef HAVE_SETVBUF
Guido van Rossumb31c7dc1997-04-11 22:19:12 +0000263 setvbuf(stdin, (char *)NULL, _IOLBF, BUFSIZ);
264 setvbuf(stdout, (char *)NULL, _IOLBF, BUFSIZ);
Guido van Rossum22ffac11998-03-06 15:30:39 +0000265#endif /* HAVE_SETVBUF */
266#endif /* !MS_WINDOWS */
Guido van Rossum775af911997-02-14 19:50:32 +0000267 /* Leave stderr alone - it should be unbuffered anyway. */
268 }
Guido van Rossum667d7041995-08-04 04:20:48 +0000269
Guido van Rossumed52aac1997-07-19 19:20:32 +0000270 Py_SetProgramName(argv[0]);
271 Py_Initialize();
272
Guido van Rossum667d7041995-08-04 04:20:48 +0000273 if (Py_VerboseFlag ||
Guido van Rossum129e91a1997-02-14 21:00:50 +0000274 (command == NULL && filename == NULL && stdin_is_interactive))
Guido van Rossumfe4dfc71997-05-19 18:33:01 +0000275 fprintf(stderr, "Python %s on %s\n%s\n",
Guido van Rossuma22865e2000-09-05 04:41:18 +0000276 Py_GetVersion(), Py_GetPlatform(), COPYRIGHT);
Guido van Rossum667d7041995-08-04 04:20:48 +0000277
Guido van Rossum667d7041995-08-04 04:20:48 +0000278
279 if (command != NULL) {
Thomas Wouters2cffc7d2000-11-03 08:18:37 +0000280 /* Backup _PyOS_optind and force sys.argv[0] = '-c' */
281 _PyOS_optind--;
282 argv[_PyOS_optind] = "-c";
Guido van Rossum667d7041995-08-04 04:20:48 +0000283 }
284
Thomas Wouters2cffc7d2000-11-03 08:18:37 +0000285 PySys_SetArgv(argc-_PyOS_optind, argv+_PyOS_optind);
Guido van Rossum667d7041995-08-04 04:20:48 +0000286
Guido van Rossum3d26cc91997-09-16 16:11:28 +0000287 if ((inspect || (command == NULL && filename == NULL)) &&
288 isatty(fileno(stdin))) {
289 PyObject *v;
290 v = PyImport_ImportModule("readline");
291 if (v == NULL)
292 PyErr_Clear();
293 else
294 Py_DECREF(v);
295 }
296
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000297 cf.cf_nested_scopes = 0;
298
Guido van Rossum667d7041995-08-04 04:20:48 +0000299 if (command) {
300 sts = PyRun_SimpleString(command) != 0;
Guido van Rossum05f7c501997-08-02 03:00:42 +0000301 free(command);
Guido van Rossum667d7041995-08-04 04:20:48 +0000302 }
303 else {
Guido van Rossum775af911997-02-14 19:50:32 +0000304 if (filename == NULL && stdin_is_interactive) {
Guido van Rossum667d7041995-08-04 04:20:48 +0000305 char *startup = getenv("PYTHONSTARTUP");
306 if (startup != NULL && startup[0] != '\0') {
307 FILE *fp = fopen(startup, "r");
308 if (fp != NULL) {
309 (void) PyRun_SimpleFile(fp, startup);
310 PyErr_Clear();
311 fclose(fp);
312 }
313 }
314 }
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000315 /* XXX */
316 sts = PyRun_AnyFileExFlags(
Guido van Rossum775af911997-02-14 19:50:32 +0000317 fp,
Guido van Rossum0df002c2000-08-27 19:21:52 +0000318 filename == NULL ? "<stdin>" : filename,
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000319 filename != NULL, &cf) != 0;
Guido van Rossum667d7041995-08-04 04:20:48 +0000320 }
321
Guido van Rossum775af911997-02-14 19:50:32 +0000322 if (inspect && stdin_is_interactive &&
Guido van Rossum667d7041995-08-04 04:20:48 +0000323 (filename != NULL || command != NULL))
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000324 /* XXX */
325 sts = PyRun_AnyFileFlags(stdin, "<stdin>", &cf) != 0;
Guido van Rossum667d7041995-08-04 04:20:48 +0000326
Guido van Rossum5d1770e1997-08-05 02:23:48 +0000327 Py_Finalize();
Guido van Rossum3ed4c152001-03-02 06:18:03 +0000328#ifdef RISCOS
329 if(Py_RISCOSWimpFlag)
330 fprintf(stderr, "\x0cq\x0c"); /* make frontend quit */
331#endif
Barry Warsaw3e13b1e2001-02-23 16:46:39 +0000332
333#ifdef __INSURE__
334 /* Insure++ is a memory analysis tool that aids in discovering
335 * memory leaks and other memory problems. On Python exit, the
336 * interned string dictionary is flagged as being in use at exit
337 * (which it is). Under normal circumstances, this is fine because
338 * the memory will be automatically reclaimed by the system. Under
339 * memory debugging, it's a huge source of useless noise, so we
340 * trade off slower shutdown for less distraction in the memory
341 * reports. -baw
342 */
343 _Py_ReleaseInternedStrings();
344#endif /* __INSURE__ */
345
Guido van Rossum05f7c501997-08-02 03:00:42 +0000346 return sts;
Guido van Rossum667d7041995-08-04 04:20:48 +0000347}
348
349
Guido van Rossum667d7041995-08-04 04:20:48 +0000350/* Make the *original* argc/argv available to other modules.
351 This is rare, but it is needed by the secureware extension. */
352
353void
Fredrik Lundh620f3772000-07-09 20:42:34 +0000354Py_GetArgcArgv(int *argc, char ***argv)
Guido van Rossum667d7041995-08-04 04:20:48 +0000355{
356 *argc = orig_argc;
357 *argv = orig_argv;
358}