Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

add ABC to the glossary

This commit is contained in:
Benjamin Peterson 2008-07-01 23:33:06 +00:00
parent aa76d77e2b
commit aac51b8a69
2 changed files with 16 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
Doc/glossary.rst
View File

@ -24,6 +24,14 @@ Glossary
2to3 is available in the standard library as :mod:`lib2to3`; a standalone 2to3 is available in the standard library as :mod:`lib2to3`; a standalone
entry point is provided as :file:`Tools/scripts/2to3`. entry point is provided as :file:`Tools/scripts/2to3`.
Abstract Base Class
Abstract Base Classes (abbreviated ABCs) complement :term:`duck-typing` by
providing a way to define interfaces when other techniques like :func:`hasattr`
would be clumsy. Python comes with many builtin ABCs for data structures
(in the :mod:`collections` module), numbers (in the :mod:`numbers`
module), and streams (in the :mod:`io` module). You can create your own
ABC with the :mod:`abc` module.
argument argument
A value passed to a function or method, assigned to a name local to A value passed to a function or method, assigned to a name local to
the body. A function or method may have both positional arguments and the body. A function or method may have both positional arguments and
@ -116,15 +124,16 @@ Glossary
be any object with a :meth:`__hash__` function, not just integers starting be any object with a :meth:`__hash__` function, not just integers starting
from zero. Called a hash in Perl. from zero. Called a hash in Perl.
duck-typing duck-typing
Pythonic programming style that determines an object's type by inspection Pythonic programming style that determines an object's type by inspection
of its method or attribute signature rather than by explicit relationship of its method or attribute signature rather than by explicit relationship
to some type object ("If it looks like a duck and quacks like a duck, it to some type object ("If it looks like a duck and quacks like a duck, it
must be a duck.") By emphasizing interfaces rather than specific types, must be a duck.") By emphasizing interfaces rather than specific types,
well-designed code improves its flexibility by allowing polymorphic well-designed code improves its flexibility by allowing polymorphic
substitution. Duck-typing avoids tests using :func:`type` or substitution. Duck-typing avoids tests using :func:`type` or
:func:`isinstance`. Instead, it typically employs :func:`hasattr` tests or :func:`isinstance`. (Note, however, that duck-typing can be complemented
:term:`EAFP` programming. with abstract base classes.) Instead, it typically employs :func:`hasattr`
tests or :term:`EAFP` programming.
EAFP EAFP
Easier to ask for forgiveness than permission. This common Python coding Easier to ask for forgiveness than permission. This common Python coding

8
Doc/library/abc.rst
View File

@ -9,10 +9,10 @@
.. versionadded:: 2.6 .. versionadded:: 2.6
This module provides the infrastructure for defining abstract base classes This module provides the infrastructure for defining :term:`abstract base
(ABCs) in Python, as outlined in :pep:`3119`; see the PEP for why this was added classes` (ABCs) in Python, as outlined in :pep:`3119`; see the PEP for why this
to Python. (See also :pep:`3141` and the :mod:`numbers` module regarding a type was added to Python. (See also :pep:`3141` and the :mod:`numbers` module
hierarchy for numbers based on ABCs.) regarding a type hierarchy for numbers based on ABCs.)
The :mod:`collections` module has some concrete classes that derive from The :mod:`collections` module has some concrete classes that derive from
ABCs; these can, of course, be further derived. In addition the ABCs; these can, of course, be further derived. In addition the