18.24.3 DateTime Objects

Python 2.5

previous page next page

18.24.3 DateTime Objects

This class may be initialized with seconds since the epoch, a time tuple, an ISO 8601 time/date string, or a datetime.datetime, datetime.date or datetime.time instance. It has the following methods, supported mainly for internal use by the marshalling/unmarshalling code:

decode( string): Accept a string as the instance's new time value.

encode( out) Write the XML-RPC encoding of this DateTime item to the out stream object. It also supports certain of Python's built-in operators through __cmp__() and __repr__() methods. Python Library Reference Previous: 18.24.2 Boolean Objects Up: 18.24 xmlrpclib Next: 18.24.4 Binary Objects Release 2.5, documentation updated on 19th September, 2006. See About this document... for information on suggesting changes.

previous page start next page

Menu Homepage Table of contents Main page Global Module Index What's New 1 PEP 308: Conditional Expressions 2 PEP 309: Partial Function Application 3 PEP 314: Metadata for Python Software Packages v1.1 4 PEP 328: Absolute and Relative Imports 5 PEP 338: Executing Modules as Scripts 6 PEP 341: Unified try/except/finally 7 PEP 342: New Generator Features 8 PEP 343: The 'with' statement 8.1 Writing Context Managers 8.2 The contextlib module 9 PEP 352: Exceptions as New-Style Classes 10 PEP 353: Using ssize_t as the index type 11 PEP 357: The '__index__' method 12 Other Language Changes 12.1 Interactive Interpreter Changes 12.2 Optimizations 13 New, Improved, and Removed Modules 13.1 The ctypes package 13.2 The ElementTree package 13.3 The hashlib package 13.4 The sqlite3 package 13.5 The wsgiref package 14 Build and C API Changes 14.1 Port-Specific Changes 15 Porting to Python 2.5 16 Acknowledgements Tutorial 1. Whetting Your Appetite 2. Using the Python Interpreter 2.1 Invoking the Interpreter 2.1.1 Argument Passing 2.1.2 Interactive Mode 2.2 The Interpreter and Its Environment 2.2.1 Error Handling 2.2.2 Executable Python Scripts 2.2.3 Source Code Encoding 2.2.4 The Interactive Startup File 3. An Informal Introduction to Python 3.1 Using Python as a Calculator 3.1.1 Numbers 3.1.2 Strings 3.1.3 Unicode Strings 3.1.4 Lists 3.2 First Steps Towards Programming 4. More Control Flow Tools 4.1 if Statements 4.2 for Statements 4.3 The range() Function 4.4 break and continue Statements, and else Clauses on Loops 4.5 pass Statements 4.6 Defining Functions 4.7 More on Defining Functions 4.7.1 Default Argument Values 4.7.2 Keyword Arguments 4.7.3 Arbitrary Argument Lists 4.7.4 Unpacking Argument Lists 4.7.5 Lambda Forms 4.7.6 Documentation Strings 5. Data Structures 5.1 More on Lists 5.1.1 Using Lists as Stacks 5.1.2 Using Lists as Queues 5.1.3 Functional Programming Tools 5.1.4 List Comprehensions 5.2 The del statement 5.3 Tuples and Sequences 5.4 Sets 5.5 Dictionaries 5.6 Looping Techniques 5.7 More on Conditions 5.8 Comparing Sequences and Other Types 6. Modules 6.1 More on Modules 6.1.1 The Module Search Path 6.1.2 ``Compiled'' Python files 6.2 Standard Modules 6.3 The dir() Function 6.4 Packages 6.4.1 Importing * From a Package 6.4.2 Intra-package References 6.4.3 Packages in Multiple Directories 7. Input and Output 7.1 Fancier Output Formatting 7.2 Reading and Writing Files 7.2.1 Methods of File Objects 7.2.2 The pickle Module 8. Errors and Exceptions 8.1 Syntax Errors 8.2 Exceptions 8.3 Handling Exceptions 8.4 Raising Exceptions 8.5 User-defined Exceptions 8.6 Defining Clean-up Actions 8.7 Predefined Clean-up Actions 9. Classes 9.1 A Word About Terminology 9.2 Python Scopes and Name Spaces 9.3 A First Look at Classes 9.3.1 Class Definition Syntax 9.3.2 Class Objects 9.3.3 Instance Objects 9.3.4 Method Objects 9.4 Random Remarks 9.5 Inheritance 9.5.1 Multiple Inheritance 9.6 Private Variables 9.7 Odds and Ends 9.8 Exceptions Are Classes Too 9.9 Iterators 9.10 Generators 9.11 Generator Expressions 10. Brief Tour of the Standard Library 10.1 Operating System Interface 10.2 File Wildcards 10.3 Command Line Arguments 10.4 Error Output Redirection and Program Termination 10.5 String Pattern Matching 10.6 Mathematics 10.7 Internet Access 10.8 Dates and Times 10.9 Data Compression 10.10 Performance Measurement 10.11 Quality Control 10.12 Batteries Included 11. Brief Tour of the Standard Library - Part II 11.1 Output Formatting 11.2 Templating 11.3 Working with Binary Data Record Layouts 11.4 Multi-threading 11.5 Logging 11.6 Weak References 11.7 Tools for Working with Lists 11.8 Decimal Floating Point Arithmetic 12. What Now? A. Interactive Input Editing and History Substitution A.1 Line Editing A.2 History Substitution A.3 Key Bindings A.4 Commentary B. Floating Point Arithmetic: Issues and Limitations B.1 Representation Error C. History and License C.1 History of the software C.2 Terms and conditions for accessing or otherwise using Python C.3 Licenses and Acknowledgements for Incorporated Software C.3.1 Mersenne Twister C.3.2 Sockets C.3.3 Floating point exception control C.3.4 MD5 message digest algorithm C.3.5 Asynchronous socket services C.3.6 Cookie management C.3.7 Profiling C.3.8 Execution tracing C.3.9 UUencode and UUdecode functions C.3.10 XML Remote Procedure Calls D. Glossary Index Library Reference 1. Introduction 2. Built-in Objects 2.1 Built-in Functions 2.2 Non-essential Built-in Functions 2.3 Built-in Exceptions 2.4 Built-in Constants 3. Built-in Types 3.1 Truth Value Testing 3.2 Boolean Operations -- and, or, not 3.3 Comparisons 3.4 Numeric Types -- int, float, long, complex 3.4.1 Bit-string Operations on Integer Types 3.5 Iterator Types 3.6 Sequence Types -- str, unicode, list, tuple, buffer, xrange 3.6.1 String Methods 3.6.2 String Formatting Operations 3.6.3 XRange Type 3.6.4 Mutable Sequence Types 3.7 Set Types -- set, frozenset 3.8 Mapping Types -- dict 3.9 File Objects 3.10 Context Manager Types 3.11 Other Built-in Types 3.11.1 Modules 3.11.2 Classes and Class Instances 3.11.3 Functions 3.11.4 Methods 3.11.5 Code Objects 3.11.6 Type Objects 3.11.7 The Null Object 3.11.8 The Ellipsis Object 3.11.9 Boolean Values 3.11.10 Internal Objects 3.12 Special Attributes 4. String Services 4.1 string -- Common string operations 4.1.1 String constants 4.1.2 Template strings 4.1.3 String functions 4.1.4 Deprecated string functions 4.2 re -- Regular expression operations 4.2.1 Regular Expression Syntax 4.2.2 Matching vs Searching 4.2.3 Module Contents 4.2.4 Regular Expression Objects 4.2.5 Match Objects 4.2.6 Examples 4.3 struct -- Interpret strings as packed binary data 4.4 difflib -- Helpers for computing deltas 4.4.1 SequenceMatcher Objects 4.4.2 SequenceMatcher Examples 4.4.3 Differ Objects 4.4.4 Differ Example 4.5 StringIO -- Read and write strings as files 4.6 cStringIO -- Faster version of StringIO 4.7 textwrap -- Text wrapping and filling 4.8 codecs -- Codec registry and base classes 4.8.1 Codec Base Classes 4.8.2 Encodings and Unicode 4.8.3 Standard Encodings 4.8.4 encodings.idna -- Internationalized Domain Names in Applications 4.8.5 encodings.utf_8_sig -- UTF-8 codec with BOM signature 4.9 unicodedata -- Unicode Database 4.10 stringprep -- Internet String Preparation 4.11 fpformat -- Floating point conversions 5. Data Types 5.1 datetime -- Basic date and time types 5.1.1 Available Types 5.1.2 timedelta Objects 5.1.3 date Objects 5.1.4 datetime Objects 5.1.5 time Objects 5.1.6 tzinfo Objects 5.1.7 strftime() Behavior 5.1.8 Examples 5.2 calendar -- General calendar-related functions 5.3 collections -- High-performance container datatypes 5.3.1 deque objects 5.3.2 defaultdict objects 5.4 heapq -- Heap queue algorithm 5.4.1 Theory 5.5 bisect -- Array bisection algorithm 5.5.1 Examples 5.6 array -- Efficient arrays of numeric values 5.7 sets -- Unordered collections of unique elements 5.7.1 Set Objects 5.7.2 Example 5.7.3 Protocol for automatic conversion to immutable 5.7.4 Comparison to the built-in set types 5.8 sched -- Event scheduler 5.8.1 Scheduler Objects 5.9 mutex -- Mutual exclusion support 5.9.1 Mutex Objects 5.10 Queue -- A synchronized queue class 5.10.1 Queue Objects 5.11 weakref -- Weak references 5.11.1 Weak Reference Objects 5.11.2 Example 5.12 UserDict -- Class wrapper for dictionary objects 5.13 UserList -- Class wrapper for list objects 5.14 UserString -- Class wrapper for string objects 5.15 types -- Names for built-in types 5.16 new -- Creation of runtime internal objects 5.17 copy -- Shallow and deep copy operations 5.18 pprint -- Data pretty printer 5.18.1 PrettyPrinter Objects 5.19 repr -- Alternate repr() implementation 5.19.1 Repr Objects 5.19.2 Subclassing Repr Objects 6. Numeric and Mathematical Modules 6.1 math -- Mathematical functions 6.2 cmath -- Mathematical functions for complex numbers 6.3 decimal -- Decimal floating point arithmetic 6.3.1 Quick-start Tutorial 6.3.2 Decimal objects 6.3.3 Context objects 6.3.4 Signals 6.3.5 Floating Point Notes 6.3.6 Working with threads 6.3.7 Recipes 6.3.8 Decimal FAQ 6.4 random -- Generate pseudo-random numbers 6.5 itertools -- Functions creating iterators for efficient looping 6.5.1 Itertool functions 6.5.2 Examples 6.5.3 Recipes 6.6 functools -- Higher order functions and operations on callable objects. 6.6.1 partial Objects 6.7 operator -- Standard operators as functions. 6.7.1 Mapping Operators to Functions 7. Internet Data Handling 7.1 email -- An email and MIME handling package 7.1.1 Representing an email message 7.1.2 Parsing email messages 7.1.3 Generating MIME documents 7.1.4 Creating email and MIME objects from scratch 7.1.5 Internationalized headers 7.1.6 Representing character sets 7.1.7 Encoders 7.1.8 Exception and Defect classes 7.1.9 Miscellaneous utilities 7.1.10 Iterators 7.1.11 Package History 7.1.12 Differences from mimelib 7.1.13 Examples 7.2 mailcap -- Mailcap file handling. 7.3 mailbox -- Manipulate mailboxes in various formats 7.3.1 Mailbox objects 7.3.2 Message objects 7.3.3 Exceptions 7.3.4 Deprecated classes and methods 7.3.5 Examples 7.4 mhlib -- Access to MH mailboxes 7.4.1 MH Objects 7.4.2 Folder Objects 7.4.3 Message Objects 7.5 mimetools -- Tools for parsing MIME messages 7.5.1 Additional Methods of Message Objects 7.6 mimetypes -- Map filenames to MIME types 7.6.1 MimeTypes Objects 7.7 MimeWriter -- Generic MIME file writer 7.7.1 MimeWriter Objects 7.8 mimify -- MIME processing of mail messages 7.9 multifile -- Support for files containing distinct parts 7.9.1 MultiFile Objects 7.9.2 MultiFile Example 7.10 rfc822 -- Parse RFC 2822 mail headers 7.10.1 Message Objects 7.10.2 AddressList Objects 7.11 base64 -- RFC 3548: Base16, Base32, Base64 Data Encodings 7.12 binhex -- Encode and decode binhex4 files 7.12.1 Notes 7.13 binascii -- Convert between binary and ASCII 7.14 quopri -- Encode and decode MIME quoted-printable data 7.15 uu -- Encode and decode uuencode files 8. Structured Markup Processing Tools 8.1 HTMLParser -- Simple HTML and XHTML parser 8.1.1 Example HTML Parser Application 8.2 sgmllib -- Simple SGML parser 8.3 htmllib -- A parser for HTML documents 8.3.1 HTMLParser Objects 8.4 htmlentitydefs -- Definitions of HTML general entities 8.5 xml.parsers.expat -- Fast XML parsing using Expat 8.5.1 XMLParser Objects 8.5.2 ExpatError Exceptions 8.5.3 Example 8.5.4 Content Model Descriptions 8.5.5 Expat error constants 8.6 xml.dom -- The Document Object Model API 8.6.1 Module Contents 8.6.2 Objects in the DOM 8.6.3 Conformance 8.7 xml.dom.minidom -- Lightweight DOM implementation 8.7.1 DOM Objects 8.7.2 DOM Example 8.7.3 minidom and the DOM standard 8.8 xml.dom.pulldom -- Support for building partial DOM trees 8.8.1 DOMEventStream Objects 8.9 xml.sax -- Support for SAX2 parsers 8.9.1 SAXException Objects 8.10 xml.sax.handler -- Base classes for SAX handlers 8.10.1 ContentHandler Objects 8.10.2 DTDHandler Objects 8.10.3 EntityResolver Objects 8.10.4 ErrorHandler Objects 8.11 xml.sax.saxutils -- SAX Utilities 8.12 xml.sax.xmlreader -- Interface for XML parsers 8.12.1 XMLReader Objects 8.12.2 IncrementalParser Objects 8.12.3 Locator Objects 8.12.4 InputSource Objects 8.12.5 The Attributes Interface 8.12.6 The AttributesNS Interface 8.13 xml.etree.ElementTree -- The ElementTree XML API 8.13.1 Functions 8.13.2 ElementTree Objects 8.13.3 QName Objects 8.13.4 TreeBuilder Objects 8.13.5 XMLTreeBuilder Objects 9. File Formats 9.1 csv -- CSV File Reading and Writing 9.1.1 Module Contents 9.1.2 Dialects and Formatting Parameters 9.1.3 Reader Objects 9.1.4 Writer Objects 9.1.5 Examples 9.2 ConfigParser -- Configuration file parser 9.2.1 RawConfigParser Objects 9.2.2 ConfigParser Objects 9.2.3 SafeConfigParser Objects 9.3 robotparser -- Parser for robots.txt 9.4 netrc -- netrc file processing 9.4.1 netrc Objects 9.5 xdrlib -- Encode and decode XDR data 9.5.1 Packer Objects 9.5.2 Unpacker Objects 9.5.3 Exceptions 10. Cryptographic Services 10.1 hashlib -- Secure hashes and message digests 10.2 hmac -- Keyed-Hashing for Message Authentication 10.3 md5 -- MD5 message digest algorithm 10.4 sha -- SHA-1 message digest algorithm 11. File and Directory Access 11.1 os.path -- Common pathname manipulations 11.2 fileinput -- Iterate over lines from multiple input streams 11.3 stat -- Interpreting stat() results 11.4 statvfs -- Constants used with os.statvfs() 11.5 filecmp -- File and Directory Comparisons 11.5.1 The dircmp class 11.6 tempfile -- Generate temporary files and directories 11.7 glob -- Unix style pathname pattern expansion 11.8 fnmatch -- Unix filename pattern matching 11.9 linecache -- Random access to text lines 11.10 shutil -- High-level file operations 11.10.1 Example 11.11 dircache -- Cached directory listings 12. Data Compression and Archiving 12.1 zlib -- Compression compatible with gzip 12.2 gzip -- Support for gzip files 12.3 bz2 -- Compression compatible with bzip2 12.3.1 (De)compression of files 12.3.2 Sequential (de)compression 12.3.3 One-shot (de)compression 12.4 zipfile -- Work with ZIP archives 12.4.1 ZipFile Objects 12.4.2 PyZipFile Objects 12.4.3 ZipInfo Objects 12.5 tarfile -- Read and write tar archive files 12.5.1 TarFile Objects 12.5.2 TarInfo Objects 12.5.3 Examples 13. Data Persistence 13.1 pickle -- Python object serialization 13.1.1 Relationship to other Python modules 13.1.2 Data stream format 13.1.3 Usage 13.1.4 What can be pickled and unpickled? 13.1.5 The pickle protocol 13.1.6 Subclassing Unpicklers 13.1.7 Example 13.2 cPickle -- A faster pickle 13.3 copy_reg -- Register pickle support functions 13.4 shelve -- Python object persistence 13.4.1 Restrictions 13.4.2 Example 13.5 marshal -- Internal Python object serialization 13.6 anydbm -- Generic access to DBM-style databases 13.7 whichdb -- Guess which DBM module created a database 13.8 dbm -- Simple ``database'' interface 13.9 gdbm -- GNU's reinterpretation of dbm 13.10 dbhash -- DBM-style interface to the BSD database library 13.10.1 Database Objects 13.11 bsddb -- Interface to Berkeley DB library 13.11.1 Hash, BTree and Record Objects 13.12 dumbdbm -- Portable DBM implementation 13.12.1 Dumbdbm Objects 13.13 sqlite3 -- DB-API 2.0 interface for SQLite databases 13.13.1 Module functions and constants 13.13.2 Connection Objects 13.13.3 Cursor Objects 13.13.4 SQLite and Python types 13.13.5 Controlling Transactions 13.13.6 Using pysqlite efficiently 14. Generic Operating System Services 14.1 os -- Miscellaneous operating system interfaces 14.1.1 Process Parameters 14.1.2 File Object Creation 14.1.3 File Descriptor Operations 14.1.4 Files and Directories 14.1.5 Process Management 14.1.6 Miscellaneous System Information 14.1.7 Miscellaneous Functions 14.2 time -- Time access and conversions 14.3 optparse -- More powerful command line option parser 14.3.1 Background 14.3.2 Tutorial 14.3.3 Reference Guide 14.3.4 Option Callbacks 14.3.5 Extending optparse 14.4 getopt -- Parser for command line options 14.5 logging -- Logging facility for Python 14.5.1 Logger Objects 14.5.2 Basic example 14.5.3 Logging to multiple destinations 14.5.4 Sending and receiving logging events across a network 14.5.5 Handler Objects 14.5.6 Formatter Objects 14.5.7 Filter Objects 14.5.8 LogRecord Objects 14.5.9 Thread Safety 14.5.10 Configuration 14.6 getpass -- Portable password input 14.7 curses -- Terminal handling for character-cell displays 14.7.1 Functions 14.7.2 Window Objects 14.7.3 Constants 14.8 curses.textpad -- Text input widget for curses programs 14.8.1 Textbox objects 14.9 curses.wrapper -- Terminal handler for curses programs 14.10 curses.ascii -- Utilities for ASCII characters 14.11 curses.panel -- A panel stack extension for curses. 14.11.1 Functions 14.11.2 Panel Objects 14.12 platform -- Access to underlying platform's identifying data. 14.12.1 Cross Platform 14.12.2 Java Platform 14.12.3 Windows Platform 14.12.4 Mac OS Platform 14.12.5 Unix Platforms 14.13 errno -- Standard errno system symbols 14.14 ctypes -- A foreign function library for Python. 14.14.1 ctypes tutorial 14.14.2 ctypes reference 15. Optional Operating System Services 15.1 select -- Waiting for I/O completion 15.1.1 Polling Objects 15.2 thread -- Multiple threads of control 15.3 threading -- Higher-level threading interface 15.3.1 Lock Objects 15.3.2 RLock Objects 15.3.3 Condition Objects 15.3.4 Semaphore Objects 15.3.5 Event Objects 15.3.6 Thread Objects 15.3.7 Timer Objects 15.3.8 Using locks, conditions, and semaphores in the with statement 15.4 dummy_thread -- Drop-in replacement for the thread module 15.5 dummy_threading -- Drop-in replacement for the threading module 15.6 mmap -- Memory-mapped file support 15.7 readline -- GNU readline interface 15.7.1 Example 15.8 rlcompleter -- Completion function for GNU readline 15.8.1 Completer Objects 16. Unix Specific Services 16.1 posix -- The most common POSIX system calls 16.1.1 Large File Support 16.1.2 Module Contents 16.2 pwd -- The password database 16.3 spwd -- The shadow password database 16.4 grp -- The group database 16.5 crypt -- Function to check Unix passwords 16.6 dl -- Call C functions in shared objects 16.6.1 Dl Objects 16.7 termios -- POSIX style tty control 16.7.1 Example 16.8 tty -- Terminal control functions 16.9 pty -- Pseudo-terminal utilities 16.10 fcntl -- The fcntl() and ioctl() system calls 16.11 pipes -- Interface to shell pipelines 16.11.1 Template Objects 16.12 posixfile -- File-like objects with locking support 16.13 resource -- Resource usage information 16.13.1 Resource Limits 16.13.2 Resource Usage 16.14 nis -- Interface to Sun's NIS (Yellow Pages) 16.15 syslog -- Unix syslog library routines 16.16 commands -- Utilities for running commands 17. Interprocess Communication and Networking 17.1 subprocess -- Subprocess management 17.1.1 Using the subprocess Module 17.1.2 Popen Objects 17.1.3 Replacing Older Functions with the subprocess Module 17.2 socket -- Low-level networking interface 17.2.1 Socket Objects 17.2.2 SSL Objects 17.2.3 Example 17.3 signal -- Set handlers for asynchronous events 17.3.1 Example 17.4 popen2 -- Subprocesses with accessible I/O streams 17.4.1 Popen3 and Popen4 Objects 17.4.2 Flow Control Issues 17.5 asyncore -- Asynchronous socket handler 17.5.1 asyncore Example basic HTTP client 17.6 asynchat -- Asynchronous socket command/response handler 17.6.1 asynchat - Auxiliary Classes and Functions 17.6.2 asynchat Example 18. Internet Protocols and Support 18.1 webbrowser -- Convenient Web-browser controller 18.1.1 Browser Controller Objects 18.2 cgi -- Common Gateway Interface support. 18.2.1 Introduction 18.2.2 Using the cgi module 18.2.3 Higher Level Interface 18.2.4 Old classes 18.2.5 Functions 18.2.6 Caring about security 18.2.7 Installing your CGI script on a Unix system 18.2.8 Testing your CGI script 18.2.9 Debugging CGI scripts 18.2.10 Common problems and solutions 18.3 cgitb -- Traceback manager for CGI scripts 18.4 wsgiref -- WSGI Utilities and Reference Implementation 18.4.1 wsgiref.util - WSGI environment utilities 18.4.2 wsgiref.headers - WSGI response header tools 18.4.3 wsgiref.simple_server - a simple WSGI HTTP server 18.4.4 wsgiref.validate - WSGI conformance checker 18.4.5 wsgiref.handlers - server/gateway base classes 18.5 urllib -- Open arbitrary resources by URL 18.5.1 URLopener Objects 18.5.2 Examples 18.6 urllib2 -- extensible library for opening URLs 18.6.1 Request Objects 18.6.2 OpenerDirector Objects 18.6.3 BaseHandler Objects 18.6.4 HTTPRedirectHandler Objects 18.6.5 HTTPCookieProcessor Objects 18.6.6 ProxyHandler Objects 18.6.7 HTTPPasswordMgr Objects 18.6.8 AbstractBasicAuthHandler Objects 18.6.9 HTTPBasicAuthHandler Objects 18.6.10 ProxyBasicAuthHandler Objects 18.6.11 AbstractDigestAuthHandler Objects 18.6.12 HTTPDigestAuthHandler Objects 18.6.13 ProxyDigestAuthHandler Objects 18.6.14 HTTPHandler Objects 18.6.15 HTTPSHandler Objects 18.6.16 FileHandler Objects 18.6.17 FTPHandler Objects 18.6.18 CacheFTPHandler Objects 18.6.19 GopherHandler Objects 18.6.20 UnknownHandler Objects 18.6.21 HTTPErrorProcessor Objects 18.6.22 Examples 18.7 httplib -- HTTP protocol client 18.7.1 HTTPConnection Objects 18.7.2 HTTPResponse Objects 18.7.3 Examples 18.8 ftplib -- FTP protocol client 18.8.1 FTP Objects 18.9 gopherlib -- Gopher protocol client 18.10 poplib -- POP3 protocol client 18.10.1 POP3 Objects 18.10.2 POP3 Example 18.11 imaplib -- IMAP4 protocol client 18.11.1 IMAP4 Objects 18.11.2 IMAP4 Example 18.12 nntplib -- NNTP protocol client 18.12.1 NNTP Objects 18.13 smtplib -- SMTP protocol client 18.13.1 SMTP Objects 18.13.2 SMTP Example 18.14 smtpd -- SMTP Server 18.14.1 SMTPServer Objects 18.14.2 DebuggingServer Objects 18.14.3 PureProxy Objects 18.14.4 MailmanProxy Objects 18.15 telnetlib -- Telnet client 18.15.1 Telnet Objects 18.15.2 Telnet Example 18.16 uuid -- UUID objects according to RFC 4122 18.16.1 Example 18.17 urlparse -- Parse URLs into components 18.17.1 Results of urlparse() and urlsplit() 18.18 SocketServer -- A framework for network servers 18.18.1 Server Creation Notes 18.18.2 Server Objects 18.18.3 RequestHandler Objects 18.19 BaseHTTPServer -- Basic HTTP server 18.20 SimpleHTTPServer -- Simple HTTP request handler 18.21 CGIHTTPServer -- CGI-capable HTTP request handler 18.22 cookielib -- Cookie handling for HTTP clients 18.22.1 CookieJar and FileCookieJar Objects 18.22.2 FileCookieJar subclasses and co-operation with web browsers 18.22.3 CookiePolicy Objects 18.22.4 DefaultCookiePolicy Objects 18.22.5 Cookie Objects 18.22.6 Examples 18.23 Cookie -- HTTP state management 18.23.1 Cookie Objects 18.23.2 Morsel Objects 18.23.3 Example 18.24 xmlrpclib -- XML-RPC client access 18.24.1 ServerProxy Objects 18.24.2 Boolean Objects 18.24.3 DateTime Objects 18.24.4 Binary Objects 18.24.5 Fault Objects 18.24.6 ProtocolError Objects 18.24.7 MultiCall Objects 18.24.8 Convenience Functions 18.24.9 Example of Client Usage 18.25 SimpleXMLRPCServer -- Basic XML-RPC server 18.25.1 SimpleXMLRPCServer Objects 18.25.2 CGIXMLRPCRequestHandler 18.26 DocXMLRPCServer -- Self-documenting XML-RPC server 18.26.1 DocXMLRPCServer Objects 18.26.2 DocCGIXMLRPCRequestHandler 19. Multimedia Services 19.1 audioop -- Manipulate raw audio data 19.2 imageop -- Manipulate raw image data 19.3 aifc -- Read and write AIFF and AIFC files 19.4 sunau -- Read and write Sun AU files 19.4.1 AU_read Objects 19.4.2 AU_write Objects 19.5 wave -- Read and write WAV files 19.5.1 Wave_read Objects 19.5.2 Wave_write Objects 19.6 chunk -- Read IFF chunked data 19.7 colorsys -- Conversions between color systems 19.8 rgbimg -- Read and write ``SGI RGB'' files 19.9 imghdr -- Determine the type of an image 19.10 sndhdr -- Determine type of sound file 19.11 ossaudiodev -- Access to OSS-compatible audio devices 19.11.1 Audio Device Objects 19.11.2 Mixer Device Objects 20. Graphical User Interfaces with Tk 20.1 Tkinter -- Python interface to Tcl/Tk 20.1.1 Tkinter Modules 20.1.2 Tkinter Life Preserver 20.1.3 A (Very) Quick Look at Tcl/Tk 20.1.4 Mapping Basic Tk into Tkinter 20.1.5 How Tk and Tkinter are Related 20.1.6 Handy Reference 20.2 Tix -- Extension widgets for Tk 20.2.1 Using Tix 20.2.2 Tix Widgets 20.2.3 Tix Commands 20.3 ScrolledText -- Scrolled Text Widget 20.4 turtle -- Turtle graphics for Tk 20.4.1 Turtle, Pen and RawPen Objects 20.5 Idle 20.5.1 Menus 20.5.2 Basic editing and navigation 20.5.3 Syntax colors 20.6 Other Graphical User Interface Packages 21. Internationalization 21.1 gettext -- Multilingual internationalization services 21.1.1 GNU gettext API 21.1.2 Class-based API 21.1.3 Internationalizing your programs and modules 21.1.4 Acknowledgements 21.2 locale -- Internationalization services 21.2.1 Background, details, hints, tips and caveats 21.2.2 For extension writers and programs that embed Python 21.2.3 Access to message catalogs 22. Program Frameworks 22.1 cmd -- Support for line-oriented command interpreters 22.1.1 Cmd Objects 22.2 shlex -- Simple lexical analysis 22.2.1 shlex Objects 22.2.2 Parsing Rules 23. Development Tools 23.1 pydoc -- Documentation generator and online help system 23.2 doctest -- Test interactive Python examples 23.2.1 Simple Usage: Checking Examples in Docstrings 23.2.2 Simple Usage: Checking Examples in a Text File 23.2.3 How It Works 23.2.4 Basic API 23.2.5 Unittest API 23.2.6 Advanced API 23.2.7 Debugging 23.2.8 Soapbox 23.3 unittest -- Unit testing framework 23.3.1 Basic example 23.3.2 Organizing test code 23.3.3 Re-using old test code 23.3.4 Classes and functions 23.3.5 TestCase Objects 23.3.6 TestSuite Objects 23.3.7 TestResult Objects 23.3.8 TestLoader Objects 23.4 test -- Regression tests package for Python 23.4.1 Writing Unit Tests for the test package 23.4.2 Running tests using test.regrtest 23.5 test.test_support -- Utility functions for tests 24. The Python Debugger 24.1 Debugger Commands 24.2 How It Works 25. The Python Profilers 25.1 Introduction to the profilers 25.2 Instant User's Manual 25.3 What Is Deterministic Profiling? 25.4 Reference Manual - profile and cProfile 25.4.1 The Stats Class 25.5 Limitations 25.6 Calibration 25.7 Extensions -- Deriving Better Profilers 25.8 hotshot -- High performance logging profiler 25.8.1 Profile Objects 25.8.2 Using hotshot data 25.8.3 Example Usage 25.9 timeit -- Measure execution time of small code snippets 25.9.1 Command Line Interface 25.9.2 Examples 25.10 trace -- Trace or track Python statement execution 25.10.1 Command Line Usage 25.10.2 Programming Interface 26. Python Runtime Services 26.1 sys -- System-specific parameters and functions 26.2 __builtin__ -- Built-in objects 26.3 __main__ -- Top-level script environment 26.4 warnings -- Warning control 26.4.1 Warning Categories 26.4.2 The Warnings Filter 26.4.3 Available Functions 26.5 contextlib -- Utilities for with-statement contexts. 26.6 atexit -- Exit handlers 26.6.1 atexit Example 26.7 traceback -- Print or retrieve a stack traceback 26.7.1 Traceback Example 26.8 __future__ -- Future statement definitions 26.9 gc -- Garbage Collector interface 26.10 inspect -- Inspect live objects 26.10.1 Types and members 26.10.2 Retrieving source code 26.10.3 Classes and functions 26.10.4 The interpreter stack 26.11 site -- Site-specific configuration hook 26.12 user -- User-specific configuration hook 26.13 fpectl -- Floating point exception control 26.13.1 Example 26.13.2 Limitations and other considerations 27. Custom Python Interpreters 27.1 code -- Interpreter base classes 27.1.1 Interactive Interpreter Objects 27.1.2 Interactive Console Objects 27.2 codeop -- Compile Python code 28. Restricted Execution 28.1 rexec -- Restricted execution framework 28.1.1 RExec Objects 28.1.2 Defining restricted environments 28.1.3 An example 28.2 Bastion -- Restricting access to objects 29. Importing Modules 29.1 imp -- Access the import internals 29.1.1 Examples 29.2 zipimport -- Import modules from Zip archives 29.2.1 zipimporter Objects 29.2.2 Examples 29.3 pkgutil -- Package extension utility 29.4 modulefinder -- Find modules used by a script 29.5 runpy -- Locating and executing Python modules. 30. Python Language Services 30.1 parser -- Access Python parse trees 30.1.1 Creating AST Objects 30.1.2 Converting AST Objects 30.1.3 Queries on AST Objects 30.1.4 Exceptions and Error Handling 30.1.5 AST Objects 30.1.6 Examples 30.2 symbol -- Constants used with Python parse trees 30.3 token -- Constants used with Python parse trees 30.4 keyword -- Testing for Python keywords 30.5 tokenize -- Tokenizer for Python source 30.6 tabnanny -- Detection of ambiguous indentation 30.7 pyclbr -- Python class browser support 30.7.1 Class Descriptor Objects 30.7.2 Function Descriptor Objects 30.8 py_compile -- Compile Python source files 30.9 compileall -- Byte-compile Python libraries 30.10 dis -- Disassembler for Python byte code 30.10.1 Python Byte Code Instructions 30.11 pickletools -- Tools for pickle developers. 30.12 distutils -- Building and installing Python modules 31. Python compiler package 31.1 The basic interface 31.2 Limitations 31.3 Python Abstract Syntax 31.3.1 AST Nodes 31.3.2 Assignment nodes 31.3.3 Examples 31.4 Using Visitors to Walk ASTs 31.5 Bytecode Generation 32. Abstract Syntax Trees 32.1 Abstract Grammar 33. Miscellaneous Services 33.1 formatter -- Generic output formatting 33.1.1 The Formatter Interface 33.1.2 Formatter Implementations 33.1.3 The Writer Interface 33.1.4 Writer Implementations 34. SGI IRIX Specific Services 34.1 al -- Audio functions on the SGI 34.1.1 Configuration Objects 34.1.2 Port Objects 34.2 AL -- Constants used with the al module 34.3 cd -- CD-ROM access on SGI systems 34.3.1 Player Objects 34.3.2 Parser Objects 34.4 fl -- FORMS library for graphical user interfaces 34.4.1 Functions Defined in Module fl 34.4.2 Form Objects 34.4.3 FORMS Objects 34.5 FL -- Constants used with the fl module 34.6 flp -- Functions for loading stored FORMS designs 34.7 fm -- Font Manager interface 34.8 gl -- Graphics Library interface 34.9 DEVICE -- Constants used with the gl module 34.10 GL -- Constants used with the gl module 34.11 imgfile -- Support for SGI imglib files 34.12 jpeg -- Read and write JPEG files 35. SunOS Specific Services 35.1 sunaudiodev -- Access to Sun audio hardware 35.1.1 Audio Device Objects 35.2 SUNAUDIODEV -- Constants used with sunaudiodev 36. MS Windows Specific Services 36.1 msilib -- Read and write Microsoft Installer files 36.1.1 Database Objects 36.1.2 View Objects 36.1.3 Summary Information Objects 36.1.4 Record Objects 36.1.5 Errors 36.1.6 CAB Objects 36.1.7 Directory Objects 36.1.8 Features 36.1.9 GUI classes 36.1.10 Precomputed tables 36.2 msvcrt - Useful routines from the MS VC++ runtime 36.2.1 File Operations 36.2.2 Console I/O 36.2.3 Other Functions 36.3 _winreg - Windows registry access 36.3.1 Registry Handle Objects 36.4 winsound -- Sound-playing interface for Windows A. Undocumented Modules A.1 Frameworks A.2 Miscellaneous useful utilities A.3 Platform specific modules A.4 Multimedia A.5 Obsolete A.6 SGI-specific Extension modules B. Reporting Bugs C. History and License C.1 History of the software C.2 Terms and conditions for accessing or otherwise using Python C.3 Licenses and Acknowledgements for Incorporated Software C.3.1 Mersenne Twister C.3.2 Sockets C.3.3 Floating point exception control C.3.4 MD5 message digest algorithm C.3.5 Asynchronous socket services C.3.6 Cookie management C.3.7 Profiling C.3.8 Execution tracing C.3.9 UUencode and UUdecode functions C.3.10 XML Remote Procedure Calls Module Index Index Language Reference 1. Introduction 1.1 Alternate Implementations 1.2 Notation 2. Lexical analysis 2.1 Line structure 2.1.1 Logical lines 2.1.2 Physical lines 2.1.3 Comments 2.1.4 Encoding declarations 2.1.5 Explicit line joining 2.1.6 Implicit line joining 2.1.7 Blank lines 2.1.8 Indentation 2.1.9 Whitespace between tokens 2.2 Other tokens 2.3 Identifiers and keywords 2.3.1 Keywords 2.3.2 Reserved classes of identifiers 2.4 Literals 2.4.1 String literals 2.4.2 String literal concatenation 2.4.3 Numeric literals 2.4.4 Integer and long integer literals 2.4.5 Floating point literals 2.4.6 Imaginary literals 2.5 Operators 2.6 Delimiters 3. Data model 3.1 Objects, values and types 3.2 The standard type hierarchy 3.3 New-style and classic classes 3.4 Special method names 3.4.1 Basic customization 3.4.2 Customizing attribute access 3.4.3 Customizing class creation 3.4.4 Emulating callable objects 3.4.5 Emulating container types 3.4.6 Additional methods for emulation of sequence types 3.4.7 Emulating numeric types 3.4.8 Coercion rules 3.4.9 With Statement Context Managers 4. Execution model 4.1 Naming and binding 4.1.1 Interaction with dynamic features 4.2 Exceptions 5. Expressions 5.1 Arithmetic conversions 5.2 Atoms 5.2.1 Identifiers (Names) 5.2.2 Literals 5.2.3 Parenthesized forms 5.2.4 List displays 5.2.5 Generator expressions 5.2.6 Dictionary displays 5.2.7 String conversions 5.3 Primaries 5.3.1 Attribute references 5.3.2 Subscriptions 5.3.3 Slicings 5.3.4 Calls 5.4 The power operator 5.5 Unary arithmetic operations 5.6 Binary arithmetic operations 5.7 Shifting operations 5.8 Binary bit-wise operations 5.9 Comparisons 5.10 Boolean operations 5.11 Lambdas 5.12 Expression lists 5.13 Evaluation order 5.14 Summary 6. Simple statements 6.1 Expression statements 6.2 Assert statements 6.3 Assignment statements 6.3.1 Augmented assignment statements 6.4 The pass statement 6.5 The del statement 6.6 The print statement 6.7 The return statement 6.8 The yield statement 6.9 The raise statement 6.10 The break statement 6.11 The continue statement 6.12 The import statement 6.12.1 Future statements 6.13 The global statement 6.14 The exec statement 7. Compound statements 7.1 The if statement 7.2 The while statement 7.3 The for statement 7.4 The try statement 7.5 The with statement 7.6 Function definitions 7.7 Class definitions 8. Top-level components 8.1 Complete Python programs 8.2 File input 8.3 Interactive input 8.4 Expression input A. History and License A.1 History of the software A.2 Terms and conditions for accessing or otherwise using Python A.3 Licenses and Acknowledgements for Incorporated Software A.3.1 Mersenne Twister A.3.2 Sockets A.3.3 Floating point exception control A.3.4 MD5 message digest algorithm A.3.5 Asynchronous socket services A.3.6 Cookie management A.3.7 Profiling A.3.8 Execution tracing A.3.9 UUencode and UUdecode functions A.3.10 XML Remote Procedure Calls Index Macintosh Reference 1. Using Python on a Macintosh 1.1 Getting and Installing MacPython 1.1.1 How to run a Python script 1.1.2 Running scripts with a GUI 1.1.3 configuration 1.2 The IDE 1.2.1 Using the ``Python Interactive'' window 1.2.2 Writing a Python Script 1.2.3 Executing a script from within the IDE 1.2.4 ``Save as'' versus ``Save as Applet'' 1.3 The Package Manager 2. MacPython Modules 2.1 macpath -- MacOS path manipulation functions 2.2 macfs -- Various file system services 2.2.1 FSSpec Objects 2.2.2 Alias Objects 2.2.3 FInfo Objects 2.3 ic -- Access to Internet Config 2.3.1 IC Objects 2.4 MacOS -- Access to Mac OS interpreter features 2.5 macostools -- Convenience routines for file manipulation 2.6 findertools -- The finder's Apple Events interface 2.7 EasyDialogs -- Basic Macintosh dialogs 2.7.1 ProgressBar Objects 2.8 FrameWork -- Interactive application framework 2.8.1 Application Objects 2.8.2 Window Objects 2.8.3 ControlsWindow Object 2.8.4 ScrolledWindow Object 2.8.5 DialogWindow Objects 2.9 autoGIL -- Global Interpreter Lock handling in event loops 3. MacPython OSA Modules 3.1 gensuitemodule -- Generate OSA stub packages 3.2 aetools -- OSA client support 3.3 aepack -- Conversion between Python variables and AppleEvent data containers 3.4 aetypes -- AppleEvent objects 3.5 MiniAEFrame -- Open Scripting Architecture server support 3.5.1 AEServer Objects 4. MacOS Toolbox Modules 4.1 Carbon.AE -- Apple Events 4.2 Carbon.AH -- Apple Help 4.3 Carbon.App -- Appearance Manager 4.4 Carbon.CF -- Core Foundation 4.5 Carbon.CG -- Core Graphics 4.6 Carbon.CarbonEvt -- Carbon Event Manager 4.7 Carbon.Cm -- Component Manager 4.8 Carbon.Ctl -- Control Manager 4.9 Carbon.Dlg -- Dialog Manager 4.10 Carbon.Evt -- Event Manager 4.11 Carbon.Fm -- Font Manager 4.12 Carbon.Folder -- Folder Manager 4.13 Carbon.Help -- Help Manager 4.14 Carbon.List -- List Manager 4.15 Carbon.Menu -- Menu Manager 4.16 Carbon.Mlte -- MultiLingual Text Editor 4.17 Carbon.Qd -- QuickDraw 4.18 Carbon.Qdoffs -- QuickDraw Offscreen 4.19 Carbon.Qt -- QuickTime 4.20 Carbon.Res -- Resource Manager and Handles 4.21 Carbon.Scrap -- Scrap Manager 4.22 Carbon.Snd -- Sound Manager 4.23 Carbon.TE -- TextEdit 4.24 Carbon.Win -- Window Manager 4.25 ColorPicker -- Color selection dialog 5. Undocumented Modules 5.1 applesingle -- AppleSingle decoder 5.2 buildtools -- Helper module for BuildApplet and Friends 5.3 cfmfile -- Code Fragment Resource module 5.4 icopen -- Internet Config replacement for open() 5.5 macerrors -- Mac OS Errors 5.6 macresource -- Locate script resources 5.7 Nav -- NavServices calls 5.8 PixMapWrapper -- Wrapper for PixMap objects 5.9 videoreader -- Read QuickTime movies 5.10 W -- Widgets built on FrameWork A. History and License A.1 History of the software A.2 Terms and conditions for accessing or otherwise using Python A.3 Licenses and Acknowledgements for Incorporated Software A.3.1 Mersenne Twister A.3.2 Sockets A.3.3 Floating point exception control A.3.4 MD5 message digest algorithm A.3.5 Asynchronous socket services A.3.6 Cookie management A.3.7 Profiling A.3.8 Execution tracing A.3.9 UUencode and UUdecode functions A.3.10 XML Remote Procedure Calls Module Index Index Extending and Embedding 1. Extending Python with C or C++ 1.1 A Simple Example 1.2 Intermezzo: Errors and Exceptions 1.3 Back to the Example 1.4 The Module's Method Table and Initialization Function 1.5 Compilation and Linkage 1.6 Calling Python Functions from C 1.7 Extracting Parameters in Extension Functions 1.8 Keyword Parameters for Extension Functions 1.9 Building Arbitrary Values 1.10 Reference Counts 1.10.1 Reference Counting in Python 1.10.2 Ownership Rules 1.10.3 Thin Ice 1.10.4 NULL Pointers 1.11 Writing Extensions in C++ 1.12 Providing a C API for an Extension Module 2. Defining New Types 2.1 The Basics 2.1.1 Adding data and methods to the Basic example 2.1.2 Providing finer control over data attributes 2.1.3 Supporting cyclic garbage collection 2.2 Type Methods 2.2.1 Finalization and De-allocation 2.2.2 Object Presentation 2.2.3 Attribute Management 2.2.4 Object Comparison 2.2.5 Abstract Protocol Support 2.2.6 Weak Reference Support 2.2.7 More Suggestions 3. Building C and C++ Extensions with distutils 3.1 Distributing your extension modules 4. Building C and C++ Extensions on Windows 4.1 A Cookbook Approach 4.2 Differences Between Unix and Windows 4.3 Using DLLs in Practice 5. Embedding Python in Another Application 5.1 Very High Level Embedding 5.2 Beyond Very High Level Embedding: An overview 5.3 Pure Embedding 5.4 Extending Embedded Python 5.5 Embedding Python in C++ 5.6 Linking Requirements A. Reporting Bugs B. History and License B.1 History of the software B.2 Terms and conditions for accessing or otherwise using Python B.3 Licenses and Acknowledgements for Incorporated Software B.3.1 Mersenne Twister B.3.2 Sockets B.3.3 Floating point exception control B.3.4 MD5 message digest algorithm B.3.5 Asynchronous socket services B.3.6 Cookie management B.3.7 Profiling B.3.8 Execution tracing B.3.9 UUencode and UUdecode functions B.3.10 XML Remote Procedure Calls Python/C API 1. Introduction 1.1 Include Files 1.2 Objects, Types and Reference Counts 1.2.1 Reference Counts 1.2.2 Types 1.3 Exceptions 1.4 Embedding Python 1.5 Debugging Builds 2. The Very High Level Layer 3. Reference Counting 4. Exception Handling 4.1 Standard Exceptions 4.2 Deprecation of String Exceptions 5. Utilities 5.1 Operating System Utilities 5.2 Process Control 5.3 Importing Modules 5.4 Data marshalling support 5.5 Parsing arguments and building values 6. Abstract Objects Layer 6.1 Object Protocol 6.2 Number Protocol 6.3 Sequence Protocol 6.4 Mapping Protocol 6.5 Iterator Protocol 6.6 Buffer Protocol 7. Concrete Objects Layer 7.1 Fundamental Objects 7.1.1 Type Objects 7.1.2 The None Object 7.2 Numeric Objects 7.2.1 Plain Integer Objects 7.2.2 Boolean Objects 7.2.3 Long Integer Objects 7.2.4 Floating Point Objects 7.2.5 Complex Number Objects 7.3 Sequence Objects 7.3.1 String Objects 7.3.2 Unicode Objects 7.3.3 Buffer Objects 7.3.4 Tuple Objects 7.3.5 List Objects 7.4 Mapping Objects 7.4.1 Dictionary Objects 7.5 Other Objects 7.5.1 File Objects 7.5.2 Instance Objects 7.5.3 Function Objects 7.5.4 Method Objects 7.5.5 Module Objects 7.5.6 Iterator Objects 7.5.7 Descriptor Objects 7.5.8 Slice Objects 7.5.9 Weak Reference Objects 7.5.10 CObjects 7.5.11 Cell Objects 7.5.12 Generator Objects 7.5.13 DateTime Objects 7.5.14 Set Objects 8. Initialization, Finalization, and Threads 8.1 Thread State and the Global Interpreter Lock 8.2 Profiling and Tracing 8.3 Advanced Debugger Support 9. Memory Management 9.1 Overview 9.2 Memory Interface 9.3 Examples 10. Object Implementation Support 10.1 Allocating Objects on the Heap 10.2 Common Object Structures 10.3 Type Objects 10.4 Mapping Object Structures 10.5 Number Object Structures 10.6 Sequence Object Structures 10.7 Buffer Object Structures 10.8 Supporting the Iterator Protocol 10.9 Supporting Cyclic Garbage Collection A. Reporting Bugs B. History and License B.1 History of the software B.2 Terms and conditions for accessing or otherwise using Python B.3 Licenses and Acknowledgements for Incorporated Software B.3.1 Mersenne Twister B.3.2 Sockets B.3.3 Floating point exception control B.3.4 MD5 message digest algorithm B.3.5 Asynchronous socket services B.3.6 Cookie management B.3.7 Profiling B.3.8 Execution tracing B.3.9 UUencode and UUdecode functions B.3.10 XML Remote Procedure Calls Index Documenting Python 1 Introduction 2 Directory Structure 3 Style Guide 4 LaTeX Primer 4.1 Syntax 4.2 Hierarchical Structure 4.3 Common Environments 5 Document Classes 6 Special Markup Constructs 6.1 Markup for the Preamble 6.2 Meta-information Markup 6.3 Information Units 6.4 Showing Code Examples 6.5 Inline Markup 6.6 Miscellaneous Text Markup 6.7 Module-specific Markup 6.8 Library-level Markup 6.9 Table Markup 6.10 Reference List Markup 6.11 Index-generating Markup 6.12 Grammar Production Displays 6.13 Graphical Interface Components 7 Processing Tools 7.1 External Tools 7.2 Internal Tools 7.3 Working on Cygwin 8 Including Graphics 9 Future Directions 9.1 Structured Documentation 9.2 Discussion Forums Installing Python Modules 1 Introduction 1.1 Best case: trivial installation 1.2 The new standard: Distutils 2 Standard Build and Install 2.1 Platform variations 2.2 Splitting the job up 2.3 How building works 2.4 How installation works 3 Alternate Installation 3.1 Alternate installation: the home scheme 3.2 Alternate installation: Unix (the prefix scheme) 3.3 Alternate installation: Windows (the prefix scheme) 4 Custom Installation 4.1 Modifying Python's Search Path 5 Distutils Configuration Files 5.1 Location and names of config files 5.2 Syntax of config files 6 Building Extensions: Tips and Tricks 6.1 Tweaking compiler/linker flags 6.2 Using non-Microsoft compilers on Windows 6.2.1 Borland C++ 6.2.2 GNU C / Cygwin / MinGW About this document ... Distributing Python Modules 1. An Introduction to Distutils 1.1 Concepts & Terminology 1.2 A Simple Example 1.3 General Python terminology 1.4 Distutils-specific terminology 2. Writing the Setup Script 2.1 Listing whole packages 2.2 Listing individual modules 2.3 Describing extension modules 2.3.1 Extension names and packages 2.3.2 Extension source files 2.3.3 Preprocessor options 2.3.4 Library options 2.3.5 Other options 2.4 Relationships between Distributions and Packages 2.5 Installing Scripts 2.6 Installing Package Data 2.7 Installing Additional Files 2.8 Additional meta-data 2.9 Debugging the setup script 3. Writing the Setup Configuration File 4. Creating a Source Distribution 4.1 Specifying the files to distribute 4.2 Manifest-related options 5. Creating Built Distributions 5.1 Creating dumb built distributions 5.2 Creating RPM packages 5.3 Creating Windows Installers 5.3.1 The Postinstallation script 6. Registering with the Package Index 6.1 The .pypirc file 7. Uploading Packages to the Package Index 8. Examples 8.1 Pure Python distribution (by module) 8.2 Pure Python distribution (by package) 8.3 Single extension module 9. Extending Distutils 9.1 Integrating new commands 9.2 Adding new distribution types 10. Command Reference 10.1 Installing modules: the install command family 10.1.1 install_data 10.1.2 install_scripts 10.2 Creating a source distribution: the sdist command 11. API Reference 11.1 distutils.core -- Core Distutils functionality 11.2 distutils.ccompiler -- CCompiler base class 11.3 distutils.unixccompiler -- Unix C Compiler 11.4 distutils.msvccompiler -- Microsoft Compiler 11.5 distutils.bcppcompiler -- Borland Compiler 11.6 distutils.cygwincompiler -- Cygwin Compiler 11.7 distutils.emxccompiler -- OS/2 EMX Compiler 11.8 distutils.mwerkscompiler -- Metrowerks CodeWarrior support 11.9 distutils.archive_util -- Archiving utilities 11.10 distutils.dep_util -- Dependency checking 11.11 distutils.dir_util -- Directory tree operations 11.12 distutils.file_util -- Single file operations 11.13 distutils.util -- Miscellaneous other utility functions 11.14 distutils.dist -- The Distribution class 11.15 distutils.extension -- The Extension class 11.16 distutils.debug -- Distutils debug mode 11.17 distutils.errors -- Distutils exceptions 11.18 distutils.fancy_getopt -- Wrapper around the standard getopt module 11.19 distutils.filelist -- The FileList class 11.20 distutils.log -- Simple PEP 282-style logging 11.21 distutils.spawn -- Spawn a sub-process 11.22 distutils.sysconfig -- System configuration information 11.23 distutils.text_file -- The TextFile class 11.24 distutils.version -- Version number classes 11.25 distutils.cmd -- Abstract base class for Distutils commands 11.26 distutils.command -- Individual Distutils commands 11.27 distutils.command.bdist -- Build a binary installer 11.28 distutils.command.bdist_packager -- Abstract base class for packagers 11.29 distutils.command.bdist_dumb -- Build a ``dumb'' installer 11.30 distutils.command.bdist_rpm -- Build a binary distribution as a Redhat RPM and SRPM 11.31 distutils.command.bdist_wininst -- Build a Windows installer 11.32 distutils.command.sdist -- Build a source distribution 11.33 distutils.command.build -- Build all files of a package 11.34 distutils.command.build_clib -- Build any C libraries in a package 11.35 distutils.command.build_ext -- Build any extensions in a package 11.36 distutils.command.build_py -- Build the .py/.pyc files of a package 11.37 distutils.command.build_scripts -- Build the scripts of a package 11.38 distutils.command.clean -- Clean a package build area 11.39 distutils.command.config -- Perform package configuration 11.40 distutils.command.install -- Install a package 11.41 distutils.command.install_data -- Install data files from a package 11.42 distutils.command.install_headers -- Install C/C++ header files from a package 11.43 distutils.command.install_lib -- Install library files from a package 11.44 distutils.command.install_scripts -- Install script files from a package 11.45 distutils.command.register -- Register a module with the Python Package Index 11.46 Creating a new Distutils command Module Index Index About this document ... Get in touch Submit feedback about this site to: [email protected] © documentation.help. Design: rehmann.co.