Пакет — каталог, который содержит модули и обязательный файл __init__.py, который инициализирует этот пакет.
Название этого каталога и является именем пакета.
Пакеты импортируются точно так же, как и модули.
Пример пакета:
mypocket/ |-- __init__.py |-- hello.py |-- max_a_b.py
Создание своего пакета в Python
Давайте создадим пакет с модулями, как в примере выше. Для этого:
- создадим файл с основной программой с названием
main.py
(в этот файл будем импортировать наш пакет) - папку
mypocket
, рядом с файломmain.py
- в папке
mypocket
создадим 2 файла, которые будут модулями нашего пакета —hello.py
иmax_a_b.py
- и в папке
mypocket
создадим файл__init__.py
для инициализации пакета.
В модуле hello.py
напишем функцию hello_world
, которая выводит приветствие:
def hello_world(): print('Hello World')
В модуле max_a_b.py
пусть будет функция, возвращающая максимальное число из двух полученных чисел:
def my_max(a, b): return a if(a > b) else b
Итак, наш пакет готов, можно двигаться дальше.
Импорт своего пакета
Импортировать наш пакет mypocket
мы будем в файл main.py
. Для этого в файле main.py
пропишем:
import mypocket print(dir(mypocket)) #['__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__path__', '__spec__']
С помощью import mypocket
мы импортировали наш пакет, а с помощью print(dir(mypocket))
мы вывели объекты, которые импортировались с пакетом.
Но мы видим, что среди импортированных объектов нет наших модулей. А все из-за того, что модули из пакета необходимо импортировать явно.
Синтаксис импортирования модуля из пакета:
import <имя пакета>.<имя модуля>
Импортируем и посмотрим результат:
import mypocket.hello import mypocket.max_a_b print(dir(mypocket)) #['__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__path__', '__spec__', 'hello', 'max_a_b']
Теперь мы видим, что наши модули hello
и max_a_b
импортировались.
Обратимся к функциям из модулей этого пакета. Для этого пишем <имя пакета>.<имя модуля>.<функция>
:
import mypocket.hello import mypocket.max_a_b mypocket.hello.hello_world() print(mypocket.max_a_b.my_max(1, 5)) #Hello World #5
Все отработало, как нужно.
Также можно импортировать функции модулей из пакета через from
и обращаться к ним напрямую:
from mypocket.hello import hello_world from mypocket.max_a_b import my_max hello_world() print(my_max(1, 5)) #Hello World #5
Или задать им псевдонимы:
from mypocket.hello import hello_world as h_w from mypocket.max_a_b import my_max as my_m h_w() print(my_m(1, 5)) #Hello World #5
Список модулей для импорта
С помощью файла __init__.py
мы можем указать, какой список модулей мы можем импортировать через from <имя_пакета> import *
.
В файле __init__.py
пропишем:
__all__ = ['hello', 'max_a_b']
Это значит, что мы хотим импортировать оба модуля.
И теперь мы можем импортировать их следующим образом:
from mypocket import * hello.hello_world() print(max_a_b.my_max(1, 5)) #Hello World #5
Установка пакетов с помощью менеджера пакетов PIP
Помимо стандартных модулей и пакетов, а также пакетов созданных своими руками, есть огромное количество пакетов от сторонних разработчиков, которые тоже можно использовать в своих проектах.
Python Package Index (PyPI)
Все эти пакеты собраны на одном ресурсе — Python Package Index (PyPI).
На этом сайте вы можете найти нужные вам пакеты через поиск, либо через классификатор.
Здесь мы разберемся, как устанавливать сторонние пакеты в ОС Windows.
Установка происходит с помощью менеджера пакетов pip.
Менеджер пакетов pip
Если вы работаете в PyCharm, то устанавливать пакеты можно прямо в нем, во вкладке «Terminal»:
Также для установки можно воспользоваться командным окном (нажимаем Win+R и набираем команду cmd):
Обычно pip устанавливается вместе с установкой Python, для того, чтобы проверить, что pip установлен, выполните в командном окне или терминале команду pip
, если у вас установлен менеджер пакетов, вы увидите примерно следующее:
Usage: pip <command> [options] Commands: install Install packages. download Download packages. uninstall Uninstall packages. freeze Output installed packages in requirements format. list List installed packages. show Show information about installed packages. check Verify installed packages have compatible dependencies. config Manage local and global configuration. search Search PyPI for packages. cache Inspect and manage pip's wheel cache. wheel Build wheels from your requirements. hash Compute hashes of package archives. completion A helper command used for command completion. debug Show information useful for debugging. help Show help for commands. General Options: -h, --help Show help. --isolated Run pip in an isolated mode, ignoring environment variables and user configuration. -v, --verbose Give more output. Option is additive, and can be used up to 3 times. -V, --version Show version and exit. -q, --quiet Give less output. Option is additive, and can be used up to 3 times (corresponding to WARNING, ERROR, and CRITICAL logging levels). --log <path> Path to a verbose appending log. --no-input Disable prompting for input. --proxy <proxy> Specify a proxy in the form [user:passwd@]proxy.server:port. --retries <retries> Maximum number of retries each connection should attempt (default 5 times). --timeout <sec> Set the socket timeout (default 15 seconds). --exists-action <action> Default action when a path already exists: (s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort. --trusted-host <hostname> Mark this host or host:port pair as trusted, even though it does not have valid or any HTTPS. --cert <path> Path to PEM-encoded CA certificate bundle. If provided, overrides the default. See 'SSL Certificate Verification' in pip documentation for more information. --client-cert <path> Path to SSL client certificate, a single file containing the private key and the certificate in PEM format. --cache-dir <dir> Store the cache data in <dir>. --no-cache-dir Disable the cache. --disable-pip-version-check Don't periodically check PyPI to determine whether a new version of pip is available for download. Implied with --no-index. --no-color Suppress colored output. --no-python-version-warning Silence deprecation warnings for upcoming unsupported Pythons. --use-feature <feature> Enable new functionality, that may be backward incompatible. --use-deprecated <feature> Enable deprecated functionality, that will be removed in the future.
Т.е. вы получите список команд и операторов для работы с менеджером пакетов.
Для того, чтобы узнать, какие пакеты у вас уже установлены выполните команду pip freeze
:
Вы увидите, установленные пакеты вместе с их версиями.
Установка пакета через pip
Для того, чтобы установить пакет нужно воспользоваться командой:
pip install <имя пакета или модуля>
Например, если выполнить команду pip install flask
, то будет установлен фреймворк flask последней версии.
Основные команды pip
Рассмотрим самые основные команды:
pip install package-name — устанавливает последнюю версию пакета; pip install package-name==2.4.6 — устанавливает пакет версии 2.4.6; pip install package-name --upgrade — обновляет версию пакета; pip download — скачивает пакеты; pip uninstall — удаляет пакеты; pip freeze — выводит список установленных пакетов для записи в requirements.txt; pip list — выводит список установленных пакетов; pip list --outdated — выводит список устаревших пакетов; pip show — показывает информацию об установленном пакете; pip check — проверяет установленные пакеты на совместимость зависимостей; pip search — по введенному названию, ищет пакеты, опубликованные в PyPI; pip wheel — собирает wheel-архив по вашим требованиям и зависимостям; pip hash — вычисляет хеши архивов пакетов; pip completion — вспомогательная команда используется для завершения основной команды; pip help — помощь по командам.
Чтобы узнать обо всех командах — выполните команду pip
, а чтобы узнать информацию, о какой то конкретной команде воспользуйтесь командой pip help <command>
, например pip help install
.