Добавляем первую зависимость

Что именно мы устанавливаем

В Python есть стандартная библиотека — например, sys и pathlib. Она приходит вместе с Python. Rich — сторонняя библиотека для оформления терминального вывода. Она отдельно устанавливается в окружение и становится зависимостью нашей программы.

pip — менеджер пакетов Python. По умолчанию он получает пакеты из PyPI — каталога Python-проектов. Имя устанавливаемого дистрибутива и имя в импорте не всегда совпадают; для Rich в обоих местах используется rich.

python -c "import rich"

Установите и проверьте

python -m pip install rich
python -m pip show rich
python -m pip list

Почему python -m pip, а не просто pip

На одном компьютере обычно живёт несколько Python: системный, установленный вами и тот, что лежит внутри .venv. У каждого из них свой pip и свой набор установленных библиотек. Команда pip — это отдельная программа на диске, и какая именно из них запустится, решает переменная PATH. Отсюда типичная ситуация: установка прошла успешно, а программа всё равно пишет ModuleNotFoundError — пакет уехал в другой Python.

Запись python -m pip читается так: «возьми тот Python, который сейчас выбран, и запусти внутри него модуль pip». Библиотека гарантированно попадает в окружение того интерпретатора, которым вы запускаете свою программу. Проверить, какой pip отработал, можно командой python -m pip --version: она печатает путь к нему.

Для установки нужен доступ к сети: pip скачивает пакет из PyPI — общего каталога Python-библиотек.

В pip show rich найдите Name, Version и Location. Последнее поле должно указывать внутрь вашей .venv. В pip list появятся Rich и его собственные зависимости — это нормально.

Продолжим тот же main.py

Замените содержимое существующего main.py версией ниже. Расчёт не меняется: добавляются импорт Console и вывод через console.print. Импорт получает класс из модуля rich.console; Console() создаёт объект для работы с терминалом.

from rich.console import Console


def calculate_average(values: list[int]) -> float:
    if not values:
        raise ValueError("Список оценок не должен быть пустым")
    return sum(values) / len(values)


def format_average(value: float) -> str:
    return f"Средний результат: {value:.2f}"


def main():
    values = [5, 4, 5, 3, 5]
    average = calculate_average(values)
    console = Console()
    console.print(f"[bold green]{format_average(average)}[/bold green]")


if __name__ == "__main__":
    main()

При отдельном скачивании файл называется 02-rich-main.py: перенесите его содержимое в ваш main.py. Метки [bold green] и [/bold green] задают оформление Rich. В обычном терминале результат будет зелёным; при перенаправлении вывода цвет может отсутствовать.

python main.py

Средний результат: 4.40

Проверяем изоляцию: смотрим на Location

Мы установили Rich «в проект». Проверим, что это действительно так: сравним, что отвечает pip внутри окружения и что — снаружи. Сравнивать будем одну строку: Location. Она показывает папку, в которой лежит библиотека.

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

• Rich в базовом Python не установлен. Тогда pip show напишет WARNING: Package(s) not found: rich, а python3 -c "import rich" — ModuleNotFoundError. Самый наглядный случай.
• Rich в базовом Python уже был — например, его поставили раньше для другой задачи. Ошибки не будет. Посмотрите на Location: путь ведёт в общую папку Python, а не в .venv вашего проекта. Это другая копия библиотеки, возможно другой версии; к вашему проекту она отношения не имеет.

Изоляцию подтверждает путь в строке Location, а не наличие ошибки. Одна и та же библиотека может стоять в нескольких местах; работает та, которая видна Python, запускающему вашу программу.

Что именно мы добавляем

В Go есть стандартная библиотека — например, fmt и errors, которыми мы уже пользовались. Она приходит вместе с Go, и в go.mod не попадает. fatih/color — сторонняя библиотека для цветного вывода в терминал. Её нужно добавить в модуль, и тогда она станет зависимостью нашей программы.

Отдельного менеджера пакетов в Go нет: с зависимостями работает сама команда go. Пакеты она берёт не из центрального каталога, а прямо из репозиториев — поэтому импорт выглядит как адрес: github.com/fatih/color. Между вами и репозиторием стоит прокси-сервер модулей proxy.golang.org, который хранит копии версий: даже если автор удалит репозиторий, уже выпущенная версия останется доступной.

go list -m all

Добавьте и проверьте

go get github.com/fatih/color
go list -m all
go list -m -f "{{.Path}} {{.Version}} {{.Dir}}" github.com/fatih/color

Первая команда скачивает библиотеку и записывает её версию в go.mod. Вторая печатает полное дерево зависимостей. Третья отвечает на вопрос «а где физически лежит этот код»: она покажет путь в кэш модулей, и в имени папки будет видна версия — например color@v1.17.0.

module example.com/student-tools

go 1.21

require github.com/fatih/color v1.17.0

require (
	github.com/mattn/go-colorable v0.1.13 // indirect
	github.com/mattn/go-isatty v0.0.20 // indirect
	golang.org/x/sys v0.18.0 // indirect
)

Номера версий у вас будут новее — это нормально. В файле два раздела require. В первом — то, что вы запросили сами. Во втором, с пометкой // indirect, — зависимости самой библиотеки color: их Go добавил без вашего участия, но версии зафиксировал так же строго.

Почему рядом появился go.sum

Вместе с go.mod команда создала файл go.sum. В нём — контрольные суммы каждой скачанной версии. При следующей сборке Go пересчитает суммы и сравнит их с записанными: если содержимое версии где-то подменили, сборка остановится с ошибкой checksum mismatch. Файл большой и выглядит нечитаемо, но править его руками не нужно — он служебный. В Git его обязательно отправляют вместе с go.mod.

Где здесь изоляция

Библиотека физически лежит в общем кэше, одном для всех ваших проектов. Изоляцию даёт не место на диске, а запись в go.mod: другой проект может требовать color v1.13.0, и он получит именно её — рядом в кэше будут лежать обе версии. Проверьте это сами командой go list -m -f "{{.Dir}}" github.com/fatih/color: в пути видна версия, а значит смена версии в go.mod приведёт к другой папке.

Продолжим тот же main.go

Замените содержимое существующего main.go версией ниже. Расчёт не меняется: добавляются импорт библиотеки и вывод через color.Green.

package main

import (
	"errors"
	"fmt"

	"github.com/fatih/color"
)

func calculateAverage(values []int) (float64, error) {
	if len(values) == 0 {
		return 0, errors.New("список оценок не должен быть пустым")
	}
	sum := 0
	for _, value := range values {
		sum += value
	}
	return float64(sum) / float64(len(values)), nil
}

func formatAverage(value float64) string {
	return fmt.Sprintf("Средний результат: %.2f", value)
}

func main() {
	values := []int{5, 4, 5, 3, 5}
	average, err := calculateAverage(values)
	if err != nil {
		color.Red("Ошибка: %v", err)
		return
	}
	color.Green(formatAverage(average))
}

Импорты разделены пустой строкой: сверху стандартная библиотека, снизу сторонние. Так принято в Go, и gofmt этот порядок сохраняет. Обращение color.Green читается как «функция Green из пакета color» — имя пакета в Go всегда остаётся в строке вызова, сокращённой формы вроде from … import … здесь нет.

go run .

Средний результат: 4.40

Число не изменилось — изменился способ печати. Цвет добавляет библиотека; при перенаправлении вывода в файл она сама отключает цветовые коды, чтобы файл остался читаемым.

Лишнее и недостающее: go mod tidy

Со временем импорты в коде и записи в go.mod расходятся: библиотеку удалили из кода, а строка осталась; или наоборот — импорт добавили руками, а версию не записали. Приводит их в соответствие одна команда.

go mod tidy
go list -m all

go mod tidy читает все импорты проекта и делает go.mod их точным отражением: недостающее добавляет, лишнее убирает, go.sum приводит в порядок. Состав зависимостей определяется импортами в коде, а go.mod хранит результат этой сверки.

Выполняйте go mod tidy перед каждой отправкой работы. Это же требование будет в критериях домашнего задания.