Зависимости
Повечето програми зависят от някакви библиотеки. Ако някога сте управлявали
зависимости на ръка, знаете каква мъка е. За щастие Ръждьо идва стандартно с
cargo! cargo може да управлява зависимостите в проекта.
За да създадете нов проект на Ръждьо, изпълнете на командния ред:
# Изпълним
cargo new foo
# Библиотека
cargo new --lib bar
До края на раздела ще приемем, че правим изпълним файл, но знайте, че е същото като за библиотека.
След изпълнението на горните команди файловото дърво на проекта изглежда така:
.
├── bar
│ ├── Cargo.toml
│ └── src
│ └── lib.rs
└── foo
├── Cargo.toml
└── src
└── main.rs
main.rs е главният файл с изходен код за новия ви проект foo –
нищо особено дотук.
Cargo.toml е файлът с настройки за cargo за този проект. Ако погледнете в
него, ще видите нещо такова:
[package]
name = "foo"
version = "0.1.0"
authors = ["mark"]
[dependencies]
Полето name под [package] определя името на проекта. То се ползва от
crates.io, ако обнародвате коша (повече по-късно). Това е и името на двоичния
изпълним файл след компилация.
Полето version е версията на коша. Използват се Значещи версии1.
Полето authorsе списък с автори и се ползва, когато кошът се обнародва.
Разделът [dependencies] е за добавяне на зависимости към проекта.
Нека предположим, че искаме програмата ни да има отлична външност за
командния ред2. Можете да намерите много чудесни пакети на
crates.io (представителния3 регистър за пакети
на Ръждьо). Чест избор е clap. По време на
това писание последната версия на clap е 2.27.1. За да добавим зависимост
към нашата програма, просто добавяме следното в Cargo.toml под
[dependencies]: clap = "2.27.1". И това е! Можете да използвате clap.
cargo поддържа и други типове зависимости. Ето малък пример:
[package]
name = "foo"
version = "0.1.0"
authors = ["mark"]
[dependencies]
clap = "2.27.1" # от crates.io
rand = { git = "https://github.com/rust-lang-nursery/rand" } # от хранилището
bar = { path = "../bar" } # от файлов път на сметалото ви
cargo е повече от управление на зависимости. Всички възможни настройки
са изброени в спецификацията на формата на
Cargo.toml.
За да построим нашия проект, можем да изпълним cargo build където и да е в
папката на проекта (включително и подпапките). Може също да изпълним cargo run, за да построим и изпълним произведения двоичен файл. Забележете, че тези
команди ще разрешат зависимостите, ще изтеглят кошовете, ако е необходимо, и ще
построят всичко, включително и вашия кош. Ще се построи отново само каквото е
нужно, подобно на make.
Voila! Това е всичко!
Б. пр.
Значещи версии – semantic versions
външност, интерфейс – interface. външност за командния ред (ВКР) –
command line interface (CLI). Външността е присъщо свойство на единиците да
си взаимодействат с други единици код. В други езици (Java до версия 8)
външностите не осъществяват никакво действие. Те са само „дрешки“, който
даден клас трябва да си „ушие“ сам, за да може да общува с обекти на други
класове. В Ръждьо пък типовете стават производни на отличителите и така могат
просто да „облекат” някои готови „дрешки” (Debug), а други да си „ушият”,
като ги осъществят (Display). Отличителите в Ръждьо са по-скоро като
абстрактните класове в Java. Но в Ръждьо, можете да извеждате (derive)
повече от един отличител.
представителен (официален) – official