9장 - 프로젝트 구성과 구조

모듈

• 모든 Rust 프로그램이나 라이브러리(library)는 Crate(크레이트)

• 모든 crate는 Module의 계층구조

• 모든 crate에는 Root Module이 있음

• module에는 전역변수, 함수, struct, trait, 또는 다른 module까지도 포함

• module의 트리 구조는 코드로 직접 작성

프로그램 작성하기

• 프로그램은 main.rs라 불리는 파일에 root module을 가짐

라이브러리 작성하기

• 라이브러리는 lib.rs라 불리는 파일에 root module을 가짐

다른 모듈과 크레이트 참조하기

• std::f64::consts::PI → 모듈 전체 경로로 참조

• use std::f64::consts::PI → PI 만으로 참조

• std 는 표준 라이브러리(standard library)의 crate

• https://crates.io/ → Rust 커뮤니티 Crate 레지스트리

use std::f64::consts::PI;

fn main() {
    println!("놀이터에 오신 것을 환영합니다!");
    println!("{} 한 조각 먹고 싶군요!", PI);
}

여러 개의 항목을 참조하기

• 복수의 항목을 하나의 module 경로로 참조

• → use std::f64::consts::{PI,TAU}

모듈 작성하기

• foo.rs 라는 이름의 파일

• foo 디렉토리에 들어있는 파일 mod.rs

모듈 계층구조

인라인 모듈

// 이 macro는 Rust가 테스트 모드가 아닐 경우
// 이 inline module을 제거합니다.
#[cfg(test)]
mod tests {
    // 부모 module에 즉시 접근이 가능하지 않다는 데에 주의하세요.
    // 반드시 명시적으로 써줘야 합니다.
    use super::*;

    ... tests go here ...
}

내부 모듈 참조하기

• crate - root module

• super - 현재 module의 부모 module

• self - 현재 module

내보내기

• 기본적으로 module의 구성원들은 외부에서 접근이 불가능

• → pub 키워드를 사용하면 모듈의 구성원들을 접근 가능

• 기본적으로 crate의 구성원들도 외부에서 접근이 불가능

• → Root module (lib.rs 또는 main.rs)에 pub을 표시하면 구성원들을 접근 가능

구조체 가시성

// SeaCreature struct는 우리 module 외부에서도 사용 가능합니다
pub struct SeaCreature {
    pub animal_type: String,
    pub name: String,
    pub arms: i32,
    pub legs: i32,
    // 우리의 무기는 비밀로 남겨둡시다
    weapon: String,
}

전주곡 (Prelude)

• Ex> Vec, Box, Option , Copy , …

여러분만의 Prelude

The Rust Programming Language 링크

• 7. 커져 가는 프로젝트를 패키지, 크레이트, 모듈로 관리하기