패키지·크레이트·모듈의 차이를 구분하고 Rust 프로젝트 구조를 정확하게 읽을 수 있습니다.
mod 선언으로 여러 파일을 모듈 트리에 연결할 수 있습니다.
라이브러리와 실행 파일의 역할을 나누어 테스트하기 쉬운 프로젝트를 구성할 수 있습니다.
역할과 변경 이유를 기준으로 모듈과 크레이트의 경계를 설계할 수 있습니다.
비공개 모듈을 연결하고 필요한 타입과 함수만 재공개하는 라이브러리를 완성할 수 있습니다.
파일만 나누던 코드를, 경계가 보이는 Rust 프로젝트로
프로젝트가 커지면 코드가 어느 파일에 있는지만 알아서는 부족합니다. 각 코드가 어떤 책임을 맡는지, 어디까지 공개해야 하는지, 여러 실행 파일이 어떤 코드를 함께 사용해야 하는지도 결정해야 합니다.
이 강의에서는 자주 혼동하는 패키지·크레이트·모듈의 차이부터 시작합니다. 이어서 모듈 트리와 파일 배치, crate::·self::·super:: 경로, use, 공개 범위, 라이브러리와 실행 파일의 분리, pub use를 이용한 재공개, Cargo 워크스페이스를 차례로 배웁니다.
마지막에는 model·parser·report 모듈의 내부 구현을 감추고, 외부 사용자가 필요한 타입과 함수만 간결한 경로로 사용할 수 있는 라이브러리를 직접 완성합니다. 문법을 외우는 데 그치지 않고, 변경하기 쉽고 사용하기 편한 Rust 프로젝트의 경계를 설계하는 것이 이 강의의 목표입니다.
이런 내용을 배워요
패키지·크레이트·모듈을 정확하게 구분해요
Cargo.toml이 관리하는 패키지, 컴파일 단위인 크레이트, 코드를 역할별로 묶는 모듈의 차이를 배웁니다. src/lib.rs, src/main.rs, src/bin이 각각 어떤 크레이트의 시작점이 되는지 살펴보고, 하나의 패키지 안에 라이브러리와 여러 실행 파일을 구성하는 방법을 이해합니다.
하나의 패키지 안에서도 라이브러리와 각 실행 파일은 서로 다른 크레이트로 컴파일됩니다.
모듈 트리와 파일 배치를 연결해서 이해해요
mod 선언이 파일을 단순히 복사하는 문법이 아니라 모듈 트리에 코드를 연결하는 선언임을 배웁니다. 인라인 모듈, parser.rs, parser/mod.rs의 차이를 살펴보고, 부모·자식 모듈의 논리적인 구조와 실제 소스 파일의 배치를 구분합니다.
모듈 트리는 코드의 논리적인 관계를 나타내고, 파일은 각 모듈의 코드를 저장합니다.
종합 실습으로 공개 API를 완성해요
이미 구현된 model, parser, report 코드를 비공개 모듈로 연결하고, 외부에 필요한 타입과 함수만 크레이트 루트에 재공개합니다. 테스트 실패 메시지를 하나씩 해결하면서 내부 구조는 감추고 사용하기 쉬운 라이브러리 API를 직접 완성합니다.
.png?w=420)
