Пакеты и крейты
Первые части системы модулей, которые мы рассмотрим, — это пакеты и крейты.
Крейт — это наименьший объём кода, который рассматривает компилятор Rust за один раз. Даже если вы запускаете rustc вместо cargo и передаёте один файл исходного кода (как мы делали в самом начале в «Основы программы на Rust» в главе 1), компилятор считает этот файл крейтом. Крейты могут содержать модули, а модули могут быть определены в других файлах, которые компилируются вместе с крейтом, как мы увидим в следующих разделах.
Крейт может быть одной из двух форм: бинарный крейт или библиотечный крейт. Бинарные крейты — это программы, которые вы можете скомпилировать в исполняемый файл, который вы можете запустить, например, программа командной строки или сервер. Каждый из них должен иметь функцию с именем main, которая определяет, что происходит при запуске исполняемого файла. Все крейты, которые мы создавали до сих пор, были бинарными крейтами.
Библиотечные крейты не имеют функции main и не компилируются в исполняемый файл. Вместо этого они определяют функциональность, предназначенную для совместного использования несколькими проектами. Например, крейт rand, который мы использовали в главе 2, предоставляет функциональность, которая генерирует случайные числа. В большинстве случаев, когда Rustaceans говорят «крейт», они имеют в виду библиотечный крейт и используют «крейт» взаимозаменяемо с общей концепцией программирования «библиотека».
Корень крейта — это исходный файл, с которого компилятор Rust начинает работу и который составляет корневой модуль вашего крейта (мы подробно объясним модули в разделе «Управление областью видимости и приватностью с помощью модулей»).
Пакет — это набор из одного или нескольких крейтов, который предоставляет набор функциональности. Пакет содержит файл Cargo.toml, в котором описывается, как собирать эти крейты. Cargo на самом деле является пакетом, который содержит бинарный крейт для инструмента командной строки, который вы использовали для сборки вашего кода. Пакет Cargo также содержит библиотечный крейт, от которого зависит бинарный крейт. Другие проекты могут зависеть от библиотечного крейта Cargo, чтобы использовать ту же логику, что и инструмент командной строки Cargo.
Пакет может содержать столько бинарных крейтов, сколько вы хотите, но не более одного библиотечного крейта. Пакет должен содержать как минимум один крейт, будь то библиотечный или бинарный.
Давайте пройдёмся по тому, что происходит, когда мы создаём пакет. Сначала мы вводим команду cargo new my-project:
$ cargo new my-project
Created binary (application) `my-project` package
$ ls my-project
Cargo.toml
src
$ ls my-project/src
main.rs
После того как мы запустили cargo new my-project, мы используем ls, чтобы увидеть, что создаёт Cargo. В каталоге my-project есть файл Cargo.toml, который даёт нам пакет. Там также есть каталог src, который содержит main.rs. Откройте Cargo.toml в вашем текстовом редакторе и обратите внимание, что там нет упоминания о src/main.rs. Cargo следует соглашению, что src/main.rs — это корень крейта бинарного крейта с тем же именем, что и пакет. Аналогично, Cargo знает, что если каталог пакета содержит src/lib.rs, пакет содержит библиотечный крейт с тем же именем, что и пакет, а src/lib.rs является его корнем крейта. Cargo передаёт файлы корня крейта в rustc для сборки библиотеки или бинарного файла.
Здесь у нас есть пакет, который содержит только src/main.rs, что означает, что он содержит только бинарный крейт с именем my-project. Если пакет содержит src/main.rs и src/lib.rs, у него есть два крейта: бинарный и библиотечный, оба с тем же именем, что и пакет. Пакет может иметь несколько бинарных крейтов, поместив файлы в каталог src/bin: каждый файл будет отдельным бинарным крейтом.