[Rust] 패키지 매니저 Cargo 사용하기

Rust 패키지 매니저 Cargo 란 무엇인가?

Cargo 는 Rust 프로젝트 생성, 빌드, 테스트, 의존성을 관리하기 위한 도구입니다.

 

 

Cargo 설치

Rust 컴파일러를 설치하면 Cargo 도 함께 설치됩니다.

설치 방법은 [Rust] 컴파일러 설치하기 (Windows) 글을 참고해 주세요.

 

 

새 프로젝트 생성

Cargo 로 완전히 새 프로젝트(package) 를 생성하려면 다음 명령어를 사용합니다.

$ cargo new 프로젝트_이름

위 명령은 기본 구조를 갖춘 Rust 프로젝트를 생성합니다. 기본 디렉터리 구조는 다음과 같습니다.

프로젝트_이름/
├── Cargo.toml  # 프로젝트 설정 파일
└── src/
    └── main.rs  # 기본 실행 파일

기존 프로젝트 초기화

현재 경로를 Cargo 프로젝트로 만들기 위해서는 다음 명령어를 사용합니다.

$ cargo init

의존성 추가

Cargo.toml 파일에 의존성을 추가하고 싶다면 아래와 같이 입력합니다.

$ cargo add 패키지_이름

예를 들어, serde 라이브러리를 추가려는 경우,

$ cargo add serde

위처럼 입력하면 Cargo.toml 파일에 다음과 같이 기록됩니다.

[dependencies]
serde = "1.0"

빌드 및 실행

아래와 같이 입력하여 현재 경로의 프로젝트를 빌드할 수 있습니다.

$ cargo build

아래와 같이 입력하여 빌드된 프로젝트를 실행합니다.

$ cargo run

Release 빌드를 생성하려면 아래와 같이 옵션을 추가하면 됩니다.

$ cargo build --release

Release 빌드의 실행 파일은 target/release/ 디렉터리에 생성됩니다.

테스트 실행

Rust 는 내장 테스트 프레임워크를 제공합니다.

아래와 같이 입력하여 테스트를 실행할 수 있습니다.

$ cargo test

코드 검사 및 포맷팅

아래와 같이 입력하여 코드에 문제가 없는지 검사할 수 있습니다.

$ cargo check

아래와 같이 입력하여 코드의 형식 (포메팅) 을 Rust 에서 권하는 형태로 자동으로 변환할 수 있습니다.

$ cargo fmt

문서 생성

Rust 는 작성한 코드를 기반으로 웹으로 볼 수 있는 HTML 형식의 도움말 문서를 자동 생성하는 기능을 제공합니다.

아래와 같이 입력하여 문서를 생성하고 웹 브라우저를 통해 도움말 문서를 열 수 있습니다.

$ cargo doc --open

 

 

 

참고자료

https://doc.rust-lang.org/cargo/