3 % NOTE: this file controls which chapters/sections of the library
4 % manual are actually printed. It is easy to customize your manual
5 % by commenting out sections that you're not interested in.
7 \title{Python Library Reference
}
11 \makeindex % tell \index to actually write the
13 \makemodindex % ... and the module index as well.
21 \chapter*
{Front Matter
\label{front
}}
29 Python is an extensible, interpreted, object-oriented programming
30 language. It supports a wide range of applications, from simple text
31 processing scripts to interactive Web browsers.
33 While the
\citetitle[../ref/ref.html
]{Python Reference Manual
}
34 describes the exact syntax and semantics of the language, it does not
35 describe the standard library that is distributed with the language,
36 and which greatly enhances its immediate usability. This library
37 contains built-in modules (written in C) that provide access to system
38 functionality such as file I/O that would otherwise be inaccessible to
39 Python programmers, as well as modules written in Python that provide
40 standardized solutions for many problems that occur in everyday
41 programming. Some of these modules are explicitly designed to
42 encourage and enhance the portability of Python programs.
44 This library reference manual documents Python's standard library, as
45 well as many optional library modules (which may or may not be
46 available, depending on whether the underlying platform supports them
47 and on the configuration choices made at compile time). It also
48 documents the standard types of the language and its built-in
49 functions and exceptions, many of which are not or incompletely
50 documented in the Reference Manual.
52 This manual assumes basic knowledge about the Python language. For an
53 informal introduction to Python, see the
54 \citetitle[../tut/tut.html
]{Python Tutorial
}; the
55 \citetitle[../ref/ref.html
]{Python Reference Manual
} remains the
56 highest authority on syntactic and semantic questions. Finally, the
57 manual entitled
\citetitle[../ext/ext.html
]{Extending and Embedding
58 the Python Interpreter
} describes how to add new extensions to Python
59 and how to embed it in other applications.
67 \input{libintro
} % Introduction
74 \input{libobjs
} % Built-in Exceptions and Functions
79 \input{libstdtypes
} % Built-in types
83 % BASIC/GENERAL-PURPOSE OBJECTS
87 \input{libstrings
} % String Services
90 \input{libstruct
} % XXX also/better in File Formats?
95 \input{libunicodedata
}
100 \input{datatypes
} % Data types and structures
103 \input{libcollections
}
114 % General object services
123 \input{numeric
} % Numeric/Mathematical modules
129 % Functions, Functional, Generators and Iterators
130 % XXX intro functional
133 \input{liboperator
} % from runtime - better with itertools and functools
140 % Big move - include all the markup and internet formats here
143 \input{netdata
} % Internet Data Handling
150 \input{libmimewriter
}
162 \input{markup
} % Structured Markup Processing Tools
163 \input{libhtmlparser
}
168 \input{xmldomminidom
}
169 \input{xmldompulldom
}
171 \input{xmlsaxhandler
}
177 \input{fileformats
} % Miscellaneous file formats
180 \input{librobotparser
}
184 \input{libcrypto
} % Cryptographic Services
191 % FILE & DATABASE STORAGE
194 \input{filesys
} % File/directory support
195 \input{libposixpath
} % os.path
208 \input{archiving
} % Data compression and archiving
216 \input{persistence
} % Persistent storage
218 \input{libcopyreg
} % really copy_reg % from runtime...
236 \input{liballos
} % Generic Operating System Services
244 \input{libascii
} % curses.ascii
245 \input{libcursespanel
}
250 \input{libsomeos
} % Optional Operating System Services
254 \input{libdummythread
}
255 \input{libdummythreading
}
258 \input{librlcompleter
}
260 \input{libunix
} % UNIX Specific Services
280 % NETWORK & COMMUNICATIONS
283 \input{ipc
} % Interprocess communication/networking
284 \input{libsubprocess
}
291 \input{internet
} % Internet Protocols
292 \input{libwebbrowser
}
311 \input{libsimplehttp
}
316 \input{libsimplexmlrpc
}
323 \input{libmm
} % Multimedia Services
334 \input{libossaudiodev
}
336 % Tkinter is a chapter in its own right.
339 % % Internationalization
355 % % Software development support
362 \input{libpdb
} % The Python Debugger
364 \input{libprofile
} % The Python Profiler
365 \input{libhotshot
} % unmaintained C profiler
374 \input{libpython
} % Python Runtime Services
376 \input{libbltin
} % really __builtin__
377 \input{libmain
} % really __main__
379 \input{libcontextlib
}
382 \input{libfuture
} % really __future__
390 \input{custominterp
} % Custom interpreter
393 \input{librestricted
} % Restricted Execution
398 \input{modules
} % Importing Modules
402 \input{libmodulefinder
}
407 % PYTHON LANGUAGE & COMPILER
410 \input{language
} % Python Language Services
418 \input{libpycompile
} % really py_compile
419 \input{libcompileall
}
421 \input{libpickletools
}
424 \input{compiler
} % compiler package
427 \input{libmisc
} % Miscellaneous Services
431 % OTHER PLATFORM-SPECIFIC STUFF
434 %\input{libamoeba} % AMOEBA ONLY
436 %\input{libstdwin} % STDWIN ONLY
438 \input{libsgi
} % SGI IRIX ONLY
448 \input{libsun
} % SUNOS ONLY
451 \input{windows
} % MS Windows ONLY
460 %\chapter{Obsolete Modules}
465 \chapter{Reporting Bugs
}
466 \input{reportingbugs
}
468 \chapter{History and License
}
472 % The ugly "%begin{latexonly}" pseudo-environments are really just to
473 % keep LaTeX2HTML quiet during the \renewcommand{} macros; they're
474 % not really valuable.
478 \renewcommand{\indexname}{Module Index
}
480 \input{modlib.ind
} % Module Index
483 \renewcommand{\indexname}{Index
}
485 \input{lib.ind
} % Index