18.2. Module Import

18.2.1. Importing modules

18.2.2. Import module

• import ...

Syntax:

import module

import module.submodule

Example:

import random

18.2.3. Importing function from module

• from ... import ...

Syntax:

from module import function

from module.submodule import function

Example:

from random import randint

18.2.4. Import and alias

• import ... as ...

Syntax:

import module as alias

from module import function as alias

Example:

import numpy as np

from django.utils.translation import gettext_lazy as _

18.2.5. Relative imports

• from . import ...

• from .. import ...

Syntax:

from . import module

from .. import module

from .module import function

from ..module import function

18.2.6. What is Python Module

• Every Python file is a module

• Every directory with __init__.py file is a module

• Python does not recognize whether it is a file or dir with init

• Useful when you start simple, and then expand

• Usually __init__.py is empty

• If you define __all__: list[str] in __init__.py it will import only those functions when from MODULE import *

18.2.7. Python file is a module

game.py

18.2.8. Directory with __init__.py file

game
    __init__.py

18.2.9. Importing from own modules

from game import run

18.2.10. Examples

game
    __init__.py
    config.py
    api.py
    dragon
        __init__.py
        wawelski.py
        red.py
        black.py
        white.py

18.2.11. Importing variable or constant from module

from game.config import RESOLUTION_X
from game.config import RESOLUTION_Y

Preferred:

from game.config import RESOLUTION_X, RESOLUTION_Y

18.2.12. Importing submodules

from game.dragon import red
from game.dragon import white


dragon1 = red.RedDragon()
dragon2 = white.WhiteDragon()

from game.dragon import red, white

dragon1 = red.RedDragon()
dragon2 = white.WhiteDragon()

18.2.13. Importing all

from game.dragon import *

dragon1 = red.RedDragon()
dragon2 = white.WhiteDragon()

18.2.14. Importing objects from modules

from game.dragon.red import RedDragon
from game.dragon.white import WhiteDragon

dragon1 = RedDragon()
dragon2 = WhiteDragon()

18.2.15. Importing with aliases

from game.dragon.red import RedDragon as Smok

dragon = Smok()

18.2.16. Import path

• Watch-out module names which are the same as in stdlib

import sys

sys.path
# ['',
#  '/opt/homebrew/Cellar/python@3.13/3.13.3_1/Frameworks/Python.framework/Versions/3.13/lib/python313.zip',
#  '/opt/homebrew/Cellar/python@3.13/3.13.3_1/Frameworks/Python.framework/Versions/3.13/lib/python3.13',
#  '/opt/homebrew/Cellar/python@3.13/3.13.3_1/Frameworks/Python.framework/Versions/3.13/lib/python3.13/lib-dynload',
#  '/opt/homebrew/lib/python3.13/site-packages']

sys.path.append('/path/to/directory')
sys.path.insert(0, '/path/to/directory')

18.2.17. __name__

• Zmienna __name__ pozwala ustalić czy dany plik jest wykonywany czy importowany.

• Jeżeli dany plik jest wykonywany, zmienna __name__ ustawiana jest na '__main__'.

• Jeżeli dany plik jest importowany jako moduł, zmienna __name__ ustawiana jest na nazwę modułu.

• Jest to przydatne na przykład przy testowaniu modułów.

18.2.18. Example 1

• Wypisane na konsoli zostanie 'hello world!' jeżeli dany plik jest uruchamiany z konsoli.

• Powyższy kod nie wykona się natomiast jeżeli plik zaimportujemy jako moduł w innym pliku.

if __name__ == '__main__':
    print('hello world')

18.2.19. Example 2

• Jeżeli skrypt wywoływany jest z konsoli "z ręki" to uruchom funkcję run()

• Jeżeli został zaimportowany, to ten fragment będzie zignorowany

• I trzeba uruchomić funkcję run() samodzielnie - kontrolowanie

def run():
    ...

if __name__ == '__main__':
    run()

18.2.20. Example

import logging

log = logging.getLogger(__name__)