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
171 .B \-O
174 adding .opt-1 before the .pyc extension.
176 .B \-OO
177 Do \fB-O\fP and also discard docstrings; change the filename for
178 compiled (bytecode) files by adding .opt-2 before the .pyc extension.
180 .B \-q
181 Do not print the version and copyright messages. These messages are
182 also suppressed in non-interactive mode.
184 .B \-s
187 .B \-S
190 and the site-dependent manipulations of
196 .B \-u
200 .B \-v
202 (filename or built-in module) from which it is loaded. When given
207 .B \-V ", " \-\-version
208 Prints the Python version number of the executable and exits. When given
212 .BI "\-W " argument
213 Warning control. Python's warning machinery by default prints warning messages
220 -Wdefault # Warn once per call location
221 -Werror # Convert to exceptions
222 -Walways # Warn every time
223 -Wmodule # Warn once per calling module
224 -Wonce # Warn once per Python process
225 -Wignore # Never warn
229 .B -Wi
231 .B -Wignore .
238 .B -W ignore::DeprecationWarning
249 case-insensitive.
259 field matches the (fully-qualified) module name; this match is case-sensitive.
267 .B -W
270 .B -W
276 environment variable and from within a Python program using the warnings
281 .BI "\-X " option
284 -X faulthandler: enable faulthandler
286 -X showrefcount: output the total reference count and number of used
290 -X tracemalloc: start tracing Python memory allocations using the
292 traceback of a trace. Use -X tracemalloc=NFRAME to start tracing with a
295 -X importtime: show how long each import takes. It shows module name,
297 nested imports). Note that its output may be broken in multi-threaded
298 application. Typical usage is python3 -X importtime -c 'import asyncio'
300 -X dev: enable CPython's "development mode", introducing additional runtime
304 * Add default warning filter, as -W default
306 * Enable the faulthandler module to dump the Python traceback on a crash
311 -X utf8: enable UTF-8 mode for operating system interfaces, overriding the default
312 locale-aware mode. -X utf8=0 explicitly disables UTF-8 mode (even when it would
315 -X pycache_prefix=PATH: enable writing .pyc files to a parallel tree rooted at the
318 .B \-x
331 .B \-c
333 it executes the Python statement(s) given as
338 Leading whitespace is significant in Python statements!
339 In non-interactive mode, the entire input is parsed before it is
343 passed to the script in the Python variable
351 .B \-c
355 .I '-c'.
356 Note that options interpreted by the Python interpreter itself
368 control returns to the primary prompt; in non-interactive mode, the
378 conventions; ${prefix} and ${exec_prefix} are installation-dependent
381 .IP \fI${exec_prefix}/bin/python\fP
384 .I ${prefix}/lib/python<version>
386 .I ${exec_prefix}/lib/python<version>
392 .I ${prefix}/include/python<version>
394 .I ${exec_prefix}/include/python<version>
397 needed for developing Python extensions and embedding the
402 Change the location of the standard Python libraries. By default, the
403 libraries are searched in ${prefix}/lib/python<version> and
404 ${exec_prefix}/lib/python<version>, where ${prefix} and ${exec_prefix}
405 are installation-dependent directories, both defaulting to
413 Non-existent directories are silently ignored.
415 begins with ${prefix}/lib/python<version> (see PYTHONHOME above).
419 The search path can be manipulated from within a Python program as the
425 If this is the name of a readable file, the Python commands in that
437 If this is set to a non-empty string it is equivalent to specifying
438 the \fB\-O\fP option. If set to an integer, it is equivalent to
439 specifying \fB\-O\fP multiple times.
441 If this is set to a non-empty string it is equivalent to specifying
442 the \fB\-d\fP option. If set to an integer, it is equivalent to
443 specifying \fB\-d\fP multiple times.
445 If this is set to a non-empty string it is equivalent to specifying
446 the \fB\-B\fP option (don't try to write
450 If this is set to a non-empty string it is equivalent to specifying
451 the \fB\-i\fP option.
462 If this is set to a non-empty string it is equivalent to specifying the
463 \fB\-s\fP option (Don't add the user site directory to sys.path).
465 If this is set to a non-empty string it is equivalent to specifying
466 the \fB\-u\fP option.
468 If this is set to a non-empty string it is equivalent to specifying
469 the \fB\-v\fP option. If set to an integer, it is equivalent to
470 specifying \fB\-v\fP multiple times.
472 If this is set to a comma-separated string it is equivalent to
473 specifying the \fB\-W\fP option for each separate value.
481 interpreter itself, or to allow a cluster of python processes to share hash
487 Set the Python memory allocators and/or install debug hooks. The available
498 When Python is compiled in debug mode, the default is
503 If set to a non-empty string, Python will print statistics of the pymalloc
511 allocator of the C library, or if Python is configured without pymalloc support.
513 If this environment variable is set to a non-empty string, enable the debug
516 If this environment variable is set to a non-empty string, start tracing
517 Python memory allocations using the tracemalloc module.
524 If this environment variable is set to a non-empty string,
527 and SIGILL signals to dump the Python traceback.
529 This is equivalent to the \fB-X faulthandler\fP option.
537 .IR site-packages
539 .IR "python setup\.py install \-\-user" .
541 If this environment variable is set to a non-empty string, Python will
543 \fB\-X importtime\fP on the command line.
547 .SS Debug-mode variables
548 Setting these variables only has an effect in a debug build of Python, that is,
549 if Python was configured with the
550 \fB\--with-pydebug\fP build option.
552 If this environment variable is set, Python will print threading debug info.
553 The feature is deprecated in Python 3.10 and will be removed in Python 3.12.
555 If this environment variable is set, Python will dump objects and reference
558 The Python Software Foundation: https://www.python.org/psf/
560 Main website: https://www.python.org/
562 Documentation: https://docs.python.org/
564 Developer resources: https://devguide.python.org/
566 Downloads: https://www.python.org/downloads/
570 Newsgroups: comp.lang.python, comp.lang.python.announce
572 Python is distributed under an Open Source license. See the file
573 "LICENSE" in the Python source distribution for information on terms &
574 conditions for accessing and otherwise using Python and for a