blob: 9ad6523cc442c212b0d35b1e7b6cdb849d6f64ac [file] [log] [blame]
Fred Drake6659c301998-03-03 22:02:19 +00001\documentclass{manual}
Guido van Rossum7a2dba21993-11-05 14:45:11 +00002
Guido van Rossumd358afe1998-12-23 05:02:08 +00003% XXX PM explain how to add new types to Python
Guido van Rossum5049bcb1995-03-13 16:55:23 +00004
Guido van Rossum6938f061994-08-01 12:22:53 +00005\title{Extending and Embedding the Python Interpreter}
Guido van Rossum7a2dba21993-11-05 14:45:11 +00006
Guido van Rossum16cd7f91994-10-06 10:29:26 +00007\input{boilerplate}
Guido van Rossum83eb9621993-11-23 16:28:45 +00008
Guido van Rossum7a2dba21993-11-05 14:45:11 +00009% Tell \index to actually write the .idx file
10\makeindex
11
12\begin{document}
13
Guido van Rossum7a2dba21993-11-05 14:45:11 +000014\maketitle
15
Fred Drake9f86b661998-07-28 21:55:19 +000016\ifhtml
17\chapter*{Front Matter\label{front}}
18\fi
19
Guido van Rossum16cd7f91994-10-06 10:29:26 +000020\input{copyright}
21
Fred Drake33698f81999-02-16 23:06:32 +000022
Guido van Rossum7a2dba21993-11-05 14:45:11 +000023\begin{abstract}
24
25\noindent
Guido van Rossumb92112d1995-03-20 14:24:09 +000026Python is an interpreted, object-oriented programming language. This
Fred Drakeec9fbe91999-02-15 16:20:25 +000027document describes how to write modules in C or \Cpp{} to extend the
Guido van Rossumb92112d1995-03-20 14:24:09 +000028Python interpreter with new modules. Those modules can define new
29functions but also new object types and their methods. The document
30also describes how to embed the Python interpreter in another
31application, for use as an extension language. Finally, it shows how
32to compile and link extension modules so that they can be loaded
33dynamically (at run time) into the interpreter, if the underlying
34operating system supports this feature.
35
36This document assumes basic knowledge about Python. For an informal
Fred Drake9fa76f11999-11-10 16:01:43 +000037introduction to the language, see the
38\citetitle[../tut/tut.html]{Python Tutorial}. The
39\citetitle[../ref/ref.html]{Python Reference Manual} gives a more
40formal definition of the language. The
41\citetitle[../lib/lib.html]{Python Library Reference} documents the
42existing object types, functions and modules (both built-in and
43written in Python) that give the language its wide application range.
Guido van Rossum7a2dba21993-11-05 14:45:11 +000044
Fred Drakeec9fbe91999-02-15 16:20:25 +000045For a detailed description of the whole Python/C API, see the separate
Fred Drake9fa76f11999-11-10 16:01:43 +000046\citetitle[../api/api.html]{Python/C API Reference Manual}.
Guido van Rossumfdacc581997-10-07 14:40:16 +000047
Guido van Rossum7a2dba21993-11-05 14:45:11 +000048\end{abstract}
49
Fred Drake4d4f9e71998-01-13 22:25:02 +000050\tableofcontents
Guido van Rossum7a2dba21993-11-05 14:45:11 +000051
Guido van Rossumdb65a6c1993-11-05 17:11:16 +000052
Fred Drakecc8f44b2001-08-20 19:30:29 +000053\input{extending}
54\input{newtypes}
55\input{unix}
56\input{windows}
57\input{embedding}
Fred Drake1c258032000-09-08 22:54:53 +000058
Fred Drakeed773ef2000-09-21 21:35:22 +000059
60\appendix
61\chapter{Reporting Bugs}
62\input{reportingbugs}
63
Fred Draked5df09c2001-06-20 21:37:34 +000064\chapter{History and License}
65\input{license}
66
Guido van Rossum7a2dba21993-11-05 14:45:11 +000067\end{document}