Module (Rust)

다른 파일에서 모듈 가져오기

  • main.rs 파일에서 src/services/user.rs 파일의 User struct를 쓰고자 한다.
+ src
| + main.rs
| + lib.rs
| + services
| | + user.rs
  • 그냥 use crate::services::user를 하면 루트에 파일이 없다는 에러가 발생한다.
// src/services/user.rs

pub struct User { ... }
  • 루트의 lib.rs 파일에 모듈을 공개해야 한다.
// src/lib.rs

pub mod services {
  pub mod user;
}

  • 디렉토리, 파일 자체가 하나의 모듈이다. services 모듈 안에 user 모듈이 있는 것.

  • pub mod user;는 user 모듈(파일)의 내용을 다른 위치에서 찾으라는 의미다.

    pub mod services {
  pub mod user {
    // contents of services/user.rs
  }
}

  • 이제 main.rs에서 루트를 기준으로 services 모듈과 그 안의 user 모듈을 찾을 수 있다.

// src/main.rs

use crate::services::user::User;

fn main() {
  let user = User { ... };
  // do something...
}
  • mod.rs 파일을 이용해 디렉토리 모듈 자체만 공개할 수도 있다.
+ src
| + main.rs
| + lib.rs
| + services
| | + mod.rs

// src/services/mod.rs

pub struct User { ... }

// src/lib.rs

pub mod services;

// src/main.rs

use crate::services::User;

fn main() {
  let user = User { ... };
  // do something...
}

크레이트와 모듈의 차이

  • 크레이트는 컴파일 단위로, 컴파일러가 다룰 수 있는 가장 작은 규모의 코드를 말한다.
  • 모듈은 크레이트 안에 있는 코드 구조의 단위를 말한다.
  • mod - 모듈이 존재함을 선언.
  • use - 다른 곳에 선언된 모듈을 참조해 그 내용을 현재 모듈의 스코프에 가져온다.

이 문서를 인용한 문서