Управление растущими проектами: пакеты, крейты и модули
По мере написания больших программ организация кода становится всё более важной. Группируя связанную функциональность и разделяя код с различными возможностями, вы проясняете, где найти код, реализующий ту или иную функцию, и куда идти, чтобы изменить, как эта функция работает.
Программы, которые мы писали до сих пор, находились в одном модуле в одном файле. По мере роста проекта следует организовывать код, разделяя его на несколько модулей, а затем на несколько файлов. Пакет может содержать несколько бинарных крейтов и, опционально, один библиотечный крейт. По мере роста пакета вы можете выделять части в отдельные крейты, которые становятся внешними зависимостями. Эта глава охватывает все эти техники. Для очень больших проектов, состоящих из набора взаимосвязанных пакетов, которые развиваются вместе, Cargo предоставляет рабочие пространства, которые мы рассмотрим в «Рабочие пространства Cargo» в четырнадцатой главе.
Мы также обсудим инкапсуляцию деталей реализации, которая позволяет повторно использовать код на более высоком уровне: как только вы реализовали операцию, другой код может вызывать ваш код через его публичный интерфейс, не зная, как работает реализация. То, как вы пишете код, определяет, какие части являются публичными для использования другим кодом, а какие — частными деталями реализации, которые вы оставляете за собой право изменять. Это ещё один способ ограничить объём деталей, которые вам приходится держать в голове.
Связанная концепция — это область видимости: вложенный контекст, в котором написан код, имеет набор имён, определённых как «находящиеся в области видимости». При чтении, написании и компиляции кода программистам и компиляторам нужно знать, относится ли конкретное имя в конкретном месте к переменной, функции, структуре, перечислению, модулю, константе или другому элементу и что этот элемент означает. Вы можете создавать области видимости и изменять, какие имена находятся в области видимости или вне неё. У вас не может быть двух элементов с одинаковым именем в одной области видимости; доступны инструменты для разрешения конфликтов имён.
В Rust есть ряд возможностей, позволяющих управлять организацией кода, включая то, какие детали раскрываются, какие детали являются частными, и какие имена находятся в каждой области видимости в ваших программах. Эти возможности, иногда называемые в совокупности системой модулей, включают:
- Пакеты: Возможность Cargo, позволяющая собирать, тестировать и делиться крейтами
- Крейты: Дерево модулей, которое производит библиотеку или исполняемый файл
- Модули и use: Позволяют контролировать организацию, область видимости и приватность путей
- Пути: Способ именования элемента, такого как структура, функция или модуль
В этой главе мы рассмотрим все эти возможности, обсудим, как они взаимодействуют, и объясним, как использовать их для управления областью видимости. К концу у вас должно быть прочное понимание системы модулей и умение работать с областями видимости как профессионал!