diff options
author | Antoine Pitrou <solipsis@pitrou.net> | 2010-10-21 13:42:28 (GMT) |
---|---|---|
committer | Antoine Pitrou <solipsis@pitrou.net> | 2010-10-21 13:42:28 (GMT) |
commit | 9583cac6337f9a5f2670fbe5e1f2e85aaad04522 (patch) | |
tree | 219c579de12fb04e6239ff11d548bfa454b6f135 /Doc/library/sys.rst | |
parent | 6d61cb4d2fc1cd0b412bdf0cf15337751e56f0d2 (diff) | |
download | cpython-9583cac6337f9a5f2670fbe5e1f2e85aaad04522.zip cpython-9583cac6337f9a5f2670fbe5e1f2e85aaad04522.tar.gz cpython-9583cac6337f9a5f2670fbe5e1f2e85aaad04522.tar.bz2 |
Issue #10089: Add support for arbitrary -X options on the command-line.
They can be retrieved through a new attribute `sys._xoptions`.
Diffstat (limited to 'Doc/library/sys.rst')
-rw-r--r-- | Doc/library/sys.rst | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index 23fdb09..bf8e0d0 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -975,6 +975,30 @@ always available. module for informational purposes; modifying this value has no effect on the registry keys used by Python. Availability: Windows. + +.. data:: _xoptions + + A dictionary of the various implementation-specific flags passed through + the :option:`-X` command-line option. Option names are either mapped to + their values, if given explicitly, or to :const:`True`. Example:: + + $ ./python -Xa=b -Xc + Python 3.2a3+ (py3k, Oct 16 2010, 20:14:50) + [GCC 4.4.3] on linux2 + Type "help", "copyright", "credits" or "license" for more information. + >>> import sys + >>> sys._xoptions + {'a': 'b', 'c': True} + + .. impl-detail:: + + This is a CPython-specific way of accessing options passed through + :option:`-X`. Other implementations may export them through other + means, or not at all. + + .. versionadded:: 3.2 + + .. rubric:: Citations .. [C99] ISO/IEC 9899:1999. "Programming languages -- C." A public draft of this standard is available at http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1256.pdf . |