【Rust 基础篇】Rust 测试详解

繁依Fanyi

发布于 2023-10-12 10:38:54

5800

发布于 2023-10-12 10:38:54

文章被收录于专栏：繁依Fanyi 的专栏

导言

在软件开发中，测试是确保代码质量和功能正确性的关键环节。Rust 提供了一套强大的测试框架，使得编写和运行测试变得简单而高效。本篇博客将详细介绍 Rust 中的测试，包括测试函数的编写、测试断言、测试组织以及测试覆盖率等内容。

一、编写测试函数

在 Rust 中，编写测试函数非常简单。我们可以使用 #[cfg(test)] 属性将测试代码标记为测试模块，并使用 #[test] 属性标记测试函数。

下面是一个示例，演示了如何编写测试函数：

#[cfg(test)]
mod tests {
    #[test]
    fn test_addition() {
        assert_eq!(2 + 2, 4);
    }

    #[test]
    fn test_subtraction() {
        assert_eq!(5 - 2, 3);
    }
}

在上述示例中，我们使用 #[cfg(test)] 属性标记了测试模块。在该模块内部，我们定义了两个测试函数 test_addition 和 test_subtraction，并使用 #[test] 属性标记它们。这样，这些函数就会被 Rust 的测试框架识别为测试函数。

二、运行测试

Rust 提供了一个命令行工具 cargo 来管理和运行测试。通过简单的命令，我们可以轻松地运行项目中的所有测试。

要运行测试，只需在项目根目录下运行以下命令：

cargo test

运行命令后，cargo 将会查找项目中所有标记为测试的函数，并执行它们。测试的运行结果将在命令行中显示。

三、断言

在测试函数中，我们经常需要断言某个表达式的结果是否符合预期。Rust 提供了丰富的断言宏，用于进行各种断言操作。

下面是一些常用的断言宏：

assert_eq!：断言两个表达式的值相等。
assert_ne!：断言两个表达式的值不相等。
assert!：断言表达式的值为 true。
assert!(expression, "message")：断言表达式的值为 true，并在断言失败时输出自定义错误信息。

下面是一个示例，演示了如何使用断言宏进行测试：

#[cfg(test)]
mod tests {
    #[test]
    fn test_addition() {
        assert_eq!(2 + 2, 4);
    }

    #[test]
    fn test_subtraction() {
        assert_ne!(5 - 2, 2);
    }

    #[test]
    fn test_assert() {
        let value = 42;
        assert!(value > 0, "Value should be positive");
    }
}

在上述示例中，我们使用了不同的断言宏来进行测试。assert_eq! 断言了 2 + 2 的结果等于 4，assert_ne! 断言了 5 - 2 的结果不等于 2，assert! 断言了 value 大于 0。

四、测试组织

在 Rust 中，我们可以使用模块来组织测试。通过使用模块，我们可以更好地组织和管理测试函数。

下面是一个示例，演示了如何组织测试：

#[cfg(test)]
mod tests {
    mod math {
        #[test]
        fn test_addition() {
            assert_eq!(2 + 2, 4);
        }

        #[test]
        fn test_subtraction() {
            assert_eq!(5 - 2, 3);
        }
    }

    mod strings {
        #[test]
        fn test_concatenation() {
            let s1 = String::from("Hello");
            let s2 = String::from("World");
            assert_eq!(s1 + " " + &s2, "Hello World");
        }
    }
}

在上述示例中，我们在测试模块内部创建了两个子模块 math 和 strings，并在各自的子模块中定义了测试函数。通过使用模块，我们可以更好地组织和分类测试函数。