Lines Matching +full:python +full:- +full:version
1 .TH PYTHON "1"
4 .\" groff -Tascii -man python.man | less
7 python \- an interpreted, interactive, object-oriented programming language
9 .B python
11 .B \-B
14 .B \-b
17 .B \-d
20 .B \-E
23 .B \-h
26 .B \-i
29 .B \-I
33 .B \-m
34 .I module-name
37 .B \-q
40 .B \-O
43 .B \-OO
46 .B \-s
49 .B \-S
52 .B \-u
56 .B \-v
59 .B \-V
62 .B \-W
66 .B \-x
70 .B \-X
73 .B \-?
77 .B \--check-hash-based-pycs
86 .B \-c
91 \-
97 Python is an interpreted, interactive, object-oriented programming
99 For an introduction to programming in Python, see the Python Tutorial.
100 The Python Library Reference documents built-in and standard types,
102 Finally, the Python Reference Manual describes the syntax and
108 Python's basic power can be extended with your own modules written in
111 Python is also adaptable as an extension language for existing
115 Documentation for installed Python modules and packages can be
121 .B \-B
126 .B \-b
128 and comparing bytes/bytearray with str. (-bb: issue errors)
130 .BI "\-c " command
135 .BI "\-\-check-hash-based-pycs " mode
136 Configure how Python evaluates the up-to-dateness of hash-based .pyc files.
138 .B \-d
142 .B \-E
146 .B \-h ", " \-? ", "\-\-help
149 .B \-i
150 When a script is passed as first argument or the \fB\-c\fP option is
156 .B \-I
157 Run Python in isolated mode. This also implies \fB\-E\fP and \fB\-s\fP. In
159 site-packages directory. All PYTHON* environment variables are ignored, too.
163 .BI "\-m " module-name
170 .B \-O
173 adding .opt-1 before the .pyc extension.
175 .B \-OO
176 Do \fB-O\fP and also discard docstrings; change the filename for
177 compiled (bytecode) files by adding .opt-2 before the .pyc extension.
179 .B \-q
180 Do not print the version and copyright messages. These messages are
181 also suppressed in non-interactive mode.
183 .B \-s
186 .B \-S
189 and the site-dependent manipulations of
195 .B \-u
199 .B \-v
201 (filename or built-in module) from which it is loaded. When given
206 .B \-V ", " \-\-version
207 Prints the Python version number of the executable and exits. When given
210 .BI "\-W " argument
211 Warning control. Python sometimes prints warning message to
218 .B \-W
222 .B \-W
225 controlled from within a Python program using the
262 case-insensitive. The
269 field matches the (fully-qualified) module name; this match is
270 case-sensitive. The
275 .BI "\-X " option
278 -X faulthandler: enable faulthandler
280 -X showrefcount: output the total reference count and number of used
284 -X tracemalloc: start tracing Python memory allocations using the
286 traceback of a trace. Use -X tracemalloc=NFRAME to start tracing with a
289 -X importtime: show how long each import takes. It shows module name,
291 nested imports). Note that its output may be broken in multi-threaded
292 application. Typical usage is python3 -X importtime -c 'import asyncio'
294 -X dev: enable CPython's "development mode", introducing additional runtime
298 * Add default warning filter, as -W default
300 * Enable the faulthandler module to dump the Python traceback on a crash
305 -X utf8: enable UTF-8 mode for operating system interfaces, overriding the default
306 locale-aware mode. -X utf8=0 explicitly disables UTF-8 mode (even when it would
309 -X pycache_prefix=PATH: enable writing .pyc files to a parallel tree rooted at the
312 .B \-x
325 .B \-c
327 it executes the Python statement(s) given as
332 Leading whitespace is significant in Python statements!
333 In non-interactive mode, the entire input is parsed before it is
337 passed to the script in the Python variable
345 .B \-c
349 .I '-c'.
350 Note that options interpreted by the Python interpreter itself
362 control returns to the primary prompt; in non-interactive mode, the
372 conventions; ${prefix} and ${exec_prefix} are installation-dependent
375 .IP \fI${exec_prefix}/bin/python\fP
378 .I ${prefix}/lib/python<version>
380 .I ${exec_prefix}/lib/python<version>
386 .I ${prefix}/include/python<version>
388 .I ${exec_prefix}/include/python<version>
391 needed for developing Python extensions and embedding the
396 Change the location of the standard Python libraries. By default, the
397 libraries are searched in ${prefix}/lib/python<version> and
398 ${exec_prefix}/lib/python<version>, where ${prefix} and ${exec_prefix}
399 are installation-dependent directories, both defaulting to
407 Non-existent directories are silently ignored.
409 begins with ${prefix}/lib/python<version> (see PYTHONHOME above).
413 The search path can be manipulated from within a Python program as the
419 If this is the name of a readable file, the Python commands in that
431 If this is set to a non-empty string it is equivalent to specifying
432 the \fB\-O\fP option. If set to an integer, it is equivalent to
433 specifying \fB\-O\fP multiple times.
435 If this is set to a non-empty string it is equivalent to specifying
436 the \fB\-d\fP option. If set to an integer, it is equivalent to
437 specifying \fB\-d\fP multiple times.
439 If this is set to a non-empty string it is equivalent to specifying
440 the \fB\-B\fP option (don't try to write
444 If this is set to a non-empty string it is equivalent to specifying
445 the \fB\-i\fP option.
456 If this is set to a non-empty string it is equivalent to specifying the
457 \fB\-s\fP option (Don't add the user site directory to sys.path).
459 If this is set to a non-empty string it is equivalent to specifying
460 the \fB\-u\fP option.
462 If this is set to a non-empty string it is equivalent to specifying
463 the \fB\-v\fP option. If set to an integer, it is equivalent to
464 specifying \fB\-v\fP multiple times.
466 If this is set to a comma-separated string it is equivalent to
467 specifying the \fB\-W\fP option for each separate value.
475 interpreter itself, or to allow a cluster of python processes to share hash
481 Set the Python memory allocators and/or install debug hooks. The available
492 When Python is compiled in debug mode, the default is
497 If set to a non-empty string, Python will print statistics of the pymalloc
505 allocator of the C library, or if Python is configured without pymalloc support.
507 If this environment variable is set to a non-empty string, enable the debug
510 If this environment variable is set to a non-empty string, start tracing
511 Python memory allocations using the tracemalloc module.
518 If this environment variable is set to a non-empty string,
521 and SIGILL signals to dump the Python traceback.
523 This is equivalent to the \fB-X faulthandler\fP option.
531 .IR site-packages
533 .IR "python setup\.py install \-\-user" .
535 If this environment variable is set to a non-empty string, Python will
537 \fB\-X importtime\fP on the command line.
541 .SS Debug-mode variables
542 Setting these variables only has an effect in a debug build of Python, that is,
543 if Python was configured with the
544 \fB\--with-pydebug\fP build option.
546 If this environment variable is set, Python will print threading debug info.
548 If this environment variable is set, Python will dump objects and reference
551 The Python Software Foundation: https://www.python.org/psf/
553 Main website: https://www.python.org/
555 Documentation: https://docs.python.org/
557 Developer resources: https://devguide.python.org/
559 Downloads: https://www.python.org/downloads/
563 Newsgroups: comp.lang.python, comp.lang.python.announce
565 Python is distributed under an Open Source license. See the file
566 "LICENSE" in the Python source distribution for information on terms &
567 conditions for accessing and otherwise using Python and for a