From f07bb12fc5c59430e995a64956b36331ce3629b9 Mon Sep 17 00:00:00 2001 From: hut Date: Fri, 25 Dec 2009 21:55:04 +0100 Subject: updated pydoc pages --- doc/sys.html | 244 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 244 insertions(+) create mode 100644 doc/sys.html (limited to 'doc/sys.html') diff --git a/doc/sys.html b/doc/sys.html new file mode 100644 index 00000000..b3de7023 --- /dev/null +++ b/doc/sys.html @@ -0,0 +1,244 @@ + +Python: built-in module sys + + + + + +
 
+ 
sys		index
(built-in)
Module Docs
+

This module provides access to some objects used or maintained by the
+interpreter and to functions that interact strongly with the interpreter.
+ 
+Dynamic objects:
+ 
+argv -- command line arguments; argv[0] is the script pathname if known
+path -- module search path; path[0] is the script directory, else ''
+modules -- dictionary of loaded modules
+ 
+displayhook -- called to show results in an interactive session
+excepthook -- called to handle any uncaught exception other than SystemExit
+  To customize printing in an interactive session or to install a custom
+  top-level exception handler, assign other functions to replace these.
+ 
+stdin -- standard input file object; used by input()
+stdout -- standard output file object; used by print()
+stderr -- standard error object; used for error messages
+  By assigning other file objects (or objects that behave like files)
+  to these, it is possible to redirect all of the interpreter's I/O.
+ 
+last_type -- type of last uncaught exception
+last_value -- value of last uncaught exception
+last_traceback -- traceback of last uncaught exception
+  These three are only available in an interactive session after a
+  traceback has been printed.
+ 
+Static objects:
+ 
+float_info -- a dict with information about the float implementation.
+int_info -- a struct sequence with information about the int implementation.
+maxsize -- the largest supported length of containers.
+maxunicode -- the largest supported character
+builtin_module_names -- tuple of module names built into this interpreter
+subversion -- subversion information of the build as tuple
+version -- the version of this interpreter as a string
+version_info -- version information as a named tuple
+hexversion -- version information encoded as a single integer
+copyright -- copyright notice pertaining to this interpreter
+platform -- platform identifier
+executable -- pathname of this Python interpreter
+prefix -- prefix used to find the Python library
+exec_prefix -- prefix used to find the machine-specific Python library
+float_repr_style -- string indicating the style of repr() output for floats
+__stdin__ -- the original stdin; don't touch!
+__stdout__ -- the original stdout; don't touch!
+__stderr__ -- the original stderr; don't touch!
+__displayhook__ -- the original displayhook; don't touch!
+__excepthook__ -- the original excepthook; don't touch!
+ 
+Functions:
+ 
+displayhook() -- print an object to the screen, and save it in builtins._
+excepthook() -- print an exception and its traceback to sys.stderr
+exc_info() -- return thread-safe information about the current exception
+exit() -- exit the interpreter by raising SystemExit
+getdlopenflags() -- returns flags to be used for dlopen() calls
+getprofile() -- get the global profiling function
+getrefcount() -- return the reference count for an object (plus one :-)
+getrecursionlimit() -- return the max recursion depth for the interpreter
+getsizeof() -- return the size of an object in bytes
+gettrace() -- get the global debug tracing function
+setcheckinterval() -- control how often the interpreter checks for events
+setdlopenflags() -- set the flags to be used for dlopen() calls
+setprofile() -- set the global profiling function
+setrecursionlimit() -- set the max recursion depth for the interpreter
+settrace() -- set the global debug tracing function

+

+ + + + + +
 
+Functions
       
__displayhook__ = displayhook(...)
displayhook(object) -> None
+ 
+Print an object to sys.stdout and also save it in builtins.
+
__excepthook__ = excepthook(...)
excepthook(exctype, value, traceback) -> None
+ 
+Handle an exception by displaying it with a traceback on sys.stderr.
+
call_tracing(...)
call_tracing(func, args) -> object
+ 
+Call func(*args), while tracing is enabled.  The tracing state is
+saved, and restored afterwards.  This is intended to be called from
+a debugger from a checkpoint, to recursively debug some other code.
+
callstats(...)
callstats() -> tuple of integers
+ 
+Return a tuple of function call statistics, if CALL_PROFILE was defined
+when Python was built.  Otherwise, return None.
+ 
+When enabled, this function returns detailed, implementation-specific
+details about the number of function calls executed. The return value is
+a 11-tuple where the entries in the tuple are counts of:
+0. all function calls
+1. calls to PyFunction_Type objects
+2. PyFunction calls that do not create an argument tuple
+3. PyFunction calls that do not create an argument tuple
+   and bypass PyEval_EvalCodeEx()
+4. PyMethod calls
+5. PyMethod calls on bound methods
+6. PyType calls
+7. PyCFunction calls
+8. generator calls
+9. All other calls
+10. Number of stack pops performed by call_function()
+
displayhook(...)
displayhook(object) -> None
+ 
+Print an object to sys.stdout and also save it in builtins.
+
exc_info(...)
exc_info() -> (type, value, traceback)
+ 
+Return information about the most recent exception caught by an except
+clause in the current stack frame or in an older stack frame.
+
excepthook(...)
excepthook(exctype, value, traceback) -> None
+ 
+Handle an exception by displaying it with a traceback on sys.stderr.
+
exit(...)
exit([status])
+ 
+Exit the interpreter by raising SystemExit(status).
+If the status is omitted or None, it defaults to zero (i.e., success).
+If the status is numeric, it will be used as the system exit status.
+If it is another kind of object, it will be printed and the system
+exit status will be one (i.e., failure).
+
getcheckinterval(...)
getcheckinterval() -> current check interval; see setcheckinterval().
+
getdefaultencoding(...)
getdefaultencoding() -> string
+ 
+Return the current default string encoding used by the Unicode 
+implementation.
+
getdlopenflags(...)
getdlopenflags() -> int
+ 
+Return the current value of the flags that are used for dlopen calls.
+The flag constants are defined in the ctypes and DLFCN modules.
+
getfilesystemencoding(...)
getfilesystemencoding() -> string
+ 
+Return the encoding used to convert Unicode filenames in
+operating system filenames.
+
getprofile(...)
getprofile()
+ 
+Return the profiling function set with sys.setprofile.
+See the profiler chapter in the library manual.
+
getrecursionlimit(...)
getrecursionlimit()
+ 
+Return the current value of the recursion limit, the maximum depth
+of the Python interpreter stack.  This limit prevents infinite
+recursion from causing an overflow of the C stack and crashing Python.
+
getrefcount(...)
getrefcount(object) -> integer
+ 
+Return the reference count of object.  The count returned is generally
+one higher than you might expect, because it includes the (temporary)
+reference as an argument to getrefcount().
+
getsizeof(...)
getsizeof(object, default) -> int
+ 
+Return the size of object in bytes.
+
gettrace(...)
gettrace()
+ 
+Return the global debug tracing function set with sys.settrace.
+See the debugger chapter in the library manual.
+
intern(...)
intern(string) -> string
+ 
+``Intern'' the given string.  This enters the string in the (global)
+table of interned strings whose purpose is to speed up dictionary lookups.
+Return the string itself or the previously interned string object with the
+same value.
+
setcheckinterval(...)
setcheckinterval(n)
+ 
+Tell the Python interpreter to check for asynchronous events every
+n instructions.  This also affects how often thread switches occur.
+
setdlopenflags(...)
setdlopenflags(n) -> None
+ 
+Set the flags used by the interpreter for dlopen calls, such as when the
+interpreter loads extension modules.  Among other things, this will enable
+a lazy resolving of symbols when importing a module, if called as
+sys.setdlopenflags(0).  To share symbols across extension modules, call as
+sys.setdlopenflags(ctypes.RTLD_GLOBAL).  Symbolic names for the flag modules
+can be either found in the ctypes module, or in the DLFCN module. If DLFCN
+is not available, it can be generated from /usr/include/dlfcn.h using the
+h2py script.
+
setfilesystemencoding(...)
setfilesystemencoding(string) -> None
+ 
+Set the encoding used to convert Unicode filenames in
+operating system filenames.
+
setprofile(...)
setprofile(function)
+ 
+Set the profiling function.  It will be called on each function call
+and return.  See the profiler chapter in the library manual.
+
setrecursionlimit(...)
setrecursionlimit(n)
+ 
+Set the maximum depth of the Python interpreter stack to n.  This
+limit prevents infinite recursion from causing an overflow of the C
+stack and crashing Python.  The highest possible limit is platform-
+dependent.
+
settrace(...)
settrace(function)
+ 
+Set the global debug tracing function.  It will be called on each
+function call.  See the debugger chapter in the library manual.
+

+ + + + + +
 
+Data
       __stderr__ = <_io.TextIOWrapper name='<stderr>' encoding='UTF-8'>
+__stdin__ = <_io.TextIOWrapper name='<stdin>' encoding='UTF-8'>
+__stdout__ = <_io.TextIOWrapper name='<stdout>' encoding='UTF-8'>
+api_version = 1013
+argv = ['./make_doc.py']
+builtin_module_names = ('__main__', '_ast', '_codecs', '_functools', '_io', '_locale', '_sre', '_symtable', '_thread', '_warnings', '_weakref', 'builtins', 'errno', 'gc', 'imp', 'marshal', 'posix', 'pwd', 'signal', 'sys', ...)
+byteorder = 'little'
+copyright = 'Copyright (c) 2001-2009 Python Software Foundati...ematisch Centrum, Amsterdam.\nAll Rights Reserved.'
+dont_write_bytecode = False
+exec_prefix = '/usr'
+executable = '/usr/bin/python3'
+flags = sys.flags(debug=0, division_warning=0, inspect=0...ignore_environment=0, verbose=0, bytes_warning=0)
+float_info = sys.floatinfo(max=1.7976931348623157e+308, max_e...epsilon=2.220446049250313e-16, radix=2, rounds=1)
+float_repr_style = 'short'
+hexversion = 50397680
+int_info = sys.int_info(bits_per_digit=30, sizeof_digit=4)
+maxsize = 9223372036854775807
+maxunicode = 1114111
+meta_path = []
+modules = {'__future__': <module '__future__' from '/usr/lib/python3.1/__future__.py'>, '__init__': <module '__init__' from '/home/hut/.ranger/__init__.py'>, '__main__': <module '__main__' from './make_doc.py'>, '_abcoll': <module '_abcoll' from '/usr/lib/python3.1/_abcoll.py'>, '_bisect': <module '_bisect' from '/usr/lib/python3.1/lib-dynload/_bisect.so'>, '_codecs': <module '_codecs' (built-in)>, '_collections': <module '_collections' from '/usr/lib/python3.1/lib-dynload/_collections.so'>, '_curses': <module '_curses' from '/usr/lib/python3.1/lib-dynload/_curses.so'>, '_functools': <module '_functools' (built-in)>, '_heapq': <module '_heapq' from '/usr/lib/python3.1/lib-dynload/_heapq.so'>, ...}
+path = ['/home/hut/.ranger', '/home/hut/work/ranger', '/usr/lib/python31.zip', '/usr/lib/python3.1', '/usr/lib/python3.1/plat-linux2', '/usr/lib/python3.1/lib-dynload', '/usr/lib/python3.1/site-packages', '/home/hut/.ranger']
+path_hooks = [<class 'zipimport.zipimporter'>]
+path_importer_cache = {'.': None, './make_doc.py': <imp.NullImporter object at 0x7f327d9e39f0>, '/home/hut/.ranger': None, '/home/hut/.ranger/colorschemes': None, '/home/hut/work/ranger': None, '/home/hut/work/ranger/ranger': None, '/home/hut/work/ranger/ranger/colorschemes': None, '/home/hut/work/ranger/ranger/container': None, '/home/hut/work/ranger/ranger/defaults': None, '/home/hut/work/ranger/ranger/ext': None, ...}
+platform = 'linux2'
+prefix = '/usr'
+stderr = <_io.TextIOWrapper name='<stderr>' encoding='UTF-8'>
+stdin = <_io.TextIOWrapper name='<stdin>' encoding='UTF-8'>
+stdout = <_io.TextIOWrapper name='<stdout>' encoding='UTF-8'>
+subversion = ('CPython', 'tags/r311', '74480')
+version = '3.1.1 (r311:74480, Aug 27 2009, 04:56:37) \n[GCC 4.4.1]'
+version_info = sys.version_info(major=3, minor=1, micro=1, releaselevel='final', serial=0)
+warnoptions = []
+ \ No newline at end of file -- cgit 1.4.1-2-gfad0