| 1 |
:tocdepth: 2 |
| 2 |
|
| 3 |
================== |
| 4 |
General Python FAQ |
| 5 |
================== |
| 6 |
|
| 7 |
.. only:: html |
| 8 |
|
| 9 |
.. contents:: |
| 10 |
|
| 11 |
|
| 12 |
General Information |
| 13 |
=================== |
| 14 |
|
| 15 |
What is Python? |
| 16 |
--------------- |
| 17 |
|
| 18 |
Python is an interpreted, interactive, object-oriented programming language. It |
| 19 |
incorporates modules, exceptions, dynamic typing, very high level dynamic data |
| 20 |
types, and classes. It supports multiple programming paradigms beyond |
| 21 |
object-oriented programming, such as procedural and functional programming. |
| 22 |
Python combines remarkable power with very clear syntax. It has interfaces to |
| 23 |
many system calls and libraries, as well as to various window systems, and is |
| 24 |
extensible in C or C++. It is also usable as an extension language for |
| 25 |
applications that need a programmable interface. Finally, Python is portable: |
| 26 |
it runs on many Unix variants including Linux and macOS, and on Windows. |
| 27 |
|
| 28 |
To find out more, start with :ref:`tutorial-index`. The `Beginner's Guide to |
| 29 |
Python <https://wiki.python.org/moin/BeginnersGuide>`_ links to other |
| 30 |
introductory tutorials and resources for learning Python. |
| 31 |
|
| 32 |
|
| 33 |
What is the Python Software Foundation? |
| 34 |
--------------------------------------- |
| 35 |
|
| 36 |
The Python Software Foundation is an independent non-profit organization that |
| 37 |
holds the copyright on Python versions 2.1 and newer. The PSF's mission is to |
| 38 |
advance open source technology related to the Python programming language and to |
| 39 |
publicize the use of Python. The PSF's home page is at |
| 40 |
https://www.python.org/psf/. |
| 41 |
|
| 42 |
Donations to the PSF are tax-exempt in the US. If you use Python and find it |
| 43 |
helpful, please contribute via `the PSF donation page |
| 44 |
<https://www.python.org/psf/donations/>`_. |
| 45 |
|
| 46 |
|
| 47 |
Are there copyright restrictions on the use of Python? |
| 48 |
------------------------------------------------------ |
| 49 |
|
| 50 |
You can do anything you want with the source, as long as you leave the |
| 51 |
copyrights in and display those copyrights in any documentation about Python |
| 52 |
that you produce. If you honor the copyright rules, it's OK to use Python for |
| 53 |
commercial use, to sell copies of Python in source or binary form (modified or |
| 54 |
unmodified), or to sell products that incorporate Python in some form. We would |
| 55 |
still like to know about all commercial use of Python, of course. |
| 56 |
|
| 57 |
See `the license page <https://docs.python.org/3/license.html>`_ to find further |
| 58 |
explanations and the full text of the PSF License. |
| 59 |
|
| 60 |
The Python logo is trademarked, and in certain cases permission is required to |
| 61 |
use it. Consult `the Trademark Usage Policy |
| 62 |
<https://www.python.org/psf/trademarks/>`__ for more information. |
| 63 |
|
| 64 |
|
| 65 |
Why was Python created in the first place? |
| 66 |
------------------------------------------ |
| 67 |
|
| 68 |
Here's a *very* brief summary of what started it all, written by Guido van |
| 69 |
Rossum: |
| 70 |
|
| 71 |
I had extensive experience with implementing an interpreted language in the |
| 72 |
ABC group at CWI, and from working with this group I had learned a lot about |
| 73 |
language design. This is the origin of many Python features, including the |
| 74 |
use of indentation for statement grouping and the inclusion of |
| 75 |
very-high-level data types (although the details are all different in |
| 76 |
Python). |
| 77 |
|
| 78 |
I had a number of gripes about the ABC language, but also liked many of its |
| 79 |
features. It was impossible to extend the ABC language (or its |
| 80 |
implementation) to remedy my complaints -- in fact its lack of extensibility |
| 81 |
was one of its biggest problems. I had some experience with using Modula-2+ |
| 82 |
and talked with the designers of Modula-3 and read the Modula-3 report. |
| 83 |
Modula-3 is the origin of the syntax and semantics used for exceptions, and |
| 84 |
some other Python features. |
| 85 |
|
| 86 |
I was working in the Amoeba distributed operating system group at CWI. We |
| 87 |
needed a better way to do system administration than by writing either C |
| 88 |
programs or Bourne shell scripts, since Amoeba had its own system call |
| 89 |
interface which wasn't easily accessible from the Bourne shell. My |
| 90 |
experience with error handling in Amoeba made me acutely aware of the |
| 91 |
importance of exceptions as a programming language feature. |
| 92 |
|
| 93 |
It occurred to me that a scripting language with a syntax like ABC but with |
| 94 |
access to the Amoeba system calls would fill the need. I realized that it |
| 95 |
would be foolish to write an Amoeba-specific language, so I decided that I |
| 96 |
needed a language that was generally extensible. |
| 97 |
|
| 98 |
During the 1989 Christmas holidays, I had a lot of time on my hand, so I |
| 99 |
decided to give it a try. During the next year, while still mostly working |
| 100 |
on it in my own time, Python was used in the Amoeba project with increasing |
| 101 |
success, and the feedback from colleagues made me add many early |
| 102 |
improvements. |
| 103 |
|
| 104 |
In February 1991, after just over a year of development, I decided to post to |
| 105 |
USENET. The rest is in the ``Misc/HISTORY`` file. |
| 106 |
|
| 107 |
|
| 108 |
What is Python good for? |
| 109 |
------------------------ |
| 110 |
|
| 111 |
Python is a high-level general-purpose programming language that can be applied |
| 112 |
to many different classes of problems. |
| 113 |
|
| 114 |
The language comes with a large standard library that covers areas such as |
| 115 |
string processing (regular expressions, Unicode, calculating differences between |
| 116 |
files), internet protocols (HTTP, FTP, SMTP, XML-RPC, POP, IMAP), |
| 117 |
software engineering (unit testing, logging, profiling, parsing |
| 118 |
Python code), and operating system interfaces (system calls, filesystems, TCP/IP |
| 119 |
sockets). Look at the table of contents for :ref:`library-index` to get an idea |
| 120 |
of what's available. A wide variety of third-party extensions are also |
| 121 |
available. Consult `the Python Package Index <https://pypi.org>`_ to |
| 122 |
find packages of interest to you. |
| 123 |
|
| 124 |
|
| 125 |
.. _faq-version-numbering-scheme: |
| 126 |
|
| 127 |
How does the Python version numbering scheme work? |
| 128 |
-------------------------------------------------- |
| 129 |
|
| 130 |
Python versions are numbered "A.B.C" or "A.B": |
| 131 |
|
| 132 |
* *A* is the major version number -- it is only incremented for really major |
| 133 |
changes in the language. |
| 134 |
* *B* is the minor version number -- it is incremented for less earth-shattering |
| 135 |
changes. |
| 136 |
* *C* is the micro version number -- it is incremented for each bugfix release. |
| 137 |
|
| 138 |
Not all releases are bugfix releases. In the run-up to a new feature release, a |
| 139 |
series of development releases are made, denoted as alpha, beta, or release |
| 140 |
candidate. Alphas are early releases in which interfaces aren't yet finalized; |
| 141 |
it's not unexpected to see an interface change between two alpha releases. |
| 142 |
Betas are more stable, preserving existing interfaces but possibly adding new |
| 143 |
modules, and release candidates are frozen, making no changes except as needed |
| 144 |
to fix critical bugs. |
| 145 |
|
| 146 |
Alpha, beta and release candidate versions have an additional suffix: |
| 147 |
|
| 148 |
* The suffix for an alpha version is "aN" for some small number *N*. |
| 149 |
* The suffix for a beta version is "bN" for some small number *N*. |
| 150 |
* The suffix for a release candidate version is "rcN" for some small number *N*. |
| 151 |
|
| 152 |
In other words, all versions labeled *2.0aN* precede the versions labeled |
| 153 |
*2.0bN*, which precede versions labeled *2.0rcN*, and *those* precede 2.0. |
| 154 |
|
| 155 |
You may also find version numbers with a "+" suffix, e.g. "2.2+". These are |
| 156 |
unreleased versions, built directly from the CPython development repository. In |
| 157 |
practice, after a final minor release is made, the version is incremented to the |
| 158 |
next minor version, which becomes the "a0" version, e.g. "2.4a0". |
| 159 |
|
| 160 |
See the `Developer's Guide |
| 161 |
<https://devguide.python.org/developer-workflow/development-cycle/>`__ |
| 162 |
for more information about the development cycle, and |
| 163 |
:pep:`387` to learn more about Python's backward compatibility policy. See also |
| 164 |
the documentation for :data:`sys.version`, :data:`sys.hexversion`, and |
| 165 |
:data:`sys.version_info`. |
| 166 |
|
| 167 |
|
| 168 |
How do I obtain a copy of the Python source? |
| 169 |
-------------------------------------------- |
| 170 |
|
| 171 |
The latest Python source distribution is always available from python.org, at |
| 172 |
https://www.python.org/downloads/. The latest development sources can be obtained |
| 173 |
at https://github.com/python/cpython/. |
| 174 |
|
| 175 |
The source distribution is a gzipped tar file containing the complete C source, |
| 176 |
Sphinx-formatted documentation, Python library modules, example programs, and |
| 177 |
several useful pieces of freely distributable software. The source will compile |
| 178 |
and run out of the box on most UNIX platforms. |
| 179 |
|
| 180 |
Consult the `Getting Started section of the Python Developer's Guide |
| 181 |
<https://devguide.python.org/setup/>`__ for more |
| 182 |
information on getting the source code and compiling it. |
| 183 |
|
| 184 |
|
| 185 |
How do I get documentation on Python? |
| 186 |
------------------------------------- |
| 187 |
|
| 188 |
The standard documentation for the current stable version of Python is available |
| 189 |
at https://docs.python.org/3/. EPUB, plain text, and downloadable HTML versions are |
| 190 |
also available at https://docs.python.org/3/download.html. |
| 191 |
|
| 192 |
The documentation is written in reStructuredText and processed by `the Sphinx |
| 193 |
documentation tool <https://www.sphinx-doc.org/>`__. The reStructuredText source for |
| 194 |
the documentation is part of the Python source distribution. |
| 195 |
|
| 196 |
|
| 197 |
I've never programmed before. Is there a Python tutorial? |
| 198 |
--------------------------------------------------------- |
| 199 |
|
| 200 |
There are numerous tutorials and books available. The standard documentation |
| 201 |
includes :ref:`tutorial-index`. |
| 202 |
|
| 203 |
Consult `the Beginner's Guide <https://wiki.python.org/moin/BeginnersGuide>`_ to |
| 204 |
find information for beginning Python programmers, including lists of tutorials. |
| 205 |
|
| 206 |
|
| 207 |
Is there a newsgroup or mailing list devoted to Python? |
| 208 |
------------------------------------------------------- |
| 209 |
|
| 210 |
There is a newsgroup, :newsgroup:`comp.lang.python`, and a mailing list, |
| 211 |
`python-list <https://mail.python.org/mailman/listinfo/python-list>`_. The |
| 212 |
newsgroup and mailing list are gatewayed into each other -- if you can read news |
| 213 |
it's unnecessary to subscribe to the mailing list. |
| 214 |
:newsgroup:`comp.lang.python` is high-traffic, receiving hundreds of postings |
| 215 |
every day, and Usenet readers are often more able to cope with this volume. |
| 216 |
|
| 217 |
Announcements of new software releases and events can be found in |
| 218 |
comp.lang.python.announce, a low-traffic moderated list that receives about five |
| 219 |
postings per day. It's available as `the python-announce mailing list |
| 220 |
<https://mail.python.org/mailman3/lists/python-announce-list.python.org/>`_. |
| 221 |
|
| 222 |
More info about other mailing lists and newsgroups |
| 223 |
can be found at https://www.python.org/community/lists/. |
| 224 |
|
| 225 |
|
| 226 |
How do I get a beta test version of Python? |
| 227 |
------------------------------------------- |
| 228 |
|
| 229 |
Alpha and beta releases are available from https://www.python.org/downloads/. All |
| 230 |
releases are announced on the comp.lang.python and comp.lang.python.announce |
| 231 |
newsgroups and on the Python home page at https://www.python.org/; an RSS feed of |
| 232 |
news is available. |
| 233 |
|
| 234 |
You can also access the development version of Python through Git. See |
| 235 |
`The Python Developer's Guide <https://devguide.python.org/>`_ for details. |
| 236 |
|
| 237 |
|
| 238 |
How do I submit bug reports and patches for Python? |
| 239 |
--------------------------------------------------- |
| 240 |
|
| 241 |
To report a bug or submit a patch, use the issue tracker at |
| 242 |
https://github.com/python/cpython/issues. |
| 243 |
|
| 244 |
For more information on how Python is developed, consult `the Python Developer's |
| 245 |
Guide <https://devguide.python.org/>`_. |
| 246 |
|
| 247 |
|
| 248 |
Are there any published articles about Python that I can reference? |
| 249 |
------------------------------------------------------------------- |
| 250 |
|
| 251 |
It's probably best to cite your favorite book about Python. |
| 252 |
|
| 253 |
The `very first article <https://ir.cwi.nl/pub/18204>`_ about Python was |
| 254 |
written in 1991 and is now quite outdated. |
| 255 |
|
| 256 |
Guido van Rossum and Jelke de Boer, "Interactively Testing Remote Servers |
| 257 |
Using the Python Programming Language", CWI Quarterly, Volume 4, Issue 4 |
| 258 |
(December 1991), Amsterdam, pp 283--303. |
| 259 |
|
| 260 |
|
| 261 |
Are there any books on Python? |
| 262 |
------------------------------ |
| 263 |
|
| 264 |
Yes, there are many, and more are being published. See the python.org wiki at |
| 265 |
https://wiki.python.org/moin/PythonBooks for a list. |
| 266 |
|
| 267 |
You can also search online bookstores for "Python" and filter out the Monty |
| 268 |
Python references; or perhaps search for "Python" and "language". |
| 269 |
|
| 270 |
|
| 271 |
Where in the world is www.python.org located? |
| 272 |
--------------------------------------------- |
| 273 |
|
| 274 |
The Python project's infrastructure is located all over the world and is managed |
| 275 |
by the Python Infrastructure Team. Details `here <https://infra.psf.io>`__. |
| 276 |
|
| 277 |
|
| 278 |
Why is it called Python? |
| 279 |
------------------------ |
| 280 |
|
| 281 |
When he began implementing Python, Guido van Rossum was also reading the |
| 282 |
published scripts from `"Monty Python's Flying Circus" |
| 283 |
<https://en.wikipedia.org/wiki/Monty_Python>`__, a BBC comedy series from the 1970s. Van Rossum |
| 284 |
thought he needed a name that was short, unique, and slightly mysterious, so he |
| 285 |
decided to call the language Python. |
| 286 |
|
| 287 |
|
| 288 |
Do I have to like "Monty Python's Flying Circus"? |
| 289 |
------------------------------------------------- |
| 290 |
|
| 291 |
No, but it helps. :) |
| 292 |
|
| 293 |
|
| 294 |
Python in the real world |
| 295 |
======================== |
| 296 |
|
| 297 |
How stable is Python? |
| 298 |
--------------------- |
| 299 |
|
| 300 |
Very stable. New, stable releases have been coming out roughly every 6 to 18 |
| 301 |
months since 1991, and this seems likely to continue. As of version 3.9, |
| 302 |
Python will have a new feature release every 12 months (:pep:`602`). |
| 303 |
|
| 304 |
The developers issue bugfix releases of older versions, so the stability of |
| 305 |
existing releases gradually improves. Bugfix releases, indicated by a third |
| 306 |
component of the version number (e.g. 3.5.3, 3.6.2), are managed for stability; |
| 307 |
only fixes for known problems are included in a bugfix release, and it's |
| 308 |
guaranteed that interfaces will remain the same throughout a series of bugfix |
| 309 |
releases. |
| 310 |
|
| 311 |
The latest stable releases can always be found on the `Python download page |
| 312 |
<https://www.python.org/downloads/>`_. |
| 313 |
Python 3.x is the recommended version and supported by most widely used libraries. |
| 314 |
Python 2.x :pep:`is not maintained anymore <373>`. |
| 315 |
|
| 316 |
How many people are using Python? |
| 317 |
--------------------------------- |
| 318 |
|
| 319 |
There are probably millions of users, though it's difficult to obtain an exact |
| 320 |
count. |
| 321 |
|
| 322 |
Python is available for free download, so there are no sales figures, and it's |
| 323 |
available from many different sites and packaged with many Linux distributions, |
| 324 |
so download statistics don't tell the whole story either. |
| 325 |
|
| 326 |
The comp.lang.python newsgroup is very active, but not all Python users post to |
| 327 |
the group or even read it. |
| 328 |
|
| 329 |
|
| 330 |
Have any significant projects been done in Python? |
| 331 |
-------------------------------------------------- |
| 332 |
|
| 333 |
See https://www.python.org/about/success for a list of projects that use Python. |
| 334 |
Consulting the proceedings for `past Python conferences |
| 335 |
<https://www.python.org/community/workshops/>`_ will reveal contributions from many |
| 336 |
different companies and organizations. |
| 337 |
|
| 338 |
High-profile Python projects include `the Mailman mailing list manager |
| 339 |
<https://www.list.org>`_ and `the Zope application server |
| 340 |
<https://www.zope.dev>`_. Several Linux distributions, most notably `Red Hat |
| 341 |
<https://www.redhat.com>`_, have written part or all of their installer and |
| 342 |
system administration software in Python. Companies that use Python internally |
| 343 |
include Google, Yahoo, and Lucasfilm Ltd. |
| 344 |
|
| 345 |
|
| 346 |
What new developments are expected for Python in the future? |
| 347 |
------------------------------------------------------------ |
| 348 |
|
| 349 |
See https://peps.python.org/ for the Python Enhancement Proposals |
| 350 |
(PEPs). PEPs are design documents describing a suggested new feature for Python, |
| 351 |
providing a concise technical specification and a rationale. Look for a PEP |
| 352 |
titled "Python X.Y Release Schedule", where X.Y is a version that hasn't been |
| 353 |
publicly released yet. |
| 354 |
|
| 355 |
New development is discussed on `the python-dev mailing list |
| 356 |
<https://mail.python.org/mailman3/lists/python-dev.python.org/>`_. |
| 357 |
|
| 358 |
|
| 359 |
Is it reasonable to propose incompatible changes to Python? |
| 360 |
----------------------------------------------------------- |
| 361 |
|
| 362 |
In general, no. There are already millions of lines of Python code around the |
| 363 |
world, so any change in the language that invalidates more than a very small |
| 364 |
fraction of existing programs has to be frowned upon. Even if you can provide a |
| 365 |
conversion program, there's still the problem of updating all documentation; |
| 366 |
many books have been written about Python, and we don't want to invalidate them |
| 367 |
all at a single stroke. |
| 368 |
|
| 369 |
Providing a gradual upgrade path is necessary if a feature has to be changed. |
| 370 |
:pep:`5` describes the procedure followed for introducing backward-incompatible |
| 371 |
changes while minimizing disruption for users. |
| 372 |
|
| 373 |
|
| 374 |
Is Python a good language for beginning programmers? |
| 375 |
---------------------------------------------------- |
| 376 |
|
| 377 |
Yes. |
| 378 |
|
| 379 |
It is still common to start students with a procedural and statically typed |
| 380 |
language such as Pascal, C, or a subset of C++ or Java. Students may be better |
| 381 |
served by learning Python as their first language. Python has a very simple and |
| 382 |
consistent syntax and a large standard library and, most importantly, using |
| 383 |
Python in a beginning programming course lets students concentrate on important |
| 384 |
programming skills such as problem decomposition and data type design. With |
| 385 |
Python, students can be quickly introduced to basic concepts such as loops and |
| 386 |
procedures. They can probably even work with user-defined objects in their very |
| 387 |
first course. |
| 388 |
|
| 389 |
For a student who has never programmed before, using a statically typed language |
| 390 |
seems unnatural. It presents additional complexity that the student must master |
| 391 |
and slows the pace of the course. The students are trying to learn to think |
| 392 |
like a computer, decompose problems, design consistent interfaces, and |
| 393 |
encapsulate data. While learning to use a statically typed language is |
| 394 |
important in the long term, it is not necessarily the best topic to address in |
| 395 |
the students' first programming course. |
| 396 |
|
| 397 |
Many other aspects of Python make it a good first language. Like Java, Python |
| 398 |
has a large standard library so that students can be assigned programming |
| 399 |
projects very early in the course that *do* something. Assignments aren't |
| 400 |
restricted to the standard four-function calculator and check balancing |
| 401 |
programs. By using the standard library, students can gain the satisfaction of |
| 402 |
working on realistic applications as they learn the fundamentals of programming. |
| 403 |
Using the standard library also teaches students about code reuse. Third-party |
| 404 |
modules such as PyGame are also helpful in extending the students' reach. |
| 405 |
|
| 406 |
Python's interactive interpreter enables students to test language features |
| 407 |
while they're programming. They can keep a window with the interpreter running |
| 408 |
while they enter their program's source in another window. If they can't |
| 409 |
remember the methods for a list, they can do something like this:: |
| 410 |
|
| 411 |
>>> L = [] |
| 412 |
>>> dir(L) # doctest: +NORMALIZE_WHITESPACE |
| 413 |
['__add__', '__class__', '__contains__', '__delattr__', '__delitem__', |
| 414 |
'__dir__', '__doc__', '__eq__', '__format__', '__ge__', |
| 415 |
'__getattribute__', '__getitem__', '__gt__', '__hash__', '__iadd__', |
| 416 |
'__imul__', '__init__', '__iter__', '__le__', '__len__', '__lt__', |
| 417 |
'__mul__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', |
| 418 |
'__repr__', '__reversed__', '__rmul__', '__setattr__', '__setitem__', |
| 419 |
'__sizeof__', '__str__', '__subclasshook__', 'append', 'clear', |
| 420 |
'copy', 'count', 'extend', 'index', 'insert', 'pop', 'remove', |
| 421 |
'reverse', 'sort'] |
| 422 |
>>> [d for d in dir(L) if '__' not in d] |
| 423 |
['append', 'clear', 'copy', 'count', 'extend', 'index', 'insert', 'pop', 'remove', 'reverse', 'sort'] |
| 424 |
|
| 425 |
>>> help(L.append) |
| 426 |
Help on built-in function append: |
| 427 |
<BLANKLINE> |
| 428 |
append(...) |
| 429 |
L.append(object) -> None -- append object to end |
| 430 |
<BLANKLINE> |
| 431 |
>>> L.append(1) |
| 432 |
>>> L |
| 433 |
[1] |
| 434 |
|
| 435 |
With the interpreter, documentation is never far from the student as they are |
| 436 |
programming. |
| 437 |
|
| 438 |
There are also good IDEs for Python. IDLE is a cross-platform IDE for Python |
| 439 |
that is written in Python using Tkinter. |
| 440 |
Emacs users will be happy to know that there is a very good Python mode for |
| 441 |
Emacs. All of these programming environments provide syntax highlighting, |
| 442 |
auto-indenting, and access to the interactive interpreter while coding. Consult |
| 443 |
`the Python wiki <https://wiki.python.org/moin/PythonEditors>`_ for a full list |
| 444 |
of Python editing environments. |
| 445 |
|
| 446 |
If you want to discuss Python's use in education, you may be interested in |
| 447 |
joining `the edu-sig mailing list |
| 448 |
<https://www.python.org/community/sigs/current/edu-sig>`_. |