| 
									
										
										
										
											2007-08-15 14:28:22 +00:00
										 |  |  | .. _tutorial-index:
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ######################
 | 
					
						
							| 
									
										
										
										
											2009-01-03 21:18:54 +00:00
										 |  |  |   The Python Tutorial
 | 
					
						
							| 
									
										
										
										
											2007-08-15 14:28:22 +00:00
										 |  |  | ######################
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | :Release: |version|
 | 
					
						
							|  |  |  | :Date: |today|
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Python is an easy to learn, powerful programming language. It has efficient
 | 
					
						
							|  |  |  | high-level data structures and a simple but effective approach to
 | 
					
						
							|  |  |  | object-oriented programming. Python's elegant syntax and dynamic typing,
 | 
					
						
							|  |  |  | together with its interpreted nature, make it an ideal language for scripting
 | 
					
						
							|  |  |  | and rapid application development in many areas on most platforms.
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | The Python interpreter and the extensive standard library are freely available
 | 
					
						
							|  |  |  | in source or binary form for all major platforms from the Python Web site,
 | 
					
						
							|  |  |  | http://www.python.org/, and may be freely distributed. The same site also
 | 
					
						
							|  |  |  | contains distributions of and pointers to many free third party Python modules,
 | 
					
						
							|  |  |  | programs and tools, and additional documentation.
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | The Python interpreter is easily extended with new functions and data types
 | 
					
						
							|  |  |  | implemented in C or C++ (or other languages callable from C). Python is also
 | 
					
						
							|  |  |  | suitable as an extension language for customizable applications.
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | This tutorial introduces the reader informally to the basic concepts and
 | 
					
						
							|  |  |  | features of the Python language and system. It helps to have a Python
 | 
					
						
							|  |  |  | interpreter handy for hands-on experience, but all examples are self-contained,
 | 
					
						
							|  |  |  | so the tutorial can be read off-line as well.
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | For a description of standard objects and modules, see the Python Library
 | 
					
						
							|  |  |  | Reference document. The Python Reference Manual gives a more formal definition
 | 
					
						
							|  |  |  | of the language. To write extensions in C or C++, read Extending and Embedding
 | 
					
						
							|  |  |  | the Python Interpreter and Python/C API Reference. There are also several books
 | 
					
						
							|  |  |  | covering Python in depth.
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | This tutorial does not attempt to be comprehensive and cover every single
 | 
					
						
							|  |  |  | feature, or even every commonly used feature. Instead, it introduces many of
 | 
					
						
							|  |  |  | Python's most noteworthy features, and will give you a good idea of the
 | 
					
						
							|  |  |  | language's flavor and style. After reading it, you will be able to read and
 | 
					
						
							|  |  |  | write Python modules and programs, and you will be ready to learn more about the
 | 
					
						
							|  |  |  | various Python library modules described in the Python Library Reference.
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2007-08-17 18:30:38 +00:00
										 |  |  | The :ref:`glossary` is also worth going through.
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2007-08-15 14:28:22 +00:00
										 |  |  | .. toctree::
 | 
					
						
							| 
									
										
											  
											
												Merged revisions 70578,70599,70641-70642,70650,70660-70661,70674,70691,70697-70698,70700,70704 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
  r70578 | benjamin.peterson | 2009-03-23 22:24:56 -0500 (Mon, 23 Mar 2009) | 1 line
  this is better written using assertRaises
........
  r70599 | benjamin.peterson | 2009-03-25 16:42:51 -0500 (Wed, 25 Mar 2009) | 1 line
  this can be slightly less ugly
........
  r70641 | guilherme.polo | 2009-03-27 16:43:08 -0500 (Fri, 27 Mar 2009) | 3 lines
  Adjusted _tkinter to compile without warnings when WITH_THREAD is not
  defined (part of issue #5035)
........
  r70642 | georg.brandl | 2009-03-27 19:48:48 -0500 (Fri, 27 Mar 2009) | 1 line
  Fix typo.
........
  r70650 | benjamin.peterson | 2009-03-28 14:16:10 -0500 (Sat, 28 Mar 2009) | 1 line
  give os.symlink and os.link() better parameter names #5564
........
  r70660 | georg.brandl | 2009-03-28 14:52:58 -0500 (Sat, 28 Mar 2009) | 1 line
  Switch to fixed Sphinx version.
........
  r70661 | georg.brandl | 2009-03-28 14:57:36 -0500 (Sat, 28 Mar 2009) | 2 lines
  Add section numbering to some of the larger subdocuments.
........
  r70674 | guilherme.polo | 2009-03-29 05:19:05 -0500 (Sun, 29 Mar 2009) | 1 line
  Typo fix.
........
  r70691 | raymond.hettinger | 2009-03-29 13:51:11 -0500 (Sun, 29 Mar 2009) | 1 line
  Make life easier for non-CPython implementations.
........
  r70697 | benjamin.peterson | 2009-03-29 16:22:35 -0500 (Sun, 29 Mar 2009) | 1 line
  this has been fixed since 2.6 (I love removing these)
........
  r70698 | benjamin.peterson | 2009-03-29 16:31:05 -0500 (Sun, 29 Mar 2009) | 1 line
  thanks to guido's bytecode verifier, this is fixed
........
  r70700 | benjamin.peterson | 2009-03-29 16:50:14 -0500 (Sun, 29 Mar 2009) | 1 line
  use the awesome new status iterator
........
  r70704 | benjamin.peterson | 2009-03-29 21:49:32 -0500 (Sun, 29 Mar 2009) | 1 line
  there's actually three methods here #5600
........
											
										 
											2009-03-30 14:51:56 +00:00
										 |  |  |    :numbered: | 
					
						
							| 
									
										
										
										
											2007-08-15 14:28:22 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  |    appetite.rst
 | 
					
						
							|  |  |  |    interpreter.rst
 | 
					
						
							|  |  |  |    introduction.rst
 | 
					
						
							|  |  |  |    controlflow.rst
 | 
					
						
							|  |  |  |    datastructures.rst
 | 
					
						
							|  |  |  |    modules.rst
 | 
					
						
							|  |  |  |    inputoutput.rst
 | 
					
						
							|  |  |  |    errors.rst
 | 
					
						
							|  |  |  |    classes.rst
 | 
					
						
							|  |  |  |    stdlib.rst
 | 
					
						
							|  |  |  |    stdlib2.rst
 | 
					
						
							|  |  |  |    whatnow.rst
 | 
					
						
							|  |  |  |    interactive.rst
 | 
					
						
							|  |  |  |    floatingpoint.rst
 |