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 (pythonGH-4041)
  • Loading branch information
mariocj89 authored and Mariatta committed Feb 25, 2018
1 parent 84c4b0c commit fbee882
Showing 1 changed file with 19 additions and 0 deletions.
19 changes: 19 additions & 0 deletions Doc/tutorial/modules.rst
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 fbee882

Please sign in to comment.