Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Package dan Crate

Bagian pertama dari sistem module yang akan kita bahas adalah package dan crate.

Crate adalah satuan kode terkecil yang diproses oleh compiler Rust pada satu waktu. Bahkan kalau kamu menjalankan rustc alih-alih cargo dan mengirimkan satu file kode sumber (seperti yang kita lakukan jauh sebelumnya di “Dasar Program Rust” pada Bab 1), compiler tetap menganggap file itu sebagai sebuah crate. Crate bisa berisi module, dan module tersebut bisa didefinisikan di file lain yang ikut dikompilasi bersama crate-nya, seperti yang akan kita lihat pada bagian-bagian berikutnya.

Crate bisa hadir dalam salah satu dari dua bentuk: binary crate atau library crate. Binary crate adalah program yang bisa kamu kompilasi menjadi executable yang bisa dijalankan, misalnya program command line atau server. Setiap binary crate harus punya fungsi bernama main yang mendefinisikan apa yang terjadi ketika executable dijalankan. Semua crate yang kita buat sejauh ini semuanya binary crate.

Library crate tidak punya fungsi main dan tidak dikompilasi menjadi executable. Sebagai gantinya, library crate mendefinisikan fungsionalitas yang dipakai bersama oleh banyak proyek. Sebagai contoh, crate rand yang kita gunakan di Bab 2 menyediakan fungsionalitas untuk menghasilkan angka acak. Sebagian besar waktu, ketika Rustacean menyebut “crate”, yang mereka maksud adalah library crate, dan mereka memakai “crate” sebagai padanan konsep pemrograman umum yaitu “library”.

Crate root adalah file sumber tempat compiler Rust mulai bekerja, dan file itu membentuk root module dari crate kamu (kita akan menjelaskan module secara mendalam di “Mengontrol Scope dan Privasi dengan Module”).

Package adalah bundel berisi satu atau lebih crate yang menyediakan satu kumpulan fungsionalitas. Package berisi file Cargo.toml yang menjelaskan cara build crate-crate tersebut. Sebenarnya Cargo adalah sebuah package yang berisi binary crate untuk tool command line yang selama ini kamu pakai untuk build kode kamu. Package Cargo juga berisi sebuah library crate yang menjadi dependensi binary crate itu. Proyek lain bisa bergantung pada library crate Cargo untuk memakai logika yang sama dengan yang dipakai tool command line Cargo.

Sebuah package boleh berisi binary crate sebanyak yang kamu mau, tetapi paling banyak hanya satu library crate. Package wajib berisi minimal satu crate, baik itu library crate maupun binary crate.

Mari kita telusuri apa yang terjadi ketika kita membuat sebuah package. Pertama, kita masukkan perintah 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

Setelah menjalankan cargo new my-project, kita memakai ls untuk melihat apa yang dibuat Cargo. Di direktori my-project ada file Cargo.toml, sehingga kita punya sebuah package. Di sana juga ada direktori src yang berisi file main.rs. Buka Cargo.toml di text editor kamu dan perhatikan bahwa tidak ada penyebutan src/main.rs. Cargo mengikuti konvensi bahwa src/main.rs adalah crate root dari binary crate yang namanya sama dengan nama package. Dengan cara yang sama, Cargo tahu bahwa jika direktori package berisi src/lib.rs, berarti package tersebut berisi library crate dengan nama yang sama dengan nama package, dan src/lib.rs adalah crate root-nya. Cargo meneruskan file-file crate root tersebut ke rustc untuk build library atau binary-nya.

Di sini, kita punya package yang hanya berisi src/main.rs, artinya package itu hanya berisi sebuah binary crate bernama my-project. Jika sebuah package berisi src/main.rs dan src/lib.rs, package itu punya dua crate: sebuah binary dan sebuah library, keduanya bernama sama dengan nama package. Sebuah package bisa punya beberapa binary crate dengan menempatkan file-file di direktori src/bin: Setiap file akan menjadi binary crate yang terpisah.