import subprocess
# Простой и понятный способ установки пакета Python
subprocess.run(['pip', 'install', 'ваш_модуль'])

import subprocess
import sys
# Запомните: всегда следует работать в рамках вашего текущего окружения.
subprocess.run([sys.executable, '-m', 'pip', 'install', 'ваш_модуль'])

import pkg_resources
import subprocess
import sys
# Избегаем ненужной установки
try:
    pkg_resources.get_distribution('ваш_модуль')
except pkg_resources.DistributionNotFound:
    subprocess.run([sys.executable, '-m', 'pip', 'install', 'ваш_модуль'])

import importlib
import subprocess
import sys

module_name = 'ваш_модуль'
# Облегчаем путь новому модулю
try:
    importlib.import_module(module_name)
except ImportError:
    subprocess.run([sys.executable, '-m', 'pip', 'install', module_name])
    importlib.invalidate_caches()
    importlib.import_module(module_name)

# До:
Детали головоломки (🗒️): [Квадрат, Круг, Треугольник]
Коробка с деталями (📦): [Звезда, Шестиугольник]

# Задача: Добавить Звезду в головоломку!

== Эквивалент в коде Python ==

И теперь головоломка содержит Звезду (⭐)!

📦 Модуль установлен! Головоломка теперь **"сияет"** звездой.

### Преодоление потенциальных трудностей

Если в процессе возникают проблемы, вот несколько способов их преодоления:

1. **Проблемы с правами доступа**: При необходимости используйте **administration permissions**.
2. **Сложные окружения**: Работа в **виртуальных средах** поможет изолировать зависимости.
3. **Проблемы с подключением**: Проверьте наличие **интернет-подключения** и доступность сервера PyPI.

### Запись зависимостей

Зафиксируйте зависимости вашего проекта для последующего воссоздания окружения:

Можно также перенаправить вывод в файл **requirements.txt** для последующего воссоздания среды.

### Надёжность программирования

Не забывайте о базовых принципах: **обработка исключений** и аккуратная **очистка** ресурсов для устойчивости вашего кода:

subprocess.run([sys.executable, '-m', 'pip', 'install', 'имя_модуля'], check=True)

print("Во время установки модуля произошла ошибка.")

## Полезные ресурсы

1. [pip documentation v23.3.2](https://pip.pypa.io/en/stable/) — Полное и **официальное** руководство по использованию "pip".
2. [PyPI · The Python Package Index](https://pypi.org/) — **Каталог** популярных **библиотек** Python. **Ищите и устанавливайте** модули отсюда.
3. [pip – как установить Python-модуль в программном режиме?](https://stackoverflow.com/questions/12332975/how-can-i-install-a-python-module-within-code) — Обсуждение на Stack Overflow о разных способах программной установки.
4. [subprocess — Управление подпроцессами](https://docs.python.org/3/library/subprocess.html) — Официальное руководство по работе с подпроцессами в Python.
5. [Установка пакетов – Руководство пользователя Python](https://packaging.python.org/en/latest/tutorials/installing-packages/#ensure-pip-setuptools-and-wheel-are-up-to-date) — рекомендации по обновлению pip, setuptools и wheel.
6. [virtualenv](https://virtualenv.pypa.io/en/latest/) — Изучите, как **изолировать Python-окружения** с помощью virtualenv.
7. [importlib — Механизмы импорта](https://docs.python.org/3/library/importlib.html) — Разбираемся в тонкостях динамического импорта модулей с помощью importlib.