#[test] と assert! — テストの書き方のサンプルコード — Rust

1assert! で真偽を検証する最小のテスト

#[cfg(test)] の mod tests に #[test] 関数を置き、assert! で真偽を検証する基本形です。assert! の条件が偽になると panic してそのテストは失敗扱いになります。この実行環境では main が動くため、同じ検証を main からも呼んで通ることを確かめています。

Rust

fn is_even(n: i32) -> bool {
    n % 2 == 0
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn even_numbers() {
        assert!(is_even(4)); // 偽なら panic してテスト失敗
        assert!(!is_even(7));
    }
}

fn main() {
    assert!(is_even(4)); // 実際のテストは cargo test が実行する
    assert!(!is_even(7));
    println!("is_even の検証をすべて通過しました");
}

2テスト関数を分けて意図を名前にする

1つの関数に対して、観点ごとにテスト関数を分ける例です。positive_stays と negative_becomes_positive という名前自体が仕様の説明になっており、失敗したときも「どの観点が壊れたか」が一目で分かります。cargo test はテスト関数を1つずつ実行して、関数名つきで成否を報告します。

Rust

fn abs(n: i32) -> i32 {
    if n < 0 { -n } else { n }
}
#[cfg(test)]
mod tests {
    use super::*;
    #[test]
    fn positive_stays() {
        assert!(abs(5) == 5);
    }
    #[test]
    fn negative_becomes_positive() {
        assert!(abs(-5) == 5);
    }
}

fn main() {
    assert!(abs(5) == 5 && abs(-5) == 5);
    println!("abs の検証を通過しました");
}

3assert! に失敗メッセージを付ける

assert!(条件, "メッセージ", 値...) の形で、失敗時に表示される説明を添えられることを示す例です。メッセージには println! と同じ {} の埋め込みが使えるため、実際の値を含めておくと原因調査が一気に楽になります。条件だけの assert! で失敗原因が分かりにくいと感じたら、この形に育てていきます。

Rust

fn discount_price(price: u32) -> u32 {
    price * 80 / 100
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn discounts_20_percent() {
        let result = discount_price(1000);
        assert!(result == 800, "期待 800, 実際 {}", result);
    }
}

fn main() {
    let result = discount_price(1000);
    assert!(result == 800, "期待 800, 実際 {}", result);
    println!("割引後 = {} 円で検証を通過", result);
}

4条件が複雑な関数こそテストで守る

うるう年判定のように条件が入り組んだ関数は、頭の中の確認だけでは漏れが出ます。「4で割り切れる」「ただし100で割り切れる年は除く」「ただし400で割り切れる年は含む」という3つのルールを、それぞれ代表的な年で assert! に固定しています。仕様の例外ケースをテストとして書き残すのは実務の基本動作です。

Rust

fn is_leap_year(year: u32) -> bool {
    (year % 4 == 0 && year % 100 != 0) || year % 400 == 0
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn leap_year_rules() {
        assert!(is_leap_year(2024));
        assert!(!is_leap_year(1900)); // 100で割り切れる年は平年
        assert!(is_leap_year(2000)); // ただし400で割り切れる年はうるう年
    }
}

fn main() {
    assert!(is_leap_year(2024) && !is_leap_year(1900) && is_leap_year(2000));
    println!("うるう年判定の検証を通過しました");
}

5ユーザー名バリデーションのテスト

「空でない・8文字以内・空白を含まない」というユーザー名の検証関数を、正常系と拒否ケースの両面からテストする実務寄りの例です。バリデーションは仕様変更が多く、テストがないと「直したら別のケースが壊れた」が起きがちな領域です。拒否すべき入力こそ assert!(!...) で明示的に固定しておきます。

Rust

fn is_valid_username(name: &str) -> bool {
    !name.is_empty() && name.len() <= 8 && !name.contains(' ')
}

#[cfg(test)]
mod tests {
    use super::*;
    #[test]
    fn validates_usernames() {
        assert!(is_valid_username("alice"));
        assert!(!is_valid_username("")); // 空文字は拒否
        assert!(!is_valid_username("a b")); // 空白入りは拒否
        assert!(!is_valid_username("toolongname")); // 9文字以上は拒否
    }
}

fn main() {
    assert!(is_valid_username("alice") && !is_valid_username("a b"));
    println!("ユーザー名バリデーションの検証を通過しました");
}

サンプルコードで身につける: #[test] と assert! — テストの書き方

1assert! で真偽を検証する最小のテスト

2テスト関数を分けて意図を名前にする

3assert! に失敗メッセージを付ける

4条件が複雑な関数こそテストで守る

5ユーザー名バリデーションのテスト