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 \-P
49 .B \-s
52 .B \-S
55 .B \-u
59 .B \-v
62 .B \-V
65 .B \-W
69 .B \-x
72 .B \-X
76 .B \-?
80 .B \--check-hash-based-pycs
89 .B \--help
92 .B \--help-env
95 .B \--help-xoptions
98 .B \--help-all
102 .B \-c
107 \-
113 Python is an interpreted, interactive, object-oriented programming
115 For an introduction to programming in Python, see the Python Tutorial.
116 The Python Library Reference documents built-in and standard types,
118 Finally, the Python Reference Manual describes the syntax and
124 Python's basic power can be extended with your own modules written in
127 Python is also adaptable as an extension language for existing
131 Documentation for installed Python modules and packages can be
137 .B \-B
142 .B \-b
144 and comparing bytes/bytearray with str. (-bb: issue errors)
146 .BI "\-c " command
151 .BI "\-\-check-hash-based-pycs " mode
152 Configure how Python evaluates the up-to-dateness of hash-based .pyc files.
154 .B \-d
158 .B \-E
162 .B \-h ", " \-? ", "\-\-help
165 .B "\-\-help\-env"
166 Prints help about Python-specific environment variables and exits.
168 .B "\-\-help\-xoptions"
169 Prints help about implementation-specific \fB\-X\fP options and exits.
172 .B "\-\-help\-all"
175 .B \-i
176 When a script is passed as first argument or the \fB\-c\fP option is
182 .B \-I
183 Run Python in isolated mode. This also implies \fB\-E\fP, \fB\-P\fP and \fB\-s\fP. In
185 site-packages directory. All PYTHON* environment variables are ignored, too.
189 .BI "\-m " module-name
197 .B \-O
200 adding .opt-1 before the .pyc extension.
202 .B \-OO
203 Do \fB-O\fP and also discard docstrings; change the filename for
204 compiled (bytecode) files by adding .opt-2 before the .pyc extension.
206 .B \-P
211 .B \-q
212 Do not print the version and copyright messages. These messages are
213 also suppressed in non-interactive mode.
215 .B \-s
218 .B \-S
221 and the site-dependent manipulations of
227 .B \-u
231 .B \-v
233 (filename or built-in module) from which it is loaded. When given
238 .B \-V ", " \-\-version
239 Prints the Python version number of the executable and exits. When given
243 .BI "\-W " argument
244 Warning control. Python's warning machinery by default prints warning messages
251 -Wdefault # Warn once per call location
252 -Werror # Convert to exceptions
253 -Walways # Warn every time
254 -Wmodule # Warn once per calling module
255 -Wonce # Warn once per Python process
256 -Wignore # Never warn
260 .B -Wi
262 .B -Wignore .
269 .B -W ignore::DeprecationWarning
280 case-insensitive.
290 field matches the (fully-qualified) module name; this match is case-sensitive.
298 .B -W
301 .B -W
307 environment variable and from within a Python program using the warnings
312 .BI "\-X " option
313 Set implementation-specific option. The following options are available:
315 -X faulthandler: enable faulthandler
317 -X showrefcount: output the total reference count and number of used
321 -X tracemalloc: start tracing Python memory allocations using the
323 traceback of a trace. Use -X tracemalloc=NFRAME to start tracing with a
326 -X importtime: show how long each import takes. It shows module name,
328 nested imports). Note that its output may be broken in multi-threaded
329 application. Typical usage is python3 -X importtime -c 'import asyncio'
331 -X dev: enable CPython's "development mode", introducing additional runtime
335 * Add default warning filter, as -W default
338 * Enable the faulthandler module to dump the Python traceback on a crash
343 -X utf8: enable UTF-8 mode for operating system interfaces, overriding the default
344 locale-aware mode. -X utf8=0 explicitly disables UTF-8 mode (even when it would
347 -X pycache_prefix=PATH: enable writing .pyc files to a parallel tree rooted at the
350 -X warn_default_encoding: enable opt-in EncodingWarning for 'encoding=None'
352 -X no_debug_ranges: disable the inclusion of the tables mapping extra location
358 -X frozen_modules=[on|off]: whether or not frozen modules should be used.
361 -X int_max_str_digits=number: limit the size of int<->str conversions.
366 .B \-x
379 .B \-c
381 it executes the Python statement(s) given as
386 Leading whitespace is significant in Python statements!
387 In non-interactive mode, the entire input is parsed before it is
391 passed to the script in the Python variable
399 .B \-c
403 .I '-c'.
404 Note that options interpreted by the Python interpreter itself
416 control returns to the primary prompt; in non-interactive mode, the
426 conventions; ${prefix} and ${exec_prefix} are installation-dependent
429 .IP \fI${exec_prefix}/bin/python\fP
432 .I ${prefix}/lib/python<version>
434 .I ${exec_prefix}/lib/python<version>
440 .I ${prefix}/include/python<version>
442 .I ${exec_prefix}/include/python<version>
445 needed for developing Python extensions and embedding the
450 If this is set to a non-empty string, don't automatically prepend a potentially
452 directory or an empty string. See also the \fB\-P\fP option.
454 Change the location of the standard Python libraries. By default, the
455 libraries are searched in ${prefix}/lib/python<version> and
456 ${exec_prefix}/lib/python<version>, where ${prefix} and ${exec_prefix}
457 are installation-dependent directories, both defaulting to
465 Non-existent directories are silently ignored.
467 begins with ${prefix}/lib/python<version> (see PYTHONHOME above).
471 The search path can be manipulated from within a Python program as the
477 If this is the name of a readable file, the Python commands in that
489 If this is set to a non-empty string it is equivalent to specifying
490 the \fB\-O\fP option. If set to an integer, it is equivalent to
491 specifying \fB\-O\fP multiple times.
493 If this is set to a non-empty string it is equivalent to specifying
494 the \fB\-d\fP option. If set to an integer, it is equivalent to
495 specifying \fB\-d\fP multiple times.
497 If this is set to a non-empty string it is equivalent to specifying
498 the \fB\-B\fP option (don't try to write
502 If this is set to a non-empty string it is equivalent to specifying
503 the \fB\-i\fP option.
514 If this is set to a non-empty string it is equivalent to specifying the
515 \fB\-s\fP option (Don't add the user site directory to sys.path).
517 If this is set to a non-empty string it is equivalent to specifying
518 the \fB\-u\fP option.
520 If this is set to a non-empty string it is equivalent to specifying
521 the \fB\-v\fP option. If set to an integer, it is equivalent to
522 specifying \fB\-v\fP multiple times.
524 If this is set to a comma-separated string it is equivalent to
525 specifying the \fB\-W\fP option for each separate value.
533 interpreter itself, or to allow a cluster of python processes to share hash
544 Set the Python memory allocators and/or install debug hooks. The available
555 When Python is compiled in debug mode, the default is
560 If set to a non-empty string, Python will print statistics of the pymalloc
568 allocator of the C library, or if Python is configured without pymalloc support.
570 If this environment variable is set to a non-empty string, enable the debug
573 If this environment variable is set to a non-empty string, start tracing
574 Python memory allocations using the tracemalloc module.
581 If this environment variable is set to a non-empty string,
584 and SIGILL signals to dump the Python traceback.
586 This is equivalent to the \fB-X faulthandler\fP option.
594 .IR site-packages
596 .IR "python setup\.py install \-\-user" .
598 If this environment variable is set to a non-empty string, Python will
600 \fB\-X importtime\fP on the command line.
604 .SS Debug-mode variables
605 Setting these variables only has an effect in a debug build of Python, that is,
606 if Python was configured with the
607 \fB\--with-pydebug\fP build option.
609 If this environment variable is set, Python will print threading debug info.
610 The feature is deprecated in Python 3.10 and will be removed in Python 3.12.
612 If this environment variable is set, Python will dump objects and reference
615 The Python Software Foundation: https://www.python.org/psf/
617 Main website: https://www.python.org/
619 Documentation: https://docs.python.org/
621 Developer resources: https://devguide.python.org/
623 Downloads: https://www.python.org/downloads/
627 Newsgroups: comp.lang.python, comp.lang.python.announce
629 Python is distributed under an Open Source license. See the file
630 "LICENSE" in the Python source distribution for information on terms &
631 conditions for accessing and otherwise using Python and for a