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 showalloccount: output the total count of allocated objects for each
290 type when the program finishes. This only works when Python was built with
293 -X importtime: show how long each import takes. It shows module name,
295 nested imports). Note that its output may be broken in multi-threaded
296 application. Typical usage is python3 -X importtime -c 'import asyncio'
298 -X dev: enable CPython’s “development mode”, introducing additional runtime
302 * Add default warning filter, as -W default
304 * Enable the faulthandler module to dump the Python traceback on a crash
309 -X utf8: enable UTF-8 mode for operating system interfaces, overriding the default
310 locale-aware mode. -X utf8=0 explicitly disables UTF-8 mode (even when it would
313 -X pycache_prefix=PATH: enable writing .pyc files to a parallel tree rooted at the
316 .B \-x
329 .B \-c
331 it executes the Python statement(s) given as
336 Leading whitespace is significant in Python statements!
337 In non-interactive mode, the entire input is parsed before it is
341 passed to the script in the Python variable
349 .B \-c
353 .I '-c'.
354 Note that options interpreted by the Python interpreter itself
366 control returns to the primary prompt; in non-interactive mode, the
376 conventions; ${prefix} and ${exec_prefix} are installation-dependent
379 .IP \fI${exec_prefix}/bin/python\fP
382 .I ${prefix}/lib/python<version>
384 .I ${exec_prefix}/lib/python<version>
390 .I ${prefix}/include/python<version>
392 .I ${exec_prefix}/include/python<version>
395 needed for developing Python extensions and embedding the
400 Change the location of the standard Python libraries. By default, the
401 libraries are searched in ${prefix}/lib/python<version> and
402 ${exec_prefix}/lib/python<version>, where ${prefix} and ${exec_prefix}
403 are installation-dependent directories, both defaulting to
411 Non-existent directories are silently ignored.
413 begins with ${prefix}/lib/python<version> (see PYTHONHOME above).
417 The search path can be manipulated from within a Python program as the
421 If this is the name of a readable file, the Python commands in that
433 If this is set to a non-empty string it is equivalent to specifying
434 the \fB\-O\fP option. If set to an integer, it is equivalent to
435 specifying \fB\-O\fP multiple times.
437 If this is set to a non-empty string it is equivalent to specifying
438 the \fB\-d\fP option. If set to an integer, it is equivalent to
439 specifying \fB\-d\fP multiple times.
441 If this is set to a non-empty string it is equivalent to specifying
442 the \fB\-B\fP option (don't try to write
446 If this is set to a non-empty string it is equivalent to specifying
447 the \fB\-i\fP option.
458 If this is set to a non-empty string it is equivalent to specifying the
459 \fB\-s\fP option (Don't add the user site directory to sys.path).
461 If this is set to a non-empty string it is equivalent to specifying
462 the \fB\-u\fP option.
464 If this is set to a non-empty string it is equivalent to specifying
465 the \fB\-v\fP option. If set to an integer, it is equivalent to
466 specifying \fB\-v\fP multiple times.
468 If this is set to a comma-separated string it is equivalent to
469 specifying the \fB\-W\fP option for each separate value.
477 interpreter itself, or to allow a cluster of python processes to share hash
483 Set the Python memory allocators and/or install debug hooks. The available
494 When Python is compiled in debug mode, the default is
499 If set to a non-empty string, Python will print statistics of the pymalloc
507 allocator of the C library, or if Python is configured without pymalloc support.
509 If this environment variable is set to a non-empty string, enable the debug
512 If this environment variable is set to a non-empty string, start tracing
513 Python memory allocations using the tracemalloc module.
520 If this environment variable is set to a non-empty string,
523 and SIGILL signals to dump the Python traceback.
525 This is equivalent to the \fB-X faulthandler\fP option.
533 .IR site-packages
535 .IR "python setup\.py install \-\-user" .
537 If this environment variable is set to a non-empty string, Python will
539 \fB\-X importtime\fP on the command line.
543 .SS Debug-mode variables
544 Setting these variables only has an effect in a debug build of Python, that is,
545 if Python was configured with the
546 \fB\--with-pydebug\fP build option.
548 If this environment variable is set, Python will print threading debug info.
550 If this environment variable is set, Python will dump objects and reference
553 The Python Software Foundation: https://www.python.org/psf/
555 Main website: https://www.python.org/
557 Documentation: https://docs.python.org/
559 Developer resources: https://devguide.python.org/
561 Downloads: https://www.python.org/downloads/
565 Newsgroups: comp.lang.python, comp.lang.python.announce
567 Python is distributed under an Open Source license. See the file
568 "LICENSE" in the Python source distribution for information on terms &
569 conditions for accessing and otherwise using Python and for a