（二）pytest自动化测试框架之添加测试用例步骤（@allure.step()）

前言

在编写自动化测试用例的时候经常会遇到需要编写流程性测试用例的场景，一般流程性的测试用例的测试步骤比较多，我们在测试用例中添加详细的步骤会提高测试用例的可阅读性。

allure提供的装饰器@allure.step()是allure测试报告框架非常有用的功能，它能帮助我们在测试用例中对测试步骤进行详细的描述。

@allure.step的使用例子：

实现一个购物的场景：1.登录；2.浏览商品；3.将商品加入到购物车中；4.下单；5.支付订单；

1. # file_name: test_allure_step.py

4. import pytest

5. import allure

8. @allure.step

9. def login():

10. """

11. 执行登录逻辑

12. :return:

13. """

14. print("执行登录逻辑")

17. @allure.step

18. def scan_good():

19. """

20. 执行浏览商品逻辑

21. :return:

22. """

23. print("执行浏览商品逻辑")

26. @allure.step

27. def add_good_to_shopping_car():

28. """

29. 将商品添加到购物车

30. :return:

31. """

32. print("将商品添加到购物车")

35. @allure.step

36. def generator_order():

37. """

38. 生成订单

39. :return:

40. """

41. print("生成订单")

44. @allure.step

45. def pay():

46. """

47. 支付订单

48. :return:

49. """

50. print("支付订单")

53. def test_buy_good():

54. """

55. 测试购买商品：

56. 步骤1：登录

57. 步骤2：浏览商品

58. 步骤3：将商品加入到购物车中

59. 步骤4：下单

60. 步骤5：支付

61. :return:

62. """

63. login()

64. scan_good()

65. add_good_to_shopping_car()

66. generator_order()

67. pay()

69. with allure.step("断言"):

70. assert 1

73. if __name__ == '__main__':

74. pytest.main(['-s', 'test_allure_step.py'])

执行命令：

1. > pytest test_allure_step.py --alluredir=./report/result_data

3. > allure serve ./report/result_data

查看测试报告展示效果：

从报告中可以看到，我们事先通过@allure.step()定义好的步骤都展示在测试用例test_buy_good()下了。

@allure.step支持嵌套，step中调用step

1. # file_name: steps.py

4. import allure

7. @allure.step

8. def passing_step_02():

9. print("执行步骤02")

10. pass

测试用例：

1. # file_name: test_allure_step_nested.py

4. import pytest

5. import allure

7. from .steps import passing_step_02 # 从外部模块中导入

10. @allure.step

11. def passing_step_01():

12. print("执行步骤01")

13. pass

16. @allure.step

17. def step_with_nested_steps():

18. """

19. 这个步骤中调用nested_step()

20. :return:

21. """

22. nested_step()

24. @allure.step

25. def nested_step_with_arguments(arg1, arg2):

26. pass

28. @allure.step

29. def nested_step():

30. """

31. 这个步骤中调用nested_step_with_arguments()，并且传递参数

32. :return:

33. """

34. nested_step_with_arguments(1, 'abc')

37. def test_with_imported_step():

38. """

39. 测试@allure.step()支持调用从外部模块导入的step

40. :return:

41. """

42. passing_step_01()

43. passing_step_02()

46. def test_with_nested_steps():

47. """

48. 测试@allure.step()支持嵌套调用step

49. :return:

50. """

51. passing_step_01()

52. step_with_nested_steps()

53. passing_step_02()

56. if __name__ == '__main__':

57. pytest.main(['-s', 'test_allure_step_nested.py'])

执行命令：

1. pytest test_allure_step_nested.py --alluredir=./report/result_data

3. allure serve ./report/result_data

查看测试报告展示效果：

从上面的结果中可以看到：

• @step可以先保存到其他模块中，在测试用例中需要用到的时候导入就可以了；
• @step也支持在一个step中嵌套调用其他的step；嵌套的形式在测试报告中以树形展示出来了；

@allure.step支持添加描述且通过占位符传递参数

1. # file_name: test_allure_step_with_placeholder.py

4. import pytest

5. import allure

8. @allure.step('这是一个带描述语的step，并且通过占位符传递参数：positional = "{0}",keyword = "{key}"')

9. def step_title_with_placeholder(arg1, key=None):

10. pass

13. def test_step_with_placeholder():

14. step_title_with_placeholder(1, key="something")

15. step_title_with_placeholder(2)

16. step_title_with_placeholder(3, key="anything")

19. if __name__ == '__main__':

20. pytest.main(['-s', 'test_allure_step_with_placeholder.py'])

执行命令：

1. pytest test_allure_step_with_placeholder.py --alluredir=./report/result_data

3. allure serve ./report/result_data

查看测试报告展示效果：

从上面的执行结果中可以看到，@allure.step()是支持输入描述的，并且支持通过占位符向描述中传递参数。

在conftest.py文件中定义@allure.step

conftest.py文件：

1. # file_name: conftest.py

4. import pytest

5. import allure

8. @pytest.fixture()

9. def fixture_with_conftest_step():

10. conftest_step()

13. @allure.step("这是一个在conftest.py文件中的step")

14. def conftest_step():

15. pass

测试用例：

1. # file_name: test_allure_step_in_fixture_from_conftest.py

4. import pytest

5. import allure

8. @allure.step

9. def passed_step():

10. pass

13. def test_with_step_in_fixture_from_conftest(fixture_with_conftest_step):

14. passed_step()

17. if __name__ == '__main__':

18. pytest.main(['-s', 'test_allure_step_in_fixture_from_conftest.py'])

执行命令：

1. pytest test_allure_step_in_fixture_from_conftest.py --alluredir=./report/result_data

3. allure serve ./report/result_data

查看测试报告展示效果：

从运行结果中可以看到，在fixture中定义的step会在setup和teardown单独以树形结构展示出来。

总结：

感谢每一个认真阅读我文章的人！！！

作为一位过来人也是希望大家少走一些弯路，如果你不想再体验一次学习时找不到资料，没人解答问题，坚持几天便放弃的感受的话，在这里我给大家分享一些自动化测试的学习资源，希望能给你前进的路上带来帮助。

  视频文档获取方式：
这份文档和视频资料，对于想从事【软件测试】的朋友来说应该是最全面最完整的备战仓库，这个仓库也陪伴我走过了最艰难的路程，希望也能帮助到你！以上均可以分享，点下方小卡片即可自行领取。