结对项目——小学四则运算题目自动生成器

这个作业属于哪个课程	<计科22级34班>
这个作业要求在哪里	<结对项目>
这个作业的目标	<实现一个自动生成小学四则运算题目的命令行程序（也可以用图像界面，具有相似功能）>
团队成员	<杨富国（3122004587）、李思柔（3222004638）>
Github项目地址	https://github.com/wWchao-111/Myapp

一、PSP表

PSP2.1	Personal Software Process Stages	预估耗时（分钟）	实际耗时（分钟）
Planning	计划	90	90
· Estimate	· 估计这个任务需要多少时间	45	60
Development	开发	120	150
· Analysis	· 需求分析 (包括学习新技术)	60	60
· Design Spec	· 生成设计文档	60	60
· Design Review	· 设计复审	60	60
· Coding Standard	· 代码规范 (为目前的开发制定合适的规范)	60	60
· Design	· 具体设计	60	60
· Coding	· 具体编码	30	30
· Code Review	· 代码复审	30	30
· Test	· 测试（自我测试，修改代码，提交修改）	180	150
Reporting	报告	60	60
· Test Repor	· 测试报告	60	60
· Size Measurement	· 计算工作量	10	10
· Postmorte· 合计m & Process Improvement Plan	· 事后总结, 并提出过程改进计划	30	30
	· 合计	955	970

二、设计实现过程

共7个模块：

main():用于命令行输入输出的对接，包含整体运行逻辑、表达式的写入写出和答案比对。
random_fraction():随机生成一个数，可能是分数也可能是整数。
random_expression():生成全部表达式。
is_valid():判断生成的表达式是否合理。
genetate_expressions():生成最终的总表达式。
evaluate():计算表达式的值。
grade():比对题目和答案是否正确。

流程图：

三、代码说明：

1.核心代码：

2.分析：

生成随机数random_fraction()：

定义一个函数random_fraction(max_denominator)，用于生成一个随机数。
此函数接收一个最大分母值 max_denominator，生成一个随机分数。分子的范围从 0 到 max_denominator - 1，而分母则从 1 到 max_denominator（避免分母为零）。
函数内部使用random.randint()生成两个随机整数作为分子和分母，然后使用fractions.Fraction()创建一个分数对象并返回。

生成表达式random_expression():

定义一个函数random_expression(max_denominator, max_operators)，用于生成一个随机的数学表达式。
此函数接收两个参数：max_denominator表示分母的最大值，max_operators表示操作符的最大数量。
函数首先生成一个随机分数作为表达式的第一个元素，然后在循环中随机选择操作符（加、减或乘）并生成另一个随机分数，将它们添加到表达式中，最后返回生成的表达式字符串。（操作符的数量在 1 到 max_operators之间随机决定）

检查表达式合法性is_valid()：

定义一个函数is_valid(expression)，用于检查表达式是否合法。
这个函数接受一个表达式字符串作为参数，将其分割成各个部分，然后检查每个操作符前后的分数是否符合四则运算的规则。例如，如果操作符是-，那么应确保被减数不小于减数；如果操作符是/，那么应确保除数不为零。如果所有操作符都符合规则，则返回True，否则返回False。

四、测试运行

测试模块代码：

五、运行结果

Exercises.txt（题目数量：10，范围：10）是题目。
Answers.txt是答案。
Grade.txt是结果。

用生成的题目文件和答案文件做比对测试：

交换第3题和第4题的答案后，grade输出第3、4题错误，其余正确：

六、效能分析

由此可以看出：生成随机数random_fraction是最耗时的。

七、项目小结

杨富国：

经过这次项目，我深刻了解到一个设计文档的重要性，当对项目进行分析设计模块的大体框架后，代码实现的进度就快了许多，剩下的更多是模块功能的微调与测试。
第一次的结对项目更让我感受到了团队合作中分工与沟通的重要性，明确的分工让我们可以节省很多时间，也让我们感受到了团队合作中交流的重要性

李思柔：

这是我第一次与人合作完成一个项目，刚开始又有点不适应，但在一次次磨合中我们还是完成了这次结对项目，我意识到在团队工作中共同协作和沟通的重要性，也发现两个人想问题和做决策比一个人的效率要快得多。感谢我的搭档！是他帮助了我很多才完成这次结对项目，本人在此郑重鸣谢！