FIT9136 S1 2024 – 教育课程

Assignment 3 - The Runner's Assertion [20%]
作业 3 - 跑步者的断言 [20%]

Description 描述

[Task 2] - At The Races (25%)
[任务 2] - 在比赛中（25%）

You are NOT allowed to use try/except blocks in Task 2.
不允许在任务 2 中使用 try/except 块。

Task Setup 任务设置

Now that we have our runners, we will turn our attention to the races. In the scaffold, you will see a (somewhat) complete code for the races. There are two types of races - Short and Marathon.
现在我们有了我们的跑步者，我们将把注意力转向比赛。在脚手架中，您将看到（某种程度上）完整的比赛代码。有两种类型的比赛 - 短跑和马拉松。

What has been given (with errors)
给出了什么（有错误）

There are certain features and attributes that the races share in common, however, some of them are different. As was the case in the previous task, here are the details of the attributes used in these classes:
种族有一些共同的特征和属性，但是，其中一些是不同的。与上一个任务中的情况一样，以下是这些类中使用的属性的详细信息：

race_type : A string that contains the type of the race. If its a short race, this will contain the string "short" whereas if the race is a marathon, then this string will contain "long".
race_type ：包含种族类型的字符串。如果是短跑，则此字符串将包含字符串 "short" ，而如果比赛是马拉松，则此字符串将包含 "long" 。
distance : A positive floating value that contains (in kilometres) the distance of the race. Distances vary even within marathons and short races.
distance ：包含（以公里为单位）比赛距离的正浮点值。即使在马拉松和短距离比赛中，距离也各不相同。
runners : A list of runner objects (from the runner class in the previous task).
runners ：运行器对象的列表（来自上一个任务中的 runner 类）。
maximum_participants : An integer that defines the maximum number of participants that can participate in the race. This value is 8 for short races and 16 for marathons.
maximum_participants ：定义可以参加比赛的最大参与者人数的整数。此值适用于 8 短途比赛和 16 马拉松比赛。
time_multiplier : Our calculations consider the runners running at the highest speed for the entire duration of a short race. To cater for the error, we apply a time_multiplier which fixes the time calculated for a runner to run the short race. The value of this multiplier is currently set to 1.2 for all short races. This value doesn't exist for marathon races.
time_multiplier ：我们的计算考虑了在整个短途比赛期间以最高速度奔跑的跑步者。为了弥补这个错误，我们应用了一个 time_multiplier 固定跑步者跑短跑计算的时间。对于所有短距离比赛，此乘数的值目前设置为 1.2。此值在马拉松比赛中不存在。
For example - if a runner's speed is $x$ meters per second, and the distance is $y$ meters, then the time should be calculated as
例如 - 如果跑步者的速度是 $x$ 米/秒，距离是 $y$ 米，那么时间的计算公式应为
$\text{time} = \frac{y}{x} * 1.2$

energy_per_km : An integer (set to 100 for all marathons) that contains the amount of energy consumed per kilometer run of a marathon. When the race is conducted for a marathon, energy is consumed per km and the racers that run out of energy before the marathon finishes don't qualify as a finisher. This value doesn't exist for short races.
energy_per_km ：一个整数（对于所有马拉松比赛，设置为 100），其中包含马拉松每公里跑步消耗的能量。当比赛进行马拉松比赛时，每公里消耗能量，在马拉松结束前耗尽能量的赛车手没有资格成为完赛者。此值不适用于短距离比赛。

The classes given to you also has the following methods:
提供给您的课程还有以下方法：

__init__(self, distance, runners = None) : this is the constructor for the Race(ABC) class that sets up the Race. As you can see, runners is an optional parameter. If the value of runners is passed as None or if no value for runners is provided, you should initialise the runners as an empty list. However, if there are values provided, then they should only be objects of the Runner class.
__init__(self, distance, runners = None) ：这是设置 Race 的 Race（ABC）类的构造函数。如您所见， runners 是一个可选参数。如果的 runners 值传递为 None 或未提供 for runners 值，则应将运行器初始化为空列表。但是，如果提供了值，则它们应该只是 Runner 类的对象。
add_runner(self) : this method adds a runner to the race. However, if the runner already exists, then this method should raise a RunnerAlreadyExistsError, which has been imported for you already. You should also make sure that the number of runners don't exceed the maximum_participants. In case adding the runner will exceed the maximum participants, you should raise a RaceIsFull error.
add_runner(self) ：此方法将跑步者添加到比赛中。但是，如果运行器已存在，则此方法应引发 RunnerAlreadyExistsError ，该已为您导入。您还应该确保运行者的数量不超过 maximum_participants .如果添加运行器将超过最大参与者数，则应引发 RaceIsFull 错误。
remove_runner(self) : this method removes a runner from the race. However, if the runner does not exist then this method should raise a RunnerDoesntExistError, which has been imported for you already.
remove_runner(self) ：此方法将跑步者从比赛中移除。但是，如果运行器不存在，则此方法应引发 RunnerDoesntExistError ，该已为您导入。
conduct_race(self) : this method should conduct a race based on the type of race that we are considering.
conduct_race(self) ：此方法应根据我们正在考虑的比赛类型进行比赛。
- For a short race: We call the run_race method for each runner and calculate the time taken to run the race.
  对于短跑：我们为每个跑步者调用该 run_race 方法并计算跑步所需的时间。
- For a marathon race: We call the run_race method once for each runner for each kilometre of the marathon race. We also reduce the runner's energy according to the value set in the class. For this purpose, feel free to round up the distance to the nearest integer. If the runner runs out of energy, their finish time is set to 'DNF' (Did Not Finish).
  对于马拉松比赛：我们为马拉松比赛的每公里的每个跑步者调用一次该 run_race 方法。我们还根据班级中设定的值来减少跑步者的能量。为此，请随意将距离四舍五入到最接近的整数。如果跑步者的能量耗尽，他们的完成时间将设置为“DNF”（未完成）。

After the conclusion of the conduct_race method, a list of tuples should be returned (this code is already done for you).
conduct_race 方法结束后，应返回元组列表（此代码已为您完成）。

For You To Do
为你做

We definitely need to find better TAs because these ones keep making mistakes!
我们肯定需要找到更好的助教，因为这些人会不断犯错！

You are tasked with the following:
您的任务如下：

Copy and replace the code for runner.py that is given in the scaffold with your pristine code from the previous task.
复制脚手架中给出的代码 runner.py 并将其替换为上一个任务中的原始代码。
Fix the errors that have been made in the class, variables, and methods based on the descriptions provided above. There may be cases where you need to remove some of the methods if you are implementing inheritance.
根据上面提供的描述修复类、变量和方法中出现的错误。如果要实现继承，则在某些情况下可能需要删除某些方法。
NOTE: You may need to move/remove some of the variables and methods in between the three classes once you implement proper inheritance. Please ensure that the names of the methods/variables DO NOT CHANGE from the ones given to you.
注意：实现正确的继承后，可能需要在三个类之间移动/删除一些变量和方法。请确保方法/变量的名称不会与提供给您的名称更改。
Check the pre-conditions and post-conditions for each of the methods. Make sure to raise the relevant errors if incorrect values are passed to the functions.
检查每种方法的前置条件和后置条件。如果将不正确的值传递给函数，请确保引发相关错误。
Document your code including type-hinting for all variables and arguments for functions and methods, as well as include relevant docstrings for each method and class.
记录您的代码，包括函数和方法的所有变量和参数的类型提示，以及每个方法和类的相关文档字符串。
Build on the unit tests that have already been given to you in the file test_races.py. You are expected to create at least three tests for each method. You should create these additional tests in a separate testing function in the given class.
基于文件中 test_races.py 已提供给您的单元测试进行构建。应为每种方法创建至少三个测试。您应该在给定类的单独测试函数中创建这些附加测试。

Important Points 要点

Remember, it is YOUR RESPONSIBILITY to ensure that a proper error is raised when an invalid input is received. Here are some pointers:
请记住，您有责任确保在收到无效输入时引发正确的错误。以下是一些提示：

If the value received by a method is invalid or not what the method expects, then you should raise a CustomValueError.
如果方法接收的值无效或不符合该方法的预期值，则应引发 CustomValueError .
If the type of value received by a method is invalid or not what the method expects, then you should raise a CustomTypeError.
如果方法接收的值类型无效或不符合方法的预期值，则应引发 CustomTypeError .
If the value being passed to the method is not an attribute of the class, then you should raise an CustomAttributeError.
如果传递给方法的值不是类的属性，则应引发 CustomAttributeError .
If the method is trying to get a value from a dictionary that shouldn't be returned, you should raise a CustomKeyError.
如果该方法尝试从字典中获取不应返回的值，则应引发 CustomKeyError .
If a runner is being added to a race that already exists in the race, you should raise a RunnerAlreadyExistsError.
如果要将跑步者添加到比赛中已存在的比赛中，则应提出 RunnerAlreadyExistsError .
If a runner is being removed from a race that doesn't exist in that race, you should raise a RunnerDoesntExistError.
如果跑步者被从该比赛中不存在的比赛中移除，您应该提出 RunnerDoesntExistError .

Description 描述

race.py

runner.py

countries.csv

test_race.py

from custom_errors import *
class Runner:
    def __init__(self, name, age, country, sprint_speed, endurance_speed):
        max_energy = 1000
        self.name = name
        self.age = age
        self.country = country
        self.sprint_speed = sprint_speed
        self.endurance_speed = endurance_speed
        self.energy = max_energy
    
    def drain_energy(self, drain_points):
        self.energy -= drain_points
    
    def recover_energy(self, recovery_amount):
        self.energy += recovery_amount
    
    def run_race(self, race_type, distance):
        race_type = 'short'
        return distance * self.sprint_speed
if __name__ == '__main__':
    runner = Runner('Elijah', 18, 'Australia', 5.8, 4.4)
    
    # running a short race
    time_taken = runner.run_race('short', 2)
    print(f"Runner {runner.name} took {time_taken} seconds to run 2km!")
    

country,latitude,longitude,name
AT,47.516231,14.550072,Austria
AU,-25.274398,133.775136,Australia
AW,12.52111,-69.968338,Aruba
AZ,40.143105,47.576927,Azerbaijan
BA,43.915886,17.679076,Bosnia and Herzegovina
BV,-54.423199,3.413194,Bouvet Island
BW,-22.328474,24.684866,Botswana
BY,53.709807,27.953389,Belarus
BZ,17.189877,-88.49765,Belize
CA,56.130366,-106.346771,Canada
CC,-12.164165,96.870956,Cocos [Keeling] Islands
CD,-4.038333,21.758664,Congo [DRC]
CF,6.611111,20.939444,Central African Republic
CG,-0.228021,15.827659,Congo [Republic]
CH,46.818188,8.227512,Switzerland
CI,7.539989,-5.54708,Cote d'Ivoire
CK,-21.236736,-159.777671,Cook Islands
CL,-35.675147,-71.542969,Chile
EH,24.215527,-12.885834,Western Sahara
ER,15.179384,39.782334,Eritrea
ES,40.463667,-3.74922,Spain
ET,9.145,40.489673,Ethiopia
FI,61.92411,25.748151,Finland
FJ,-16.578193,179.414413,Fiji
FK,-51.796253,-59.523613,Falkland Islands [Islas Malvinas]
FM,7.425554,150.550812,Micronesia
FO,61.892635,-6.911806,Faroe Islands
FR,46.227638,2.213749,France
GA,-0.803689,11.609444,Gabon
GB,55.378051,-3.435973,United Kingdom
GD,12.262776,-61.604171,Grenada
GE,42.315407,43.356892,Georgia
GF,3.933889,-53.125782,French Guiana
GG,49.465691,-2.585278,Guernsey

/home/race.py /首页/race.py All changes saved 装载。。。

Console will be displayed here after running your code

Workspace 工作