Skip to content

Commit

Permalink
bpo-31454: Include information about "import X as Y" in Modules tutor…
Browse files Browse the repository at this point in the history
…ial (GH-4041)

(cherry picked from commit fbee882)

Co-authored-by: Mario Corchero <[email protected]>
  • Loading branch information
miss-islington and mariocj89 authored Feb 25, 2018
1 parent ddf2485 commit e48e649
Showing 1 changed file with 19 additions and 0 deletions.
19 changes: 19 additions & 0 deletions Doc/tutorial/modules.rst
Original file line number Diff line number Diff line change
Expand Up @@ -112,6 +112,25 @@ Note that in general the practice of importing ``*`` from a module or package is
frowned upon, since it often causes poorly readable code. However, it is okay to
use it to save typing in interactive sessions.

If the module name is followed by :keyword:`as`, then the name
following :keyword:`as` is bound directly to the imported module.

::

>>> import fibo as fib
>>> fib.fib(500)
0 1 1 2 3 5 8 13 21 34 55 89 144 233 377

This is effectively importing the module in the same way that ``import fibo``
will do, with the only difference of it being available as ``fib``.

It can also be used when utilising :keyword:`from` with similar effects::

>>> from fibo import fib as fibonacci
>>> fibonacci(500)
0 1 1 2 3 5 8 13 21 34 55 89 144 233 377


.. note::

For efficiency reasons, each module is only imported once per interpreter
Expand Down

0 comments on commit e48e649

Please sign in to comment.