summaryrefslogtreecommitdiffstats
path: root/Doc/tutorial
diff options
context:
space:
mode:
authorEzio Melotti <ezio.melotti@gmail.com>2012-11-17 10:50:14 (GMT)
committerEzio Melotti <ezio.melotti@gmail.com>2012-11-17 10:50:14 (GMT)
commit52e855084dc21fc2ea9a8a4a8c9c0beab6a855c3 (patch)
treefd16cbf71307d52a52c2703a4ada2d22da60b7a6 /Doc/tutorial
parent89b03b0ec6ade7bce04aa3bdd9f43dc47781de4a (diff)
downloadcpython-52e855084dc21fc2ea9a8a4a8c9c0beab6a855c3.zip
cpython-52e855084dc21fc2ea9a8a4a8c9c0beab6a855c3.tar.gz
cpython-52e855084dc21fc2ea9a8a4a8c9c0beab6a855c3.tar.bz2
Update section about dir() in the tutorial.
Diffstat (limited to 'Doc/tutorial')
-rw-r--r--Doc/tutorial/modules.rst74
1 files changed, 41 insertions, 33 deletions
diff --git a/Doc/tutorial/modules.rst b/Doc/tutorial/modules.rst
index 15b8094..86c1a0d 100644
--- a/Doc/tutorial/modules.rst
+++ b/Doc/tutorial/modules.rst
@@ -288,16 +288,21 @@ defines. It returns a sorted list of strings::
>>> import fibo, sys
>>> dir(fibo)
['__name__', 'fib', 'fib2']
- >>> dir(sys)
- ['__displayhook__', '__doc__', '__excepthook__', '__name__', '__stderr__',
- '__stdin__', '__stdout__', '_getframe', 'api_version', 'argv',
- 'builtin_module_names', 'byteorder', 'callstats', 'copyright',
- 'displayhook', 'exc_info', 'excepthook',
- 'exec_prefix', 'executable', 'exit', 'getdefaultencoding', 'getdlopenflags',
- 'getrecursionlimit', 'getrefcount', 'hexversion', 'maxint', 'maxunicode',
- 'meta_path', 'modules', 'path', 'path_hooks', 'path_importer_cache',
- 'platform', 'prefix', 'ps1', 'ps2', 'setcheckinterval', 'setdlopenflags',
- 'setprofile', 'setrecursionlimit', 'settrace', 'stderr', 'stdin', 'stdout',
+ >>> dir(sys) # doctest: +NORMALIZE_WHITESPACE
+ ['__displayhook__', '__doc__', '__excepthook__', '__name__', '__package__',
+ '__stderr__', '__stdin__', '__stdout__', '_clear_type_cache',
+ '_current_frames', '_getframe', '_mercurial', '_xoptions', 'abiflags',
+ 'api_version', 'argv', 'builtin_module_names', 'byteorder', 'call_tracing',
+ 'callstats', 'copyright', 'displayhook', 'dont_write_bytecode', 'exc_info',
+ 'excepthook', 'exec_prefix', 'executable', 'exit', 'flags', 'float_info',
+ 'float_repr_style', 'getcheckinterval', 'getdefaultencoding',
+ 'getdlopenflags', 'getfilesystemencoding', 'getobjects', 'getprofile',
+ 'getrecursionlimit', 'getrefcount', 'getsizeof', 'getswitchinterval',
+ 'gettotalrefcount', 'gettrace', 'hash_info', 'hexversion', 'int_info',
+ 'intern', 'maxsize', 'maxunicode', 'meta_path', 'modules', 'path',
+ 'path_hooks', 'path_importer_cache', 'platform', 'prefix', 'ps1',
+ 'setcheckinterval', 'setdlopenflags', 'setprofile', 'setrecursionlimit',
+ 'setswitchinterval', 'settrace', 'stderr', 'stdin', 'stdout', 'subversion',
'version', 'version_info', 'warnoptions']
Without arguments, :func:`dir` lists the names you have defined currently::
@@ -306,7 +311,7 @@ Without arguments, :func:`dir` lists the names you have defined currently::
>>> import fibo
>>> fib = fibo.fib
>>> dir()
- ['__builtins__', '__doc__', '__file__', '__name__', 'a', 'fib', 'fibo', 'sys']
+ ['__builtins__', '__name__', 'a', 'fib', 'fibo', 'sys']
Note that it lists all types of names: variables, modules, functions, etc.
@@ -317,28 +322,31 @@ want a list of those, they are defined in the standard module
:mod:`builtins`::
>>> import builtins
- >>> dir(builtins)
-
- ['ArithmeticError', 'AssertionError', 'AttributeError', 'BaseException', 'Buffer
- Error', 'BytesWarning', 'DeprecationWarning', 'EOFError', 'Ellipsis', 'Environme
- ntError', 'Exception', 'False', 'FloatingPointError', 'FutureWarning', 'Generato
- rExit', 'IOError', 'ImportError', 'ImportWarning', 'IndentationError', 'IndexErr
- or', 'KeyError', 'KeyboardInterrupt', 'LookupError', 'MemoryError', 'NameError',
- 'None', 'NotImplemented', 'NotImplementedError', 'OSError', 'OverflowError', 'P
- endingDeprecationWarning', 'ReferenceError', 'RuntimeError', 'RuntimeWarning', '
- StopIteration', 'SyntaxError', 'SyntaxWarning', 'SystemError', 'SystemExit', 'Ta
- bError', 'True', 'TypeError', 'UnboundLocalError', 'UnicodeDecodeError', 'Unicod
- eEncodeError', 'UnicodeError', 'UnicodeTranslateError', 'UnicodeWarning', 'UserW
- arning', 'ValueError', 'Warning', 'ZeroDivisionError', '__build_class__', '__deb
- ug__', '__doc__', '__import__', '__name__', '__package__', 'abs', 'all', 'any',
- 'ascii', 'bin', 'bool', 'bytearray', 'bytes', 'chr', 'classmethod', 'compile', '
- complex', 'copyright', 'credits', 'delattr', 'dict', 'dir', 'divmod', 'enumerate
- ', 'eval', 'exec', 'exit', 'filter', 'float', 'format', 'frozenset', 'getattr',
- 'globals', 'hasattr', 'hash', 'help', 'hex', 'id', 'input', 'int', 'isinstance',
- 'issubclass', 'iter', 'len', 'license', 'list', 'locals', 'map', 'max', 'memory
- view', 'min', 'next', 'object', 'oct', 'open', 'ord', 'pow', 'print', 'property'
- , 'quit', 'range', 'repr', 'reversed', 'round', 'set', 'setattr', 'slice', 'sort
- ed', 'staticmethod', 'str', 'sum', 'super', 'tuple', 'type', 'vars', 'zip']
+ >>> dir(builtins) # doctest: +NORMALIZE_WHITESPACE
+ ['ArithmeticError', 'AssertionError', 'AttributeError', 'BaseException',
+ 'BufferError', 'BytesWarning', 'DeprecationWarning', 'EOFError',
+ 'Ellipsis', 'EnvironmentError', 'Exception', 'False', 'FloatingPointError',
+ 'FutureWarning', 'GeneratorExit', 'IOError', 'ImportError',
+ 'ImportWarning', 'IndentationError', 'IndexError', 'KeyError',
+ 'KeyboardInterrupt', 'LookupError', 'MemoryError', 'NameError', 'None',
+ 'NotImplemented', 'NotImplementedError', 'OSError', 'OverflowError',
+ 'PendingDeprecationWarning', 'ReferenceError', 'ResourceWarning',
+ 'RuntimeError', 'RuntimeWarning', 'StopIteration', 'SyntaxError',
+ 'SyntaxWarning', 'SystemError', 'SystemExit', 'TabError', 'True',
+ 'TypeError', 'UnboundLocalError', 'UnicodeDecodeError',
+ 'UnicodeEncodeError', 'UnicodeError', 'UnicodeTranslateError',
+ 'UnicodeWarning', 'UserWarning', 'ValueError', 'Warning',
+ 'ZeroDivisionError', '_', '__build_class__', '__debug__', '__doc__',
+ '__import__', '__name__', '__package__', 'abs', 'all', 'any', 'ascii',
+ 'bin', 'bool', 'bytearray', 'bytes', 'callable', 'chr', 'classmethod',
+ 'compile', 'complex', 'copyright', 'credits', 'delattr', 'dict', 'dir',
+ 'divmod', 'enumerate', 'eval', 'exec', 'exit', 'filter', 'float', 'format',
+ 'frozenset', 'getattr', 'globals', 'hasattr', 'hash', 'help', 'hex', 'id',
+ 'input', 'int', 'isinstance', 'issubclass', 'iter', 'len', 'license',
+ 'list', 'locals', 'map', 'max', 'memoryview', 'min', 'next', 'object',
+ 'oct', 'open', 'ord', 'pow', 'print', 'property', 'quit', 'range', 'repr',
+ 'reversed', 'round', 'set', 'setattr', 'slice', 'sorted', 'staticmethod',
+ 'str', 'sum', 'super', 'tuple', 'type', 'vars', 'zip']
.. _tut-packages: