Fred Drake | dca8792 | 1998-01-13 16:53:23 +0000 | [diff] [blame] | 1 | \documentclass[twoside,openright]{report} |
Fred Drake | 1f8449a | 1998-01-09 05:36:43 +0000 | [diff] [blame] | 2 | \usepackage{myformat} |
Guido van Rossum | 19f1b82 | 1991-11-12 15:41:57 +0000 | [diff] [blame] | 3 | |
Guido van Rossum | 8675115 | 1995-02-28 17:14:32 +0000 | [diff] [blame] | 4 | % NOTE: this file controls which chapters/sections of the library |
| 5 | % manual are actually printed. It is easy to customize your manual |
| 6 | % by commenting out sections that you're not interested in. |
| 7 | |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 8 | \title{Python Library Reference} |
Guido van Rossum | 515834a | 1991-01-22 11:45:29 +0000 | [diff] [blame] | 9 | |
Guido van Rossum | 16cd7f9 | 1994-10-06 10:29:26 +0000 | [diff] [blame] | 10 | \input{boilerplate} |
Guido van Rossum | 83eb962 | 1993-11-23 16:28:45 +0000 | [diff] [blame] | 11 | |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 12 | \makeindex % tell \index to actually write the .idx file |
| 13 | |
Guido van Rossum | 1230c08 | 1992-01-07 16:40:44 +0000 | [diff] [blame] | 14 | |
Guido van Rossum | 515834a | 1991-01-22 11:45:29 +0000 | [diff] [blame] | 15 | \begin{document} |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 16 | |
Guido van Rossum | 515834a | 1991-01-22 11:45:29 +0000 | [diff] [blame] | 17 | \maketitle |
| 18 | |
Guido van Rossum | 16cd7f9 | 1994-10-06 10:29:26 +0000 | [diff] [blame] | 19 | \input{copyright} |
| 20 | |
Guido van Rossum | 515834a | 1991-01-22 11:45:29 +0000 | [diff] [blame] | 21 | \begin{abstract} |
| 22 | |
| 23 | \noindent |
Guido van Rossum | 2ddd978 | 1995-03-30 16:01:33 +0000 | [diff] [blame] | 24 | Python is an extensible, interpreted, object-oriented programming |
| 25 | language. It supports a wide range of applications, from simple text |
| 26 | processing scripts to interactive WWW browsers. |
| 27 | |
Fred Drake | b2c6ef8 | 1997-12-18 15:56:05 +0000 | [diff] [blame] | 28 | While the \emph{Python Reference Manual} describes the exact syntax and |
Guido van Rossum | 2ddd978 | 1995-03-30 16:01:33 +0000 | [diff] [blame] | 29 | semantics of the language, it does not describe the standard library |
| 30 | that is distributed with the language, and which greatly enhances its |
| 31 | immediate usability. This library contains built-in modules (written |
| 32 | in C) that provide access to system functionality such as file I/O |
| 33 | that would otherwise be inaccessible to Python programmers, as well as |
| 34 | modules written in Python that provide standardized solutions for many |
| 35 | problems that occur in everyday programming. Some of these modules |
| 36 | are explicitly designed to encourage and enhance the portability of |
| 37 | Python programs. |
| 38 | |
| 39 | This library reference manual documents Python's standard library, as |
| 40 | well as many optional library modules (which may or may not be |
| 41 | available, depending on whether the underlying platform supports them |
| 42 | and on the configuration choices made at compile time). It also |
| 43 | documents the standard types of the language and its built-in |
| 44 | functions and exceptions, many of which are not or incompletely |
| 45 | documented in the Reference Manual. |
| 46 | |
| 47 | This manual assumes basic knowledge about the Python language. For an |
Fred Drake | b2c6ef8 | 1997-12-18 15:56:05 +0000 | [diff] [blame] | 48 | informal introduction to Python, see the \emph{Python Tutorial}; the |
Fred Drake | b660b63 | 1998-01-16 16:34:34 +0000 | [diff] [blame] | 49 | \emph{Python Reference Manual} remains the highest authority on |
| 50 | syntactic and semantic questions. Finally, the manual entitled |
| 51 | \emph{Extending and Embedding the Python Interpreter} describes how to |
| 52 | add new extensions to Python and how to embed it in other applications. |
Guido van Rossum | 515834a | 1991-01-22 11:45:29 +0000 | [diff] [blame] | 53 | |
| 54 | \end{abstract} |
| 55 | |
Fred Drake | 4d4f9e7 | 1998-01-13 22:25:02 +0000 | [diff] [blame] | 56 | \tableofcontents |
Guido van Rossum | 515834a | 1991-01-22 11:45:29 +0000 | [diff] [blame] | 57 | |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 58 | % Chapter title: |
| 59 | |
| 60 | \input{libintro} % Introduction |
| 61 | |
| 62 | \input{libobjs} % Built-in Types, Exceptions and Functions |
| 63 | \input{libtypes} |
| 64 | \input{libexcs} |
| 65 | \input{libfuncs} |
| 66 | |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 67 | \input{libpython} % Python Services |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 68 | \input{libsys} |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 69 | \input{libtypes2} % types is already taken :-( |
Guido van Rossum | 36764b8 | 1997-08-30 20:02:25 +0000 | [diff] [blame] | 70 | \input{libuserdict} |
Guido van Rossum | 61ed4db | 1996-12-06 21:22:41 +0000 | [diff] [blame] | 71 | \input{liboperator} |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 72 | \input{libtraceback} |
Guido van Rossum | d188358 | 1995-02-15 15:53:08 +0000 | [diff] [blame] | 73 | \input{libpickle} |
Fred Drake | 2d75443 | 1998-01-21 04:58:39 +0000 | [diff] [blame] | 74 | \input{libcopyreg} |
Guido van Rossum | d188358 | 1995-02-15 15:53:08 +0000 | [diff] [blame] | 75 | \input{libshelve} |
| 76 | \input{libcopy} |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 77 | \input{libmarshal} |
| 78 | \input{libimp} |
Guido van Rossum | 0fcbe8d | 1997-07-17 16:27:42 +0000 | [diff] [blame] | 79 | \input{libni} |
Guido van Rossum | ca81470 | 1995-10-11 17:32:29 +0000 | [diff] [blame] | 80 | \input{libparser} |
Fred Drake | b0df567 | 1998-02-18 15:59:13 +0000 | [diff] [blame^] | 81 | \input{libsymbol} |
| 82 | \input{libtoken} |
Fred Drake | 14bf341 | 1997-10-06 21:40:48 +0000 | [diff] [blame] | 83 | \input{libkeyword} |
Guido van Rossum | 61c2703 | 1997-07-18 21:08:07 +0000 | [diff] [blame] | 84 | \input{libcode} |
Fred Drake | 00eb96a | 1997-10-06 21:26:03 +0000 | [diff] [blame] | 85 | \input{libpprint} |
Guido van Rossum | eae121e | 1997-11-18 15:11:47 +0000 | [diff] [blame] | 86 | \input{libdis} |
Guido van Rossum | 571391b | 1997-04-03 22:41:49 +0000 | [diff] [blame] | 87 | \input{libsite} |
Guido van Rossum | 36764b8 | 1997-08-30 20:02:25 +0000 | [diff] [blame] | 88 | \input{libuser} |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 89 | \input{libbltin} % really __builtin__ |
| 90 | \input{libmain} % really __main__ |
| 91 | |
| 92 | \input{libstrings} % String Services |
| 93 | \input{libstring} |
Guido van Rossum | 9cb6480 | 1997-12-29 20:01:55 +0000 | [diff] [blame] | 94 | \input{libre} |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 95 | \input{libregex} |
| 96 | \input{libregsub} |
| 97 | \input{libstruct} |
Guido van Rossum | cda3d7d | 1997-03-03 16:01:21 +0000 | [diff] [blame] | 98 | \input{libstrio} |
Guido van Rossum | 3486f27 | 1996-12-12 17:02:21 +0000 | [diff] [blame] | 99 | \input{libsoundex} |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 100 | |
| 101 | \input{libmisc} % Miscellaneous Services |
| 102 | \input{libmath} |
Guido van Rossum | 84057a3 | 1997-07-17 16:15:18 +0000 | [diff] [blame] | 103 | \input{libcmath} |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 104 | \input{libwhrandom} |
Guido van Rossum | 571391b | 1997-04-03 22:41:49 +0000 | [diff] [blame] | 105 | \input{librandom} |
| 106 | \input{librand} |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 107 | \input{libarray} |
| 108 | |
| 109 | \input{liballos} % Generic Operating System Services |
| 110 | \input{libos} |
| 111 | \input{libtime} |
| 112 | \input{libgetopt} |
Guido van Rossum | dc46c7f | 1995-03-01 15:38:16 +0000 | [diff] [blame] | 113 | \input{libtempfile} |
Guido van Rossum | c0fcc44 | 1996-07-30 18:20:01 +0000 | [diff] [blame] | 114 | \input{liberrno} |
Guido van Rossum | b6a8026 | 1997-03-25 22:09:18 +0000 | [diff] [blame] | 115 | \input{libglob} |
Guido van Rossum | e76b7a8 | 1997-04-27 21:25:52 +0000 | [diff] [blame] | 116 | \input{libfnmatch} |
Guido van Rossum | bc12f78 | 1997-11-20 21:04:27 +0000 | [diff] [blame] | 117 | \input{liblocale} |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 118 | |
| 119 | \input{libsomeos} % Optional Operating System Services |
| 120 | \input{libsignal} |
| 121 | \input{libsocket} |
| 122 | \input{libselect} |
| 123 | \input{libthread} |
Barry Warsaw | 17c8e78 | 1997-11-20 19:54:16 +0000 | [diff] [blame] | 124 | \input{libqueue} |
Guido van Rossum | 571391b | 1997-04-03 22:41:49 +0000 | [diff] [blame] | 125 | \input{libanydbm} |
| 126 | \input{libwhichdb} |
Guido van Rossum | dfb4120 | 1997-04-30 19:40:10 +0000 | [diff] [blame] | 127 | \input{libzlib} |
Guido van Rossum | 0fcbe8d | 1997-07-17 16:27:42 +0000 | [diff] [blame] | 128 | \input{libgzip} |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 129 | |
| 130 | \input{libunix} % UNIX Specific Services |
| 131 | \input{libposix} |
| 132 | \input{libppath} % == posixpath |
| 133 | \input{libpwd} |
| 134 | \input{libgrp} |
Guido van Rossum | 5c6e373 | 1996-04-10 16:18:20 +0000 | [diff] [blame] | 135 | \input{libcrypt} |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 136 | \input{libdbm} |
| 137 | \input{libgdbm} |
| 138 | \input{libtermios} |
| 139 | \input{libfcntl} |
| 140 | \input{libposixfile} |
Guido van Rossum | 3c7b2dc | 1996-12-18 18:37:05 +0000 | [diff] [blame] | 141 | \input{libresource} |
Guido van Rossum | fbe34fa | 1995-10-09 20:49:57 +0000 | [diff] [blame] | 142 | \input{libsyslog} |
Guido van Rossum | 3dd68d3 | 1996-12-31 02:24:54 +0000 | [diff] [blame] | 143 | \input{libstat} |
Fred Drake | 4fd1292 | 1997-06-12 16:05:46 +0000 | [diff] [blame] | 144 | \input{libcommands} |
Guido van Rossum | df804f8 | 1995-03-02 12:38:39 +0000 | [diff] [blame] | 145 | |
| 146 | \input{libpdb} % The Python Debugger |
| 147 | |
| 148 | \input{libprofile} % The Python Profiler |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 149 | |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 150 | \input{libwww} % Internet and WWW Services |
Guido van Rossum | a12ef94 | 1995-02-27 17:53:25 +0000 | [diff] [blame] | 151 | \input{libcgi} |
Guido van Rossum | cca8d2b | 1995-03-22 15:48:46 +0000 | [diff] [blame] | 152 | \input{liburllib} |
| 153 | \input{libhttplib} |
Guido van Rossum | 817a842 | 1995-02-16 16:28:22 +0000 | [diff] [blame] | 154 | \input{libftplib} |
| 155 | \input{libgopherlib} |
Guido van Rossum | 817a842 | 1995-02-16 16:28:22 +0000 | [diff] [blame] | 156 | \input{libnntplib} |
Guido van Rossum | 817a842 | 1995-02-16 16:28:22 +0000 | [diff] [blame] | 157 | \input{liburlparse} |
Guido van Rossum | cca8d2b | 1995-03-22 15:48:46 +0000 | [diff] [blame] | 158 | \input{libsgmllib} |
Fred Drake | e1980ed | 1996-10-09 14:36:54 +0000 | [diff] [blame] | 159 | \input{libhtmllib} |
Guido van Rossum | eae121e | 1997-11-18 15:11:47 +0000 | [diff] [blame] | 160 | \input{libxmllib} |
Fred Drake | 53e84d5 | 1996-10-08 21:54:41 +0000 | [diff] [blame] | 161 | \input{libformatter} |
Guido van Rossum | cca8d2b | 1995-03-22 15:48:46 +0000 | [diff] [blame] | 162 | \input{librfc822} |
| 163 | \input{libmimetools} |
Jack Jansen | 4549b13 | 1995-08-29 11:30:24 +0000 | [diff] [blame] | 164 | \input{libbinascii} |
Guido van Rossum | 40006cf | 1996-08-19 22:58:03 +0000 | [diff] [blame] | 165 | \input{libxdrlib} |
Guido van Rossum | b6a8026 | 1997-03-25 22:09:18 +0000 | [diff] [blame] | 166 | \input{libmailcap} |
Guido van Rossum | e76b7a8 | 1997-04-27 21:25:52 +0000 | [diff] [blame] | 167 | \input{libbase64} |
| 168 | \input{libquopri} |
Guido van Rossum | 6181e00 | 1997-05-19 19:55:16 +0000 | [diff] [blame] | 169 | \input{libsocksvr} |
Guido van Rossum | e5bb790 | 1997-06-02 17:35:51 +0000 | [diff] [blame] | 170 | \input{libmailbox} |
Guido van Rossum | fd16ca4 | 1997-07-30 22:05:07 +0000 | [diff] [blame] | 171 | \input{libmimify} |
Guido van Rossum | 9cb6480 | 1997-12-29 20:01:55 +0000 | [diff] [blame] | 172 | \input{libbasehttp} |
Guido van Rossum | 817a842 | 1995-02-16 16:28:22 +0000 | [diff] [blame] | 173 | |
Guido van Rossum | 6e308d7 | 1996-10-22 01:11:53 +0000 | [diff] [blame] | 174 | \input{librestricted} |
| 175 | \input{librexec} |
| 176 | \input{libbastion} |
| 177 | |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 178 | \input{libmm} % Multimedia Services |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 179 | \input{libaudioop} |
| 180 | \input{libimageop} |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 181 | \input{libaifc} |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 182 | \input{libjpeg} |
| 183 | \input{librgbimg} |
Guido van Rossum | 40006cf | 1996-08-19 22:58:03 +0000 | [diff] [blame] | 184 | \input{libimghdr} |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 185 | |
Guido van Rossum | ecde781 | 1995-03-28 13:35:14 +0000 | [diff] [blame] | 186 | \input{libcrypto} % Cryptographic Services |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 187 | \input{libmd5} |
| 188 | \input{libmpz} |
| 189 | \input{librotor} |
| 190 | |
| 191 | %\input{libamoeba} % AMOEBA ONLY |
| 192 | |
Guido van Rossum | 8675115 | 1995-02-28 17:14:32 +0000 | [diff] [blame] | 193 | \input{libmac} % MACINTOSH ONLY |
Guido van Rossum | dc46c7f | 1995-03-01 15:38:16 +0000 | [diff] [blame] | 194 | \input{libctb} |
| 195 | \input{libmacconsole} |
Guido van Rossum | 85c4ff2 | 1995-03-07 10:12:11 +0000 | [diff] [blame] | 196 | \input{libmacdnr} |
Guido van Rossum | dc46c7f | 1995-03-01 15:38:16 +0000 | [diff] [blame] | 197 | \input{libmacfs} |
Guido van Rossum | e229d86 | 1997-08-18 15:14:26 +0000 | [diff] [blame] | 198 | \input{libmacic} |
Jack Jansen | ebed45f | 1995-08-14 13:40:05 +0000 | [diff] [blame] | 199 | \input{libmacos} |
Jack Jansen | da53c52 | 1995-10-10 14:43:20 +0000 | [diff] [blame] | 200 | \input{libmacostools} |
Guido van Rossum | dc46c7f | 1995-03-01 15:38:16 +0000 | [diff] [blame] | 201 | \input{libmactcp} |
| 202 | \input{libmacspeech} |
Jack Jansen | da53c52 | 1995-10-10 14:43:20 +0000 | [diff] [blame] | 203 | \input{libmacui} |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 204 | |
Guido van Rossum | e5bb790 | 1997-06-02 17:35:51 +0000 | [diff] [blame] | 205 | %\input{libstdwin} % STDWIN ONLY |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 206 | |
| 207 | \input{libsgi} % SGI IRIX ONLY |
| 208 | \input{libal} |
Sjoerd Mullender | ffd6de1 | 1995-03-28 11:56:52 +0000 | [diff] [blame] | 209 | \input{libcd} |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 210 | \input{libfl} |
| 211 | \input{libfm} |
| 212 | \input{libgl} |
| 213 | \input{libimgfile} |
| 214 | %\input{libpanel} |
| 215 | |
| 216 | \input{libsun} % SUNOS ONLY |
| 217 | |
Guido van Rossum | 612316f | 1997-03-14 04:12:52 +0000 | [diff] [blame] | 218 | \input{libundoc} |
| 219 | |
Fred Drake | 0b1337d | 1998-01-02 02:59:09 +0000 | [diff] [blame] | 220 | \renewcommand{\indexname}{Module Index} |
| 221 | \input{modules.ind} % Module Index |
| 222 | |
| 223 | \renewcommand{\indexname}{Index} |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 224 | \input{lib.ind} % Index |
Guido van Rossum | 515834a | 1991-01-22 11:45:29 +0000 | [diff] [blame] | 225 | |
| 226 | \end{document} |