Lines Matching +full:- +full:- +full:enable +full:- +full:warnings
4 .\" groff -Tascii -man python.man | less
7 python \- an interpreted, interactive, object-oriented programming language
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
116 The Python Library Reference documents built-in and standard types,
137 .B \-B
142 .B \-b
143 Issue warnings about str(bytes_instance), str(bytearray_instance)
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
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
243 .BI "\-W " argument
248 The simplest settings apply a particular action unconditionally to all warnings
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
270 ignores all DeprecationWarning warnings.
274 field is as explained above but only applies to warnings that match
280 case-insensitive.
290 field matches the (fully-qualified) module name; this match is case-sensitive.
298 .B -W
301 .B -W
305 Warnings can also be controlled using the
307 environment variable and from within a Python program using the warnings
308 module. For example, the warnings.filterwarnings() function can be used to use
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
333 more verbose than the default if the code is correct: new warnings are
335 * Add default warning filter, as -W default
338 * Enable the faulthandler module to dump the Python traceback on a crash
339 * Enable asyncio debug mode
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
387 In non-interactive mode, the entire input is parsed before it is
399 .B \-c
403 .I '-c'.
416 control returns to the primary prompt; in non-interactive mode, the
426 conventions; ${prefix} and ${exec_prefix} are installation-dependent
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.
457 are installation-dependent directories, both defaulting to
465 Non-existent directories are silently ignored.
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.
560 If set to a non-empty string, Python will print statistics of the pymalloc
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
581 If this environment variable is set to a non-empty string,
582 .IR faulthandler.enable()
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
607 \fB\--with-pydebug\fP build option.