통합 테스트
tests 디렉터리
통합 테스트은(는) CoddyKit의 무료 Learn Rust Coding 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Learn Rust Coding 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
이 강의의 일부는 아직 번역되지 않았으며 영어로 표시됩니다.
What Are Integration Tests?
Integration tests verify your crate's public API the way an external user would. They live outside src and can only call public items.
The tests Directory
Cargo treats every file in the top-level tests/ directory as a separate test crate. No #[cfg(test)] module is needed there.
tests/api.rstests/parsing.rs
A Library to Test
Integration tests target a library crate. Suppose src/lib.rs exposes a public function.
// src/lib.rs
pub fn add(a: i32, b: i32) -> i32 {
a + b
}Writing an Integration Test
In tests/add.rs, import the crate by name and test its public API. Each function still uses #[test].
// tests/add.rs
use my_lib::add;
#[test]
fn adds_two_numbers() {
assert_eq!(add(2, 2), 4);
}Public Only
Because integration tests are a separate crate, they can use only public (pub) items. Private functions are invisible — just like to any real consumer.
Running Integration Tests
cargo test runs unit and integration tests together. Each file under tests/ appears as its own test binary in the output.
cargo testRunning One File
Use --test with the file name (without extension) to run a single integration test file.
cargo test --test addShared Test Helpers
To share setup code without making it a test file, put helpers in tests/common/mod.rs. Files in subdirectories are not treated as test crates.
// tests/common/mod.rs
pub fn setup() {
// shared setup logic
}Using the Helper
Declare the module and call its functions from your integration test.
// tests/api.rs
mod common;
#[test]
fn uses_setup() {
common::setup();
assert!(true);
}Unit vs Integration
Two complementary test styles:
- Unit tests live in
src, can test private items, fast and focused - Integration tests live in
tests/, test the public API end to end
Testing a Binary Crate
Integration tests target libraries, not binaries. A common pattern is to keep logic in src/lib.rs and have a thin src/main.rs that calls it, so both unit and integration tests can reach the code.
// src/main.rs
fn main() {
println!("{}", my_lib::add(2, 3));
}Quick Check
Where do integration tests live, and what can they access?
Recap
You learned integration testing:
- Files in
tests/are separate test crates - They import your crate by name and test only public items
cargo test --test nameruns one file- Shared helpers go in
tests/common/mod.rs
자주 묻는 질문
“통합 테스트” 강의는 무료인가요?
네 — “통합 테스트” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Learn Rust Coding 강의 전체를 잠금 해제할 수 있습니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
“통합 테스트”에서 뭘 배우나요?
tests 디렉터리 브라우저에서 직접 실행하는 실습 코드로 Learn Rust Coding을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Learn Rust Coding을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Learn Rust Coding은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“통합 테스트” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Learn Rust Coding 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Learn Rust Coding 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.